PuffCrusher is a premium, lightweight recycling plugin for Paper that converts player items into valuable materials or Vault-backed currency via a secure, polished GUI.
Why PuffCrusher?
-
Player-friendly: intuitive GUI with live reward preview (materials or money).
-
Monetization-ready: Vault support enables instant shopless payouts.
-
Balanced and configurable: base values, multiplier, enchant bonuses and durability effects are fully configurable in `config.yml`.
-
VIP-ready cooldowns: define permission-based cooldown tiers to monetize or reward premium players.
-
Polished presentation: configurable processing animations (particles & sounds) for an engaging UX.
-
Lightweight & safe: minimal footprint, thread-safe structures and protections against item loss.
Core features:
-
Two operating modes: Materials or Money (Vault integration)
-
Live reward preview and enchant/durability bonuses
-
Permission-based VIP cooldown tiers and admin bypass
-
GUI protections: input validation, debounce (100ms), item return on close/logout
-
Optional processing animation with configurable duration, sound and particles
-
Multi-language support: included `en_US.yml` and `pl_PL.yml` with easy custom localization
Commands & Permissions:
- `
/crusher` — open GUI (perm: `puffcrusher.use`)
- `
/crusher give [player] [amount]` — give crusher item (perm: `puffcrusher.give`)
- `
/crusher open [player]` — open GUI for another player (perm: `puffcrusher.open.other`)
- `
/crusher reload` — reload config (perm: `puffcrusher.reload`)
Recommended settings for production servers:
- Enable Vault integration and set `selling.price-multiplier` to match your economy balance
- Configure VIP cooldowns under `cooldown.permissions` to monetize premium ranks
- Test `recycling` values on a staging server to fine-tune material vs money rewards
Support: https://discord.gg/mkyU3SgBUP