🎰 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

PolyWallet (Polymer)