Black jack

Blackjack A full blackjack plugin for Rust (Oxide / uMod). Play against the dealer with real blackjack rules (double down, blackjack payout, configurable dealer stand), or go head-to-head against another player. Configurable currency, animated card table UI, sounds, leaderboard, and offline-safe payouts. Author: carl · Version: 1.0.0

Features VS Dealer — hit, stand, and double down against a dealer that plays by configurable rules (stands on 17, optional hit soft 17, multi-deck shoe). VS Player — challenge another online player head-to-head; closest to 21 wins the pot minus a configurable table tax, with a per-turn timer. Three currencies — Scrap (built in), Economics, or ServerRewards. Animated dealing, win/lose/push sounds, chat + on-screen messages. Per-player stats (wins/losses/pushes/blackjacks) and a /bj top leaderboard. Offline-safe: stakes and payouts owed to a disconnected player are refunded/settled, with scrap repaid on next login.

Chat Commands Default command is /blackjack with the alias /bj (both configurable). Command Description /blackjack or /bj Open the blackjack table. /bj accept Accept a pending challenge from another player. /bj decline (or /bj deny) Decline a pending challenge. /bj cancel Cancel your outgoing challenge (refunds your stake). /bj toggle Turn player-vs-player challenges to you on or off. /bj top (or /bj stats) Show the profit leaderboard (top 10). /bj help List the commands. In-table buttons (DEAL, HIT, STAND, DOUBLE DOWN, SEND CHALLENGE, REMATCH, FORFEIT/LOBBY, bet controls) drive blackjack.* console commands internally — you don't type those.

Permissions Permission Grants blackjack.use Open the table and play the dealer. blackjack.pvp Challenge other players (and be listed as a valid opponent). By default both are granted to the default group (toggle in config). Manual grant:

oxide.grant group default blackjack.use
oxide.grant group default blackjack.pvp

Configuration File: oxide/config/Blackjack.json General Setting Default Description Title BLACKJACK Header shown on the table. Command blackjack Primary chat command. CommandAlias bj Secondary chat command. ChatPrefix [Blackjack] Prefix on chat messages. GrantUseToDefaultGroup true Auto-grant blackjack.use to default. GrantPvpToDefaultGroup true Auto-grant blackjack.pvp to default. ChatResultMessages false Also print hand results in chat. ChatMatchMessages false Print PvP match/challenge status in chat. LogHandsToConsole false Log each hand to the server console. BlockWhileBuildingBlocked false Prevent play while building blocked. Bet Setting Default Description Currency Scrap Scrap, Economics, or ServerRewards. Min / Max 10 / 5000 Bet bounds. Step 25 Bet increment for +/-. Default 100 Starting bet. AllowBetAllIn true MAX button uses your balance (up to Max). Dealer Setting Default Description Enabled true Enable VS Dealer mode. DeckCount 6 Number of decks in the shoe (1–12). PayoutMultiplier 2.0 Normal win pays bet × this. BlackjackMultiplier 2.5 Natural blackjack pays bet × this (3:2). StandsOn 17 Dealer stands on this total (12–21). HitsSoft17 false Dealer hits a soft 17. AllowDoubleDown true Allow doubling on the first two cards. CooldownSeconds 2 Delay between hands. MaxHandsPerDay 0 Daily cap per player (0 = unlimited). AnnounceWinsAbove 0 Broadcast wins with profit ≥ this (0 = off). PvP Setting Default Description Enabled true Enable VS Player mode. TaxPercent 5 House cut taken from the pot. ChallengeTimeoutSeconds 45 How long a challenge waits for a response. TurnSeconds 30 Time limit per turn (auto-stands on timeout). CooldownSeconds 5 Delay between challenges. RequireTargetPermission true Target must hold blackjack.pvp. AllowTeammates true Allow challenging teammates. CursorPopupForTarget false Show a cursor popup to the challenged player. ResultHoldSeconds 25 How long the finished match stays on screen. BroadcastResults false Announce PvP results to everyone. AnnounceWinsAbove 0 Broadcast PvP wins above this profit. Also configurable: cards (suit symbols, face/back colors, red/black suit colors, deal speed), sounds, theme colors / background image (optional ImageLibrary), and CurrencyNames (display labels for each currency).

How PvP Plays Head-to-head is turn-based with a per-turn timer: players take turns hitting or standing, and when both are done the higher hand (closest to 21 without busting; natural blackjack beats a plain 21) wins the pot minus the table tax. A push returns both stakes. Leaving mid-hand forfeits to your opponent.

Economy Integrations Scrap — built in, no dependency. Economics — install the Economics plugin, set Currency to Economics. ServerRewards — install ServerRewards, set Currency to ServerRewards. Stakes are taken when a hand/challenge starts and paid on result. If a player is offline when a payout is due, Economics/ServerRewards settle by their ID and scrap is stored and repaid on next login.

Notes A player can't start a dealer hand while they have a pending PvP challenge (prevents a table being stranded when the challenge is accepted). If your card suit symbols show as blank boxes in-game, set Cards.SuitSymbols to ["S","H","D","C"] (some Rust fonts don't include ♠♥♦♣ glyphs). Stats and owed payouts persist in oxide/data/Blackjack.json.