🎰 Economy, Trading, and Casino Systems

A unified server-side economy and casino framework built for persistent multiplayer worlds, physical gameplay interactions, and vanilla-client compatibility.

This system combines a full SQLite-backed economy, merchant-style trading, casino games, NPC gamblers, and admin management tools into one connected package.

---

💰 Core Economy

A full persistent economy system designed for long-term worlds and reliable server-side operation.

Features

• Persistent wallet and account storage
• Multiple currencies with balances, transfers, and transaction history
• Admin audit tools with transaction rollback support
• First-run setup with /wallet setup ...
• Fast one-command initialization with /wallet quickstart
• Primary currency support with custom symbol and scale formatting

Player Wallet Access

Players can manage their funds through both commands and GUI systems:

• /wallet
• /wallet balance
• /wallet pay
• /wallet history

Optional Balance Display

Balances can also be shown through:

• Scoreboard
• Actionbar
• Bossbar

Admin Freeze Controls

Admins can freeze:

• Individual accounts
• Entire currencies

---

🛒 Trading and Money Items

Server-native money handling for shops, merchants, and casino exchange systems.

Trading Features

• Wallet Card item for merchant-style wallet transactions
• Market Stall workstation with villager-style trading UI
• Optional Digital Chest integration for market stalls
• Cash Clerk workstation reworked into a stationary villager merchant

Cash Clerk Modes

Cash Clerks can handle payout and input in:

• Currency
• Emeralds
• Diamonds

Casino Chip Support

• Fixed chip exchange ladder in both directions:
  • 1
  • 5
  • 10
  • 25
• Real casino chip items with denomination-specific visuals
• Admin chip issuing and management tools

---

🎲 Shared Casino Reward Modes

A unified reward and tender system across supported casino games.

Supported Reward / Tender Types

• Wallet currency
• Casino chips
• Emeralds
• Diamonds
• Loot / item payouts where supported

Safety Systems

• Overflow payout chest so item rewards are never lost
• Recovery ledgers for unresolved payouts after reconnects or restarts

---

🃏 Blackjack

A physical multiplayer blackjack experience with Polymer-powered vanilla compatibility.

Blackjack Features

• Physical blackjack tables with on-table visuals
• Persistent per-table 6-deck shoe
• Visible dealer shoe and card dealing presentation
• Main bet support plus side bets:
  • Perfect Pairs
  • 21+3
  • Insurance
• Direct on-felt betting with:
  • casino chips
  • emeralds
  • diamonds
• GUI betting flow with chip change-making
• Physical wager stacks rendered on the felt
• Vanilla interaction path and companion-mod interaction support
• Per-table configuration for:
  • limits
  • tender mode
  • currency
• Player action dashboard
• Betting and insurance GUIs
• Dealer entity and simulation/controller support

---

♠️ Poker

A dedicated Texas Hold’em system built for multiplayer table play.

Poker Features

• 6-player Texas Hold’em table
• Cash-game style buy-in, rebuy, and cash-out flow
• Blinds, betting rounds, community cards, showdown, and side pots
• Hidden private hole-card presentation
• Shared public board presentation
• Seat-based table interactions
• Polymer-powered vanilla-safe visuals
• Table bankroll GUI and configuration
• Dealer entity support

---

🎡 Roulette

A physical roulette implementation with persistent session handling.

Roulette Features

• Physical roulette table and wheel/display setup
• Direct felt interaction for bet placement
• Session manager for:
  • bet placement
  • spin handling
  • payout processing
  • recovery
• Supports configured tender modes:
  • wallet currency
  • casino chips
  • emeralds
  • diamonds
• Companion snapshot/networking support
• Visual table occupancy and chip rendering

---

🎰 Slots

Flexible slot machines with multiple themes and reward styles.

Slot Features

• Multiple themed slot machine variants
• Supports:
  • currency
  • casino chips
  • loot/item payout modes
• Multiline betting systems
• Per-player remembered settings
• Slot remote item
• Companion client support
• Structured spin result model including:
  • spin cost
  • gross payout
  • net result
  • winning lines

---

🧍 Casino NPCs

Bring the casino to life with autonomous villager-like patrons.

NPC Features

• Gambler / casino patron NPCs
• Persistent bankroll and chip stash tracking
• NPCs can find and use:
  • Cash Clerks
  • Blackjack tables
  • Poker tables
  • Roulette tables
  • Slot machines
• Admin spawn and control commands
• Vanilla-safe Polymer presentation
• Named patron list support

---

🛠 Commands and Admin Tools

Player Commands

• /wallet
• /wallet balance
• /wallet pay
• /wallet history
• /wallet display ...

Setup Commands

• /wallet setup ...
• /wallet quickstart

Admin Tools

• Give or take funds
• Give or take chips
• Give clerk workstation/items
• Gambler controls:
  • spawn
  • home
  • bankroll
  • chips
  • status
  • stop
• Freeze account
• Freeze currency
• Roll back transaction
• Audit player
• View audit log

---

🔗 Compatibility and Presentation

Designed for broad compatibility and immersive presentation on vanilla clients.

Compatibility Features

• Built around Polymer for vanilla-client compatibility
• Bundled generated assets, models, and language entries for wallet and casino content
• Uses native-style villager merchant flows where possible instead of chest UI
• Companion-side support for:
  • blackjack
  • roulette
  • slots