127 lines
3.7 KiB
Markdown
127 lines
3.7 KiB
Markdown
# ⚽ SoccerCloud — Cloudified Soccer Simulation Environment
|
|
|
|
**Live Demo:** [https://mentalnet.xyz/soccercloud/](https://mentalnet.xyz/soccercloud/)
|
|
**Author:** [markmental / MentalNet.xyz](https://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
|
|
|
|
> [https://mentalnet.xyz/soccercloud/](https://mentalnet.xyz/soccercloud/)
|
|
|
|
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
|
|
```bash
|
|
open index.html
|
|
````
|
|
|
|
### Option 2: Local dev server
|
|
|
|
```bash
|
|
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 `SimulationInstance` class.
|
|
* 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:
|
|
|
|
1. Fork this repository
|
|
2. Make your edits in a feature branch
|
|
3. 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](https://fonts.google.com)
|
|
* Icons via [Font Awesome](https://fontawesome.com)
|
|
|
|
---
|
|
|
|
### ⚽ *"Deploy your next match like a VM — welcome to SoccerCloud."*
|
|
|