🧩 Custom games

Custom games let you build your own themed line slots from the GoldLine Admin dashboard. You pick a certified math profile, assign images and optional sounds, tune layout/colors in Live Tune, then publish so the game appears on slot machines.

What Custom games are

• Admin-created slot titles (not a separate paid mini-game like Orbit/Plinko).
• Stored as drafts until you publish; published games register through the custom slot engine.
• Each game uses a fixed math profile (lines + grid + RTP) plus your theme assets and bet list.
• Custom titles are machine-only (not available in the phone lobby app).

Requirements

tgg-slots-custom depends on tgg-slots-server and must be started. If the engine is down, Custom Slots actions fail with an error that tgg-slots-custom is unavailable.

Also required for admin use:

• Admin ACE + command permission (same as the rest of the admin dashboard).
• Theme files you want to use, placed under tgg-slots-custom/assets/ (see Assets).

How to open Custom Slots

1. Open the admin dashboard:
   • Run /slotdashboard, or
   • Open an in-world machine lobby (account is auto-resolved); as ACE admin, use the admin icon / Machine Metrics entry.
   • Not available from the phone lobby app.
2. Select the Custom Slots tab.

You should see the game list (draft / published / archived), KPIs, and Create.

Create → configure → publish

High-level flow supported by the UI:

1. Create a draft

Click Create. The wizard opens on Name & bets.

2. Name, math profile, and bets

• Enter a display name (this also generates the game type / slug).
• Choose a math profile (see Math profiles & RTP).
• Set bet options (at least one valid amount). New drafts start from the server default bet ladder when you do not change them.

You can Save draft at any step. Draft edits stay in authoring until you publish.

3. Theme images

Assign files from the asset library (scanned from tgg-slots-custom/assets/).

Required before publish:

• Reel symbols: scatter, wild, high 1, mid 1, mid 2, low 1, low 2, low 3
• Logo and thumbnail

Optional:

• Background, reel background, machine screen

Filenames do not need to match slot names — pick any scanned image for each slot.

4. Sounds (optional)

Map gameplay events (spin, reel stop, wins, free spins, etc.) to audio files from tgg-slots-custom/assets/ (WebM / WAV / OGG / MP3).
Unassigned events play no sound. Mapped files must still exist in the library.

5. Live Tune & publish

• Live Tune opens the real custom-game UI with a floating editor (layout / theme colors).
  Needs reel symbols + logo first. Archived games cannot be Live Tuned.
• Publish makes the game available on machines (writes a published snapshot and registers it).
  Publish needs all required image slots assigned to files that still exist in the library.
• Archive takes a game out of the published set (frees a publish slot). Archived games cannot be published again from the current UI path.

Statuses you will see: draft, published, archived.

Limits

Math profiles & RTP

The admin UI exposes a Math profile dropdown. Only these certified profiles are allowed:

Both include free spins. The UI labels them as certified profiles — choose before first publish; you cannot change math afterward.

Assets (images & sounds)

1. Drop image files (PNG / WebP / JPG) and/or audio (WebM / WAV / OGG / MP3) anywhere under tgg-slots-custom/assets/ (root or subfolders).
2. Restart tgg-slots-custom (txAdmin restart / ensure tgg-slots-custom).
3. New files appear in the Custom Slots pickers only after that restart.

See also tgg-slots-custom/assets/README.md in the resource.

Ensure order & restarts

In server.cfg, start the custom engine after the core (same order as Installation):

lua
Copy
ensure tgg-slots-server
-- … other slot games …
ensure tgg-slots-custom

• tgg-slots-custom must be running for create/edit/publish, asset/sound libraries, Live Tune, and play.
• After adding or replacing files in assets/, restart tgg-slots-custom so the library rescans.
• Changing admin ACE / related tgg-slots-server config still requires a tgg-slots-server restart as usual.

Related docs

• Admin dashboard — permissions and /slotdashboard
• Installation — full ensure order
• Games — shipped titles + link back here