Configuration

The main config file is located at mods/kyuubisoft_graveyard/config/graveyard.json.

---

General Settings

Setting	Default	Description
captureMode	DROPPED_ONLY	DROPPED_ONLY = only items that normally drop on death. ALL_ITEMS = entire inventory
protectionTimerSeconds	300	How long the gravestone is owner-only (seconds). -1 = no protection
gravestoneLifetimeSeconds	-1	How long until the gravestone despawns. -1 = never
lifetimeWarningBeforeSeconds	60	Warn owner X seconds before gravestone expires
maxGravestonesPerPlayer	5	Maximum active gravestones per player. Oldest is deleted when exceeded
spawnAtSafePosition	true	Spawn gravestone at last safe position instead of death position
showWorldMapMarker	true	Show death marker on the world map
showPlayerName	true	Show player name above the gravestone
enableParticles	true	Enable/disable the entire particle system (tab, commands, effects)
defaultDesign	default	Default gravestone design for new players
defaultLanguage	en-US	Default language (en-US or de-DE)

---

Database

Default: SQLite (single file, no setup needed).

"database": {
    "type": "sqlite",
    "sqlitePath": "graveyard.db",
    "mysql": {
        "host": "localhost",
        "port": 3306,
        "database": "hytale",
        "username": "root",
        "password": ""
    }
}

Set "type": "mysql" to use MySQL or MariaDB instead.

---

Designs

Each design defines a gravestone appearance:

"designs": {
    "default": {
        "displayName": "Simple Tombstone",
        "blockId": "Furniture_KS_Gravestone",
        "premium": false
    },
    "royal": {
        "displayName": "Royal Gravestone",
        "blockId": "Furniture_KS_Gravestone_Royal",
        "premium": true,
        "price": 500,
        "currency": "coins"
    }
}

Field	Description
displayName	Name shown in the menu
blockId	The furniture item ID used for the gravestone block
premium	true = players must purchase it
price	Cost (only if premium)
currency	Currency type (for economy integration)

---

Particles

Each particle preset defines an effect:

"particles": {
    "none": {
        "displayName": "No Particles",
        "systemId": null,
        "premium": false
    },
    "golden_glow": {
        "displayName": "Golden Glow",
        "systemId": "Block_Top_Glow",
        "color": "#ffd700",
        "scale": 1.0,
        "premium": true,
        "price": 300,
        "currency": "coins"
    }
}

Field	Description
displayName	Name shown in the menu
systemId	Hytale particle system ID (see list below)
color	Hex color override (e.g. #ffd700)
scale	Particle scale (default 1.0)
premium	true = players must purchase it
price	Cost (only if premium)
currency	Currency type

Available Particle System IDs

System ID	Effect
Block_Top_Glow	Subtle block glow
Totem_Heal_AoE	Healing aura circle
Drop_Legendary	Legendary item glow
Drop_Epic	Epic item glow
Drop_Rare	Rare item glow
Drop_Uncommon	Uncommon item glow
Dust_Sparkles_Fine	Fine dust particles
Fire_Charged1	Fire effect
Block_Gem_Sparks	Crystal sparks

---

Item Loss

Optional system to destroy a percentage of items on death:

"itemLoss": {
    "enabled": false,
    "mode": "BLACKLIST",
    "defaultLossPercent": 10,
    "items": {
        "Sword_Iron": { "lossPercent": 25 },
        "Key_Dungeon": { "lossPercent": 0 }
    }
}

Mode	Description
BLACKLIST	All items can be lost (default rate), except items in the list
WHITELIST	No items lost, except items explicitly in the list
NONE	No item loss

---

Economy Integration (Optional)

Graveyard supports VaultUnlocked for premium purchases. No other plugins (including KyuubiSoft Core) are required.

How it works

Scenario	Behavior
VaultUnlocked installed	Players can buy premium designs and particles with in-game currency
VaultUnlocked not installed	Premium items can only be unlocked via admin commands (design_give, particle_give)

Detection priority

The plugin checks for economy providers in this order:

1. KyuubiSoft Core — if installed, uses Core's ExternalEconomyBridge (supports VaultUnlocked + EliteEssentials)
2. VaultUnlocked direct — if Core is not installed, connects to VaultUnlocked directly via the vault2 API
3. Disabled — no economy, admin commands only

Console output

On startup you will see one of:

[Graveyard] Economy via Core's ExternalEconomyBridge
[Graveyard] Economy via VaultUnlocked direct (Ecotale)
[Graveyard] No economy provider detected — premium purchases via admin commands only

Teleport cost

You can also charge players for teleporting to their gravestone:

"allowTeleportToGravestone": true,
"teleportCost": 50,
"teleportCurrency": "coins"

Set teleportCost to 0 to allow free teleporting.

---

Customization

Background Image

Replace images/gravestone_bg.png with your own 350x497 PNG image. Restart the server.

Language Overrides

Copy i18n/en-US.json to the mod's i18n/ directory and edit. Changes override the built-in translations.

Custom Designs

See Custom Designs for adding new gravestone models.