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
@tediousmaximus1
I just uploaded another version. 1.6.7b It has a new option. Set this to false and ops will have false permissions on everything except reload.
@cnaude
so i got the dev version and popped it in... i even deleted the old config file for scavenger. is there anything i need to add to permissions to make ops permissions false? specifically for scavenger of course.
@tediousmaximus1
Try the latest dev version. The issue a lot of users run into is that the default permissions for ops is true. I'm going to make that optional. The dev version has the default permissions for ops=false (except the reload permission).
@cnaude
sorry to bother you again :/ but is there any way i can disable exp/level recovery for ops as well? i used your line and it didnt work. this is what it looks like right now
@tediousmaximus1
Glad to heat that. :)
@cnaude
yep that was it... my bad its good now :p
BTW awesome plugin. it works fantastic.
@tediousmaximus1
could it be scavenger.* thats causing the problem?
@cnaude it still wont work. this is what i have in my permissions.yml
@tediousmaximus1
By default xp recovery is off, unless you are an op. To explicitly disable it try this in your permissions.yml file
@cnaude
i cant seem to get xp recover to turn off. :/ i have a fairly straightforward private server. i might be doing this wrong. do i add the scavenger.exp: false line to default in the permissions yml file? im using PermissionsEx btw.
@tediousmaximus1
The XP recovery is optional and can be disabled by setting scavenger.exp to false. There is no option to dock a percentage of the XP.
I dont know if anyone has asked this. is there a option to turn off XP recovery? either that or the ability to dock people of 10% of their xp upon death?
Dupe bug with UltimateArena plugin. Scavenger recover arena items after round ends. (Works only for last player. If lives amount 0.)
@ryvix
There are no issues of losing inventory that I am aware of.
Hey, I am going to try using this plugin for awhile and see how it goes. Are there any reports of people randomly losing their things? Because this was happening with DeathControl for me for some reason and that's just no good. Thanks!
Hey there. Thanks for the Worldguard PvP integration, but its actually the opposite of what I wanted. I want there to be a PvP arena where you dont lose your items upon death, but you still drop your items if you die elsewhere
@cnaude hm do not work for me. But thaaanks!
You should make it somehow optional for a player to recover his inventory.
@DasDing73
The minus sign tells it to set that permission to false.
You can try this as well.
This node don't work too. This - mean that this permission node is set to false?! I didn't found something like that on the bpermissions page. But thank you for your help. You are awesome!