Files
soccercloud/README.md
2025-10-20 21:32:45 -04:00

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

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

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 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
  • Icons via Font Awesome

"Deploy your next match like a VM — welcome to SoccerCloud."