Skip to content

🔮 Crystal Currency

Crystals are a combat-driven progression currency in Mirage, designed to reward active PvE gameplay and controlled mob grinding.

Crystals are earned by killing configured mob types using a Crystal Sword, making them ideal for servers that want to incentivize combat, mob farming, and weapon progression without inflating the main economy.

⚔ Earning Crystals

Crystals are obtained by killing specific mobs with a Crystal Sword.

  • Only mobs defined in the configuration can drop Crystals
  • Kills without a Crystal Sword will not generate Crystals
  • Crystal drops scale with weapon upgrades and enchants

This ensures Crystals remain balanced, intentional, and resistant to passive or AFK farming.

🗡 Crystal Sword Integration

The Crystal Sword is the core weapon used to generate Crystals.

Key Features

  • Mob-specific Crystal drops
  • Fully configurable supported mob types
  • Custom combat enchants to increase Crystal yield
  • Upgradeable via in-game menus

Server owners can configure: - Which mobs drop Crystals
- Drop chances and amounts per mob
- Scaling per sword level or enchant tier

This allows Crystals to function as either: - A PvE progression currency
- A combat-focused reward system
- A requirement for higher-tier upgrades

⬆ Weapon Upgrades (Upgrade Menu)

Crystals are primarily spent through the Crystal Sword Upgrade Menu.

Players can use Crystals to: - Increase Crystal drops per kill
- Unlock or upgrade combat enchants
- Improve sword efficiency and scaling

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

🛒 Crystal Shop

The Crystal Shop allows players to exchange Crystals for server-defined rewards.

Common Shop Rewards

  • Sword upgrades or upgrade tokens
  • Enchant books
  • Crate keys
  • PvE-focused rewards
  • Cosmetic or prestige items

The shop is: - Accessible via /crystal shop
- Fully configurable
- Independent of other Mirage currencies

💰 Player Commands

All player-facing Crystal commands require no permissions.

🔐 Staff Commands & Permissions

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

⚙ Configuration Overview

Crystals are designed to be safe to balance and highly configurable.

Common configuration options include: - Allowed mob types
- Crystal drop rates per mob
- Scaling per weapon level
- Enchant multipliers
- World or region restrictions

Crystals do not interfere with other Mirage currencies unless explicitly configured to do so.

🎯 Intended Use

Crystals are best used as: - A PvE progression currency
- A reward for active combat
- A cost for weapon upgrades
- A controlled alternative to mob-based money farms

They are ideal for: - Factions
- OP Prisons
- PvE-focused SMPs