WolfLoot is a complete crate, reward, currency, and temporary-ability system for Paper servers. Create custom crates, configure rewards, distribute virtual keys, build powerful Wolf Tools, sell items through the Fang Shop, and connect crates to FancyNPCs—all from an intuitive in-game admin GUI.
Spend less time editing configuration files and more time building an engaging reward system for your players.
Current release: WolfLoot 2.0.4
Platform: Paper 26.2
Java: Java 25
Open /wolflootadmin to manage WolfLoot without manually editing YAML files.
The admin interface supports:
Changes are validated before they are published to the live server.
Each crate has its own:
Players can preview a crate’s rewards and select the reward they want to claim. A successful claim consumes one matching virtual key.
Keys can be:
/keysFangs are WolfLoot’s built-in server currency.
Players can earn Fangs through:
Players can spend Fangs in /wolfshop on:
Shop prices and availability are configurable through the admin GUI or config.yml.
Wolf Tools are special temporary items that can automatically expire after a configured number of days.
WolfLoot includes preset tools such as:
Expiration begins when the player claims the reward. Expired Wolf Tools are automatically removed.
| Category | Abilities |
|---|---|
| Mining | Excavator, Tree Feller, Vein Miner |
| Weapons | Sweep, Lightning, Frostbite, Gale Strike, Hunter’s Mark |
| Ranged | Lightning, Frostbite, Gale Strike, Hunter’s Mark |
| Armor | Gravity Glide, Miner’s Vision, Tidal Crown, Guardian Heart, Prowler Speed |
Ability limits, cooldowns, damage, duration, radius, and maximum affected blocks can be configured.
WolfLoot 2.0.4 includes a guided custom Wolf item creator.
From the reward editor:
No held item is required.
WolfLoot automatically filters incompatible combinations. For example, Gravity Glide is limited to boots, Tidal Crown is limited to helmets, and ranged abilities are only shown for supported ranged items.
Custom Wolf items are saved to the plugin’s custom tool catalog and can be used as time-limited crate rewards.
Fang Boosters temporarily multiply Fang earnings.
Example:
- type: FANG_BOOSTER
booster-version: 1
multiplier: 2
duration-seconds: 300This example provides a 2× Fang multiplier for five minutes.
Boosters work with supported Fang sources such as AFK rewards and PvP rewards.
WolfLoot supports typed creature spawners as shop items and crate rewards.
Available default shop spawners include:
Example crate reward:
- type: SPAWNER
spawner-version: 2
entity-type: SKELETON
spawn-rule: FULL_LIGHTWolfLoot-issued spawners retain their configured creature type and include a full-light spawn rule. Normal Minecraft requirements such as player proximity, available space, delay, collision, and nearby-entity limits still apply.
The in-game item editor supports:
You can select an item through the GUI or safely copy supported properties from a held item.
For security, WolfLoot does not copy arbitrary plugin data, nested containers, executable metadata, or unknown custom NBT.
- type: DIAMOND_SWORD
name: "&c&lAlpha Blade"
amount: 1
enchantments:
- "SHARPNESS:5"
- "UNBREAKING:3"
- "LOOTING:3"
lore:
- "&7Forged for the leader of the pack."
- "&6Tier: Legendary"- type: NETHERITE_HELMET
name: "&3&lTidal Helmet"
amount: 1
trim: "tide"
trim-material: "diamond"
enchantments:
- "PROTECTION:4"
- "RESPIRATION:3"
- "UNBREAKING:3"
lore:
- "&7Marked by the ocean pack."- type: WOLF_TOOL
tool: wolf-frost-sword
days: 2
name: "&b&lFROSTBITE WOLF SWORD"
lore:
- "&7Slows enemies struck by the blade."
- "&cTemporary: expires two days after claiming."Area-mining example:
- type: WOLF_TOOL
tool: wolf-pickaxe-5x5
days: 2
name: "&c&lFENRIR PICKAXE &7(5x5)"
lore:
- "&7Breaks a bounded 5x5 mining plane."
- "&cTemporary: expires two days after claiming."Crates can be managed entirely through /wolflootadmin, but advanced users can also edit crates.yml.
schema-version: 2
crates:
lunar:
display-name: "&d&lLunar Crate"
icon: ENDER_CHEST
enabled: true
archived: false
shop:
enabled: true
cost: 800
hourly-drop:
enabled: true
chance-percent: 1
amount: 1
fancy-npc-ids: []
rewards:
- type: WOLF_TOOL
tool: wolf-pickaxe-3x3
days: 2
- type: FANG_BOOSTER
booster-version: 1
multiplier: 2
duration-seconds: 300After manual changes, run:
/wolfloot reloadInvalid configuration changes are rejected, and the previous valid live configuration remains active.
Replacing the plugin JAR with a new version still requires a normal server restart.
FancyNPCs is an optional integration.
Administrators can bind one or more exact FancyNPC IDs to a crate through the in-game editor. Interacting with a bound NPC opens that crate’s visual reward interface.
Bindings are stored by exact NPC identity, preventing crates from accidentally connecting to similarly named NPCs.
Every active crate can have an independent hourly drop configuration:
This allows both traditional crate tiers and custom seasonal or event crates.
Configure:
Use /setafkzone <radius> to capture a zone around your current position.
Configure:
Players can purchase a temporary wolf transformation through the Wolf Shop.
The transformation can include:
| Command | Description |
|---|---|
/wolflootadmin |
Open the visual administration panel |
/wolfshop |
Open the Fang Shop |
/fangs [player] |
View a Fang balance |
/keys [player] |
Open or inspect a virtual key wallet |
/wolfloot help |
Display WolfLoot command help |
/wolfloot reload |
Validate and reload configuration |
/wolfloot stats |
View plugin status and runtime information |
/givefangs <player> <amount> |
Give Fangs to a player |
/takefangs <player> <amount> |
Remove Fangs from a player |
/setfangs <player> <amount> |
Set a player’s Fang balance |
/setafkzone <radius> |
Capture and enable an AFK earning zone |
| Permission | Default | Description |
|---|---|---|
wolfloot.fangs |
Everyone | View Fang balances |
wolfloot.keys |
Everyone | View the virtual key wallet |
wolfloot.shop |
Everyone | Access the Wolf Shop |
wolfloot.wolf |
Everyone | Use wolf transformations |
wolfloot.admin |
Operators | Admin GUI, configuration, Fang management, and administrative commands |
When PlaceholderAPI is installed, WolfLoot provides:
| Placeholder | Value |
|---|---|
%wolfloot_fangs% |
Player’s current Fang balance |
%wolfloot_keys_total% |
Total keys across all crates |
%wolfloot_keys_<crate-id>% |
Keys owned for a specific crate |
%wolfloot_keydrop_countdown% |
Time remaining until the next hourly drop |
Example:
%wolfloot_keys_lunar%WolfLoot-2.0.4.jar inside the server’s plugins folder./wolflootadmin as an operator.WolfLoot includes default configuration files so you can begin testing immediately.
