Skip to content

FAQ.md

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

Frequently Asked Questions

General

Q: What Minecraft versions are supported?

Minecraft 1.18 – 1.21.x and 26.1 / 26.1.1 (Java Edition only).

Server software:

  • Spigot, Paper, Purpur, Pufferfish — fully supported
  • Folia — fully supported
  • Forge, Fabric, Bedrock — not supported

Q: Is this plugin free?

Yes. Free and open source under MIT.

Q: Where can I get support?

Installation

Q: Plugin doesn't load?

  1. Correct Minecraft version? (1.18+)
  2. Using Spigot or Paper, not Vanilla?
  3. JAR in the plugins/ folder?
  4. Server restarted after installing?
  5. Check console for errors.
UnsupportedClassVersionError  →  Update Java to 17+
NoClassDefFoundError          →  Re-download the JAR

Q: How do I update?

  1. Stop server
  2. Back up plugins/SpawnChestPlugin/
  3. Replace the old JAR with the new one
  4. Start server

Config files are always preserved.

Chest Spawning

Q: Chests don't spawn?

/chestconfig get settings.enabled-worlds   # check world list
/nextchest                                  # check remaining time
/chestnow                                   # force spawn for testing
/testchestzone                              # preview coordinates

Q: How do I spawn multiple chests per interval?

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

Q: Chests spawn in wrong locations?

settings:
  spawn-zone:
    min-distance: 400
    max-distance: 2000
    min-height: 50
    max-height: 200

Run /testchestzone to preview sample coordinates.

Q: Chests spawn on water, lava, or ice?

Configure surface exclusions:

settings:
  spawn-zone:
    exclude-surfaces:
      water: true
      lava:  true
      ice:   true

Q: Do chests despawn?

Unopened chest — disappears after chest-disappear-minutes from spawn time.
Opened chest — gets a fresh chest-disappear-minutes from the moment it was opened.

Set chest-disappear-minutes: 0 to keep chests forever.

Q: What is the pre-open timer?

When pre-open-timer.enabled: true, chests start locked. The first player to right-click starts a countdown (default 30 seconds). Anyone can open the chest after the countdown ends. This gives distant players time to run.

Legendary Items

Q: Legendary items don't work?

/chestconfig get legendary-items.enabled
/chestconfig get legendary-items.dragon-slayer-sword.enabled
/cooldowns
/chestconfig get abilities.pvp-protection

If pvp-protection: true, items do not work on other players.

Q: How do I get legendary items?

  • Find them in Legendary chests (15% spawn chance)
  • Admin command: /getlegendaryitems
  • Add to custom loot via /putintothechest

Q: Can I disable specific items?

/togglelegendary dragon-slayer-sword

Or in config:

legendary-items:
  dragon-slayer-sword:
    enabled: false

Q: Do legendary items work in PvP?

Controlled by:

abilities:
  pvp-protection: true   # items do NOT work on players
  pvp-protection: false  # items work in PvP

Q: Phoenix Feather doesn't resurrect me?

  • Must be in inventory when you die
  • One-time use — consumed on death
  • Does not protect against /kill
  • Check: /chestconfig get legendary-items.phoenix-feather.resurrection

Q: Master Pickaxe doesn't auto-smelt?

Works on: Iron Ore, Gold Ore, Copper Ore, Ancient Debris.
Does not smelt: Diamond, Emerald, Coal, Redstone, Lapis.

Check: /chestconfig get legendary-items.master-pickaxe.auto-smelt

Summoner Apples

Q: How many apple types are there?

Four: random, common, rare, legendary. Each forces a specific chest tier or picks one randomly.

/giveapple random    Steve 1
/giveapple common    Steve 1
/giveapple rare      Steve 1
/giveapple legendary Steve 1

Q: Does the apple reset the spawn timer?

No. Apples spawn an extra chest without affecting the main timer.

Q: What is World Apple Drop?

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

Custom Loot

