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
Can there be a max charge as well? Someone has almost 200k and I'm about to charge 2.5%..thats like 5k per. :D
@ledhead900
It happens instantly. I have never seen an instance where it was possible to duplicate items at death.
@cnaude
I have a Question.
How does this handle exploited duping, by this I mean if someone dies and is able to have someone near by where they died what happens to the gear on the ground ?, can they be picked up or does it get it cleaned up instantly if they can afford the charge for the gear retrieval.
Also would you consider fixing this if a dupe was possible by by person B collecting person A's lost gear on death and would you be open to the idea of damage applied to any tools or armor your get back from this ?
@thealmightypsycho
I was unable to replicate this problem. What version of CraftBukkit and WorldInventories are you running?
There seems to be a conflict with WorldInventories. When a player dies WorldIventories empties the players inventory and then scavenger spits this error out I tested scavenger without WorldInventories and it worked fine. Is there any way to fix this conflict? Thanks
@cnaude
Hello,
I tested the version and it does not work :/
@Hyurst
Please try this test version. It includes support for PVP arena.
@Hyurst
The PVP arena is likely causing a conflict. I'm working on a fix for that.
@cnaude
Hello,
I changed the permissions there is always the same problem ... I have the following version of essential B-Pre2.9.1.2 Essentials (R0.3) for CB-1.2.3 R0.2 And i have PVP Arena
@pandapipino
I remember seeing that in the wish list for the original version. How would this work? Are you referring to configuring a list of items that would always drop and not be saved?
are you gonna include a configurable specific item drop on death in the future?
@cnaude
For my part before it goes into the plugins 1.2.3 focntionné very well. But once the transition to this version the plugin no longer focntionné ... :/
@IIIeeCode
That depends entirely on the permissions plugin you use. Which plugin are you using? I use PermissionsBukkit but there are others out there that might be easier.
Just make sure you put the correct permission nodes in the correct groups for the players you want to give Scavenger access to.
What should I wrote in permissions file (and what should I download) to got this to work free for all players :( I'm afraid of permissions, help :( please.
I fear that when I set up permissions for it all other plugins will detect permissions and without setup will grant rights to everyone :(!
I use the yml file for permissionsEx, configurations are:
Vagabond: permissions: - scavenger.savenge inheritance: - Visitor
I have not changed from the configuration file of yml scavenger ... I also tried with scavenger.free and also try with both and scavenger.free scavenger.scavenge! Without it working
@Hyurst
What does your permissionsEx config look like? Are you using yml or sql for the backend? Are you able to replicate the issue yourself?
Hello,
I am in 1.2.3 and the people playing on my server losing their items. Even having activated the permissions on the file permissionsEx. I think there must be a compatibility issue with this version.
@Zombiemold
I am now running MobArena on my server with Scavenger 1.6.3. So far no issues. :)
@Zombiemold
Try this version with MobArena and let know if it works for you.
@cnaude
MobArena seems to be the primary issue, and likely the most important.
I have gotten reports that it happened in CTP as well, however I use all 3 of the aforementioned plugins, which work together nicely.