♟ Chess — Fully Playable Chess for RedM

A complete, immersive chess experience built for Red Dead Redemption roleplay servers. Challenge a fellow outlaw to a game at the saloon, wager your hard-earned cash, and settle it over the board — all without ever leaving the game world.

---

🎮 Gameplay Features

• Full chess engine — every legal move enforced: castling, en passant, pawn promotion, check, checkmate, and stalemate
• Multiplayer via server relay — both players see moves in real time; colours assigned randomly each game
• Promotion picker — clean in-game UI to choose Queen, Rook, Bishop, or Knight on pawn promotion
• Material advantage display — captured pieces and score advantage shown above and below the board
• Check highlighting — king square turns red when in check
• Last-move highlight — previous move squares are always marked
• Legal-move dots — click a piece to see all valid destinations

⚔️ Game Management

• Draw offers — offer a draw in-game; opponent sees a notification bar at the bottom and can accept or decline without interrupting the game; accepting closes the UI for both players
• Resign — in-game confirmation modal (no browser popups) before forfeiting
• Spectator mode — bystanders can watch live games from the same table
• Idle-timeout auto-forfeit — configurable inactivity timer ends abandoned games automatically
• Disconnect handling — opponent is awarded the win if a player disconnects mid-game

💰 Betting System

• Optional cash betting — enable with a single config toggle
• Configurable min/max bet limits
• Winnings pulled directly from your framework's wallet (VORP or RSG)

🔧 Technical

• VORP Core & RSG Core compatible — switch frameworks with one line in config.lua
• Pure JS chess engine — no external libraries; all move validation runs client-side
• Western-themed NUI — dark wood tones, gold accents, serif fonts — fits seamlessly into any RDR2 RP server
• Escrow-safe config — config.lua is excluded from escrow so you can always edit table coords, betting settings, and framework selection
• Multi-table support — add as many chess tables as you want across your map
• oxmysql dependency is optional — remove one line and it's gone

---

📦 Installation

1. Drop the chess folder into your resources/ directory
2. Add ensure chess to your server.cfg
3. Open config.lua and set your framework and table coordinates
4. Restart — done

⚙️ Config Options

Key

Default

Description

Config.Framework

'VORP'

'VORP' or 'RSG'

Config.EnableBetting

false

Toggle cash betting on/off

Config.MinBet / MaxBet

1 / 500

Bet amount limits

Config.InteractDistance

2.5

Metres before [E] prompt appears

Config.EnableSpectate

true

Allow spectators

Config.IdleTimeout

600

Seconds before auto-forfeit (0 = off)

Config.DrawOfferTimeout

30

Seconds before a draw offer auto-declines

---

Built with a fully custom chess engine — no third-party chess libraries. Every move, rule, and edge case is handled natively.