FAQ.md - Fragmer2/ChestSpawn GitHub Wiki

Frequently Asked Questions

General Questions

Q: What Minecraft versions are supported?

A: Minecraft 1.18 - 1.20.6 (Java Edition)

Server types:

  • ✅ Spigot
  • ✅ Paper (recommended)
  • ✅ Purpur
  • ❌ Forge (not supported)
  • ❌ Fabric (not supported)
  • ❌ Bedrock (not supported)

Q: Does this work on Bedrock Edition?

A: No, this is a Java Edition plugin. Bedrock uses different plugin systems.

Alternatives for Bedrock:

  • Use Geyser + Floodgate (allows Bedrock players on Java servers)
  • Look for Bedrock addons

Q: Is this plugin free?

A: Yes! Completely free and open source.

Q: Can I use this on my server?

A: Yes! Free for personal and commercial servers.

Q: Where can I get support?

A:

  • GitHub Issues
  • Discord server
  • SpigotMC forum thread

Installation & Setup

Q: Plugin doesn't load/work?

Check these:

  1. Correct Minecraft version?
  2. Using Spigot/Paper (not Vanilla)?
  3. JAR file in /plugins folder?
  4. Server restarted after installing?
  5. Check console for errors

Common errors:

UnsupportedClassVersionError
→ Update Java to version 17+

NoClassDefFoundError
→ Corrupted JAR file, re-download

Q: How do I update the plugin?

A:

  1. Stop server
  2. Backup /plugins/SpawnChestPlugin/ folder
  3. Replace old JAR with new JAR
  4. Start server
  5. Check console for migration messages

Your config files are preserved!

Q: Can I use this with other chest plugins?

A: Usually yes, but conflicts possible.

Compatible:

  • Shop plugins (ChestShop, etc.)
  • Protection plugins (WorldGuard, GriefPrevention)
  • Economy plugins

May conflict:

  • Other random chest spawn plugins
  • Custom loot table plugins

Chest Spawning

Q: Chests don't spawn?

Troubleshooting:

  1. Check enabled worlds:
/chestconfig get settings.enabled-worlds

If empty → spawns in ALL worlds
If has worlds → check if you're in enabled world

  1. Check timer:
/nextchest

May need to wait!

  1. Test spawn:
/chestnow

If this works → timer issue
If this doesn't work → check console

  1. Check spawn zone:
/testchestzone

Might be spawning outside loaded chunks

Q: Chests spawn too often/rarely?

A: Change spawn interval:

/setchesttimer 600  # 10 minutes
/setchesttimer 1800 # 30 minutes
/setchesttimer 3600 # 1 hour

Or edit config:

settings:
  spawn-interval-seconds: 600

Q: Can I spawn chest on command?

A: Yes!

/chestnow

Permission: spawnchest.admin

Q: Chests spawn in wrong locations?

A: Configure spawn zone:

settings:
  spawn-zone:
    min-distance: 400     # Min from spawn
    max-distance: 2000    # Max from spawn
    min-height: 50        # Min Y level
    max-height: 200       # Max Y level

Test settings:

/testchestzone

Q: Chests spawn in water/lava/air?

A: Plugin tries to find safe ground. If spawning in bad spots:

  1. Adjust height range (avoid caves)
  2. Enable burial mode:
spawn-zone:
  bury-in-ground: true

Q: How many chests can spawn at once?

A: One chest spawns per interval. Multiple chests only if:

  • Players use Summoner Apples
  • Admin uses /chestnow

Q: Do chests despawn?

A: Yes, unopened chests despawn after configured time:

settings:
  chest-disappear-minutes: 30  # 30 minutes

Set to 0 to disable despawning.

Opened chests become normal chests (stay forever until broken).

Legendary Items

Q: Legendary items don't work?

Check:

  1. Enabled globally:
/chestconfig get legendary-items.enabled
  1. Specific item enabled:
/chestconfig get legendary-items.dragon-slayer-sword.enabled
  1. On cooldown:
/cooldowns
  1. PvP protection:
/chestconfig get abilities.pvp-protection

If true, items don't work on players

Q: How do I get legendary items?

Methods:

  1. Find in Legendary chests (15% spawn chance)
  2. Admin command: /getlegendaryitems
  3. Custom loot: Add to loot table in /putintothechest

Q: Can I disable specific legendary items?

