Documentation
🎮 Games Guide
Complete guide for Match'n Gacha and RhythmMech gameplay
Games Guide📊 Regression Tester Pro
Complete user guide for the testing management platform
User Guide📈 MSR Generator
User guide for the automated report generation platform
User GuideQuick Links
Initial Setup
Point the following domains to your server:
playtopia.com.au*.playtopia.com.au
2. Update Environment Variables
Edit the .env file to customize:
- Email for SSL certificates
- Passwords and secrets
- Timezone settings
3. Start Services
cd playtopia-dev
docker-compose up -d
Security Configuration
Change Default Passwords
- Update user passwords in
config/authelia/users_database.yml - Generate new hashes:
docker run --rm authelia/authelia:latest authelia hash-password --password your-password - Update secrets in
.env file
SSL Certificates
- Certificates are automatically generated via Let’s Encrypt
- Development uses staging environment (change in docker-compose.yml for production)
Troubleshooting
Check Logs
docker-compose logs [service-name]
Access Container
docker exec -it [container-name] sh
Restart Services
docker-compose restart [service-name]
🎮 Games User Guide - Match’n Gacha & RhythmMech
Overview
This guide covers gameplay mechanics, strategies, and advanced features for Playtopia’s premium puzzle and rhythm games: Match’n Gacha and RhythmMech.
🎲 Match’n Gacha - Complete Strategy Guide
Game Basics
Match’n Gacha is a professional-grade block-matching puzzle game that combines addictive match-3 mechanics with a revolutionary token economy and risk/reward psychology.
Core Mechanics
- Grid Size: 8x10 playing field with 60px blocks
- Block Types: 6 colored elements (red, blue, green, yellow, purple, orange)
- Match Types: Lines (3+), Squares (4), Rectangles (6), L/T shapes
- Physics: Gravity-based cascading with combo scoring
- Objectives: Complete level goals within move limits
Power-up System Mastery
💥 Bomb Blocks (Created from 2x2 matches)
- Activation: Tap/click the bomb block
- Effect: Destroys 3x3 area around activation point
- Strategy: Position bombs near clusters for maximum clear
- Combo Potential: Can trigger chain reactions with other power-ups
🚀 Rocket Blocks (Created from 4+ line matches)
- Activation: Tap/click the rocket block
- Effect: Clears entire row AND column simultaneously
- Strategy: Best used when row/column has many target blocks
- Positioning: Consider both horizontal and vertical impact
🌈 Rainbow Blocks (Created from 5+ line matches)
- Activation: Tap/click the rainbow block
- Effect: Removes ALL blocks of the activated color
- Strategy: Target the most abundant color for maximum impact
- Objective Use: Excellent for color-specific level goals
Power-up Combinations
- Bomb + Rocket: Creates cross-shaped explosion pattern
- Rocket + Rainbow: Clears all blocks of rocket’s row/column colors
- Rainbow + Rainbow: Clears entire board (rare but devastating)
Revolutionary Token Economy
Token Earning System
Base Earning: 1 Token per completed level objective
Bonus Opportunities: Double-or-nothing wagering system
Risk/Reward: Compound wagering for exponential gains
Persistence: Tokens saved automatically via LocalStorage
Double-or-Nothing Mechanics
After completing any level objective:
📊 Regression Tester Pro - User Guide
Overview
Regression Tester Pro (RTP) is a comprehensive testing management platform that standardizes test case creation and execution tracking across teams. This guide covers all aspects of using the platform effectively.
🚀 Getting Started
- Navigate to RTP: Visit https://rtp.playtopia.com.au
- Authentication: Log in using your Authelia credentials
- Dashboard: You’ll land on the main dashboard showing testing overview
User Roles & Permissions
- Admin: Full access to all features, user management, system settings
- Manager: Create/edit testing templates and instances, view all reports
- User: Create testing instances from templates, execute tests, view own reports
📋 Testing Templates
Creating Testing Templates
Testing templates are reusable structures that define the fields and format for testing instances.
🔬 Playtopia Dev Lab - Infrastructure Guide
Overview
Playtopia Dev Lab is a comprehensive containerized development environment that enables rapid deployment of web services with enterprise-grade security, automatic SSL, and authentication. This guide covers accessing and using the development infrastructure.
🚀 Getting Started
Accessing Dev Lab Services
Public Services (No Authentication Required)
Protected Services (Authentication Required)
Authentication System
Authelia Access Control
Playtopia Dev Lab uses Authelia for enterprise-grade authentication with three access levels:
Match’n Gacha Admin Guide 🔧⚙️
“With great power comes great responsibility… to make cool themes” - Admin Spider-Man, probably
Welcome to the admin side of Match’n Gacha! This guide covers everything you need to know about managing themes, collectible assets, and system configuration. Perfect for when you want to add that kawaii cat theme or introduce limited-edition collectibles.
🎨 Theme Management System
Theme File Structure
Themes are stored as JSON manifests in /public/data/themes/. Each theme defines colors, visual styles, and asset mappings.
Match’n Gacha Player Guide 🎮✨
“Believe in the power of the blocks!” - Every anime protagonist ever, probably
Welcome, future Match Master! Ready to embark on an epic quest where tetris blocks meet Trading Card Game addiction? Let’s dive into the world of Match’n Gacha - where every match could be your ticket to legendary status!
🎯 How to Play
The Basics (AKA “How Not to Fail Spectacularly”)
Match’n Gacha is like Tetris and Pokémon had a beautiful, block-shaped baby. Your mission, should you choose to accept it (and avoid disappointing Sensei), is to: