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:

• supreme-goggles - SNS platform for community engagement

Healthcare & Utilities:

• fluffy-memory - Medical assistance platform

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)

1. Fork this repository
2. Create a new Web Service on Render
3. Connect your GitHub repo
4. Configure:
   • Runtime: Node
   • Build Command: npm install
   • Start Command: npm start
   • Instance Type: Free (or higher for production)
5. Add environment variables (see below)
6. 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:

1. 📧 Email & Password - Traditional registration and login

   • Stored securely with bcrypt hashing
   • No setup required

2. 🦊 Web3 Wallet Authentication - Perfect for crypto gaming!

   • MetaMask (Ethereum)
   • Phantom (Solana)
   • XUMM/Crossmark (XRP)
   • No API keys or setup required

3. 👤 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

• OAUTH_SECURITY.md - Understanding OAuth security and why API keys in URLs are safe
• TROUBLESHOOTING.md - Fixing common issues with Google/Apple login
• FIREBASE_SETUP.md - Setting up Firebase authentication
• DEPLOYMENT_GUIDE.md - Deploying to production
• README_DEPLOYMENT.md - Additional deployment information

---

📄 License

MIT License - Free to use and modify.

---

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

Built with ❤️ by Bastion Quartet

Strategic Gaming for Everyone

🎮 Play Now • 🐛 Report Bug • 💡 Request Feature