Metrics Fix

Fixed particle rendering crash on MC 1.21+ The ChestEffectsTask was calling world.spawnParticle() with offset/extra parameters that MC 1.21+ no longer accepts for certain particle types without explicit ParticleData. This caused the beacon beam effect to throw IllegalArgumentException: missing required data class java.lang.Float every tick.

What changed: Simplified END_ROD particle spawning to use single-parameter method

Removed problematic offset/extra float parameters that require ParticleData in 1.21+ Beacon beam effect now renders correctly without console spam Technical details:

// Before (broken in 1.21+): world.spawnParticle(Particle.END_ROD, x, y, z, 1, 0.1, 0.0, 0.1, 0.0f);

// After (works everywhere): world.spawnParticle(Particle.END_ROD, x, y, z, 1);

Affected versions: MC 1.21 - 1.21.4 Recommended for all Paper/Purpur 1.21+ users experiencing console warnings

SpawnChestPlugin v4.4.2

IN THIS VERSION FOLIA SUPPORT WAS REMOVED

What's New

bStats Integration

• Added anonymous usage statistics to help improve the plugin
• Plugin ID: 31206
• View stats at: https://bstats.org/plugin/bukkit/SpawnChestPlugin/31206
• Fully compliant with privacy - no personal data collected

Customizable Guardian Types

Configuration Example

Add to your config.yml:

features:
  guardians:
    enabled: true
    
    # Guardian counts per tier
    common-count: 2
    rare-count: 3
    legendary-count: 5
    
    # NEW: Guardian mob types
    # Valid types: ZOMBIE, SKELETON, WITHER_SKELETON, SPIDER, CAVE_SPIDER,
    # CREEPER, ENDERMAN, PIGLIN, ZOMBIFIED_PIGLIN, BLAZE, STRAY, HUSK, 
    # DROWNED, VEX, VINDICATOR, PILLAGER, RAVAGER, SHULKER, PHANTOM, etc.
    
    common-type: ZOMBIE           # Default guardians for Common chests
    rare-type: SKELETON           # Default guardians for Rare chests
    legendary-type: WITHER_SKELETON  # Default guardians for Legendary chests

# Example 1: Spider-themed server
features:
  guardians:
    common-type: SPIDER
    rare-type: CAVE_SPIDER
    legendary-type: CAVE_SPIDER  # with more spawns

# Example 2: Nether-themed
features:
  guardians:
    common-type: ZOMBIFIED_PIGLIN
    rare-type: BLAZE
    legendary-type: WITHER_SKELETON

# Example 3: End-themed  
features:
  guardians:
    common-type: ENDERMITE
    rare-type: ENDERMAN
    legendary-type: SHULKER

# Example 4: Raid-themed
features:
  guardians:
    common-type: PILLAGER
    rare-type: VINDICATOR
    legendary-type: RAVAGER

• Fixed compatibility issue with mob types across MC versions
• Improved version-safe entity type detection

Fixed a bug where the pre-open timer lock persisted even when pre-open-timer.enabled: false was set in config.

SpawnChestPlugin 4.4

What's new

Multi-chest spawning

Spawn multiple chests per interval simultaneously. Each chest finds its own random location with a configurable delay between spawns to keep the server load even.

settings:
  chest-count-per-interval: 3   # spawn 3 chests at once
  chest-spawn-delay-seconds: 5  # 5 seconds between each

Four summoner apples

The old generic Summoner Apple is now four distinct items — each forces a specific chest tier or picks one at random. All four can be given via command, configured to drop inside chests independently, and obtained through /getlegendaryitems.

World apple drop

When enabled, a Summoner Apple spawns as a physical item in the world each time a chest appears. Players see the coordinates in chat and race to pick it up. The item never despawns until collected.

world-apple-drop:
  enabled: false
  spawn-method: near-chest   # near-chest | near-player | with-chest
  radius: 15

Pre-open timer

