Recov

This fabric mod is meant to be installed on the server only. It will detect player deaths and cache their inventories for some period of time. During this period, a server administrator can easily restore the items to the player.

The plugin is interacted with entirely through a command API. The actions are all subcommands of the recov command.

The commands are listed below.

/recov list [<player>]
/recov list [<onlyOnlinePlayers>] [<filter>]
/recov clear [<player>]
/recov restore <player> [<deathNumber>] [<sourcePlayer>]
/recov printDeathInventory <player> [<deathNumber>]
/recov setTicksUntilExpired <ticksUntilExpired>
/recov setTickUpdatePeriod <tickUpdatePeriod>
/recov setMaxInventoriesPerPlayer <maxInventoriesPerPlayer>
/recov setRequirePermissionToCache <requirePermissionToCache>

The list command, with no arguments passed, will list players who have stored inventories, including offline players. When passing a player's username, it will list the death inventories of that player. The second set of optional arguments for the list command will allow one to only view the inventories of online players, and specify an optional filter. A consequence of this is that, if one wants to list the death inventories of players whose names are either true or false, one must specify them in all uppercase. So, /recov list TRUE will list the inventories of the player whose username is true, which /recov list true will list the players who are online and who have death inventories.

The clear command, with zero parameters, will clear all death inventories. When passing a player's username, it will only clear that player's death inventories.

The restore command will restore a player's inventory. The deathNumber field specifies which death to restore from. If you want to restore the death inventory of one player to a different one, you can use the sourcePlayer parameter.

The printDeathInventory command will print the items in a player's inventory at the time of their death.

The setTicksUntilExpired will set the amount of ticks the mod will wait before deleting a player death inventory entry. By default, this is set to 48000.

The setTickUpdatePeriod will set the amount of time the mod will wait before checking if there are any expired death inventories to remove. By default, this is set to 8000.

The setMaxInventoriesPerPlayer will set the maximum inventories per player. If any more deaths occur, the oldest inventories are deleted early. By default, this is set to 10.

The setRequirePermissionToCache will set whether the plugin will check if a player has the recov.cacheinventory permission before caching their inventory on death. By default, this is set to false.

!!! DO NOT ENABLE setRequirePermissionToCache IF THE SERVER DOES NOT HAVE A PERMISSIONS MOD/PLUGIN. IT WILL CRASH ON ANY PLAYER DEATH !!!

Players with permission level of at least 3 have access to all recov commands, but they do not have the recov.cacheinventory permission. If you are using a permissions mod, the following permissions correspond to each command.

Removing the recov.cacheinventory permission from a player will not clear their currently-existing cached inventories.