A: Yes!

/togglelegendary dragon-slayer-sword

Or config:

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

Q: Legendary items too powerful/weak?

A: Adjust in config:

legendary-items:
  dragon-slayer-sword:
    bonus-damage: 10.0  # Increase damage
    cooldown-ms: 1000   # Reduce cooldown

Reload:

/reloadchestconfig

Q: Do legendary items work in PvP?

A: Depends on config:

abilities:
  pvp-protection: true  # Items DON'T work on players
  pvp-protection: false # Items DO work on players

When enabled (true):

  • No bonus damage to players
  • No fire/lightning effects
  • AOE damage skips players

Q: Phoenix Feather doesn't resurrect me?

Possible reasons:

  1. Not in your inventory - must be in inventory when you die
  2. Already used - one-time use, consumed on death
  3. Feature disabled:
/chestconfig get legendary-items.phoenix-feather.resurrection
  1. Killed by /kill command - doesn't protect against admin commands

Q: Guardian Bow arrows don't home?

Check:

  1. Homing enabled:
/chestconfig get legendary-items.guardian-bow.homing-arrows
  1. Targets in range (5 blocks default)
  2. Not targeting players (if PvP protection on)

Q: Master Pickaxe doesn't auto-smelt?

Check:

  1. Auto-smelt enabled:
/chestconfig get legendary-items.master-pickaxe.auto-smelt
  1. Mining correct ores:
    • ✅ Iron Ore → Iron Ingot
    • ✅ Gold Ore → Gold Ingot
    • ❌ Diamond Ore (stays diamond)
    • ❌ Coal Ore (stays coal)

Custom Loot

Q: How do I create custom loot?

A:

  1. Get items you want in inventory
  2. Run /putintothechest
  3. Click tier (Common/Rare/Legendary)
  4. Place items in chest area
  5. Adjust fraction (how many items spawn)
  6. Click Save

Guide: Custom Loot System

Q: Custom loot doesn't work?

Check:

  1. Saved properly - green "Custom loot: ENABLED" in main menu
  2. Items in loot table - check items count
  3. Fraction not too low - 1/10 of 5 items = 0-1 items
  4. Correct tier spawning - maybe other tier spawned

Q: Can I have different loot for each tier?

A: YES! Each tier (Common, Rare, Legendary) has separate loot tables.

Q: Reset deletes settings too?

A: NO! Reset only deletes items.

Preserved:

  • Chest type (single/double)
  • Item fraction
  • All other settings

Q: Can I export/import loot tables?

A: Yes! Copy custom_loot.yml file between servers.

Location:

/plugins/SpawnChestPlugin/custom_loot.yml

Commands & Permissions

Q: Commands don't work?

Check:

  1. Correct spelling
  2. Have permission:
/lp user YourName permission check spawnchest.admin
  1. Console errors when running command

Q: How do I give players permission to spawn chests?

A:

LuckPerms:

/lp user PlayerName permission set spawnchest.admin true

PermissionsEx:

/pex user PlayerName add spawnchest.admin

GroupManager:

/manuadd PlayerName spawnchest.admin

Q: Players can't see chest timer?

A: /nextchest requires NO permission - works for everyone.

If not working:

  1. Check command aliases
  2. Check for command conflicts
  3. Try /spawnchestplugin:nextchest

Guardians

Q: Guardians don't spawn?

Check:

/chestconfig get features.guardians.enabled

If false:

/togglefeature guardians

Q: Too many/few guardians?

A: Configure per tier:

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

Q: What mobs spawn as guardians?

A: Depends on chest tier:

Common:

  • Zombie
  • Skeleton
  • Spider

Rare:

  • Zombie Pigman
  • Blaze
  • Witch

Legendary:

  • Wither Skeleton
  • Evoker
  • Ravager
  • Vindicator

Q: Guardians too weak/strong?

A: Configure mob equipment/enchantments in config (future feature).

Current workaround: Use mob modifier plugins.

Statistics & Achievements

Q: Stats don't track?

Check:

/chestconfig get statistics.enabled

If disabled:

/togglefeature statistics

Q: How do I see my stats?

A:

/mystats

No permission required!

Q: Achievement didn't unlock?

Possible reasons:

  1. Requirements not met - check progress in /mystats
  2. Statistics disabled
  3. Achievement disabled in config

Force check (admin):