Chests start locked. The first player to right-click starts a countdown visible to everyone nearby. Only after the countdown ends can anyone open the chest — giving distant players a chance to run. The chest-disappear timer begins only after the chest unlocks.

pre-open-timer:
  enabled: true
  duration-seconds: 30
  notify-radius: 20.0   # countdown messages visible within this range

Chest protection zone

Blocks around an active chest are protected from breaking and placing. Removed automatically when the chest disappears or is opened. Uses real WorldGuard regions when WorldGuard is installed; falls back to built-in event blocking otherwise.

chest-protection-zone:
  enabled: true
  radius: 5   # 11×11 area

Protection plugin integration

Chests no longer spawn inside claimed territories. Detected automatically — no extra setup needed beyond having the plugin installed.

Supported: WorldGuard · GriefPrevention · GriefDefender · Lands

Permission-based broadcasts

All announcements now respect individual permission nodes. On servers where all permissions are denied by default, grant the spawnchest.notify.* nodes to the default group.

Chest lifetime overhaul

• Unopened chest — disappears after chest-disappear-minutes from spawn time
• Opened chest — disappears after another full chest-disappear-minutes from the moment it was opened

The two timers are independent. Opening a chest gives players the full window to loot it.

BossBar improvements

• Pre-open countdown shown in BossBar with configurable color
• After chest is opened: bar switches to a dimmed "opened · disappears in Xs" state
• show-countdown and show-active-chest flags now correctly hide the bar when both are off
• BossBar re-initialises on /reloadchestconfig without a server restart

Minecraft 26.1 / 26.1.1 support

Mojang introduced a new versioning scheme in 2026 (year.drop instead of 1.X). The version adapter now handles both formats transparently. No plugin changes needed on the server side — drop in the new jar and go.

Bug fixes

• Batch spawning — second and third chests in a batch were blocked by the spawnInProgress flag from the previous chest. Replaced fixed delays with a queue that waits for each spawn to finish before starting the next.
• Particle errors — END_ROD and BLOCK_CRACK particles require explicit Float data in 1.21.10+. Fixed with correct types and a try-catch fallback for unsupported versions.
• Paper 26.1 detection — the old PaperConfig class was removed in the Paper hard-fork. Added ServerBuildInfo and server-name fallback checks.
• BossBar visible when disabled — the bar stayed visible after setting show-countdown: false. Bar now hides explicitly when there is nothing to show.

Config changes

New sections added — existing configs are fully backward-compatible. Add the new sections manually or delete config.yml to regenerate it.

# New in 4.4
settings:
  chest-count-per-interval: 1
  chest-spawn-delay-seconds: 5
  spawn-zone:
    exclude-surfaces:
      water: true
      lava: true
      leaves: true
      ice: true
      magma: true
      cactus: true
      sand: false
      gravel: false
      netherrack: false

pre-open-timer:
  enabled: true
  duration-seconds: 30
  announce-at-seconds: [30, 20, 10, 5, 3, 2, 1]
  show-in-bossbar: true
  bossbar-color: PINK
  notify-radius: 20.0

chest-protection-zone:
  enabled: true
  radius: 5
  use-worldguard: true
  worldguard-region-prefix: "spawnchest"
  notify-players: true

protection:
  enabled: true
  check-worldguard: true
  check-grief-prevention: true
  check-grief-defender: true
  check-lands: true
  max-protection-retries: 20

world-apple-drop:
  enabled: false
  apple-type: random
  spawn-method: near-chest
  radius: 15
  announce-coordinates: true
  persist-until-pickup: true

summoner-apple:
  random:
    enabled: true
    drop-in-legendary: true
    drop-chance: 0.05
  common:
    enabled: true
    drop-in-legendary: false
  rare:
    enabled: true
    drop-in-legendary: false
  legendary:
    enabled: true
    drop-in-legendary: false

Compatibility

v4.3 — Protection plugin integration (WorldGuard, GriefPrevention, GriefDefender, Lands), optional BossBar timer, and per-permission broadcast control so all players see announcements regardless of server permission setup.

