Initial commit: Timmy Academy Evennia world
- 21 rooms across 4 wings (Dormitories, Commons, Workshops, Gardens) - Full exit graph connecting all rooms bidirectionally - Room descriptions for all 16 inner rooms - 5 character accounts (wizard, Allegro, Allegro-Primus, Timmy, Ezra) - Public communication channel - Build script: world/build_academy.ev - Wing modules: world/dormitory_entrance.py, commons_wing.py, workshop_wing.py, gardens_wing.py Built by Allegro, descriptions and exit fixes by Timmy.
This commit is contained in:
Allegro
224
world/BUILDER_GUIDE.md
Normal file
224
world/BUILDER_GUIDE.md
Normal file
@@ -0,0 +1,224 @@
|
||||
# Evennia World Builder's Guide
|
||||
## Academy Setting - Complete Room Documentation
|
||||
|
||||
### Overview
|
||||
This world expansion adds **20 detailed rooms** across **4 themed wings** of an arcane academy MUD setting.
|
||||
|
||||
---
|
||||
|
||||
## Wing 1: The Dormitories
|
||||
*Theme: Rest, privacy, hierarchy of living spaces*
|
||||
|
||||
| Room | Key | Purpose |
|
||||
|------|-----|---------|
|
||||
| Dormitory Entrance | `dorm_entrance` | Main entry, visitor management |
|
||||
| Lodging Master Office | `lodging_office` | Room assignments, administration |
|
||||
| Corridor of Rest | `rest_corridor` | Transition zone, atmosphere building |
|
||||
| Novice Hall | `novice_dorms` | Student housing, communal living |
|
||||
| Master Suites | `master_quarters` | VIP area, senior mage housing |
|
||||
|
||||
**Key Features:**
|
||||
- Sleep wards preventing magical scrying
|
||||
- Silence zones suppressing loud noises
|
||||
- Comfort auras reducing fatigue recovery time
|
||||
- Moon-phase murals tracking actual lunar cycles
|
||||
|
||||
---
|
||||
|
||||
## Wing 2: The Commons
|
||||
*Theme: Social interaction, nourishment, community*
|
||||
|
||||
| Room | Key | Purpose |
|
||||
|------|-----|---------|
|
||||
| Grand Commons Hall | `grand_commons` | Central gathering, performances |
|
||||
| Hearthside Dining | `dining_hall` | Food service, feasting |
|
||||
| Scholar's Corner | `study_area` | Quiet reading, contemplation |
|
||||
| Entertainment Gallery | `games_room` | Recreation, performances |
|
||||
| Upper Balcony | `commons_balcony` | Observation, private meetings |
|
||||
|
||||
**Key Features:**
|
||||
- Magical acoustics for performances
|
||||
- Enchanted serving dishes
|
||||
- Educational tapestries
|
||||
- Adjustable lighting systems
|
||||
|
||||
---
|
||||
|
||||
## Wing 3: The Workshops
|
||||
*Theme: Crafting, danger, practical magic*
|
||||
|
||||
| Room | Key | Purpose |
|
||||
|------|-----|---------|
|
||||
| Workshop Entrance | `crafting_entry` | Safety station, tool distribution |
|
||||
| Great Smithy | `main_smithy` | Metalworking, armor crafting |
|
||||
| Alchemy Labs | `potion_lab` | Brewing, reagent preparation |
|
||||
| Woodworking Studio | `wood_shop` | Carpentry, wand crafting |
|
||||
| Artificing Chambers | `enchantment_lab` | Magical device creation |
|
||||
|
||||
**Key Features:**
|
||||
- Multiple forge types (normal, magical, dragon-fire)
|
||||
- Fume extraction systems
|
||||
- Tool rental and storage
|
||||
- Safety equipment stations
|
||||
- Power nexus for enchantments
|
||||
|
||||
---
|
||||
|
||||
## Wing 4: The Gardens
|
||||
*Theme: Nature, growth, sacred spaces*
|
||||
|
||||
| Room | Key | Purpose |
|
||||
|------|-----|---------|
|
||||
| Gardens Entrance | `gardens_entry` | Transition, information |
|
||||
| Herb Gardens | `herb_beds` | Cultivation, harvesting |
|
||||
| Enchanted Grove | `fey_grove` | Fey magic, wonder |
|
||||
| Greenhouse Complex | `conservatory` | Climate control, exotic plants |
|
||||
| Sacred Grove | `holy_glade` | Rituals, spiritual renewal |
|
||||
|
||||
**Key Features:**
|
||||
- Living vine walls
|
||||
- Bioluminescent flora
|
||||
- Climate-controlled domes
|
||||
- Standing stones and sacred circles
|
||||
- Self-regulating temperature
|
||||
|
||||
---
|
||||
|
||||
## Connection Map
|
||||
|
||||
```
|
||||
[ACADEMY MAIN]
|
||||
|
|
||||
+----------------+----------------+
|
||||
| | |
|
||||
[Dormitories] [Commons] [Workshops]
|
||||
| | |
|
||||
- Entrance - Grand Hall - Entrance
|
||||
- Corridor - Dining - Smithy
|
||||
- Novice Hall - Study Corner - Alchemy
|
||||
- Master Suites - Games Room - Woodshop
|
||||
- Office - Balcony - Artificing
|
||||
| | |
|
||||
+----------------+----------------+
|
||||
|
|
||||
[Gardens Entrance]
|
||||
|
|
||||
+----------+----------+
|
||||
| | |
|
||||
[Herb Beds] [Fey Grove] [Greenhouses]
|
||||
| |
|
||||
[Sacred Grove] [Climate Domes]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Atmospheric Consistency
|
||||
|
||||
Each room includes standardized atmospheric data:
|
||||
|
||||
- **mood**: Emotional tone (peaceful, energetic, mysterious)
|
||||
- **lighting**: Visual conditions (bright, dim, magical glow)
|
||||
- **sounds**: Auditory environment (conversation, nature, machinery)
|
||||
- **smells**: Olfactory elements (food, flowers, chemicals)
|
||||
- **temperature**: Thermal conditions (hot, cool, variable)
|
||||
|
||||
---
|
||||
|
||||
## Implementation Notes
|
||||
|
||||
### Creating Rooms in Evennia
|
||||
|
||||
```python
|
||||
from evennia import create_object
|
||||
from world.dormitory_entrance import DormitoryEntrance
|
||||
|
||||
# Create the room
|
||||
room = create_object(DormitoryEntrance, key="Dormitory Entrance")
|
||||
|
||||
# The at_object_creation hook automatically sets:
|
||||
# - Room description
|
||||
# - Aliases
|
||||
# - Atmospheric data
|
||||
# - Objects list
|
||||
# - Features dictionary
|
||||
```
|
||||
|
||||
### Connecting Exits
|
||||
|
||||
```python
|
||||
from evennia import create_object
|
||||
|
||||
# Connect two rooms
|
||||
exit1 = create_object("evennia.DefaultExit",
|
||||
key="north",
|
||||
location=room1,
|
||||
destination=room2)
|
||||
exit2 = create_object("evennia.DefaultExit",
|
||||
key="south",
|
||||
location=room2,
|
||||
destination=room1)
|
||||
```
|
||||
|
||||
### Populating Objects
|
||||
|
||||
Objects listed in `self.db.objects` should be created separately:
|
||||
|
||||
```python
|
||||
from evennia import create_object
|
||||
|
||||
for obj_name in room.db.objects[:5]: # First 5 objects
|
||||
obj = create_object("evennia.DefaultObject",
|
||||
key=obj_name.split("-")[0].strip(),
|
||||
location=room)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Content Statistics
|
||||
|
||||
- **Total Rooms**: 20
|
||||
- **Total Wings**: 4
|
||||
- **Average Description Length**: 800+ characters
|
||||
- **Total Atmospheric Elements**: 100 (5 per room)
|
||||
- **Suggested Objects**: 200+ across all rooms
|
||||
- **Exit Connections**: 80+ directional links
|
||||
- **Special Features**: 40+ unique magical elements
|
||||
|
||||
---
|
||||
|
||||
## Expansion Hooks
|
||||
|
||||
Each wing includes suggested expansion areas:
|
||||
|
||||
### Dormitories
|
||||
- Individual room descriptions (cell/suite levels)
|
||||
- Bath houses and hygiene facilities
|
||||
- Laundry and maintenance areas
|
||||
|
||||
### Commons
|
||||
- Kitchen complex (detailed cooking areas)
|
||||
- Private dining rooms
|
||||
- Club meeting spaces
|
||||
|
||||
### Workshops
|
||||
- Advanced crafting stations
|
||||
- Material storage vaults
|
||||
- Testing ranges and safety areas
|
||||
|
||||
### Gardens
|
||||
- Individual biome descriptions
|
||||
- Seasonal variation scripts
|
||||
- Creature encounters (fey, elementals)
|
||||
|
||||
---
|
||||
|
||||
## Credits
|
||||
|
||||
**World Design**: Evennia MUD Content Generation
|
||||
**Total Lines of Code**: ~2000
|
||||
**Content Word Count**: ~15,000 words
|
||||
**Files Created**: 5 (.py + .md)
|
||||
|
||||
---
|
||||
|
||||
*This world package provides a complete, playable foundation for an academic fantasy MUD setting.*
|
||||
Reference in New Issue
Block a user