Files
novafarma/docs/IMPLEMENTATION_GUIDE.md

12 KiB

KRVAVA ŽETEV - Implementation Guide

System Integration & UI Creation Plan

Datum: 23.12.2025
Cilj: Integrate all 46 systems into GameScene.js and create all required UIs


📊 CURRENT STATUS

Systems Created: 46
Lines of Code: 22,596
Phases Complete: 30/30 (100%)
Game Status: Systems ready, needs integration


🎯 PHASE 1: QUICK WINS (1-2 hours)

1.1 Add Missing System Imports to index.html

Status: To Do
Time: 15 minutes

Missing Systems to Add:

  • MiningSystem.js
  • CharacterCustomizationSystem.js
  • TimeSystem.js (check if different from WeatherSystem)
  • TownRestorationSystem.js
  • PortalRepairSystem.js
  • SmartZombieSystem.js
  • ToolSystem.js
  • AnaClueSystem.js
  • PyramidSystem.js
  • SlimesDogsSystem.js
  • AnimalsSeedsSystem.js
  • AutomationSystem.js
  • InventorySystemExpanded.js

Action:

<!-- Add before GameScene.js (line 212) -->
<script src="src/systems/MiningSystem.js"></script>
<script src="src/systems/CharacterCustomizationSystem.js"></script>
<script src="src/systems/TimeSystem.js"></script>
<script src="src/systems/TownRestorationSystem.js"></script>
<script src="src/systems/PortalRepairSystem.js"></script>
<script src="src/systems/SmartZombieSystem.js"></script>
<script src="src/systems/ToolSystem.js"></script>
<script src="src/systems/AnaClueSystem.js"></script>
<script src="src/systems/PyramidSystem.js"></script>
<script src="src/systems/SlimesDogsSystem.js"></script>
<script src="src/systems/AnimalsSeedsSystem.js"></script>
<script src="src/systems/AutomationSystem.js"></script>
<script src="src/systems/InventorySystemExpanded.js"></script>

1.2 Test System Loading

Status: To Do
Time: 10 minutes

Action:

  1. Hard reload browser (Ctrl+Shift+R)
  2. Check console for errors
  3. Verify all systems load without conflicts

1.3 Fix Any Export/Import Issues

Status: To Do
Time: 30 minutes

Known Issues:

  • Some systems might use ES6 export (like DialogueSystem did)
  • Check all new systems for export keywords
  • Remove if found

1.4 Basic Smoke Tests

Status: To Do
Time: 15 minutes

Tests:

  • Game launches
  • No console errors
  • Player spawns
  • Basic movement works

🔧 PHASE 2: SYSTEM INTEGRATION (4-6 hours)

2.1 Initialize All Systems in GameScene.create()

Status: To Do
Time: 2 hours

Current GameScene Systems: ~40
New Systems to Add: 13

Integration Pattern:

// In GameScene.create(), add after line 800:

// ========================================================
// 🆕 NEW SYSTEMS (P16-P30) - 23.12.2025
// ========================================================
console.log('🆕 Initializing New Systems (P16-P30)...');

// P16: Mining System
console.log('⛏️ Initializing Mining System...');
this.miningSystem = new MiningSystem(this);

// P17: Character Customization
console.log('👤 Initializing Character Customization...');
this.characterCustomization = new CharacterCustomizationSystem(this);

// P18: Time System (if different from WeatherSystem)
console.log('🕐 Initializing Time System...');
this.timeSystem = new TimeSystem(this);

// P19: Town Restoration
console.log('🏘️ Initializing Town Restoration...');
this.townRestoration = new TownRestorationSystem(this);

// P20: Portal Repair
console.log('🌀 Initializing Portal Repair...');
this.portalRepair = new PortalRepairSystem(this);

// P22: Smart Zombies
console.log('🧠 Initializing Smart Zombies...');
this.smartZombies = new SmartZombieSystem(this);

// P23: Tool System
console.log('🔧 Initializing Tool System...');
this.toolSystem = new ToolSystem(this);

// P25: Ana's Clues
console.log('💜 Initializing Ana Clues...');
this.anaClues = new AnaClueSystem(this);

// P26: Pyramids
console.log('🏜️ Initializing Pyramid System...');
this.pyramids = new PyramidSystem(this);

// P27: Slimes & Dogs
console.log('🟢🐶 Initializing Slimes & Dogs...');
this.slimesDogs = new SlimesDogsSystem(this);

