NxShards: AFK-Zone Shards Economy for Paper and Folia

NxShards rewards players with Shards for staying in AFK zones, includes a GUI shop, leaderboard, MySQL/SQLite storage, and full Folia support.

NxShards is an advanced Shards economy plugin built for modern Minecraft servers with full Folia support. Players earn Shards by spending time inside designated AFK zones, spend them through an interactive GUI shop, and compete for the top spots on a server-wide leaderboard. Every periodic task is wired through the Lifecycle API and Folia entity schedulers, keeping the plugin smooth even on high-population shards.

Key Features

Folia + Paper Support

Natively compiled for the Folia architecture. All AFK timers and periodic tasks run through dedicated entity schedulers, reducing tick delay to the absolute minimum.

Dynamic AFK Zones

Reward players for the time they spend inside any region you define. Each zone has its own interval and Shards payout, configured live with a selection wand.

Titles and BossBars

Fully customisable entry, in-zone, and exit feedback — pick colors, durations, and messages for titles, action bars, and the boss bar.

GUI Shop

Players spend Shards through an interactive shop menu defined in config.yml. Stock items, set prices, and customise icons without touching code.

MySQL or SQLite Storage

Use MySQL for shared multi-server balances or SQLite for a zero-setup local database. Switch backends from a single config option.

Safe Player Transfers

/shards pay lets players move Shards between accounts, with configurable maximum transfer limits to block abuse and protect the economy.

Leaderboard

/shards top ranks the wealthiest players on the network. Expose any leaderboard position to other plugins through PlaceholderAPI.

PlaceholderAPI Support

Drop %shards_balance% and %shards_leaderboard_*% into scoreboards, chat formats, holograms, and tab lists.

How It Works

1. Mark an AFK zone

   An admin grabs the selection wand with /shards wand, left- and right-clicks two opposite corners, then runs /shards zone create <name> <interval> <amount>.

2. Players enter the zone

   Anyone standing inside the region sees the configured boss bar, action bar, and entry title — they are now earning Shards on every tick of the interval.

3. Spend or transfer

   Players check their balance with /shards, buy items from /shards shop, send Shards to friends with /shards pay, or climb the /shards top leaderboard.

Compatibility

Requirement	Details
Server software	Paper or Folia
Folia	Fully supported (native scheduler)
Database	MySQL or SQLite (default)
PlaceholderAPI	Optional — enables %shards_*% placeholders
Language	Java
License	MIT