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`)

World Exclusion

The excludedWorlds list disables the graveyard system entirely in the worlds you name — no gravestone spawns on death, no integrity/restore checks, no cleanup scans. Use it for lobby, PvP arenas, minigame instances, or any world where a death-drop behavior would interfere.

Entries are case-insensitive and support two glob wildcards:

* — matches any sequence of characters (including empty)
? — matches exactly one character

"excludedWorlds": [
  "lobby",
  "pvp_*",
  "dungeon_?_instance"
]

Pattern	Matches	Doesn’t match
`lobby`	`lobby` (exact, case-insensitive)	`lobby_1`, `main_lobby`
`pvp_*`	`pvp_arena`, `pvp_1v1`, `pvp_flag`, `pvp_`	`arena_pvp`, `pv_team`
`dungeon_?_instance`	`dungeon_1_instance`, `dungeon_a_instance`	`dungeon_12_instance`, `dungeon__instance`

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:

KyuubiSoft Core — if installed, uses Core’s ExternalEconomyBridge (supports VaultUnlocked + EliteEssentials)
VaultUnlocked direct — if Core is not installed, connects to VaultUnlocked directly via the vault2 API
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.