Coin Flip

Coin Flip A polished coin-flip gambling plugin for Rust (Oxide / uMod). Bet against the house on a 50/50 (with a configurable edge and payout), or challenge another player head-to-head. Fully configurable currency, payouts, animated coin UI, sounds, leaderboard, and offline-safe payouts. Author: carl · Version: 1.0.0

Features VS Server — flip against the house with a configurable win chance, payout multiplier, cooldown, and optional daily limit. VS Player — challenge another online player; winner takes the pot minus a configurable table tax. Three currencies — Scrap (built in), Economics, or ServerRewards. Animated flipping coin, win/lose sounds, chat + on-screen result popups. Per-player stats and a /cf top profit leaderboard. Offline-safe: fares/payouts owed to a disconnected player are settled on their next login.

Chat Commands Default command is /coinflip with the alias /cf (both configurable). Command Description /coinflip or /cf Open the coin flip menu. /cf accept Accept a pending challenge from another player. /cf decline (or /cf deny) Decline a pending challenge. /cf cancel Cancel your outgoing challenge (refunds your stake). /cf toggle Turn player-vs-player challenges to you on or off. /cf top (or /cf stats) Show the profit leaderboard (top 10). /cf help List the commands. The in-menu buttons (side selection, bet +/-, MAX, FLIP, SEND CHALLENGE, etc.) drive coinflip.* console commands internally — you don't need to type those.

Permissions Permission Grants coinflip.use Open the menu and flip against the server. coinflip.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 coinflip.use
oxide.grant group default coinflip.pvp

Configuration File: oxide/config/CoinFlip.json General Setting Default Description Title COIN FLIP Header shown on the menu. Command coinflip Primary chat command. CommandAlias cf Secondary chat command. ChatPrefix [Coin Flip] Prefix on chat messages. GrantUseToDefaultGroup true Auto-grant coinflip.use to default. GrantPvpToDefaultGroup true Auto-grant coinflip.pvp to default. LogFlipsToConsole false Log each flip to the server console. ChatResultMessages false Also print win/lose results in chat. 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). Server Game Setting Default Description Enabled true Enable VS Server mode. WinChancePercent 47.5 Player win chance (house edge below 50%). PayoutMultiplier 2.0 Win pays bet × this (2.0 = double). CooldownSeconds 3 Delay between flips. MaxFlipsPerDay 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. CooldownSeconds 5 Delay between challenges. RequireTargetPermission true Target must hold coinflip.pvp. AllowTeammates true Allow challenging teammates. CursorPopupForTarget false Show a cursor popup to the challenged player. ResultPopupSeconds 7 How long the result popup stays. BroadcastResults true Announce PvP results to everyone. AnnounceWinsAbove 0 Broadcast PvP wins above this profit. Also configurable: coin faces (display name, item icon, skin, image URL, colors), sounds, theme colors / background image (optional ImageLibrary), and CurrencyNames (display labels for each currency).

Economy Integrations Scrap — built in, no dependency. Economics — install the Economics plugin, set Currency to Economics. ServerRewards — install ServerRewards, set Currency to ServerRewards. Bets are taken up front (escrow) 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 Win chance under 50% + a 2× payout is the house edge — tune WinChancePercent and PayoutMultiplier to set your margin. A player can't flip the server while they have a pending PvP challenge (prevents a payout conflict). Stats and owed payouts persist in oxide/data/CoinFlip.json.