timmy-academy/world/BUILDER_GUIDE.md

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

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

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:

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.