9DTTT Game Platform
╔══════════════════════════════════════════════════════════════╗
║ ║
║ ██████╗ █████╗ ███████╗████████╗██╗ ██████╗ ███╗ ██╗ ║
║ ██╔══██╗██╔══██╗██╔════╝╚══██╔══╝██║██╔═══██╗████╗ ██║ ║
║ ██████╔╝███████║███████╗ ██║ ██║██║ ██║██╔██╗ ██║ ║
║ ██╔══██╗██╔══██║╚════██║ ██║ ██║██║ ██║██║╚██╗██║ ║
║ ██████╔╝██║ ██║███████║ ██║ ██║╚██████╔╝██║ ╚████║ ║
║ ╚═════╝ ╚═╝ ╚═╝╚══════╝ ╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═══╝ ║
║ ║
║ Q U A R T E T S T U D I O S ║
║ ║
╚══════════════════════════════════════════════════════════════╝
A Bastion Quartet Production
Strategic multiplayer gaming platform featuring accessible and competitive games
🎮 About
Version 2.0 - Full Stack Edition 🚀
9DTTT (Nine Dimensional Tic-Tac-Toe Tournament Tournament Tournament) is the XRP Layer of the AtomicFizzCaps.xyz ecosystem - a comprehensive full-stack game platform featuring 31 games, complete backend API, and cross-chain token integration.
🌐 Ecosystem Role
9dttt.com is part of the broader Unwrenchable project portfolio:
Gaming & Token Economy:
- Primary Hub: atomicfizzcaps.xyz - Solana SPL token (already deployed on testnet)
- XRP Layer: 9dttt.com (this repo) - Provides XRP Ledger integration and gaming portal (31 games)
- Shared Economy: Same FIZZ token across both chains via bridge
Social & Community:
Healthcare & Utilities:
See ECOSYSTEM_ARCHITECTURE.md for complete portfolio architecture and integration details.
🆕 What's New in v2.0
Full-Stack Architecture
- ✅ Vercel-Ready Deployment - One-command serverless deployment
- ✅ Real API Backend - RESTful endpoints for auth, leaderboards, stats, and progress
- ✅ Admin Dashboard - Real-time platform monitoring at
/admin.html
- ✅ Cloud Sync - Player progress saves across devices
- ✅ JWT Authentication - Secure login with guest mode fallback
Enhanced Crypto Quest Academy
Completely rebuilt with actual interactive gameplay instead of text screens:
- 🎮 Mining Simulator - Click-to-mine with real hashrate upgrades
- ⛓️ Blockchain Builder - Visually build and validate blockchain
- 👛 Wallet Creator - Generate realistic wallets with seed phrases
- 📈 Trading Academy - Live charts, buy/sell tokens, manage portfolio
- 🛡️ Scam Detector - Interactive quiz to identify crypto scams
- 🎨 NFT Studio - Create and mint NFTs (coming soon)
- 💰 DeFi Farming - Stake and earn yield (coming soon)
- 🏛️ DAO Builder - Create governance proposals (coming soon)
3D Holographic Gaming Revolution
Flagship game upgraded to AAA quality with Babylon.js 3D engine:
- 🌌 Immersive 3D Boards - 9 floating holographic tic-tac-toe boards in cyber-space
- ⚡ Particle Effects - Dynamic visual feedback for moves and board transitions
- 🎥 Smooth Animations - Camera fly-throughs and orbital controls
- 💫 Win Celebrations - Spectacular particle explosions and screen effects
- 🔄 Mode Toggle - Instant switch between classic 2D and 3D holographic modes
- 📱 Performance Optimized - Scales beautifully on mobile and desktop
API Endpoints
GET /api/health - Health check
GET /api/stats - Platform statistics
GET /api/leaderboard - Global leaderboard
POST /api/leaderboard - Submit high score
POST /api/auth/login - Login/register
GET /api/crypto-quest/progress - Load player progress
POST /api/crypto-quest/progress - Save player progress
GET /api/caps/balance - Get player's CAPS balance
POST /api/caps/redeem - Redeem CAPS for real tokens (triggers XRP mechanics)
Quick Deploy to Vercel
npm install -g vercel
vercel --prod
See README_DEPLOYMENT.md for detailed deployment guide.
Original Platform Description
9DTTT is a real-time multiplayer game platform developed by Bastion Quartet. Our mission is to create engaging, accessible, and strategic games that bring players together.
Features
- 🎯 Real-time Multiplayer - Challenge friends or find opponents worldwide
- 💬 In-Game Chat - Communicate with opponents and the community
- 🏆 Leaderboards - Compete for the top spot
- 👤 Player Profiles - Custom avatars, stats tracking, and achievements
- 🖼️ Avatar Uploads - Upload your own profile picture (JPEG, PNG, GIF, WebP)
- 🔐 Multi-Chain Wallet Auth - Sign in with XRP, Solana, or Ethereum wallets (Quick Start)
- 🛡️ Safe Community - Comprehensive moderation and anti-abuse systems
- ♿ Fully Accessible - Keyboard navigation, screen reader support, and more
- 🎨 Cosmetics - Unlock avatar frames, board themes, and player icons
- 💰 Player-Friendly Monetization - Ad-free base experience with optional rewards
- 🌌 3D Holographic Gaming - Flagship 9D Tic-Tac-Toe with stunning Babylon.js 3D effects
- 🔄 Dual Rendering Modes - Switch between classic 2D and immersive 3D gameplay
- 🪙 CAPS Reward System - Earn Atomic Fizz CAPS tokens that trigger XRP mechanics
- 🔄 Cross-Multichain Bridge - CAPS flows between Solana, XRP, and Ethereum chains
CAPS Token Rewards
Atomic Fizz Integration: CAPS is the reward token from the Atomic Fizz ecosystem that powers cross-multichain gaming.
🎮 Earning CAPS
- Win Games: 50 CAPS for Ultimate Tic-Tac-Toe, 25 CAPS for other games
- Participation: 10-15 CAPS for draws and forfeits
- Tournaments: Bonus CAPS for competitive play
- Daily Login: 5-10 CAPS for daily activity
🔄 XRP Mechanics Trigger
When you earn CAPS, it activates XRP Ledger features:
- DEX Trading: Unlock decentralized exchange access
- NFT Minting: Create gaming achievements as NFTs
- Staking: Earn yield by staking CAPS
- Governance: Vote on platform decisions
- DeFi: Access lending and borrowing protocols
💱 Token Redemption
- Exchange Rate: 10 CAPS = 1 real CAPS token
- Treasury Distribution: Tokens sent from Atomic Fizz treasury
- Multi-Chain: Redeem on Solana, XRP, or Ethereum
- No Minting: Fixed 77M supply, treasury-based distribution
🎮 Current Games
Ultimate Tic-Tac-Toe (9D TTT) ⭐ FLAGSHIP GAME
Now featuring holographic 3D gameplay! Experience the strategic 9-board tic-tac-toe in stunning 3D space.
🎮 Core Gameplay
A strategic 9-board tic-tac-toe where your move determines your opponent's next board!
| Feature | Description |
|---|
| Players | 2 |
| Boards | 9 mini-boards in a 3×3 grid |
| Rule | Your cell choice sends opponent to that board |
| Scoring | Points = moves in section when won (max 9 per section) |
| Max Points | 81 total (9 sections × 9 moves) |
| Win Condition | Most points when all sections complete |
✨ 3D Holographic Upgrade
- 🌌 Floating Boards: 9 semi-transparent holographic boards in dark cyber-space
- ⚡ Particle Effects: Dynamic trails when moves "send" opponents to new boards
- 🎥 Smooth Camera: Automatic fly-through transitions between active boards
- 💫 Visual Feedback: Pulsing glows, screen shake, and win celebrations
- 🎮 Interactive 3D: Mouse/controller orbit, zoom, and click-to-play
- 🔄 Mode Toggle: Switch between "Classic 2D" and "3D Holographic" anytime
- 📱 Mobile Optimized: Touch controls with performance scaling
🎯 Why It Matters
The 3D upgrade transforms 9DTTT from a clever strategy game into a visually stunning AAA experience while preserving the core gameplay that makes it unique. Experience the future of board games!
Other Games (31 Total)
- 🎲 4D Chess - Mind-bending spatial strategy
- 🧩 Quantum Sudoku - Logic puzzles with quantum twists
- 🎯 Dimensional Dice - Multi-dimensional dice rolling
- 🌀 Recursive Maze - Infinitely nested maze navigation
- 🔮 Crystal Connect - Gem-matching with dimensional shifts
- 🎮 Air Hockey - Fast-paced arcade action
- 🏓 Pong - Classic paddle battles
- 🎪 Carnival Shooter - Retro arcade shooting gallery
- 🐉 Dragon Fist - Beat-em-up fighter
- 🏆 Tournament Fighters - Competitive fighting game
- 🧠 Brain Academy - Puzzle and brain training games
- 🎨 Memory Game - Pattern matching challenges
- ✂️ Rock Paper Scissors - Classic hand game
- 🎲 Farkle - Dice rolling strategy
- 🏀 Basketball - Arcade basketball
- 🏈 Football - American football simulation
- ⚽ Soccer - International football
- 🏒 Hockey - Ice hockey action
- 🎳 Bowling - Ten-pin bowling
- 🎯 Darts - Pub darts simulation
- 🏓 Table Tennis - Ping pong action
- 🎲 Dice Games - Various dice-based games
- 🃏 Card Games - Classic card games
- 🎪 Mini-Games - Quick arcade challenges
🚀 Quick Start
Deploy to Render (Recommended)
- Fork this repository
- Create a new Web Service on Render
- Connect your GitHub repo
- Configure:
- Runtime: Node
- Build Command:
npm install
- Start Command:
npm start
- Instance Type: Free (or higher for production)
- Add environment variables (see below)
- Deploy!
Local Development
# Clone the repository
git clone https://github.com/Unwrenchable/9dttt.git
cd 9dttt
# Install dependencies
npm install
# Start the server
npm start
# Visit http://localhost:3000
⚙️ Configuration
Environment Variables
| Variable | Description | Required |
|---|
PORT | Server port (default: 3000) | No |
NODE_ENV | Environment (development/production) | No |
JWT_SECRET | Secret for JWT tokens | Yes (production) |
REDIS_URL | Redis connection URL for persistence | No |
RENDER_EXTERNAL_URL | Your Render app URL (for keep-alive) | No |
Authentication Methods
The platform supports multiple authentication methods without requiring any external services:
-
📧 Email & Password - Traditional registration and login
- Stored securely with bcrypt hashing
- No setup required
-
🦊 Web3 Wallet Authentication - Perfect for crypto gaming!
- MetaMask (Ethereum)
- Phantom (Solana)
- XUMM/Crossmark (XRP)
- No API keys or setup required
-
👤 Guest Mode - Instant access without registration
- Perfect for trying games
- Progress saved locally
All authentication methods work out of the box. Just install dependencies and start the server!
See QUICK_START_NO_FIREBASE.md for a simple setup guide.
💰 Monetization
Our player-friendly monetization philosophy:
| Feature | Description |
|---|
| Base Experience | Completely ad-free - no forced ads ever |
| Rewarded Ads | Optional: Watch ad → 1 hour ad-free, XP boost, or cosmetic |
| Battle Pass | Free, Premium ($4.99), Ultimate ($9.99) tiers |
| Cosmetics | Avatar frames, board themes, player icons |
| Fair Play | No pay-to-win - all purchases are cosmetic only |
API Endpoints
GET /api/monetization/status - Check ad-free status & unlocks
POST /api/monetization/ad-reward - Record ad view, receive reward
GET /api/monetization/cosmetics - List available cosmetics
POST /api/monetization/equip - Equip a cosmetic item
POST /api/profile/avatar - Upload custom avatar
DELETE /api/profile/avatar - Reset to default avatar
🔒 Security
The platform implements comprehensive security measures:
Headers & Protocols
| Security Feature | Implementation |
|---|
| HTTPS | Automatic redirect in production |
| HSTS | 1-year max-age with preload |
| CSP | Content Security Policy headers |
| XSS | X-XSS-Protection enabled |
| Clickjacking | X-Frame-Options: SAMEORIGIN |
| MIME Sniffing | X-Content-Type-Options: nosniff |
| Referrer | strict-origin-when-cross-origin |
| Permissions | Restrictive Permissions-Policy |
| Cross-Origin | COOP & CORP headers |
Application Security
- ✅ Rate limiting on all endpoints
- ✅ Bot detection (timing analysis, honeypot fields)
- ✅ Input sanitization (iterative HTML tag removal)
- ✅ Failed login tracking with automatic lockout
- ✅ JWT token authentication
- ✅ CSRF protection for OAuth flows
- ✅ Password hashing with bcrypt (cost factor 10)
📁 Project Structure
9dttt/
├── Public/ # Static frontend files
│ ├── index.html # Main game library
│ ├── maintenance.html # Maintenance page with mini-game
│ ├── css/ # Stylesheets
│ ├── js/ # Client-side JavaScript
│ └── games/ # Individual game pages
├── server/ # Backend modules
│ ├── config.js # Configuration
│ ├── storage.js # Data persistence (Redis/Memory)
│ ├── auth.js # Authentication & profiles
│ ├── oauth.js # Social login (OAuth2)
│ ├── gameManager.js # Game logic & matchmaking
│ ├── moderation.js # Block, report, discipline
│ ├── security.js # Rate limiting, bot protection, headers
│ ├── monetization.js # Ads, cosmetics, battle pass
│ ├── keepAlive.js # Prevent Render sleeping
│ └── boot.js # ASCII boot sequence
├── server.js # Main server entry point
├── package.json
├── render.yaml # Render deployment config
└── README.md
🏗️ Architecture
Backend
- Express.js - Web server and REST API
- Socket.io - Real-time multiplayer communication
- Redis - Optional persistence layer (falls back to in-memory)
- JWT - Secure authentication tokens
- bcrypt - Password hashing
Frontend
- Vanilla JavaScript - No framework dependencies
- CSS Custom Properties - Easy theming
- Progressive Enhancement - Works without JavaScript for basic content
♿ Accessibility
All games include:
- ✅ Full keyboard navigation
- ✅ ARIA labels and roles
- ✅ Screen reader announcements
- ✅ High contrast mode
- ✅ Reduced motion preferences
- ✅ Mobile-responsive design
- ✅ Focus management
📱 Mobile App
This platform can be installed as an app:
PWA (Progressive Web App)
Users can "Add to Home Screen" for an app-like experience with offline support.
Native App (Capacitor)
npm install @capacitor/core @capacitor/cli
npx cap init
npx cap add ios android
npx cap sync
Note: When running npx cap init, you'll be prompted for a package name (e.g., com.example.app). For Android apps, this package name becomes the applicationId in your app-level build.gradle file.
🛡️ Moderation
The platform includes comprehensive moderation tools:
| Feature | Description |
|---|
| Block Players | Prevent all interactions with specific users |
| Report System | Report harassment, cheating, spam, inappropriate content |
| Discipline Ladder | Warning → Mute → Temp Ban → Permanent Ban |
| Auto-Moderation | Automatic action on multiple reports |
Report Categories
- Harassment / Bullying
- Cheating / Exploits
- Spam / Flooding
- Inappropriate Content
- Other
📚 Documentation
📄 License
MIT License - Free to use and modify.
🤝 Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature)
- Commit your changes (
git commit -m 'Add amazing feature')
- Push to the branch (
git push origin feature/amazing-feature)
- Open a Pull Request
Built with ❤️ by Bastion Quartet
Strategic Gaming for Everyone
🎮 Play Now • 🐛 Report Bug • 💡 Request Feature
