# \ud83d\udc8e MysticalCurrency<\/p>\n
### Enterprise-grade Physical Currency, Lottery & Economy System for Paper 1.21.1<\/p>\n
Turn your Minecraft economy into a **real, tangible experience**.<\/p>\n
MysticalCurrency allows players to withdraw physical currency items, trade them in the world, and deposit them back into their Vault balance. Combined with a powerful lottery system, anomaly detection, advanced anti-dupe protection, and a live web dashboard \u2014 this is not just another economy plugin.<\/p>\n
It\u2019s a complete financial ecosystem for serious survival servers.<\/p>\n
—<\/p>\n
# \ud83d\ude80 Features Overview<\/p>\n
—<\/p>\n
## \ud83d\udcb0 Physical Currency System<\/p>\n
Bring money to life.<\/p>\n
– **4 fully configurable currency tiers**
\n – \ud83e\ude99 Shard (`IRON_NUGGET`, $0.01)
\n – \ud83d\udfe1 Coin (`GOLD_NUGGET`, $1)
\n – \ud83d\uddfa Banknote (`MAP`, $10)
\n – \ud83c\udfe6 Capital (`GOLD_INGOT`, $100)<\/p>\n
– Polished **Bank GUI**
\n – Step multipliers
\n – Custom withdraw amounts
\n – Deposit all \/ per-tier
\n – Inventory space validation (prevents failed withdrawals)<\/p>\n
– Player-to-player **money transfers**
\n– Full **Vault integration** (EssentialsX & any Vault-compatible economy)
\n– Optional inflation control system<\/p>\n
—<\/p>\n
## \ud83c\udfb0 Advanced Lottery System<\/p>\n
A fully featured, secure, configurable lottery framework.<\/p>\n
– Configurable ticket costs, jackpots & schedules
\n– **Progressive jackpot support**
\n– Suspense animations with countdown & sounds
\n– Secondary prize tiers (percentage-based)
\n– Soft & hard pity system
\n– Ticket expiry support
\n– Cron-based scheduled draws
\n– Physical, signed lottery tickets with right-click book preview
\n– Admin ticket distribution commands
\n– Lottery seasons with automatic stat archiving
\n– Weekly seasonal resets (configurable)<\/p>\n
—<\/p>\n
## \ud83d\udd12 Enterprise Security<\/p>\n
Built for high-population survival servers.<\/p>\n
– **HMAC-SHA256 signed currency & lottery tickets**
\n– Auto-generated secret key on first run
\n– Automatic invalid item removal
\n– Full interaction protection
\n– Anti multi-account detection (IP-hash based, optional)
\n– Anomaly detection with rate limiting:
\n – Withdraw spikes
\n – Transfer spikes
\n – Ticket purchase spikes
\n – Claim spikes
\n– Temporary auto-blocking on suspicious behavior
\n– Inventory space validation before withdrawals<\/p>\n
—<\/p>\n
## \ud83d\udcca Statistics & Leaderboards<\/p>\n
– Per-player tracking:
\n – Tickets bought
\n – Wins
\n – Money won
\n – Biggest win
\n – Deposits
\n – Withdrawals
\n – Transfers<\/p>\n
– Statistics GUI
\n– Leaderboards:
\n – Most wins
\n – Most money won
\n – Recent winners
\n– SQLite database (async queries, zero main-thread blocking)<\/p>\n
—<\/p>\n
## \ud83c\udf10 Multi-Language Support<\/p>\n
Full i18n system \u2014 **no translatable text in config.yml**<\/p>\n
Included languages:
\n– \ud83c\uddec\ud83c\udde7 English
\n– \ud83c\uddf3\ud83c\uddf1 Dutch (Nederlands)
\n– \ud83c\udde9\ud83c\uddea German (Deutsch)
\n– \ud83c\uddf5\ud83c\uddf9 Portuguese (Portugu\u00eas)<\/p>\n
Add new languages easily by placing a YAML file inside:<\/p>\n
plugins\/MysticalCurrency\/lang\/<\/p>\n
—<\/p>\n
## \ud83d\udd17 Integrations<\/p>\n
### PlaceholderAPI
\nLive updating placeholders:
\n– Active lottery
\n– Jackpot amount
\n– Top wins
\n– Top money
\n– Player stats
\n– Season info<\/p>\n
### Discord Webhooks
\nReceive structured embed notifications for:
\n– Draw results
\n– Winners
\n– Big transactions
\n– Exploit attempts
\n– Anomalies
\n– Season resets<\/p>\n
### Web Dashboard (Optional)
\n– REST API
\n– Token authentication
\n– Rate limiting
\n– Optional HTTPS\/SSL
\n– Async & performance-safe<\/p>\n
—<\/p>\n
## \u2699\ufe0f Economy Controls<\/p>\n
– Inflation control (dynamic tax brackets)
\n– Config migration system (safe updates)
\n– Automatic config backups
\n– Schema versioning
\n– Probability balancing system (optional)
\n– Anomaly detection thresholds fully configurable<\/p>\n
—<\/p>\n
# \ud83d\udce6 Requirements<\/p>\n
| Dependency | Required | Version |
\n|————|———-|———|
\n| Paper | \u2705 | 1.21.1+ |
\n| Java | \u2705 | 21+ |
\n| Vault | \u2705 | 1.7+ |
\n| Economy Plugin | \u2705 | Any Vault-compatible (e.g. EssentialsX) |
\n| PlaceholderAPI | \u274c | 2.11+ |<\/p>\n
—<\/p>\n
# \u2699\ufe0f Installation<\/p>\n
1. Download the latest `.jar`
\n2. Place it in your `plugins\/` folder
\n3. Start the server
\n4. Default config & language files generate automatically
\n5. HMAC secret key is auto-generated on first run
\n6. Set preferred language in `config.yml` \u2192 `general.locale`<\/p>\n
—<\/p>\n
# \ud83d\udcbb Commands<\/p>\n
## Player Commands<\/p>\n
| Command | Description | ## Admin Commands<\/p>\n | Command | Description | —<\/p>\n # \ud83d\udd10 Permissions<\/p>\n | Permission | Description | —<\/p>\n # \ud83e\uddf1 Built for Performance<\/p>\n – Async SQLite queries A brand new way of economy! This is next level!<\/p>\n","protected":false},"featured_media":108303,"template":"","meta":{"_minecraft_slug":"mysticalcurrency","_minecraft_project_id":"X1Qaqqr3","_minecraft_author":"mysticalcraft-ancientvipers","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":28,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"mysticalcurrency.zip","_minecraft_size_bytes":26918290,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:10:50.053269Z","_minecraft_date_created":"2026-03-04T21:53:02.743459Z","_minecraft_date_modified":"2026-03-04T06:04:25.719171Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/mysticalcurrency","_minecraft_icon_attachment_id":108303,"_minecraft_imported_at":"2026-06-06T06:18:41+00:00","_minecraft_import_hash":"e76559af85da470bcb52631d8f01649c","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,126,127,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-108302","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-management","mod_category-paper","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————|
\n| `\/bank` | Open Bank GUI |
\n| `\/bank withdraw
\n| `\/bank deposit [all|tier]` | Deposit currency |
\n| `\/bank transfer
\n| `\/bank balance` | Check balance |
\n| `\/bank stats` | View statistics |
\n| `\/lottery` | View active lottery |
\n| `\/lottery buy [amount]` | Buy ticket(s) |
\n| `\/lottery claim` | Claim prizes |
\n| `\/lottery stats [player]` | View lottery stats |<\/p>\n
\n|———|————|
\n| `\/mc reload` | Reload config & language |
\n| `\/mc migrate
\n| `\/mc backup now` | Backup config |
\n| `\/mc webhooktest` | Send test Discord webhook |
\n| `\/mc dashboard
\n| `\/lottery create
\n| `\/lottery start` | Start lottery |
\n| `\/lottery stop` | Cancel lottery |
\n| `\/lottery draw` | Force draw |
\n| `\/lottery give
\n| `\/lottery giveall` | Give tickets to all |
\n| `\/lottery season
\n|————|————|
\n| `mysticalcurrency.bank` | Access bank |
\n| `mysticalcurrency.lottery` | Access lottery |
\n| `mysticalcurrency.lottery.admin` | Lottery admin |
\n| `mysticalcurrency.admin` | Full admin |
\n| `mysticalcurrency.bypass.anomaly` | Bypass anomaly detection |
\n| `mysticalcurrency.antidupe.alert` | Receive anti-dupe alerts |<\/p>\n
\n– Async webhooks
\n– Async dashboard
\n– Zero main-thread blocking
\n– No memory leaks
\n– Optimized for 100+ player survival servers<\/p>\n","protected":false},"excerpt":{"rendered":"