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`: ```yaml 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 ``` ```yaml # 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml # 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: ```yaml 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