3.7 KiB
⚽ SoccerCloud — Cloudified Soccer Simulation Environment
Live Demo: https://mentalnet.xyz/soccercloud/
Author: markmental / MentalNet.xyz
License: MIT
🧠 Overview
SoccerCloud is a browser-based soccer simulator that reimagines match simulations through the aesthetic and structure of a cloud orchestration dashboard — think OpenStack meets Football Manager.
Each match, league, or knockout bracket behaves like a “virtual instance”, complete with lifecycle controls:
- Create / Start / View / Delete / Clone / Export
- Real-time logs, xG data, formations, and tactical analytics
- Dynamic UI styled like a cloud console with per-match telemetry
SoccerCloud is written entirely in HTML, CSS, and vanilla JavaScript, with no external backend dependencies. It runs fully client-side and is suitable for static hosting.
🌐 Live Deployment
Hosted on MentalNet.xyz, the current deployment showcases all features including:
- Match instance dashboard
- 4-team League and Knockout modes
- CSV export of results and tables
- Auto-team picker with J-League and European clubs
- Cloud-inspired modal configuration UI
🏗️ Features
| Category | Description |
|---|---|
| Simulation Types | Single Match, 4-Team League, 4-Team Knockout |
| Team Database | Includes J-League + top European clubs with realistic formations/tactics |
| UI Design | Styled like a lightweight OpenStack/Proxmox console |
| Export Options | Download match or league data as CSV |
| Logging & Recaps | Live xG updates, goal commentary, and tactical analysis |
| Client-Only | Runs directly in browser — no backend needed |
🗂️ Project Structure
soccercloud/
├── index.html # Main web dashboard and simulation logic
├── data.js # Team definitions, flags, formations, and tactics
└── assets/ # (Optional) icons, logos, or future expansion files
🚀 Getting Started (Local)
You can run SoccerCloud locally with no build process — just open it in a browser.
Option 1: Double-click
open index.html
Option 2: Local dev server
python3 -m http.server 8080
Then visit:
👉 http://localhost:8080
🧩 Technical Notes
- Written in vanilla JavaScript for speed and transparency.
- Each simulation instance is handled via a
SimulationInstanceclass. - Data persistence is session-based; future versions may support saving instance states.
- CSS uses retro UnifrakturCook + Press Start 2P fonts for a distinct MentalNet look.
🖥️ Upcoming: CLI Edition
⚡ tuxsoccercloud (Coming soon!)
A simplified terminal version of the simulator is in development — ideal for users who prefer a command-line workflow or want to integrate match simulations into scripts or data pipelines.
Planned features:
- Text-only match recaps and league tables
- Randomized or argument-based team selection
- Fully offline operation
🤝 Contributing
Pull requests are welcome (when I get signups up)! To contribute:
- Fork this repository
- Make your edits in a feature branch
- Submit a pull request with a clear description
💡 Credits
- Built and designed by markmental
- Hosted under MentalNet.xyz
- Inspired by OpenStack Horizon dashboards and Football Manager-style simulations
- Font assets via Google Fonts
- Icons via Font Awesome