Skip to content

🧿 Shard Currency

Shards are a fishing-based progression currency in Mirage, designed to reward active fishing gameplay while giving server owners full control over where and how Shards are earned.

Shards are obtained by fishing in configured worlds using a Shard Rod, making them ideal for servers that want to turn fishing into a meaningful progression path rather than a passive activity.

🎣 Earning Shards

Shards are earned by catching fish with a Shard Rod in configured worlds.

  • Only worlds defined in the configuration can generate Shards
  • Fishing without a Shard Rod will not award Shards
  • Shard drops scale with rod upgrades and custom enchants

This ensures Shards remain balanced, intentional, and resistant to AFK fishing abuse.

🪝 Shard Rod Integration

The Shard Rod is the core tool used to generate Shards.

Key Features

  • World-restricted Shard drops
  • Custom fishing logic separate from vanilla loot tables
  • Custom enchants to increase Shard yield
  • Upgradeable through in-game menus

Server owners can configure: - Which worlds allow Shard fishing
- Shard drop chances and amounts
- Scaling per rod level or enchant tier

This allows Shards to function as either: - A niche progression currency
- A side-activity reward system
- A requirement for fishing-related upgrades

⬆ Rod Upgrades (Upgrade Menu)

Shards are primarily spent through the Shard Rod Upgrade Menu.

Players can use Shards to: - Increase Shard drops per catch
- Unlock or upgrade fishing enchants
- Improve fishing efficiency and rewards

Upgrades are: - Purchased in-game
- Previewed before buying
- Fully configurable and permission-aware

🛒 Shard Shop

The Shard Shop allows players to exchange Shards for server-defined rewards.

Common Shop Rewards

  • Rod upgrades or upgrade tokens
  • Enchant books
  • Crate keys
  • Fishing cosmetics or tags
  • Secondary currencies

The shop is: - Accessible via /shard shop
- Fully configurable
- Independent from other Mirage currencies

💰 Player Commands

All player-facing Shard commands require no permissions.

🔐 Staff Commands & Permissions

These commands are intended for: - Event rewards
- Admin testing
- Manual balancing
- Store or crate integrations

⚙ Configuration Overview

Shards are designed to be easy to tune and safe to configure.

Typical configurable options include: - Allowed fishing worlds
- Shard drop rates per catch
- Rod upgrade scaling
- Enchant multipliers
- Cooldowns or anti-AFK logic

Shards do not interact with other Mirage currencies unless explicitly configured.

🎯 Intended Use

Shards are best used as: - A fishing-focused progression currency
- A reward for active engagement
- A cost for fishing tool upgrades
- A controlled alternative to passive fishing rewards

They are ideal for: - Survival SMPs
- Custom progression servers
- Side-activity reward systems