Chest Spawn

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. | Command | Result | |---|---| | /giveapple random <player> | Spawns a random-tier chest | | /giveapple common <player> | Always spawns a Common chest | | /giveapple rare <player> | Always spawns a Rare chest | | /giveapple legendary <player> | Always spawns a Legendary chest |

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. | Permission | Controls | |---|---| | spawnchest.notify.spawn | Spawn announcement + title | | spawnchest.notify.coordinates | Coordinates in announcement | | spawnchest.notify.disappear | Disappear announcement | | spawnchest.notify.countdown | Countdown warnings | | spawnchest.notify.bossbar | BossBar visibility |

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

| | | |---|---| | Minecraft | 1.18 – 1.21.x · 26.1 · 26.1.1 | | Server software | Spigot · Paper · Purpur · Pufferfish | | Protection plugins | WorldGuard · GriefPrevention · GriefDefender · Lands | | Java | 17+ |

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](https://github.com/Fragmer2/ChestSpawn/issues) - Discord: [Join our Discord](https://discord.gg/cgwAMXDcyh) --- Version 4.2.0 - February 2026

SpawnChestPlugin v4.1.5

Now fully localized in 10 languages.

Major Update: Complete Localization

Version 4.1.5 represents a complete overhaul of the plugin's messaging system. Every message, GUI element, item description, and system notification has been moved to external language files. This means you can now use the plugin in your native language or easily customize any text to match your server's style. Previously, messages were scattered throughout the code in English. Now, all over 300 text strings are organized in clean YAML files, supporting 10 languages: English, Russian, Ukrainian, Spanish, German, French, Chinese, Portuguese, Polish, and Italian.

Supported Languages

- English (en) - Russian (ru) - Ukrainian (ua) - Spanish (es) - German (de) - French (fr) - Chinese (zh) - Portuguese (pt) - Polish (pl) - Italian (it)

How to Use

Set your preferred language in config.yml:

language: "en"

Then reload the plugin:

/reloadchestconfig

The change applies immediately without requiring a server restart.

For Server Owners

You can now create custom translations or modify existing ones by editing files in the lang folder. Each language file follows the same structure, making it easy to copy and customize. Simply duplicate an existing language file, translate the values, and set your custom language code in the config. This update maintains full backward compatibility. Existing configurations will continue working, defaulting to English if no language is specified.

Technical Details

The localization system includes: - Over 300 translatable message keys - Support for placeholder variables (player names, numbers, coordinates) - Message caching for optimal performance - Hot-reload capability without server restart - Fallback to English for missing translations All message formatting, colors, and styling are preserved in the language files, allowing complete customization of the player experience.

GitHub Update!

Project was updated on the GitHub open source - https://github.com/Fragmer2/ChestSpawn

SpawnChestPlugin v4.1.0

New Features

- Multi-version support: 1.18.x - 1.21.x - Multi-platform support: Spigot, Paper, Purpur, Pufferfish, Folia - Custom loot editor GUI (/putintothechest) - 10 languages: EN, RU, UA, ES, DE, FR, ZH, PT, PL, IT

Improvements

- Automatic server version and platform detection - Asynchronous chunk loading on Paper-based servers - 30-second timeout recovery for stuck spawns - Optimized particle and enchantment handling for all versions

Technical

- Renamed particle constants support (1.20.5+) - Renamed enchantment constants support (1.20.5+) - Renamed potion effect constants support (1.20.5+) - Java 17 and 21 compatible

SpawnChestPlugin v4.0 - Changelog

New Features

- Added Summoner Apple (donator item for instant chest spawns) - Added Poseidon's Trident legendary weapon - Added persistent statistics system - Added achievements with XP rewards - Added custom potion effects - Added proximity-based sound system - Added visual chest effects (particles, beacon beam) - Added minimum distance from world center (0,0) - Added spawn timeout recovery system

Improvements

- Improved async spawning logic for better performance - Enhanced configuration options - Optimized chunk loading system - Better guardian spawning mechanics - Improved loot distribution

Technical Changes

- Updated to support Java 21 - Requires Paper 1.21+ (no Spigot/Bukkit support) - Async chunk loading requires Paper API - Memory optimizations - Fixed config reload issues - Improved error handling

Stable Legendary Items – The Phoenix Feather now gives you fire resistance while held and can revive you once if you would die. No More Double Spawns – Chests appear exactly on schedule, without duplicates. Balanced Cooldowns – Special weapons like the Titan Axe or Storm Hammer show clear cooldowns, so abilities feel fair. Smooth Performance – Effects, particles, and guardian mobs spawn without lag or errors.

Stable Legendary Items – The Phoenix Feather now gives you fire resistance while held and can revive you once if you would die. No More Double Spawns – Chests appear exactly on schedule, without duplicates. Balanced Cooldowns – Special weapons like the Titan Axe or Storm Hammer show clear cooldowns, so abilities feel fair. Smooth Performance – Effects, particles, and guardian mobs spawn without lag or errors.

Optimized permissions checking: All commands now correctly check permissions via LuckPerms and other permissions managers. Descriptions of permissions and commands have been brought to a single style for ease of administration.

v1.00.01.02

v1.00.01.01 added English

v1.00.00.99