SelfRefund
Automated self-service inventory refunds for hacker victims
Stop manually refunding players one by one. Let them refund themselves.
Automated self-service inventory refunds for hacker victims
Stop manually refunding players one by one. Let them refund themselves.
What makes SelfRefund different
Most refund plugins force your staff to manually restore each victim's inventory, one player at a time, after a cheater is caught. If a hacker killed 30 players before the ban, that's 30 separate manual refunds for your team to process.
SelfRefund flips that. When a cheater is flagged with a single command, every player they killed becomes eligible to refund themselves through a clean in-game GUI — with zero manual work from your staff, no matter how many victims there are.
One command flags the hacker. Every victim claims their own loot back. Your staff does nothing.
How it works
- A player is killed by another player. SelfRefund silently saves a snapshot of the victim's full inventory in the background.
- Your anticheat (or a staff member) runs /sethacker <player> on the cheater before banning them.
- Every player that cheater killed instantly becomes eligible for a self-refund — including players who are currently offline.
- Victims run /invrefund, browse all of their pending refunds in a GUI, preview the exact items, and claim them back themselves.
IMPORTANT — Anticheat setup
SelfRefund only works if /sethacker runs BEFORE the cheater is banned.
The command reads the cheater's stored kills and turns them into refunds. If you ban first and flag afterwards, that data may no longer be reachable. Always order the punishment commands like this in your anticheat:
Code:
sethacker %player%
ban %player% CheatingThis works with any anticheat that can run console commands on punishment — Vulcan, Grim, Spartan, Matrix, and others. Simply add sethacker %player% to the punishment command list, placed above your ban command.
Full feature list
Automated self-refund
- A single /sethacker command flags a cheater and converts ALL of their recorded kills into pending refunds for the victims.
- Players refund themselves through a GUI — staff never has to manually restore a single inventory.
- Scales effortlessly whether the hacker killed 2 players or 200.
Per-death refund history
- Every death is stored as its own separate refund. Die three times to three different hackers and you receive three separate refunds.
- Older refunds are never overwritten or lost when a newer one is added.
Clean, intuitive GUI
- Each pending refund is displayed as the hacker's player head, showing their name, the time of death, and the time they were flagged.
- Click a head to open a preview of the exact items before claiming anything.
- Simple Claim and Return buttons. Items in the menu are view-only and cannot be moved, dragged, or stolen.
- Bedrock players are fully supported with their own dedicated head display.
Keep-inventory aware (no duping)
- Automatically respects the vanilla keepInventory gamerule and the death event keep-inventory flag.
- A config toggle covers servers that use a keep-inventory plugin, so players never get refunded items they never actually lost.
Smart claiming
- Checks for enough free inventory space before handing items back.
- Safely drops any overflow on the ground if the player's inventory fills up mid-claim.
Reminders
- Reminds players with pending refunds periodically and again when they join.
- Delivered via chat, action bar, and a sound — all fully configurable.
Expiry system
- Refunds can expire after a configurable amount of time so old data does not pile up forever.
- Expiry is checked even for players who are offline.
- A configurable console command fires on expiry with the victim name, hacker name, and date of death.
World and region blacklists
- Block refunds from being generated in specific worlds, such as arenas or event worlds.
- Block refunds inside specific WorldGuard regions, such as spawn, duels, or KitPvP zones.
Discord and command hooks
- Run any console command when a hacker is flagged, when a victim becomes eligible, when a refund is claimed, and when a refund expires.
- Perfect for DiscordSRV broadcasts and direct messages.
Admin friendly
- /removehacker undoes a wrong flag and wipes all related refund data, even for offline victims.
- /srreload reloads the configuration with no restart required.
- Every message the plugin sends is fully customizable in the config.
Commands
| Command | Description | Permission |
|---|---|---|
| /invrefund | Open your personal refund GUI | selfrefund.use |
| /sethacker <player> | Flag a cheater and create refunds for their victims | selfrefund.admin |
| /removehacker <player> | Undo a flag and clear all related refund data | selfrefund.admin |
| /srreload | Reload the configuration | selfrefund.admin |
Permissions
- selfrefund.use — allows a player to open and use /invrefund (default: everyone)
- selfrefund.admin — allows /sethacker, /removehacker, and /srreload (default: op)
Configuration
Code:
messages:
inv-full: '&cYou need more free inventory space to claim this refund.'
refund-success: '&aYou have successfully been refunded!'
refund-not-eligible: '&cYou have no pending refunds.'
hacker-not-found: '&cCould not find that player.'
hacker-set: '&a%player% has been flagged as a hacker.'
hacker-removed: '&a%player% has been removed as a hacker and all refund data cleared.'
no-refunds-left: '&cYou have no more pending refunds.'
items-dropped: '&eYour inventory was full, some items were dropped on the ground.'
# If true, refunds will NOT be generated when the player kept their items on death.
# Respects the vanilla keepInventory gamerule AND the death event keep-inventory flag.
# Set this true if your server uses a keep-inventory plugin that bypasses the gamerule.
respect-keep-inventory: true
# Command run as console when /sethacker is used (hacker is punished).
# Placeholders: %hacker% = hacker name
command-on-sethacker: ''
# Command run as console when a victim becomes eligible for a refund (after /sethacker).
# Placeholders: %player% = victim name
command-on-victim-notify: ''
# Command run as console when a player successfully claims a refund.
# Placeholders: %player% = victim name
command-on-refund: ''
# Reminder sent to players who have pending refunds
reminder-message: '&6[SelfRefund] &eYou have pending refunds! Type &a/invrefund &eto claim them.'
# How often to remind in seconds
reminder-interval: 120
# Worlds where deaths will not generate a refund
world-blacklist:
- 'world_example'
# WorldGuard regions where deaths will not generate a refund
region-blacklist:
- 'spawn'
- 'arena'
- 'duels'
# How long in seconds before a refund expires (e.g. 604800 = 7 days)
refund-expiry: 604800
# How often in seconds to check for expired refunds
expiry-check-interval: 3600
# Console command fired when a refund expires
# Placeholders: %victim% = victim name, %hacker% = hacker name, %death_date% = date of death
command-on-expiry: ''Compatibility
- Server software: Spigot and Paper
- Minecraft versions: 1.20 – 1.21
- Soft dependency: WorldGuard (only required if you use the region blacklist feature)
- Anticheat: Works with any anticheat that can run console commands on punishment (Vulcan, Grim, Spartan, Matrix, and others)
Refunds without the workload.
One command flags the cheater. Your players handle the rest.
One command flags the cheater. Your players handle the rest.
