FAQ & Troubleshooting
Version: 2.0.1
General
Section titled “General”How does the gravestone system work?
Section titled “How does the gravestone system work?”When a player dies, the items the game would drop go into a gravestone at the death position instead of onto the ground. The owner presses F on the gravestone and takes everything back with Loot all. For protectionTimerSeconds (5 minutes) only the owner can loot it; after that anyone can. See UI Pages.
What goes into the gravestone?
Section titled “What goes into the gravestone?”The world’s death settings decide, the same way they decide what drops without the plugin:
| The world’s death setting | Gravestone |
|---|---|
| Drop everything | Every item of the inventory |
| Drop a share | That share of every stack whose item drops on death (at least one item per such stack). Items that do not drop on death, such as most armor and weapons, stay with the player |
| Keep the inventory | No gravestone |
- With
captureMode: "ALL_ITEMS"(default"DROPPED_ONLY") a world that drops a share puts the whole inventory into the gravestone instead, armor and weapons included. See Configuration. - The world’s durability loss on death is applied first.
- Items that KyuubiSoft Item Control marks as soulbound or drop-protected stay with the player. With KyuubiSoft Pets 1.11.1 or newer, pet eggs, Battle Runes and Mount Horns stay with the player too. When Item Control (or another mod) has already chosen the items that drop, exactly those go into the gravestone.
- With item loss switched on, a share of these items is destroyed.
- The death screen lists the items that went into the gravestone.
I died but no gravestone appeared
Section titled “I died but no gravestone appeared”- You were in creative mode: creative deaths never create a gravestone.
- The world is in
excludedWorlds: the items dropped the normal way. - The world keeps the inventory on death, or nothing you carried drops on death: there was nothing to store.
- The plugin is disabled because the database failed, see below.
Where is the gravestone placed?
Section titled “Where is the gravestone placed?”At the death position, moved down to the ground (leaves, flowers, grass and similar plants are skipped). If that spot is taken, the nearest free spot within 10 blocks is used. The chat and a notification show the coordinates, and /ksgraveyard menu, /ksgraveyard locate and the world map show it later.
What happens if I die again before I recovered my items?
Section titled “What happens if I die again before I recovered my items?”Every death creates a new gravestone. A player can have maxGravestonesPerPlayer gravestones (5). When a player at the limit dies, their oldest gravestone is removed with its contents and they get “Your oldest gravestone was deleted (limit reached).”
Can other players loot my gravestone?
Section titled “Can other players loot my gravestone?”Not while it is protected: they only see a memorial view with the countdown. After protectionTimerSeconds anyone can loot it with Loot or take items out by hand. When another player empties it, you get “Another player looted your gravestone!” if you are online. With protectionTimerSeconds at 0 or below, gravestones are never protected.
”This gravestone is already open”
Section titled “”This gravestone is already open””Only one player at a time can have a gravestone’s contents open, the owner included. Wait until the other player closes the window. The gravestone is free again at the latest 5 minutes after it was opened; a window still open then is closed and its changes are saved.
Do gravestones disappear?
Section titled “Do gravestones disappear?”Not by default (gravestoneLifetimeSeconds: -1). With a positive value they disappear after that many seconds together with their contents. The owner is warned during the last lifetimeWarningBeforeSeconds (60) seconds. Protection and lifetime count real time from the death, also while the server is offline.
My inventory is full. Do I lose items?
Section titled “My inventory is full. Do I lose items?”No. Loot all fills your inventory and drops the rest at your feet (“Some items were dropped on the ground (inventory full).”). You can also take single stacks out by hand and come back for the rest; the gravestone keeps what is left.
Are enchantments and other item data kept?
Section titled “Are enchantments and other item data kept?”Yes, for gravestones created by 2.0.0. Enchantments, pet IDs on eggs and other item data go into the gravestone and come back with the item.
Can players break gravestones?
Section titled “Can players break gravestones?”No. Breaking a gravestone does nothing.
Economy and purchases
Section titled “Economy and purchases”How do premium designs and particles work?
Section titled “How do premium designs and particles work?”Every design and particle preset is free, for sale or admin-only:
premium: false: free for everyone.premium: truewith aprice: players buy it in the menu with the server economy. It stays unlocked and becomes active at once.premium: truewithprice: 0: “Locked”, onlydesign_give/particle_giveunlock it.
Which economy is used?
Section titled “Which economy is used?”VaultUnlocked with an economy plugin that registers with it (for example Ecotale). With KyuubiSoft Core installed, the graveyard uses Core’s economy bridge; otherwise it connects to VaultUnlocked directly. The log shows which one was found the first time a player opens the menu.
Players cannot buy anything
Section titled “Players cannot buy anything”- The Buy button is greyed out when the player’s balance is lower than the price.
- Without an economy, or with
purchaseWithEconomy: false, prices are charged in a graveyard-only currency that the plugin never hands out. Install an economy and setpurchaseWithEconomy: true, or unlock items withdesign_giveandparticle_give. - The economy is looked up once and the result is kept until the next restart. If the economy plugin was installed or fixed later, restart the server.
Can players teleport to their gravestones?
Section titled “Can players teleport to their gravestones?”Set allowTeleportToGravestone: true. The Teleport button in the Gravestones tab teleports the player on top of the selected gravestone, in the same world only. teleportCost sets a price (0 = free). Everything is checked before the price is charged. Without an economy keep teleportCost at 0, or the teleport cannot be paid.
Designs and particles
Section titled “Designs and particles”How do I add my own gravestone designs?
Section titled “How do I add my own gravestone designs?”Put a JSON file into custom-items/ and restart twice. See Custom Designs.
Why does a new design need two restarts?
Section titled “Why does a new design need two restarts?”The first start builds mods/KyuubiSoftGraveyard_Designs.jar from the JSON files; the server only loads that jar at the next start. Let players select the design only after the second restart.
I changed a design’s price in graveyard.json, but it came back
Section titled “I changed a design’s price in graveyard.json, but it came back”Designs from custom-items/ are updated from their JSON file on every start. Change the price in the JSON file.
Particles do not show
Section titled “Particles do not show”enableParticlesmust betrue, and the change needs a restart.- The gravestone’s owner must have chosen particles other than “No Particles”.
- Particles are shown to players within 64 blocks of the gravestone.
systemIdmust be a valid Hytale particle system.
I deleted a particle preset and it came back
Section titled “I deleted a particle preset and it came back”The presets none, golden_glow, ghost_smoke and arcane_pulse are added again on every start. To take one out of sale, set "premium": true and "price": 0.
Can I get the old stone grave window back?
Section titled “Can I get the old stone grave window back?”Set classicLootLook: true. It uses the images in images/, which you can replace, see Configuration.
An admin command says “Player not found”
Section titled “An admin command says “Player not found””Commands with a player name only find players who are online (in any world). Check the spelling; upper and lower case do not matter. admin_remove and admin_tp work with gravestone IDs and do not need the player.
admin_tp says the world is not loaded
Section titled “admin_tp says the world is not loaded”/ksgraveyard admin_tp <id> teleports you into the gravestone’s world. If that world is not loaded right now, it answers “The world … of this gravestone is not loaded.” and you stay where you are. admin_list shows the world of each gravestone.
How do I give a player their items back?
Section titled “How do I give a player their items back?”The items stay in the gravestone until it is looted, expires or is removed. Tell the player where it is (/ksgraveyard admin_list <player>), or teleport there with admin_tp and check it. admin_remove and admin_clear delete the contents, they do not return them.
Which settings need a restart?
Section titled “Which settings need a restart?”enableParticles, database, the images in images/ and new custom designs. Everything else, itemLoss included, applies with /ksgraveyard reload. Changed protection and lifetime values only apply to new gravestones. See Configuration.
Troubleshooting
Section titled “Troubleshooting”The log says the graveyard is disabled
Section titled “The log says the graveyard is disabled”[Graveyard] Failed to initialize database: ... followed by [Graveyard] DISABLED — no gravestones will be created or loaded ... means the database could not be opened at the start. The server keeps running without gravestones.
- SQLite: check that
mods/kyuubisoft_graveyard/is writable anddatabase.sqlitePathis a valid file name. - MySQL: check
database.mysql(host, port, database, username, password); the database must exist.
Fix the setting and restart the server.
My config changes have no effect
Section titled “My config changes have no effect”If graveyard.json contains an error (for example a missing comma), the log shows Failed to load config: ... and the plugin uses built-in values. Your file is not overwritten: the log shows Config not saved: ... could not be read and is kept as it is. whenever the plugin would have saved it. Fix the file and run /ksgraveyard reload. Check the log after each change.
A gravestone cannot be opened
Section titled “A gravestone cannot be opened”Gravestones only open with the built-in gravestone block or the block of a custom design. Since 2.0.0 a design whose block cannot open the grave window places the built-in gravestone block instead (the log says so). Gravestones that older versions placed with such a block stay unopenable; find them with admin_list and remove them with admin_remove. Their items are lost with them.
Players see the wrong language
Section titled “Players see the wrong language”Players see the language they chose with /kslang if the server lets players choose, otherwise the server’s default player language (set in KyuubiSoft Core’s /ksadmin hub, Language tab), otherwise their client language. /kslang alone shows the current language and the available codes in chat, /kslang de-DE sets a language, /kslang auto goes back to the client language. Texts a language does not have come from defaultLanguage. Single texts can be changed with override files, see Configuration.
The grave window shows no head
Section titled “The grave window shows no head”The owner’s head is loaded from hyvatar.io. Without access to that site (or for a name it does not know) the head stays empty; everything else works.
Items from a removed mod
Section titled “Items from a removed mod”Items whose ID no longer exists are not shown in the menu and the grave window; the contents line counts them as “unknown”. Keep the mod installed until such gravestones are looted, or remove them with admin_remove.