About Glitched item retriever
"My backpack fell through the ground, again!" is a sentence that all admins hate to hear.
And what will happen if no admin is online when a players backpack (or held item) glitches through the ground?
Correct, it will be lost forever.
This plugin checks for all items which are dropped after a players death and will smoothly bring them up to the players death position (+ a little extra so they won't fall through the ground again).
Just one command, one permission and the configuration is very small and simple.
Configuration:
"Lift glitched items slowly up instead of teleporting them instantly": (Just a small cosmetic feature)
If true, the items will be slowly lifted up until they pop out of the terrain.
If false, the items will be teleported instantly to the position on which the played died.
--> If you experience any performance issues by the animation/coroutine, leave the setting on "false". While testing I had no performance issues unless I retrieved 50+ items simultaneously (which won't ever happen on a live server nevertheless).
Permissions:
glitcheditemretriever.active
If a player does not have this permission, his items will not be retrieved.
Why? Admins tend to throw stuff under the map and want to disable the retrieve logic for these items. Or you want to enable this plugin only for a VIP group of users. Whatever floats your boat.
Commands:
/gir.toggle
Can be used by every player with the permission mentioned earlier. Toggles a settings with the enabled/disabled state for the calling player.
Useful for admins when they want to throw stuff under the map. Just toggle the retrieve logic (to off), throw the stuff away, toggle the retrieve login again (to on).
Notes:
To make sure an item is dropped under the terrain ON PURPOSE, I added a minimum distance of 3 meters between the noclip-flying-admin-player and the terrain.
If an admin wants to throw his stuff under the map WITHOUT toggling the setting first, make sure to fly more than 3 meters under the terrain.
If the players position is below the terrain but not at least 3 meters, the plugin assumes that the player glitched through the terrain, dropped the items by accident and retrieves them.
Known issues:
- Rust does not always calculcate the terrain correctly when a player is inside a cave, tunnel or custom underground monument. An item that is glitched there will likely be teleported on the surface ABOVE the underground location.
I opened a ticket at facepunch in 2024, not fixed yet.
- Items that are thrown away on purpose (dragged out of the inventory or when used the "drop item (single)") are not handled by my plugin, when less then the whole stack was thrown away, since there is a bug in Facepunch's code that does not set the "dropped by" attribute (player's steam ID). So my plugin does now know to which player the item belonged, who should be informed via chat message and if the (unknown) owner has the setting enabled or disabled (via gir.toggle).
I opened a ticket at facepunch in april 2025, not fix yet.
Roadmap:
- Since the plugins name could lead to the confusion: currently it only retreives the backpack and/or the held item the player drops on his death.
I will check for items that were looted by p.e. barrels and other props later.
- Maybe: configurable list of items that should be retrieved or ignored by the plugin
- Smoother animation
- Configurable message that is sent to the player
- Check if player is in a tunnel/cave, since items that are dropped in these locations, are retrieved to the terrain (which is above the tunnel/cave!)
