Scavenger
About Scavenger
This is a continuation of the Scavenger plugin originally written by SirHedgehog. This plugin will automatically recover items for players after they die.
Features
- Automatic item recovery at death.
- Individual item recovery based on permissions if enabled.
- Automatic level and experience recovery at death.
- Supports SuperPerms
- Supports Vault based economies.
- Persistent recoveries. If the server is stopped before a player can recover inventory the inventory is saved to disk.
- Slot based recovery
How to install
Just drop the jar file in your plugins directory and restart your server. Configure permissions.
Links
Hooks
Scavenger hooks into several plugins to play nice with their inventory controls.
- Multiverse-Inventories
- MultiInv
- Mob Arena
- PVP Arean
- Ultimate Arena
- Battle Arena
- WorldInventories
- Minigames
- xInventories
Scavenger also hooks into Residence to provide item recovery override per residence.
Scavenger also hooks into Factions to provide item recovery override in enemy territory.
Scavenger optionally hooks into authentication plugins via Authenticator. Update the config.yml accordingly. More info here.
Dependencies
- To use an economy plugin you will need Vault and an economy plugin.
Permissions
- scavenger.scavenge - Enable item recovery
- scavenger.scavenge.damage_cause
- scavenger.level - Enable level recover
- scavenger.exp - Enable experience points recovery
- scavenger.free - Free item recovery
- scavenger.reload - Reload config
- scavenger.drop.[ITEM] - If SingleItemDrops is true then don't recover these items.
- scavenger.keep.[ITEM] - If SingleItemKeeps is true then only recover these items.
- scavenger.self.on - Allows players to enable item recovery for themselves.
- scavenger.self.off - Allows players to disable item recovery for themselves.
- scavenger.disable - Allows players to completely disable Scavenger.
- scavenger.enable - Allows players to completely enable Scavenger.
- scavenger.list - Allows player to list all pending recoveries. (Purely informational)
If you enabled slot based recovery you will need to give each player a permission node for each slot.
- Armour:
- scavenger.armour.X - Armour slots where X is 0, 1, 2, or 3.
- Armor: 0 = boots, 1 = leggings, 2 = chestplate, 3 = helmet
- scavenger.armour.X - Armour slots where X is 0, 1, 2, or 3.
- Inventory
- scavenger.inv.X - Inventory slots where X is 0 to 35.
- Inventory bar: 0 - 8
- Inventory row 1: 9 - 17
- Inventory row 2: 18 - 26
- Inventory row 3: 27 - 35
- scavenger.inv.X - Inventory slots where X is 0 to 35.
- Offhand (shield etc...)
- scavenger.offhand.1
FAQ
Q) How do I explicitly keep items?
A) Set SingleItemKeeps true. Then use scavenger.keep.[ITEM] to keep the ITEM.
Q) How do I explicitly drop items?
A) Set SingleItemDrops true. Then use scavenger.drop.[ITEM] to drop the ITEM.
Commands
- /scvr - Reload configuration
- /scvron - Self enable scavenger
- /scvroff - Self disable scavenger
- /scvrlist - List all pending recoveries
Videos
Configuration
Donations
Doge: DEaQKfC9ivumNgs3feo53xndhjhd4PV5Yk
BTC: 3Nthksfx8fNKkUgZnHWRTaH4MjUMe4dQG8
ETH: 0xf65cB1960e176ea980545f525f687cF2354D310d
XCH: xch1jgtw6vxyy4wv302xlhyuzwtfen67w5yrvcwc2gz2us3fwtjp3uxq6hlzhc
I have the correct permissions to retrieve only XP, not recuperea nothing more .. : (
<<reply 724002="">>
can we change the color of the [ ] so it won't be white by default? I know you can change the color of the word inside of it.
@gibbly96
Try the latest dev version.
Hey :)
Great Plugin. But one question. Can you add a function to change the Prefix of the messages.. I think you know what i mean..
normal:
[Scavenger] Saving my mom.
possible with my suggestion:
[Your Mom] Clean your room and dont play this stupid computer game!
..
Gabriel
@cnaude
No they don't lose their exp, they just drop an orb. It doesn't seem to give them all the exp they have even, but maybe it gives them the amount they had when they first died over and over. I am not really sure. The permissions seem correct to me.
@ryvix When the orbs drop do the players lose their exp, or are the exp recovered automatically? Are the player's levels recovered? I have tested this with PEXand I know it does work. The scavenger plugin uses the superperms API so it supports any superperms permissions plugin. Please double check your permissions.
<<reply 707724>>
Thank you.
They currently have these permissions:
- scavenger.scavenge
- scavenger.level
- scavenger.exp
- scavenger.free
I am using PEX.
@ryvix
The proper way to stop this is to give payers the scavenger.exp permission.
Is there something in this plugin that drops the players xp when they die? I notice it has the scavenger.exp permission and when they die they are dropping a group of xp orbs for some reason which I don't want to happen and I am wondering if it's caused by this plugin since it happens when they die and if so, what is the proper way to stop it.
@cnaude
Tested it long ago, could've swore I posted here but apparently not. It seems to be working correctly, so thanks for that :D
@fjutte
I have the /return command from CommandBook and this teleport you not back to your death point ;). Or you have to ban the command in permissions.
@DasDing73
"And if the player don't want to pay for the recovery, the items will be drop on the death point."
You mean, so those who don't want to pay, can do "/back" or "/home" and pick up their items for free.... seems pretty useless to me :)
Hm okay, but maybe when Scavenger saves also the point of death. And if the player don't want to pay for the recovery, the items will be drop on the death point.
I have found a mestake in the translation, one word to much.
@DasDing73
It is technically possible to make it so players are prompted after they die. I don't think it's a good idea to do that. The problem is Scavenger collects a player's inventory at the time of death. The only way to prompt a player would be after the inventory is already saved in memory and the drops are cleared.
@cnaude I will try it today. But it would be better if you are ask after respawn to recover your items or not. I can't program with Java, but I think it is possible to manage. Edit: here are the translations
@tediousmaximus1 check if you got the permissions node scavenger.free. Because you have to delete it. And maybe through the new configs you forgot to set the economy to true. But I can say that it works with the dev build.
@cnaude
its still not working... what the heck have i done wrong lol.
@DasDing73
The latest dev version 1.6.8 contains two new permissions and two new commands. If a user runs /scvroff they will disable scavenger for them self. The change is persistent.
Send me the translations and I'll find a place for them.
@cnaude
Thank you. Ill test it later tonight when i can get a restart in :D
The new dev build is fantastic! It works very fine. Now only an option to recover your items or not is missing. You can link on the dev build site different translations for the messages in Scavenger. I can send you my german translation (I come form Germany) if you like.
@Kevdama
The latest dev version supports both cases now. There are two options in the config file for this. I recommend testing them.