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.



  • 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.


Scavenger hooks into several plugins to play nice with their inventory controls.

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.


  • To use an economy plugin you will need Vault and an economy plugin.


  • scavenger.scavenge - Enable item recovery
  • scavenger.scavenge.damage_cause
  • scavenger.level - Enable level recover
  • scavenger.exp - Enable experience points recovery
  • - 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.
  • - 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
  • 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
  • Offhand (shield etc...)
    • scavenger.offhand.1


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.


  • /scvr - Reload configuration
  • /scvron - Self enable scavenger
  • /scvroff - Self disable scavenger
  • /scvrlist - List all pending recoveries



You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of cnaude cnaude Jul 03, 2016 at 21:52 UTC - 0 likes

    @guerocraft: Go

    Should be fixed in latest dev build.

    Jenkins | GitHub BFAK:cnaude,99361,b703b55cc7c33b67a0dde6d0e3e3b46833573e8f906baec978d45c87a0139279

  • Avatar of guerocraft guerocraft Jul 03, 2016 at 21:01 UTC - 0 likes
    Last edited Jul 03, 2016 by guerocraft
  • Avatar of cnaude cnaude Jul 03, 2016 at 20:27 UTC - 0 likes

    @guerocraft: Go

    What does your config look like?

  • Avatar of guerocraft guerocraft Jul 03, 2016 at 19:18 UTC - 0 likes

    Another bug: it doesnt save items in the left hand.

  • Avatar of guerocraft guerocraft Jul 03, 2016 at 01:04 UTC - 0 likes

    @cnaude: Go

    Thanks a lot, love you <3. I'll test it in a few days.

  • Avatar of cnaude cnaude Jun 30, 2016 at 03:05 UTC - 0 likes
  • Avatar of guerocraft guerocraft Jun 29, 2016 at 21:19 UTC - 0 likes

    Hi there!) Great plugin, but there is an error with latest Authme jenkins build. I use latest spigot 1.10, offline mod, offlinemod=true in your plugin. Error:

    [00:04:16] [Server thread/INFO]: hardc0r issued server command: /l 123321 [00:04:16] [Craft Scheduler Thread - 0/INFO]: [AuthMe] hardc0r logged in! [00:04:16] [Server thread/ERROR]: Could not pass event LoginEvent to Scavenger v1.7-16 org.bukkit.event.EventException at$1.execute( [spigot.jar:git-Spigot-5391d73-00359a1] at org.bukkit.plugin.RegisteredListener.callEvent( [spigot.jar:git-Spigot-5391d73-00359a1] at org.bukkit.plugin.SimplePluginManager.fireEvent( [spigot.jar:git-Spigot-5391d73-00359a1] at org.bukkit.plugin.SimplePluginManager.callEvent( [spigot.jar:git-Spigot-5391d73-00359a1] at fr.xephi.authme.util.BukkitService.callEvent( [AuthMe-5.2-SNAPSHOT-spigot.jar:?] at fr.xephi.authme.process.login.ProcessSyncPlayerLogin.processPlayerLogin( [AuthMe-5.2-SNAPSHOT-spigot.jar:?] at fr.xephi.authme.process.SyncProcessManager$ [AuthMe-5.2-SNAPSHOT-spigot.jar:?] at [spigot.jar:git-Spigot-5391d73-00359a1] at org.bukkit.craftbukkit.v1_10_R1.scheduler.CraftScheduler.mainThreadHeartbeat( [spigot.jar:git-Spigot-5391d73-00359a1] at net.minecraft.server.v1_10_R1.MinecraftServer.D( [spigot.jar:git-Spigot-5391d73-00359a1] at net.minecraft.server.v1_10_R1.DedicatedServer.D( [spigot.jar:git-Spigot-5391d73-00359a1] at net.minecraft.server.v1_10_R1.MinecraftServer.C( [spigot.jar:git-Spigot-5391d73-00359a1] at [spigot.jar:git-Spigot-5391d73-00359a1] at Source) [?:1.8.0_91] Caused by: java.lang.NoSuchFieldError: api at com.cnaude.scavenger.Hooks.ScavengerAuthMeReloaded.isAuthenticated( [?:?] at com.cnaude.scavenger.Scavenger.isAuthenticated( [?:?] at com.cnaude.scavenger.ScavengerEventListenerOffline.isScavengeAllowed( [?:?] at com.cnaude.scavenger.ScavengerEventListenerOffline.playerLoggedOn( [?:?] at com.cnaude.scavenger.AuthMeListener.onPlayerOfflineModeLogin( [?:?] at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) [?:1.8.0_91] at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source) [?:1.8.0_91] at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source) [?:1.8.0_91] at java.lang.reflect.Method.invoke(Unknown Source) [?:1.8.0_91] at$1.execute( [spigot.jar:git-Spigot-5391d73-00359a1] ... 13 more

  • Avatar of cnaude cnaude Jun 22, 2016 at 17:59 UTC - 0 likes

    @Denizay22: Go

    Please verify that you are running the new version Scavenger. Your log output shows the old version. See line 1.

  • Avatar of Denizay22 Denizay22 Jun 22, 2016 at 17:53 UTC - 0 likes

    @cnaude: Go

    Same. In the first load of plugin, everything is normal, plugin loading succesfully. But It doesn't work. Then I stop the server, and start it again. Then I get this error :

    Config( the original config file, I don't touch it) :

    Sorry for bad english :/

  • Avatar of cnaude cnaude Jun 22, 2016 at 03:26 UTC - 0 likes

    @Denizay22: Go

    Please try the latest dev build. If you continue to get that error please also pastebin your config.yml.


Date created
Mar 10, 2012
Last update
Jul 03, 2016
Development stage
  • deDE
  • enUS
  • itIT
  • koKR
  • ruRU
  • zhCN
GNU General Public License version 3 (GPLv3)
Curse link
Recent files