Phase 29: Gameplay Systems (5/5) - Structure interaction, NPCs, Enemies, Quests, Map
This commit is contained in:
276
docs/STRUCTURE_VISUAL_GUIDE.md
Normal file
276
docs/STRUCTURE_VISUAL_GUIDE.md
Normal file
@@ -0,0 +1,276 @@
|
||||
# 🏛️ STRUCTURE VISUAL GUIDE
|
||||
|
||||
Quick reference for structure types and their visual appearance in the game.
|
||||
|
||||
---
|
||||
|
||||
## 🎨 **COLOR CODING:**
|
||||
|
||||
### **Landmarks** (Gold)
|
||||
```
|
||||
Color: #FFD700 (Gold)
|
||||
Symbol: ★ (Star)
|
||||
Size: 15x15 tiles
|
||||
```
|
||||
|
||||
### **Grassland Structures** (Brown tones)
|
||||
- Farm: #8B4513 (Saddle Brown)
|
||||
- House: #A0522D (Sienna)
|
||||
- Barn: #654321 (Dark Brown)
|
||||
- Windmill: #D2691E (Chocolate)
|
||||
- Well: #708090 (Slate Gray)
|
||||
|
||||
### **Forest Structures** (Brown/Purple)
|
||||
- Cabin: #8B4513 (Saddle Brown)
|
||||
- Ruins: #696969 (Dim Gray)
|
||||
- Treehouse: #8B7355 (Burlywood)
|
||||
- Camp: #8B4513 (Saddle Brown)
|
||||
- Shrine: #9370DB (Medium Purple)
|
||||
|
||||
### **Desert Structures** (Sand/Gold)
|
||||
- Pyramid: #DAA520 (Goldenrod)
|
||||
- Oasis Camp: #8B7355 (Burlywood)
|
||||
- Tomb: #CD853F (Peru)
|
||||
- Pillar: #D2B48C (Tan)
|
||||
|
||||
### **Mountain Structures** (Gray tones)
|
||||
- Mine: #2F4F4F (Dark Slate Gray)
|
||||
- Cave: #363636 (Very Dark Gray)
|
||||
- Tower: #708090 (Slate Gray)
|
||||
- Altar: #9370DB (Medium Purple)
|
||||
|
||||
### **Swamp Structures** (Green/Brown)
|
||||
- Hut: #556B2F (Dark Olive Green)
|
||||
- Totem: #8B4513 (Saddle Brown)
|
||||
- Bog Shrine: #6B8E23 (Olive Drab)
|
||||
- Abandoned Dock: #654321 (Dark Brown)
|
||||
|
||||
---
|
||||
|
||||
## 📏 **SIZE REFERENCE:**
|
||||
|
||||
### **Small (2-3 tiles):**
|
||||
- Well (2x2)
|
||||
- Totem (2x2)
|
||||
- Pillar (2x2)
|
||||
- Camp (3x3)
|
||||
- Hut (3x3)
|
||||
|
||||
### **Medium (4-5 tiles):**
|
||||
- House (4x4)
|
||||
- Cabin (4x4)
|
||||
- Shrine (4x4)
|
||||
- Treehouse (4x4)
|
||||
- Altar (4x4)
|
||||
- Tower (4x4)
|
||||
- Tomb (5x5)
|
||||
- Mine (5x5)
|
||||
- Cave (5x5)
|
||||
- Windmill (5x5)
|
||||
- Oasis Camp (5x5)
|
||||
- Bog Shrine (4x4)
|
||||
- Abandoned Dock (5x5)
|
||||
|
||||
### **Large (6-8 tiles):**
|
||||
- Barn (6x6)
|
||||
- Ruins (6x6)
|
||||
- Farm (7x7)
|
||||
- Pyramid (8x8)
|
||||
|
||||
### **Landmarks (15 tiles):**
|
||||
- All landmarks: 15x15
|
||||
|
||||
---
|
||||
|
||||
## 🛤️ **ROAD COLORS:**
|
||||
|
||||
Roads adapt to biome:
|
||||
- **Desert:** #cda869 (Sandy)
|
||||
- **Mountain:** #9090a0 (Stone Gray)
|
||||
- **Swamp:** #5a4a3d (Dark Brown Mud)
|
||||
- **Default:** #8B7355 (Brown Dirt)
|
||||
|
||||
**Width:** 3 tiles
|
||||
**Pattern:** Natural curves (not straight)
|
||||
|
||||
---
|
||||
|
||||
## 🗺️ **IN-GAME APPEARANCE:**
|
||||
|
||||
### **Grassland Area:**
|
||||
```
|
||||
[🏡 House] [🌾 Farm] [⛲ Well]
|
||||
[🌾 Farm]
|
||||
[🏚️ Barn] [🌬️ Windmill]
|
||||
```
|
||||
|
||||
### **Forest Area:**
|
||||
```
|
||||
[🏚️ Ruins] [🌲 Treehouse]
|
||||
[⛺ Camp]
|
||||
[🏡 Cabin] [⛩️ Shrine]
|
||||
```
|
||||
|
||||
### **Desert Area:**
|
||||
```
|
||||
[🔺 Pyramid]
|
||||
[🗿 Pillar] [⚰️ Tomb]
|
||||
[⛺ Oasis Camp]
|
||||
```
|
||||
|
||||
### **Mountain Area:**
|
||||
```
|
||||
[🗼 Tower] [⛰️ Cave]
|
||||
[⚒️ Mine]
|
||||
[⛩️ Altar]
|
||||
```
|
||||
|
||||
### **Swamp Area:**
|
||||
```
|
||||
[🗿 Totem] [🏚️ Hut]
|
||||
[⛩️ Bog Shrine]
|
||||
[🚢 Abandoned Dock]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🌟 **LANDMARKS:**
|
||||
|
||||
### **Ancient Temple** (Forest)
|
||||
```
|
||||
★
|
||||
┌─────────────────┐
|
||||
│ │
|
||||
│ ANCIENT TEMPLE │
|
||||
│ (GOLD 15x15) │
|
||||
│ │
|
||||
└─────────────────┘
|
||||
Location: Deep in forest biome
|
||||
Color: Gold (#FFD700)
|
||||
```
|
||||
|
||||
### **Great Pyramid** (Desert)
|
||||
```
|
||||
★
|
||||
┌───┐
|
||||
┌┴───┴┐
|
||||
┌┴─────┴┐
|
||||
┌┴───────┴┐
|
||||
┌┴─────────┴┐
|
||||
│GREAT PYRAMID│
|
||||
└─────────────┘
|
||||
Location: Desert biome
|
||||
Color: Gold (#FFD700)
|
||||
```
|
||||
|
||||
### **Mountain Peak** (Mountain)
|
||||
```
|
||||
★
|
||||
/│\
|
||||
/ │ \
|
||||
/ │ \
|
||||
/ PEAK \
|
||||
/________\
|
||||
Location: Highest mountain
|
||||
Color: Gold (#FFD700)
|
||||
```
|
||||
|
||||
### **Abandoned City** (Grassland)
|
||||
```
|
||||
┌──┐ ┌──┐ ┌──┐
|
||||
│ │ │★ │ │ │
|
||||
│ │┌┴──┴┐│ │
|
||||
└──┘│CITY││ │
|
||||
└────┘└──┘
|
||||
Location: Grassland biome
|
||||
Color: Gold (#FFD700)
|
||||
```
|
||||
|
||||
### **Dragon Skeleton** (Swamp)
|
||||
```
|
||||
★ /\
|
||||
┌─┐ /──\
|
||||
┌┴─┴┐──── >
|
||||
│DRAGON \
|
||||
└─────┘
|
||||
Location: Deep swamp
|
||||
Color: Gold (#FFD700)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎮 **GAMEPLAY TIPS:**
|
||||
|
||||
### **Finding Structures:**
|
||||
1. **Follow roads** - they connect major areas
|
||||
2. **Explore biomes** - each has unique structures
|
||||
3. **Look for landmarks** - gold stars visible from distance
|
||||
4. **Check minimap** - structures appear as colored dots
|
||||
|
||||
### **Structure Density:**
|
||||
- **Grassland:** High (farms, houses common)
|
||||
- **Forest:** Medium (cabins, camps scattered)
|
||||
- **Desert:** Low (oases rare, pyramids rarer)
|
||||
- **Mountain:** Low (mines, caves isolated)
|
||||
- **Swamp:** Low (huts, totems sparse)
|
||||
|
||||
### **Landmark Rarity:**
|
||||
- Only **1 per biome type**
|
||||
- **50-tile exclusion zone** (no structures nearby)
|
||||
- **Visible from distance** (gold star)
|
||||
- **Largest structures** in game (15x15)
|
||||
|
||||
---
|
||||
|
||||
## 📐 **TECHNICAL DETAILS:**
|
||||
|
||||
### **Placement Rules:**
|
||||
- Minimum 20-tile spacing between regular structures
|
||||
- Minimum 50-tile spacing from landmarks
|
||||
- Cannot place on water (rivers/lakes)
|
||||
- Cannot place on roads
|
||||
- Biome-specific types only
|
||||
|
||||
### **Rendering:**
|
||||
- Structures render in chunks (only visible chunks)
|
||||
- Depth = 4-5 (above ground, below trees)
|
||||
- Landmarks depth = 5-6 (very visible)
|
||||
- Roads depth = 1.5 (below decorations)
|
||||
|
||||
### **Performance:**
|
||||
- 80 structures = negligible impact
|
||||
- Chunk-based loading (only active chunks)
|
||||
- Simple rectangles (fast rendering)
|
||||
- Future: Can replace with sprites
|
||||
|
||||
---
|
||||
|
||||
## 🔮 **FUTURE PLANS:**
|
||||
|
||||
### **Visual Improvements:**
|
||||
- [ ] Replace rectangles with detailed sprites
|
||||
- [ ] Add structure variety (different designs)
|
||||
- [ ] Animated landmarks (particles, glow effects)
|
||||
- [ ] Weather effects on structures (snow, sand)
|
||||
|
||||
### **Gameplay Features:**
|
||||
- [ ] Interactive structures (enter buildings)
|
||||
- [ ] Structure ownership (claim/build)
|
||||
- [ ] NPC inhabitants
|
||||
- [ ] Loot chests inside
|
||||
- [ ] Quest objectives
|
||||
|
||||
### **Expansion:**
|
||||
- [ ] More structure types (20+ per biome)
|
||||
- [ ] Village clusters (grouped structures)
|
||||
- [ ] Dynamic structures (change over time)
|
||||
- [ ] Player-built structures
|
||||
- [ ] Structure upgrades
|
||||
|
||||
---
|
||||
|
||||
**Quick Reference:** Use this guide to identify structures while exploring the world!
|
||||
|
||||
**Color Coding:** Each biome has distinct colors for easy identification!
|
||||
|
||||
**Landmarks:** Look for gold stars (★) to find epic locations!
|
||||
Reference in New Issue
Block a user