Xgenia Slot Template Overview
The Xgenia Slot Template is a complete, ready-to-use foundation for building professional slot machine games. This template provides all essential components, functions, and connections needed to create a modern slot game experience.
Documentation Navigation Guide
For optimal understanding, read the documentation in this order:
- Overview (Current) → Understanding template purpose and architecture
- Layout → Visual structure and responsive design
- Components → Individual component details and connections
- Functions → Backend logic and API integrations
- Guide → Player experience and troubleshooting
Technical Architecture
System Requirements:
- Frontend: Modern web browser with JavaScript enabled
- Network: Stable internet connection (for API mode)
- Device: Desktop, tablet, or mobile with touch support
- Performance: Minimum 2GB RAM for optimal experience
Security Features:
- API Authentication: Session-based user authentication
- Random Number Generation: Certified RNG for fair gameplay
- Data Encryption: HTTPS communication for all API calls
- Balance Validation: Server-side balance verification
API Endpoints Structure:
Base URL: https://api.xgenia-slots.com/v1/
├── /auth/session → Player authentication
├── /game/config → Game configuration and assets
├── /spin/bet → Server-side spin processing
├── /balance/get → Balance inquiries
└── /exchange/rates → Currency conversion rates
How It Works
The template operates through a clear data flow system:
1. Game Initialization:
- GameID → Launch Game → Get Session → Asset Loading
2. Asset Management:
- Config JSON → Download Functions → Image Processing → Component Display
3. Gameplay Loop:
- Button Press → Bet Transactions → Result Processing → Symbol Display → UI Update
4. Connections Flow:
- From GameID → Provides "slot_classic_01" to identify which game to load
- From API → Provides Balance (1000 credits), Icons array, Music URL
- From User Input → SPIN button sends bet amount (10 credits) to server or local generator
- From Spin Options → LocalSpin boolean determines API vs Local TRNG generation
- From Server Response → Returns win amount (50 credits) and symbol results (API mode)
- From Local TRNG → Generates immediate results using client-side algorithms (Local mode)
Architecture Diagram
┌─────────────────────────────────────────────────────────────────┐
│ XGENIA SLOT TEMPLATE │
├─────────────────────┬───────────────────┬────────────────────────┤
│ PRESENTATION │ BUSINESS │ DATA │
│ LAYER │ LOGIC │ LAYER │
│ │ │ │
│ ┌─ UI Components │ ┌─ Game Engine │ ┌─ API Services │
│ │ • Header │ │ • Spin Logic │ │ • Authentication │
│ │ • Slot Frame │ │ • Bet Logic │ │ • Balance Service │
│ │ • Buttons │ │ • Win Logic │ │ • Asset Service │
│ │ • Audio │ │ • Session Mgmt │ │ • Exchange Rate │
│ │ │ │ │ │ │
│ ├─ Layout System │ ├─ Spin Modes │ ├─ Local Storage │
│ │ • Responsive │ │ • API Mode │ │ • Game State │
│ │ • Positioning │ │ • Local TRNG │ │ • Asset Cache │
│ │ • Animations │ │ • Validation │ │ • User Preferences │
│ └──────────────────│ └─────────────────│ └──────────────────────│
└─────────────────────┴───────────────────┴────────────────────────┘
Data Flow Architecture:
Node-Based Flow Structure:
┌─────────────────────────────────────────────────────────────────┐
│ NOODL NODE CONNECTIONS │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 1. INITIALIZATION PHASE │
│ ┌────────────┐ ┌─────────────┐ ┌──────────────┐ │
│ │ GameID │───▶│ Launch Game │───▶│ Get Session │ │
│ │ Variable │ │ Function │ │ Function │ │
│ └────────────┘ └─────────────┘ └──────┬───────┘ │
│ │ │
│ ┌─────────────┐ ┌──────▼───────┐ │
│ │ Download │◀───│ Get Config │ │
│ │ Assets │ │ JSON Function│ │
│ └─────────────┘ └──────────────┘ │
│ │
│ 2. GAMEPLAY PHASE │
│ ┌────────────┐ ┌─────────────┐ ┌──────────────┐ │
│ │ SPIN Button│───▶│Spin Options │───▶│ Bet Trans. │ │
│ │ Component │ │ Controller │ │ OR Local TRNG│ │
│ └────────────┘ └─────────────┘ └──────┬───────┘ │
│ │ │
│ ┌─────────────┐ ┌──────▼───────┐ │
│ │ UI Update │◀───│ Process │ │
│ │ Components │ │ Results │ │
│ └─────────────┘ └ ──────────────┘ │
│ │
│ 3. STATE MANAGEMENT │
│ ┌────────────┐ ┌─────────────┐ ┌──────────────┐ │
│ │ Balance │◀───│ Update │◀───│ Spin Result │ │
│ │ Variable │ │ State │ │ Data │ │
│ └────────────┘ └─────────────┘ └──────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
Function Node Connections:
- GameID Variable → Outputs to Launch Game Function
- Launch Game Function → Triggers Get Session Function
- Get Session Function → Outputs UserID, SessionID, Balance
- Get Config JSON Function → Outputs BackgroundURL, IconsArray, AudioURL
- Download Functions → Process asset URLs and output processed data
- Spin Options Controller → Routes to either Bet Transactions OR Local TRNG
- Result Processing → Updates Balance Variable and UI Components
Component Interaction Flow
The template follows a reactive architecture where components communicate through a centralized event system:
Event-Driven Communication:
User Action → Button Component → Game Logic → Data Layer → UI Update
↓ ↓ ↓ ↓ ↓
Click Event Process API/Local Refresh
SPIN Trigger Request Response Display
Error Handling Chain:
API Error → Error Handler → User Notification → Fallback Action
↓ ↓ ↓ ↓
Network Log Error Show Message Retry/Local
Timeout & Recover to Player Alternative
Template Components
Main Interface Elements:
- Header Display → Shows CREDIT, BET, and WIN amounts
- Control Buttons → BET, SPIN, BONUS action buttons
- Slot Frame → 5x3 grid displaying game symbols
- Audio System → Background music and sound effects
- Spin Options → Toggle between API and Local TRNG generation modes
Core Functions:
- Game Logic → Handles betting, spinning, and win calculations
- Asset Loading → Downloads backgrounds, symbols, and audio files
- Data Processing → Converts server results to visual symbols
- Session Management → Maintains player authentication and balance
- Currency Support → Real-time exchange rates for multi-currency display
- Dual Spin Modes → API server-side or Local TRNG client-side generation
Advanced Toolkit Functions:
The template includes comprehensive utility libraries for advanced game development:
Math and Logic Toolkit:
- Random Number Generation → Supports Local TRNG with configurable RTP
- Value Mapping and Clamping → For betting limits and animation scaling
- Easing Functions → Smooth animations for better user experience
- Color Blending → Dynamic visual effects for winning combinations
- Distance Calculations → Touch/mouse interaction detection
String and Data Manipulation:
- Array Operations → Shuffle, sample, group for game mechanics
- Object Processing → Clone, merge, filter for state management
- String Utilities → Validation, formatting, HTML sanitization
- JSON Processing → Safe parsing with error handling
Utility and Helpers:
- Validation Functions → Email, URL, number validation for user input
- Security Features → UUID generation, hash functions, Base64 encoding
- Browser Integration → DOM manipulation, cookie management, file operations
- Performance Optimization → Memory management and asset caching
Date and Time Management:
- Session Tracking → Play duration monitoring and break reminders
- Statistics Processing → Daily/monthly game data analysis
- Responsible Gaming → Time limits and session management
- Locale Support → Indonesian language date formatting
Who is it for?
This template is perfect for:
- Game developers who want a quick start for slot projects.
- Designers looking to customize the visual style of a slot game.
- Anyone interested in learning how slot games are structured and function.
How to Get Started
Explore the sections in this documentation to learn about the layout, components, functions, and how to play. You'll find step-by-step guides, feature explanations, and tips to help you make the most of the Xgenia Slot Template.
Enjoy building and playing your slot game!