PolyWallet (polymer)

🎰 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