// P28: Animals & Seeds
console.log('🐄🌱 Initializing Animals & Seeds...');
this.animalsSeeds = new AnimalsSeedsSystem(this);

// P29: Automation
console.log('⚙️ Initializing Automation...');
this.automation = new AutomationSystem(this);

// P30: Inventory Expanded
console.log('🎒 Initializing Inventory Expansion...');
this.inventoryExpanded = new InventorySystemExpanded(this, this.inventorySystem);

2.2 Connect System Communications

Status: To Do
Time: 1-2 hours

Key Integrations:

A. SmartZombieSystem ↔ ZombieSystem

// Connect smart zombie features to base zombie system
this.smartZombies.onZombieUpgraded = (zombieId, level) => {
    this.zombieSystem.upgradeIntelligence(zombieId, level);
};

B. ToolSystem ↔ InventorySystem

// Tools affect inventory durability
this.toolSystem.onToolBreak = (toolId) => {
    this.inventorySystem.removeItem(toolId, 1);
};

C. AutomationSystem ↔ Multiple Systems

// Automation connects to farming, zombies, inventory
this.automation.farmingSystem = this.farmingSystem;
this.automation.zombieSystem = this.smartZombies;
this.automation.inventorySystem = this.inventoryExpanded;

D. AnaClueSystem ↔ TwinBondSystem

// Clues trigger Twin Bond events
this.anaClues.onClueFound = (clueId) => {
    this.twinBondSystem.triggerMemory(clueId);
};

E. PyramidSystem ↔ QuestSystem

// Pyramid exploration triggers quests
this.pyramids.onPyramidEntered = (pyramidId) => {
    this.questSystemExpanded.checkPyramidQuests(pyramidId);
};

2.3 Update GameScene.update()

Status: To Do
Time: 1 hour

Add Daily Updates:

// In GameScene.update(time, delta):

// Update automation daily
if (this.automation) {
    this.automation.runDailyAutomation();
}

// Update animals & breeding
if (this.animalsSeeds) {
    this.animalsSeeds.updateLivestock();
    this.animalsSeeds.updateTrees(this.currentSeason);
}

// Update smart zombies
if (this.smartZombies) {
    this.smartZombies.updateZombies(delta);
}

// Update town restoration
if (this.townRestoration) {
    this.townRestoration.updateConstruction(delta);
}

// Update portal repair
if (this.portalRepair) {
    this.portalRepair.updateConstruction(delta);
}

2.4 Testing & Debugging

Status: To Do
Time: 1 hour

Test Each System:

  • MiningSystem - Enter a mine
  • Character Customization - Create character
  • TimeSystem - Day/night cycle
  • TownRestoration - Restore a building
  • PortalRepair - Repair a portal
  • SmartZombies - Level up zombie
  • ToolSystem - Use and break tool
  • AnaClues - Find a clue
  • Pyramids - Enter pyramid
  • SlimesDogs - Spawn slime, adopt dog
  • AnimalsSeeds - Buy livestock, plant seeds
  • Automation - Build sprinkler
  • InventoryExpanded - Upgrade inventory

🎨 PHASE 3: UI CREATION (4-6 hours)

3.1 Character Creation Screen

Status: To Do
Time: 1 hour
File: src/scenes/CharacterCreationScene.js

Features:

  • Gender selection (Kai/Ana story reversal)
  • RGB hair color picker (10 presets + custom + rainbow/glowing)
  • Body customization (4 skin tones, 4 body types)
  • Starting outfit selection
  • Preview window
  • Confirm button

Priority: HIGH (game start)

3.2 Mining UI

Status: To Do
Time: 30 minutes
File: src/ui/MiningUI.js

Features:

  • Mine selection panel
  • Current depth indicator
  • Oxygen/radiation warning
  • Ore inventory
  • Elevator button
  • Boss warning

Priority: MEDIUM

3.3 Smart Zombie Command UI

Status: To Do
Time: 45 minutes
File: src/ui/SmartZombieUI.js

Features:

  • Zombie list (with intelligence levels)
  • Command buttons (Stop, Help, Attack, Home)
  • Follower management (max 10)
  • Team construction interface
  • XP display

Priority: HIGH (core gameplay)

3.4 Tool Management UI

Status: To Do
Time: 30 minutes
File: src/ui/ToolUI.js

Features:

  • Tool durability bars
  • Repair options (Ivan, Repair Kit, Blacksmith Zombie)
  • Upgrade menu (6 tiers)
  • Ultimate tools display

