How anukul1712/mlfootball_env works
This is a self-contained AI soccer participant development kit: participants create or train a bot, run it in the game environment, inspect matches, then validate and package a submission. The graph includes the game engine, policy choices, training, and local match/viewer workflow, plus submission checks. Relationships for sampled core modules are supported by excerpts or the SOURCE INDEX; broader workflow links are documented in the README. Unsampled implementation details are not inferred.
Main entry points: train_bot.py Training Runner · match_runner.py Match Runner · live_viewer.py Live Viewer · engine.py Soccer Engine
Components 17
Game Environment
- Game Rules
participants/soccer_env/config.py - Soccer Engine
participants/soccer_env/engine.py
Bot Policies
- Starter Bot
participants/soccer_env/bots.py - Readable Opponent
participants/reference_bot/policy.py - Organizer RL Bot
participants/organizer_rl_bot/policy.py - Team Policy
participants/submission_kit/team_bot/policy.py
Training
- RL Algorithms
participants/soccer_env/reinforcement.py - Training Runner
participants/train_bot.py
Matches And Viewing
- Match Runner
participants/soccer_env/match_runner.py - Live Viewer
participants/live_viewer.py - Replay Viewer
participants/replay_viewer.py - Viewer Server
participants/soccer_env/web_viewer.py - Browser Viewer
participants/viewer/viewer.js
Submission
- Process Validator
participants/validate_submission.py - Archive Checker
participants/submission_checker.py - ZIP Packager
participants/package_submission.py
Other components
- Participant
Connections 19
- Participant → Training Runner: trains bot
README.md - Participant → Live Viewer: watches match
README.md - Participant → Process Validator: validates submission
README.md - Participant → ZIP Packager: packages bot
README.md - Game Rules → Soccer Engine: configures
participants/soccer_env/engine.py - Training Runner → Soccer Engine: runs episodes
participants/train_bot.py - Training Runner → RL Algorithms: trains policy
participants/train_bot.py - Training Runner → Organizer RL Bot: uses opponent
participants/train_bot.py - Training Runner → Readable Opponent: uses opponent
participants/train_bot.py - Training Runner → Starter Bot: selects opponents
participants/train_bot.py - Organizer RL Bot → RL Algorithms: delegates to
participants/organizer_rl_bot/policy.py - Live Viewer → Match Runner: runs match
participants/live_viewer.py - Live Viewer → Viewer Server: starts viewer
participants/live_viewer.py - Replay Viewer → Viewer Server: opens replay
participants/replay_viewer.py - Match Runner → Soccer Engine: steps game
participants/soccer_env/match_runner.py - Match Runner → Game Rules: loads rules
participants/soccer_env/match_runner.py - Process Validator → Match Runner: runs matches
participants/validate_submission.py - ZIP Packager → Archive Checker: checked by
README.md - Participant → Team Policy: edits policy
README.md