Supports Spigot / Paper / Purpur · Minecraft 1.18 – 1.21.x

v4.3 — Protection plugin integration (WorldGuard, GriefPrevention, GriefDefender, Lands), optional BossBar timer, and per-permission broadcast control so all players see announcements regardless of server permission setup.

Supports Spigot / Paper / Purpur · Minecraft 1.18 – 1.21.x

SpawnChestPlugin v4.2.0 - Release Notes

Custom Loot System Overhaul

Version 4.2 introduces a complete redesign of the custom loot editor with advanced configuration options and improved safety features.

Major Changes

Dynamic Chest Sizing

• Toggle between single chest (27 slots) and double chest (54 slots)
• Items automatically transfer when expanding chest size
• Excess items safely drop at player's location when downsizing
• Configuration settings persist through size changes

Configurable Drop Rates

New fraction system allows precise control over item spawning:

• 10 options: All items, 1/2, 1/3, 1/4, 1/5, 1/6, 1/7, 1/8, 1/9, 1/10
• Items are shuffled randomly on each spawn
• Allows fine-tuning of loot balance per tier
• Current setting displayed in edit menu

Protected Reset System

Two-step confirmation prevents accidental data loss:

• First confirmation menu shows current item count and warns about deletion
• Second confirmation menu requires final approval
• Settings (chest type, drop rate) are preserved during reset
• Only item list is cleared
• Cancel option available at both stages

Configuration Preservation

Reset now intelligently preserves your settings:

• Chest type setting retained
• Drop rate fraction retained
• Only removes items from loot table
• Enables faster reconfiguration

Technical Improvements

GUI Stability

• Fixed bug where control buttons could be moved despite protection
• Fixed button click responsiveness issues
• Improved inventory state management during menu transitions
• Better session tracking across multiple menu changes
• Fixed timing issue that caused buttons to stop working

Validation and Safety

• Fixed inventory size validation errors (63 slot error)
• Added proper checks for chest area boundaries
• Improved item transfer logic
• Added atomic save operations for custom loot data
• Enhanced drag and drop protection

Localization

• Added 30+ new translation keys for all features
• Updated all 10 supported languages
• Context-aware messages throughout new system
• Consistent terminology across menus

Bug Fixes

• Fixed control buttons becoming movable in certain scenarios
• Fixed edit menu buttons not responding after opening from main menu
• Fixed inventory close event clearing state prematurely
• Fixed drag protection not blocking all control area slots
• Fixed shift-click allowing items into control buttons
• Fixed number keys bypassing protection
• Resolved session state conflicts during rapid menu switching

Upgrade Instructions

1. Backup your current SpawnChestPlugin folder
2. Replace the old JAR file with version 4.2
3. Restart your server
4. Existing custom loot configurations will be automatically migrated
5. No manual configuration changes required

Your custom loot tables will remain intact and functional.

Configuration Example

After upgrading, you can now configure loot like this:

Balanced Rare Chest:

• 30 items configured in double chest (45 usable slots)
• Drop rate set to 1/3
• Result: Each chest spawns with 10 random items from the pool

High-tier Legendary Chest:

• All 9 legendary items plus 20 support items
• Drop rate set to All
• Result: Every configured item spawns in every chest

Command Changes

No new commands added. The /putintothechest command now opens the improved editor interface.

API Notes

No breaking changes for developers. All existing API methods remain functional. New methods added to CustomLootManager class for accessing chest size and fraction settings.

Performance

• All GUI operations are thread-safe
• No performance impact from new features
• Inventory management optimized for servers with high player counts
• Atomic file operations prevent corruption during saves

Documentation

Full documentation updated on GitHub Wiki covering:

• Step-by-step custom loot editor guide
• Chest type and fraction system explanation
• Reset system walkthrough
• Best practices for loot configuration
• Troubleshooting common issues

Feedback

Report bugs or suggest features:

• Issues: GitHub Issues
• Discord: Join our Discord

Version 4.2.0 - February 2026