# Sour Graves
\n– Save your items from being deleted after a death!
\n– Items are always saved no matter how you die!
\n– Recover items by clicking on the grave
\n– Graves become public (raidable) after a timer (5 mins by default)
\n– Graves are deleleted with their items dropped on the ground after a timer (30 mins by default)<\/p>\n
## Default Configuration
\n“`toml
\n# irishgreencitrus’ Sour Graves v2 config
\n#
\n#
\n##############################################
\n# COMMENTS MADE IN THIS FILE WILL BE DELETED #
\n##############################################
\n#
\n#
\n# Notable updates since v1:
\n# – Graves are now stored in `graves.db` instead of `graves.json`.
\n# – If you have an existing `graves.json`, they should be converted to the new format.
\n# – Postgres and MySQL are also supported as external databases.
\n#
\n# Everything in the plugin is completely configurable.
\n# If you mess up the file, you can delete it to reset it to the defaults.
\n#
\n# Some key notes:
\n# – A player without any items in their inventory will not drop a grave.
\n# – A player with keepInventory enabled will not drop a grave.
\n# – The cleanup task is what actually deletes graves, as well as saves graves to disk.
\n# It should not be ran too infrequently, as your graves will not be saved if the server crashes.
\n# The default should probably be fine, but it can be raised or lowered as necessary.
\n## There is no need to edit this manually, it just tells the plugin whether to rewrite the config after it has been updated.
\nconfigVersion = 2
\n# After this many minutes, the grave will be accessible by all players.
\n# Set to `-1` to disable this.
\npublicInMinutes = 5
\n# After this many minutes, the grave will be deleted.
\n# Set to `-1` to disable this.
\ndeleteInMinutes = 30
\n# The maximum number of graves a player can have.
\n# After this limit, a player’s oldest grave will be deleted.
\n# Set to `-1` to disable this
\nmaxGravesPerPlayer = 3
\n# Whether to prevent graves being created for PvP kills
\ndisableForPvpKills = false
\n# Whether to drop the items of the oldest grave once a player has exceeded max graves
\ndropItemsOnTooManyGraves = true
\n# Whether to drop the items of a just-deleted grave. If false, the items just disappear
\ndropItemsOnGraveDeletion = true
\n# The particle to use for the grave recovery animation
\nrecoverParticle = “SOUL”
\n# The number of particles to use in the grave recovery animation
\nrecoverParticleAmount = 1000
\n# The sound to play on grave recovery
\nrecoverSound = “minecraft:block.respawn_anchor.deplete”
\n# When should the first grave cleanup run, after the server has started
\nperiodicCleanupDelayMinutes = 10
\n# How frequently the grave cleanup runs
\nperiodicCleanupPeriodMinutes = 5
\n# Whether to send a player their grave coordinates once they respawn
\nnotifyCoordsOnRespawn = false
\n# If this is `true`, the default Right-Click will now open an inventory.
\n# You can use Shift-Right-Click to restore the grave as normal.
\nallowChestLikeGraveAccess = false
\n# Swaps the behaviour of normal and shift clicking when `allowChestLikeGraveAccess` is `true`
\nchestAccessSwapNormalAndShift = false
\n# Whether to use legacy json-based file storage rather than the new SQLite database.
\n# I can’t think of any reason to enable this, but the functionality remains, so the option also remains.
\n# Overrides any settings in [sql].
\nforceLegacyFileStorage = false
\n# A list of the worlds that graves will *not* spawn in.
\n# This will lead to the default behaviour i.e. dropping items.
\n# Example values: [‘world_nether’]
\ndisabledWorlds = [ ]<\/p>\n
# Changing the [sql] options require you to restart the server.
\n# NOTE: this only controls the supported SQL servers.
\n# SQLite storage is enabled by default and does not require any configuration.<\/p>\n
[sql]
\n# Whether to enable connecting to a SQL server to store graves, instead of the JSON file.
\n# Useful for very large servers where a lot of graves are being created.
\nenable = false
\n# Supported SQL servers: MySQL and PostgreSQL
\n# Google ‘jdbc connection URL’ to find out what to put here
\njdbcConnectionUri = “jdbc:postgres:admin@localhost\/sourgraves”
\nusername = “admin”
\npassword = “changeme”
\n# Soft deletion will mean all grave data will stay in the database, and only ever be marked as deleted.
\n# This provides extra protection against item loss and allows complete recovery.
\n# Disabling this will not retroactively apply, and merely actually delete graves made after the change.
\nsoftDeletion = true
\nalreadyConvertedFromJson = true<\/p>\n
[economy]
\n# Whether to enable the economy features of this plugin (Requires VaultUnlocked to be installed)
\nenable = false
\n# The cost to recover one of your own graves
\ngraveRecoverCost = 1.0
\n# The cost either per grave or per item stack in the grave
\ngraveRecoverPaymentType = “FLAT”
\n# The cost to rob someone else’s grave
\ngraveRobCost = 5.0
\n# The cost either per grave or per item stack in the grave
\ngraveRobPaymentType = “FLAT”<\/p>\n
# Change anything in here if you find the log messages too invasive.
\n# Most severe and warning messages cannot be disabled, by design.<\/p>\n
[logMessages]
\n# Whether to enable the GitHub and Discord message on startup.
\nstartupMessage = true
\n# Whether to log every time the cleanup task runs. Useful for debugging configuration.
\n# Not recommended to leave on for prolonged periods of time.
\ncleanupTask = false
\n# Whether to log if a grave hasn’t stored its location. Can occur for graves created before v1.5.0.
\n# It is recommended to leave this enabled as it will only be printed once anyway.
\ngraveMissingLocation = true
\n# Gives a warning if a grave that is about to be deleted has its chunk loaded but the armour stand (The player head) has been deleted.
\n# This could be a sign that another plugin is deleting armour stands.
\narmourStandNotFoundOnGravePurge = true
\n# Gives a warning on startup if you are still using legacy JSON storage and have more than 100 graves.
\nmoreThan100GravesWarning = true
\n“`<\/p>\n
## Permissions
\n“`yml
\nsourgraves.admin.server:
\n description: Allows you to use `\/sourgraves disk` and `\/sourgraves config`
\n default: op
\nsourgraves.admin.settings:
\n description: Allows you to use `\/sourgraves settings`
\n default: op
\nsourgraves.admin.give:
\n description: Allows you use `\/sourgraves give`
\n default: op
\nsourgraves.player.graveaccess:
\n description: A player with this permission can open any grave, regardless of whether it is public.
\n default: false
\nsourgraves.player.permaprivate:
\n description: A player with this permission will have a grave that never goes public.
\n default: false
\nsourgraves.player.permagraves:
\n description: A player with this permission will have a grave that never expires by itself. This doesn’t affect other situations which delete a grave.
\n default: false
\nsourgraves.utils.player:
\n description: Allows you to use `\/sourgraves player`
\n default: op
\nsourgraves.utils.locateown:
\n description: Allows you to use `\/sourgraves locate`
\n default: true
\n“`<\/p>\n
Found a bug, have questions or feature requests?<\/p>\n
Join the Discord on the right hand side and drop me a message.<\/p>\n","protected":false},"excerpt":{"rendered":"
A simple, configurable grave plugin for 1.21+<\/p>\n","protected":false},"featured_media":145875,"template":"","meta":{"_minecraft_slug":"sour-graves","_minecraft_project_id":"8ngJlpNI","_minecraft_author":"irishgreencitrus","_minecraft_license":"LGPL-3.0-or-later","_minecraft_downloads":1723,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"sour-graves.zip","_minecraft_size_bytes":75594857,"_minecraft_version_count":20,"_minecraft_updated_at":"2026-05-16T06:50:23.936076Z","_minecraft_date_created":"2025-03-10T21:12:16.337562Z","_minecraft_date_modified":"2025-08-22T18:19:23.431446Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/sour-graves","_minecraft_icon_attachment_id":145875,"_minecraft_imported_at":"2026-06-08T17:37:25+00:00","_minecraft_import_hash":"20a7c1069141169a4cf37128a60afaf5","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,89,127,128,92],"mod_loader":[132,133],"minecraft_version":[62,37,73,74,38,78,79,80,81],"class_list":["post-145874","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n