Raids

[1.0.0] - 2026-01-26

Major Overhaul - Totem-Based Raid System

This release completely redesigns the raid system from the ground up, replacing the bed-based automatic system with a player-controlled totem system.

Added

Raid Totem Block

• New craftable block: Raid Totem that players can place anywhere in the world
• Directional placement: Totems can face North, East, South, or West
• Interactive controls: Interact (F) to toggle totem on/off
• Visual feedback: Totem changes appearance when active/inactive
• Persistent state: Totem on/off state and schedule saved across server restarts

Zone-Based Enemy System

• 4 unique zones with different enemy types:
  • Emerald Grove: Skeletons, Trorks, or Goblins (3 groups with weighted selection)
  • Howling Sands: Scaraks
  • Whisperfrost Frontiers: Outlanders
  • Devastated Lands: Skeleton Soldiers
• Weighted group selection: Each zone randomly selects from multiple enemy groups
• Varied mob types: Each group contains different mob types with individual spawn chances
• Configurable spawning: Min/max counts and spawn weights per mob type

Zone-Based Reward System

• Zone-specific chests:
  • Emerald Grove: Village Chest
  • Howling Sands: Wind Temple Chest
  • Whisperfrost Frontiers: Dark Temple Chest
  • Devastated Lands: Goblin Chest
• Unique loot tables per zone with themed rewards
• Tiered drop chances: Guaranteed, common (20%), and rare (5%) items
• Player scaling: Reward quantities scale with nearby player count
• Zone-appropriate materials: Each zone drops materials matching its theme

New Commands

• /clearraid - Manually despawn all active raid entities (Creative mode only)

Quality of Life Features

• Custom sound event: Raid Horn sound effect (replaces generic thunder)
• Smart chest placement: Automatically clears grass and bushes before placing reward chest
• Lightning effects: Visual particles spawn on individual mobs and reward chest
• 1-hour timeout: Raids automatically clean up after 1 hour to prevent entity buildup
• Server shutdown cleanup: Raid entities despawn gracefully on server stop
• Robust persistence: Enhanced error handling and logging for totem state saves

Changed

Core Mechanics

• Removed bed-based system: Raids no longer trigger automatically at player beds
• Removed automatic scheduling per player: No more individual player raid timers based on join date
• New activation method: Players must place and activate Raid Totems to trigger raids
• Totem-based scheduling: Each totem tracks its own 3-day cycle independently
• Manual control: Players can turn totems on/off to control when raids occur

Raid Behavior

• Spawn location: Raids now spawn near active totems instead of beds
• Zone detection: Raid difficulty and rewards based on totem location, not player location
• Flexible placement: Totems can be placed anywhere, not restricted to bed locations
• Multiple totems: Players can have multiple totems with independent schedules

Reward Distribution

• Zone-specific loot: Rewards now vary significantly by zone
• Expanded item pools: More diverse loot including zone-specific essences and rare metals
• Better scaling: Improved reward quantity scaling with player count
• Themed chests: Visual variety with different chest types per zone

Technical Improvements

• Thread-safe entity operations: All entity removal operations run on world thread
• Enhanced logging: Detailed logging for totem placement, breaks, and state saves
• Optimized grass detection: Simplified plant/bush detection using contains() checks
• Config system: Separate configuration classes for mobs (RaidMobConfig) and rewards (RaidRewardConfig)
• Modular design: Zone-based groups allow easy addition of new zones and content

Fixed

• Totem persistence: Improved reliability of raid_totems.json updates when totems are broken
• Entity cleanup: Proper despawning on server shutdown and timeout
• Sound file loading: Custom sounds now correctly load from Common/Sounds folder
• Interaction hints: Fixed key binding display to show actual bound key

Removed

• Bed-based raid triggers: No longer uses player bed locations
• Per-player join timers: Removed individual player raid schedules based on join date
• Automatic catch-up system: No longer reschedules missed raids on login
• Bed proximity checks: Removed 50-block bed validation

Migration Notes

For players upgrading from beta versions:

1. Old raid schedules will not carry over - The bed-based system has been completely removed
2. Craft Raid Totems - Use the new totem blocks to trigger raids
3. Place totems strategically - Consider zone placement for desired enemy types and rewards
4. Activate totems - Interact with totems to turn them on and start the 3-day cycle
5. Old config files - raid_state.json is no longer used; totems use raid_totems.json

Version 1.0.0 marks the full release with a complete redesign of the raid system!