/checkachievements PlayerName

Q: Can I reset my stats?

A: Currently no command. Manual method:

  1. Stop server
  2. Edit /plugins/SpawnChestPlugin/statistics.yml
  3. Remove your UUID entry
  4. Start server

Performance

Q: Plugin causes lag?

Troubleshooting:

  1. Check TPS:
/tps

If < 18 → server lag

  1. Reduce particle effects:
features:
  effects:
    particles: false
  1. Reduce guardian count:
guardians:
  legendary-count: 3  # Instead of 5
  1. Increase spawn interval:
/setchesttimer 1800  # 30 min instead of 10

Q: Too many particles?

A: Disable particles:

/togglefeature particles

Or reduce in config:

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

Compatibility

Q: Works with WorldGuard?

A: Yes! Plugin respects WorldGuard regions.

Chests won't spawn in protected regions if configured.

Q: Works with GriefPrevention?

A: Yes! Similar to WorldGuard.

Q: Works with economy plugins?

A: Yes! No conflicts. You can:

  • Give money for opening chests (custom hook)
  • Sell legendary items
  • Charge for Summoner Apples

Q: Works with McMMO?

A: Yes! No conflicts. Legendary items still gain McMMO XP.

Q: Works with claim plugins?

A: Usually yes. Chest spawns in wilderness, not in claims.

If spawning in claims, configure spawn zone to avoid claimed areas.

Multiplayer

Q: Only one player can open chest?

A: No! Chest is normal Minecraft chest - multiple players can access.

However:

  • First player to open gets achievement
  • Loot disappears when taken

Q: Can teams share chests?

A: Yes! Bring your friends:

  • Work together to kill guardians
  • Share the loot
  • Both get achievements/stats

Q: PvP at chests?

A: Depends on server rules!

Legendary item PvP:

abilities:
  pvp-protection: true  # Items don't work on players
  pvp-protection: false # Full PvP

Summoner Apple

Q: How do I get Summoner Apples?

Methods:

  1. Find in Legendary chests (5% chance)
  2. Admin command: /giveapple PlayerName 1
  3. Custom loot: Add to loot table

Q: Summoner Apple doesn't work?

Check:

/chestconfig get summoner-apple.enabled

If disabled:

/chestconfig set summoner-apple.enabled true

Q: Does apple reset spawn timer?

A: NO! Apple spawns EXTRA chest without affecting timer.

Example:

Timer: 5 minutes until next spawn
Player uses apple → chest spawns immediately
Timer: Still 5 minutes (unchanged)

Miscellaneous

Q: Can I change language?

A: Yes! 10 languages available:

language: "en"  # English
language: "ru"  # Russian
language: "ua"  # Ukrainian
language: "es"  # Spanish
language: "de"  # German
language: "fr"  # French
language: "zh"  # Chinese
language: "pt"  # Portuguese
language: "pl"  # Polish
language: "it"  # Italian

Reload:

/reloadchestconfig

Q: Can I customize messages?

A: Yes! Edit language files:

/plugins/SpawnChestPlugin/lang/en.yml

Change any message, reload config.

Q: How do I report bugs?

A:

  1. Check if bug is known - search existing issues
  2. Gather information:
    • Minecraft version
    • Plugin version
    • Server software (Paper/Spigot)
    • Console error (if any)
    • Steps to reproduce
  3. Submit: GitHub Issues

Q: Can I request features?

A: Yes! Submit feature requests on GitHub.

Popular requests:

  • MySQL database support
  • Multiple chest spawns
  • Custom mob guardians
  • Web dashboard
  • More achievements
  • XP-based ranks

Q: Is source code available?

A: Yes! Open source on GitHub.

You can:

  • View code
  • Fork & modify
  • Submit pull requests
  • Report issues

Q: Can I modify the plugin?

A: Yes! It's open source.

If you distribute modified version:

  • Credit original author
  • Follow license terms
  • Don't claim as fully your own

Q: Where's the API documentation?

A: See API Documentation page for developers.

Still Need Help?

Contact methods:

  1. GitHub Issues - Bug reports & features https://github.com/Fragmer2/ChestSpawn/issues
  2. Discord - Quick help & community https://discord.gg/cgwAMXDcyh

Before asking:

  1. Read this FAQ
  2. Check Troubleshooting page
  3. Search existing issues
  4. Include error messages & versions