PuffCrusher 1.0
PuffCrusher allows players to process armor, weapons, and tools into raw materials or money
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
