TON Gaming Suite

Support the project. If you launch this script in production please consider sending a tip on the TON network: UQDD3Ocxd97NJIq81GVvJb7noy0RZiQfXTjCMgwm-2bKackD.

Need custom features or help deploying? Reach out on Telegram—I'm happy to extend the codebase, integrate new games, or tailor the back-office for your operation. The live bot with the production-ready flow is available at t.me/TonGamesHubBot.

Table of Contents

• Overview
• Key Features
• Available Games
• Player Experience
• Admin Panel
• Technology Stack
• Project Structure
• Local Development

Overview

TON Gaming Suite is a Laravel + Livewire based multi-product gaming platform for TON communities. It ships with a real-time Node.js game server, Ambassador and referral programs, scheduled campaigns, and a management console that allows operators to monitor the entire ecosystem from a single dashboard.

The codebase is structured for quick takeover—bring your own branding, connect your payment rails, and you are ready to start accepting players. All player-facing screens use real-time websockets, so balances, bets, and chat stay synchronized across the product line.

Key Features

• All-in-one hub: crash, jackpot, roulette, coinflip, sportsbook tickets, automated tasks, and GEMS airdrops live under one navigation.
• Wallet-first onboarding: TON-based balances with JWT-secured websocket sessions and Telegram-powered login flows.
• Retention & growth tooling: referral links, ambassador revenue sharing, scheduled mass-messages, and configurable tasks that reward users for activity.
• Real-time engine: shared Socket.IO server keeps bets, chats, timers, and round state consistent without page refreshes.
• Production-ready operations: audit trails, anti multi-account safeguards, ledger exports, and configurable settings for house edges or bet limits.

Available Games

Below are the core games included out of the box—each screenshot is available in the repository for reference and marketing.

Crash

Fast-paced multiplier growth with join, cash-out, and round history updated in real time.

Jackpot

Players deposit tickets into shared pots while live chat, timers, and winner reveals keep engagement high.

Roulette

Classic three-column roulette experience backed by provably fair rolls and bet tracking.

Coinflip

Head-to-head coinflips with instant settlements and recent history widgets.

Sportsbook Bets & Tasks

Sportsbook slips, mission-based tasks, and GEMS rewards help diversify engagement.

Player Experience

• Unified wallet: all games share the same GEMS balance and ledger entries.
• Instant feedback: Livewire components keep bet buttons, history, and leaderboards in sync with the websocket server.
• Reward loops: airdrops, referrals, and ambassador earnings automatically update as players progress.
• Mobile friendly: Tailwind + Vite assets ensure responsive layouts across devices.

Admin Panel

Operate the entire platform from the back-office suite.

• Dashboard intelligence: monitor balances, wager volumes, player registrations, and seven-day trendlines per product.
• User management: search, ban, adjust balances, and review activity logs with anti multi-account tooling.
• Game tuning: configure odds, house edge, min/max bet limits, and scheduled events per game.
• Marketing automation: compose mass messages with media, set send windows, and preview before launch.
• Ambassador & referrals: manage revenue splits, approve payouts, and inspect historical distributions.

Technology Stack

• Backend: Laravel 12, PHP 8.2, Livewire 3, Redis queues, Firebase JWT, ElephantIO, Imagick.
• Realtime server: Node.js with Express, Socket.IO, JWT authentication, Winston logging, and recovery endpoints.
• Frontend: Vite, TailwindCSS, Alpine.js, Axios, TonConnect UI widgets, and localized Blade templates.
• Integrations: Telegram login/bot webhooks, TON blockchain payments, and referral confirmation services.

Project Structure

Key directories to explore:

app/             # Laravel application logic, Livewire components, models
resources/       # Blade templates, Livewire views, Tailwind styles
server/          # Node.js Socket.IO engine powering Crash & Jackpot
routes/          # Web and API routes (player + admin prefixes)
docs/            # Additional technical documentation and onboarding guides

Local Development

1. Install dependencies

   composer install
   npm install

2. Configure environment
   • Duplicate .env.example to .env and update database, Redis, and TON credentials.
   • Run php artisan key:generate.
3. Build & run

   php artisan migrate --seed
   php artisan serve
   npm run dev
   node server/JackpotServer.js

4. Login & test
   • Access the web panel at http://localhost:8000.
   • Register via Telegram OAuth or seeded admin credentials.
   • Open multiple tabs to see real-time bet synchronization.

You're now ready to customize the suite for your community. Reach out if you want to extend the platform with new games, KYC providers, or custom payment flows.