Q: How do I create custom loot?

  1. Get items in your inventory
  2. Run /putintothechest
  3. Click a tier
  4. Drag items into the chest area
  5. Set fraction (how many items spawn per chest)
  6. Click Save

Q: Custom loot doesn't appear in chests?

  1. Did you click Save?
  2. Is custom loot shown as enabled (green) in the main menu?
  3. Is the fraction too low? 1/10 of 5 items = 0–1 items.

Q: Can I configure each tier separately?

Yes. Common, Rare, and Legendary each have their own independent loot table.

Q: Does reset delete my settings?

No. Reset only deletes items (dropped at your location). Chest type and fraction are preserved.

Q: Can I copy loot tables between servers?

Yes. Copy plugins/SpawnChestPlugin/custom_loot.yml to the other server.

Protection Plugins

Q: Do chests spawn inside player claims?

With 4.4+ they don't. The plugin detects WorldGuard, GriefPrevention, GriefDefender, and Lands automatically and skips protected locations.

protection:
  enabled: true
  check-worldguard:       true
  check-grief-prevention: true
  check-grief-defender:   true
  check-lands:            true

Q: What is the Chest Protection Zone?

A temporary zone around each active chest that blocks breaking and placing blocks. Removed automatically when the chest disappears or is opened. Uses WorldGuard regions when available, falls back to built-in event blocking otherwise.

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

BossBar

Q: How do I enable the BossBar?

features:
  bossbar:
    enabled: true

Then grant players the spawnchest.notify.bossbar permission.

Q: BossBar shows even when both modes are disabled?

Update to 4.4 — this was a known bug. The bar now hides explicitly when both show-countdown and show-active-chest are false.

Broadcasts & Permissions

Q: Players don't see chest announcements?

The plugin uses spawnchest.notify.* permissions. On servers where all permissions are denied by default, grant these to the default group:

/lp group default permission set spawnchest.notify.spawn true
/lp group default permission set spawnchest.notify.coordinates true
/lp group default permission set spawnchest.notify.countdown true
/lp group default permission set spawnchest.notify.disappear true
/lp group default permission set spawnchest.notify.bossbar true

Q: Can I hide coordinates from some players?

Players without spawnchest.notify.coordinates still see the spawn announcement — coordinates are just omitted: "A Legendary Chest has appeared somewhere in the world."

Statistics

Q: Stats don't track?

/chestconfig get statistics.enabled
/togglefeature statistics

Q: How do I view stats?

/mystats      # your own stats
/leaderboard  # top 10 players

Q: Achievement didn't unlock?

Check progress in /mystats. Make sure statistics.achievements.enabled: true.

Performance

Q: Plugin causes lag?

features:
  effects:
    particles:        false
    chest-beacon-beam: false

features:
  guardians:
    common-count:    1
    rare-count:      2
    legendary-count: 3

Increase spawn interval: /setchesttimer 1800

Compatibility

Q: Works with WorldGuard / GriefPrevention / Lands?

Yes — these are detected automatically for both chest protection zone creation and spawn location filtering.

Q: Works with economy plugins?

Yes. No conflicts. You can use legendary items as high-value trade goods or configure Summoner Apples as donator rewards.

Q: Works with McMMO?

Yes. Legendary items still gain McMMO XP normally.

Miscellaneous

Q: Can I change language?

language: "ru"  # or any supported code

Run /reloadchestconfig after changing.

Q: Can I customize messages?

Edit plugins/SpawnChestPlugin/lang/en.yml (or your language file). Run /reloadchestconfig after saving.

Q: Minecraft 26.1 / 26.1.1 support?

Yes. Version 4.4 handles Mojang's new versioning scheme automatically. No changes needed on the server side.

Q: How do I report a bug?

  1. Search existing issues first
  2. Include: Minecraft version, plugin version, server software, console error, steps to reproduce
  3. Submit at GitHub Issues

Q: Is source code available?

Yes — GitHub. Open source under MIT.

Clone this wiki locally