> For the complete documentation index, see [llms.txt](https://docs.sirecstudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sirecstudio.com/ss-slotmachine.md).

# SS-SlotMachine

SS-SlotMachine documentation

## Overview

**SS-SlotMachine** is a premium RedM casino slot machine with a **fully server-side, real-casino payout engine**. The house edge is mathematically guaranteed, the payout behavior **scales automatically to your server economy**, and the whole game logic runs on the server — nothing a cheater can touch.

Each machine is a living machine with its own **persistent bank**: it pays only from what it has eaten, builds up over time, and periodically enters a **BONUS (wild) mode** that empties its bank in a rain of jollies.

## Main Features

* **Slot Machine Interface**
  * Beautiful western-style NUI — 5 reels, 6 symbols, animated lever, paytable, and sounds.
  * Map blips per machine (optional), busy-machine protection, safe cleanup on disconnect / restart.
* **100% Server-Side Game Engine**
  * The server generates every spin, computes every win and pays out; the UI only plays the animation.
  * There is no client event that can be exploited to receive money.
* **Real Casino RTP System**
  * The house keeps a configurable edge (default **8%**) from every bet; the remaining **92% always returns to the players**.
  * Just like a real casino: many players win their session, the house wins the month — guaranteed.
* **Scales To Any Economy Automatically**
  * Every payout threshold is a multiple of your **highest bet**.
  * Whether your server plays with $1–$25 or $10–$500 bets, the machine behaves identically — same win frequency, same bonus frequency, same return.
* **Living Machines With Persistent Banks**
  * Each machine has its own bank stored in the database (survives restarts).
  * Wins are paid **only from the machine bank** — a machine can never pay money it has not eaten first.
  * When the bank fills up, the machine enters **BONUS mode** with frequent jollies until the bank drains back down.
* **Anti-Cheat Protection**
  * Server validates machine occupancy, physical distance, and the bet whitelist on every spin.
  * One machine per player; wins are hard-capped at the machine bank.
* **Discord Webhook Logs**
  * Player enter / exit logs with balance.
  * **Big win alerts** for every win of at least a configurable multiple of the bet.
* **Zero Database Setup**
  * The `ss_slotmachine` table is **created automatically at startup** — no manual SQL import needed.
* **Integrations**
  * Required integration with `SS-Core`; database storage through `ghmattimysql`.
  * Notifications through `SS-Notify` (or plug in your own notify system with one function).
* **Multi-Language Support**
  * Lua translations and UI translations, driven by one setting.
  * Default language support for `EN`, `RO`, `IT`, `DE`, `FR`, `ES`, and `PT`.