Forevercraft Bedrock Edition

# Forevercraft Bedrock Edition v1.3.0 — Changelog

**Release Date:** April 4, 2026
**Minecraft Bedrock:** 1.21.80+
**Total Systems:** 162 files across 145+ interconnected systems

---

## New Systems

### Blueprint Building System
A complete city-builder-inspired structure placement system for the Building profession. Obtain tiered blueprint papers (T1-T7), preview placement with glowing corner markers, and watch structures build layer-by-layer with animation.
- **33 structures** across 7 tiers: wells, coops, barns, houses, taverns, manors, castles, cathedrals, and more
- Preview mode with green (valid) / red (blocked) corner markers
- Collision detection prevents overlapping builds
- Material costs from forging, cooking, and alchemy systems
- Layer-by-layer build animation with particles and sound
- Building XP integration with CraftForever progression
- Rank gates per tier (Rank 0 through Rank 60)

### Ecodex System
A tiered codex progression system combining multiple knowledge books into one.
- 4-tier codex evolution (Separate Books -> Eternal Codex -> XP Banking -> Phoenix Codex)
- XP Vault for depositing and withdrawing experience levels
- Claim Rewards hub across 6 milestone categories
- Affinity claims for 14 weapon classes

### Custom Items
Special consumable items with unique effects.
- 13 Boss DR consumables (permanent +1 Dream Rate per boss, one-time use)
- Salvation Stones with death protection charges
- 6 auto-grant milestones for major achievements
- Tree Shards, Crumbs of Dreams, Tomes of Lucid Visions

### Dyeing System
An 8-color Forevercraft palette for equipment customization.
- Azure, Crimson, Solar, Verdant, Ivory, Obsidian, Rose, and Noir
- Dye application and wash effects with particles and sound

### Visual Time
Sleep and dawn effects for immersion.
- Blindness fade-to-black when entering bed
- Weather clearing and dawn announcements on sleep skip
- Buddy sleep bonus integration

---

## Critical Bug Fixes (18)

- **Raid bosses now actually spawn** — namespace prefix was being stripped, causing silent spawn failure after 10 floors of combat
- **World boss rewards now distributed** — event listener was subscribed to a non-existent event; participants never registered
- **Boss fight cleanup works** — entity validity check was calling a method instead of reading a property
- **Dungeon multi-floor descent functional** — was referencing wrong variable name, entire feature was dead
- **Cooking minigame no longer crashes** — constructor was missing eventBridge parameter
- **Fishing crate drops now trigger** — was listening to wrong event (itemCompleteUse never fires for fishing rods)
- **Crate animations play properly** — player lookup was using wrong API method
- **Story mode branch switching works** — StorageManager was called with non-existent static methods
- **Inscription stones UI works** — was using require() instead of ES module import
- **Dreaming realm trials work** — same require() issue
- **Forage/Prospect XP tracking works** — event was emitting bare player instead of data object
- **Black market no longer double-charges** — emerald clear command was called twice per purchase
- **Duel disconnect awards correct winner** — winner and loser were inverted
- **Floor mob difficulty now scales** — was using find() instead of findLast() for DR scaling
- **Castle dungeon bosses spawn once** — added guard preventing 5x boss spawns on boss floors
- **Quest reroll exploit patched** — options now persist until paid reroll or daily reset
- **Spirit weapon player check works** — operator precedence bug made guard useless
- **World events now trigger** — isNightTime()/isDawnTime() were hardcoded to return false

## High Bug Fixes (25)

- Weapon mastery tick crash prevented (missing method)
- Spirit raids null guard on disconnected players
- Night terrors inscription stone ward check added
- Convergence DR modifier now granted and cleaned up properly
- Raids boss ability system added (AoE damage scaling with phase)
- Mount training undefined method crash fixed
- Stormcaller companion ability now fires
- Buddy mount charge feature now activates
- Daily class affinity caps now properly reset
- Tutorial iron pickaxe and codex detection now works
- Shiny companion odds modifiers now actually apply
- Party combo bit collision fixed (unique indices)
- Fox/ocelot taming data persists across reloads
- Reputation entity death handler crash-proofed
- Health bar absorption display now reads effects correctly
- Campfire block state name corrected
- Moon menu double-fire prevented
- Convergence timer warnings at correct intervals
- Dungeon HUD floor display initialized properly
- Raid boss HP now exceeds vanilla max via health boost
- Spirit raids boss prompt limited to raid leader (race condition fix)
- Trim abilities summon commands use integer coordinates
- Artifact collection event name standardized across systems
- Lore discovery event uses data object format
- Anecdotes UI uses static import

## Event Wiring Fixes (8)

- Dungeon completion now emits event — coins, class affinity XP, spirit tome, and news ticker all receive it
- Sleep event name standardized (sleep_complete)
- Quest completion event name standardized (quest_completed)
- Villager trade event name standardized (trade_completed)
- Companion summoned/fed events now emitted — companion HP system activates
- Spirit tool block break XP now awarded
- Story difficulty reads correct storage key
- fc_coins scoreboard initialized

---

## Performance Optimizations

### Tick Loop
- `world.getAllPlayers()` cached once per tick cycle (was called 30+ times redundantly)
- Event subscriptions consolidated — single dispatchers for itemUse and playerBreakBlock
- Empty season tick call removed
- Dead reaper system references cleaned up

### Entity Queries
- Tamed bond/protection: entity queries now filtered by tags (was scanning ALL entities within 64 blocks)
- Raid cleanup scoped to active dimension + 128-block radius (was scanning all 3 dimensions)
- World boss minion queries scoped to boss location
- Heist cleanup: redundant global query removed
- Potion growth serum: query filtered by tag

### Throttling & Caching
- Dream Rank recalculation: every 60s instead of every 5s (12x reduction)
- Trim detection: cached results, recheck every 5s instead of every 1s
- Health bar: update every 0.5s instead of every 0.1s, skip if unchanged
- Advantage trees: staggered checks (4 trees per cycle instead of all 16)
- Pantry: JSON cached in memory, flush on mutation
- Friends: JSON cached in memory per tick cycle
- Guild saves: debounced to every 5 seconds
- Campfire heal: scan radius reduced 71% (507 to 147 blocks)
- Dreaming realm: player references stored directly instead of name lookup

### Memory Management
- Player disconnect cleanup added for 8+ Map/Set caches (combat combo, dual swordsman, weapon classes, weapon mastery, spirit weapons, fox taming, party, etc.)
- Dream echoes array capped at 50 entries
- Shared distance utility extracted (eliminates 4 duplicate implementations)
- Party nearby members cached once per tick (was computed 3x)
- Companion evolution hostile query cached (3 queries merged to 1)

### Dead Code Removed
- Biome detection: removed dead loop running 25+ testfor commands that did nothing
- World boss: removed unused tickTimer() method and console.log debug statements
- Reputation: removed dead onKill() method
- Cooking: removed 3 unnecessary dynamic imports

---

## Technical Details
- **Pack format:** Bedrock Addon (.mcaddon)
- **API version:** @minecraft/server 1.17.0, @minecraft/server-ui 1.3.0
- **Total files:** 162 JavaScript files
- **New files:** blueprints.js (74KB), ecodex.js (34KB), custom-items.js (22KB), dyeing.js (7KB), visual-time.js (5KB), utils/math.js (1KB)
- **Manifest fixes:** RP dependency version corrected (1.1.0 -> 1.2.0), min_engine_version corrected (1.26.10 -> 1.21.80)