Priority: MEDIUM

Status: To Do
Time: 45 minutes
File: src/ui/BlueprintGalleryUI.js

Features:

  • Collection progress (X/35)
  • Category tabs (Buildings, Weapons, Bows, Vehicles, Special)
  • Discovery method indicators
  • Quest-locked visual indicators
  • Preview on hover

Priority: MEDIUM

3.6 Ana's Clue Collection UI

Status: To Do
Time: 1 hour
File: src/ui/AnaClueUI.js

Features:

  • Progress tracker (15 Messages, 12 Photos, 23 Items)
  • Gallery view with thumbnails
  • Story milestone indicators (6 milestones)
  • Clue description on click
  • Kai's reaction display

Priority: HIGH (story)

3.7 Town Restoration UI

Status: To Do
Time: 45 minutes
File: src/ui/TownRestorationUI.js

Features:

  • Town list (27 towns)
  • Building progress bars
  • NPC count (X/180)
  • Global milestone tracker
  • Zombie assignment

Priority: MEDIUM

3.8 Portal Repair UI

Status: To Do
Time: 30 minutes
File: src/ui/PortalRepairUI.js

Features:

  • Portal list (18 portals, 5 difficulty tiers)
  • Material requirements
  • Construction progress
  • Defend event warnings
  • Teleport button (when complete)

Priority: MEDIUM

3.9 Animal Shop UI

Status: To Do
Time: 45 minutes
File: src/ui/AnimalShopUI.js

Features:

  • Animal Rescue quest progress (0/8)
  • Livestock shop (16+ types)
  • Breeding interface (30-day countdown)
  • Rarity indicators (Common/Rare/Legendary/Mythic)

Priority: MEDIUM

3.10 Seed Shop UI

Status: To Do
Time: 30 minutes
File: src/ui/SeedShopUI.js

Features:

  • Season tabs (Spring, Summer, Fall, Winter)
  • 100+ seed varieties
  • Growth time display
  • Sell price preview
  • Greenhouse indicator

Priority: MEDIUM

3.11 Automation Control Panel

Status: To Do
Time: 45 minutes
File: src/ui/AutomationUI.js

Features:

  • Sprinkler management
  • Water tower status
  • Minting building controls
  • Auto-harvest worker assignment
  • Full automation status (requirements checklist)

Priority: LOW (endgame feature)

3.12 Inventory Expansion UI

Status: To Do
Time: 30 minutes
File: src/ui/InventoryUpgradeUI.js

Features:

  • Tier upgrade buttons (Jakob's shop)
  • Tool Belt unlock
  • Dog Backpack unlock
  • Quick Sort options
  • Stack All button
  • Quick Deposit button

Priority: HIGH (core gameplay)


TESTING CHECKLIST

System Integration Tests:

  • All 46 systems initialize without errors
  • No memory leaks
  • Systems communicate correctly
  • Save/load works with all systems
  • Performance is acceptable (60 FPS)

UI Tests:

  • All UIs open/close correctly
  • Buttons are functional
  • Data displays correctly
  • Responsive to window resize
  • No visual bugs

Gameplay Tests:

  • Start new game → Character Creation
  • Mine exploration
  • Zombie commands
  • Tool usage and repair
  • Blueprint discovery
  • Clue finding
  • Town restoration
  • Portal repair
  • Animal breeding
  • Seed planting
  • Automation setup
  • Inventory management

📝 ESTIMATED TIMELINE

PHASE 1 (Quick Wins): 1-2 hours
PHASE 2 (Integration): 4-6 hours
PHASE 3 (UI Creation): 4-6 hours

TOTAL: 9-14 hours

If Starting Now (22:00):

  • Quick Wins: 22:00-23:30
  • Integration: 23:30-05:30
  • UI Creation: 05:30-11:30

Completion: Tomorrow morning (11:30)


🎯 SUCCESS CRITERIA

All 46 systems integrated into GameScene
All systems communicate correctly
All 12 UIs created and functional
Game is playable from start to finish
No critical bugs
Performance is stable


💡 TIPS

  1. Work in Batches: Don't try to do everything at once
  2. Test Frequently: Test after each system integration
  3. Use Console Logs: Debug with extensive logging
  4. Save Often: Commit every major milestone
  5. Take Breaks: This is a marathon, not a sprint!

Created: 23.12.2025, 21:57
By: Antigravity AI
Status: Ready to Execute