Skip to content

Home

Jump to bottom
Fragmer2 edited this page Apr 8, 2026 · 3 revisions

SpawnChestPlugin - Complete Documentation

Version Minecraft Language

Welcome!

SpawnChestPlugin is an advanced Minecraft plugin that spawns treasure chests at random locations with customizable loot, guardians, and legendary items. Perfect for survival servers, events, and PvP gameplay!

Key Features

  • Random Chest Spawning — Chests spawn automatically at configurable intervals
  • Batch Spawning — Spawn multiple chests per interval simultaneously (new in 4.4)
  • Three Tier System — Common, Rare, and Legendary chests with different loot
  • Guardian Protection — Mobs spawn to guard the chests
  • 9 Legendary Items — Unique weapons and tools with special abilities
  • Custom Loot System — Create your own loot tables with GUI editor
  • 10 Languages — Full localization support
  • Statistics & Achievements — Track player progress
  • Four Summoner Apple Types — Force specific chest tiers on demand (new in 4.4)
  • World Apple Drop — Physical item spawns in the world with coordinates (new in 4.4)
  • Pre-Open Timer — First click starts a countdown before chest can be opened (new in 4.4)
  • Chest Protection Zone — Area around chest protected from building/breaking (new in 4.4)
  • Particle Effects — Visual effects for chest spawns
  • BossBar — Optional HUD timer with countdown and active chest info (improved in 4.4)
  • Protection Plugin Integration — WorldGuard, GriefPrevention, GriefDefender, Lands
  • Notification Permissions — Fine-grained control over who sees announcements
  • Minecraft 26.1 / 26.1.1 Support — Mojang's new versioning scheme handled automatically (new in 4.4)

What's new in 4.4

Batch spawning

Spawn multiple chests per interval. Each chest finds its own random location with a configurable delay between spawns to avoid server lag.

settings:
  chest-count-per-interval: 3
  chest-spawn-delay-seconds: 5

Pre-open timer

Chests start locked after spawning. The first player to right-click starts a countdown. Only after it ends can anyone open the chest — giving distant players a chance to run. The chest-disappear timer starts fresh after the chest is opened.

pre-open-timer:
  enabled: true
  duration-seconds: 30
  notify-radius: 20.0

Chest protection zone

Blocks around an active chest are protected from breaking and placing. Uses real WorldGuard regions when available, falls back to built-in event blocking otherwise. Zone is removed when the chest disappears or is opened.

chest-protection-zone:
  enabled: true
  radius: 5

Four summoner apple types

Four distinct items — random, common, rare, legendary. Each can be given via /giveapple, 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.

Surface exclusions in config

Control which surfaces chests are allowed to spawn on.

spawn-zone:
  exclude-surfaces:
    water: true
    lava: true
    ice: true
    sand: false

Chest lifetime logic overhaul

  • Unopened chest disappears after chest-disappear-minutes from spawn
  • Opened chest gets a fresh chest-disappear-minutes from the moment it was opened
  • The two timers are fully independent

Minecraft 26.1 / 26.1.1 support

Mojang introduced a new versioning scheme in 2026. The version adapter now handles both 1.X and YY.X formats transparently — no changes needed on the server side.

Documentation Sections

  1. Installation — How to install and setup
  2. Configuration — All config options explained
  3. Commands* — Complete command reference
  4. Permissions* — Permission nodes
  5. Legendary Items* — All legendary items and abilities
  6. Custom Loot* — How to create custom loot tables
  7. Statistics* — Player stats and achievements
  8. Language Files* — Multi-language support
  9. API* — For developers
  10. FAQ* — Frequently asked questions
  11. Troubleshooting* — Common issues and solutions

Quick Start

  1. Download the plugin JAR file
  2. Place it in your server's plugins folder
  3. Restart the server
  4. Edit plugins/SpawnChestPlugin/config.yml
  5. Use /reloadchestconfig to apply changes
  6. First chest will spawn in 30 seconds
  7. Configure custom loot with /putintothechest

Support

License

This plugin is released under MIT

Last Updated: April 2026 Plugin Version: 4.4 Minecraft Version: 1.18 – 1.21.x · 26.1 · 26.1.1

Clone this wiki locally