SingleMFA

SingleMFA is a lightweight, high-performance reward engine that connects to Vault to pay players for mining blocks and killing mobs while strictly preventing economy exploits.

Key Features

• Block & Mob Rewards: Reward players with currency for mining natural ores/blocks and hunting hostile or passive entities.
• Randomized Reward Ranges: Configure static payouts or dynamic ranges (e.g., 50-100) for any block or mob type.
• Rank Multipliers: Reward VIP and donor ranks with configurable payout multipliers via permission nodes.
• HEX Color & Notification Support: Send feedback to players via Chat, ActionBar, or both, featuring customizable HEX color gradients.
• Developer API: Includes an extensible API allowing other plugins to inject custom external multipliers and process external block-break events.
• Multi-Version & Folia Ready: Native support for Paper, Spigot, and multi-threaded Folia servers across versions 1.16 through 1.26+.

Anti-Abuse Protection

• Persistent Chunk Storage: Player-placed blocks are tracked using persistent chunk data rather than volatile memory. Block tags persist through server restarts, chunk unloads, and piston displacement.
• Silk Touch Prevention: Blocks harvested with Silk Touch can be configured to yield no financial reward, eliminating infinite ore placement/mining cycles.
• Spawner & Farm Filtering: Prevents automated mob-grinder exploits by ignoring mobs spawned via spawners, spawn eggs, breeding, dispensers, split slimes, or player-built golems.
• Creative Mode Check: Players in creative mode cannot trigger payouts or generate currency.

Commands & Permissions

• /mfa reload — Reloads config.yml and active locale messages.
• Permission: singlemfa.admin (required for /mfa commands).

Requirements

• Spigot / Paper / Purpur / Folia: 1.16 – 1.26+
• Vault: Required.
• Economy Provider: Any Vault-compatible economy plugin (e.g., EssentialsX, CMI, Treasury).