haxball-core 1.0.0__tar.gz

haxball_core-1.0.0/.gitignore

@@ -0,0 +1,5 @@
+/target
+/.venv
+__pycache__/
+*.so
+Cargo.lock

haxball_core-1.0.0/Cargo.lock

@@ -0,0 +1,391 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "autocfg"
+version = "1.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f2032f911046de80f0a198e0901378627c33f59ea0ac00e363d481118bd70a53"
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[package]]
+name = "crossbeam-deque"
+version = "0.8.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9dd111b7b7f7d55b72c0a6ae361660ee5853c9af73f70c3c2ef6858b950e2e51"
+dependencies = [
+ "crossbeam-epoch",
+ "crossbeam-utils",
+]
+
+[[package]]
+name = "crossbeam-epoch"
+version = "0.9.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5b82ac4a3c2ca9c3460964f020e1402edd5753411d7737aa39c3714ad1b5420e"
+dependencies = [
+ "crossbeam-utils",
+]
+
+[[package]]
+name = "crossbeam-utils"
+version = "0.8.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d0a5c400df2834b80a4c3327b3aad3a4c4cd4de0629063962b03235697506a28"
+
+[[package]]
+name = "either"
+version = "1.16.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "91622ff5e7162018101f2fea40d6ebf4a78bbe5a49736a2020649edf9693679e"
+
+[[package]]
+name = "haxball_core"
+version = "1.0.0"
+dependencies = [
+ "libm",
+ "numpy",
+ "pyo3",
+ "rayon",
+ "serde",
+ "serde_json",
+]
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "indoc"
+version = "2.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "79cf5c93f93228cf8efb3ba362535fb11199ac548a09ce117c9b1adc3030d706"
+dependencies = [
+ "rustversion",
+]
+
+[[package]]
+name = "itoa"
+version = "1.0.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682"
+
+[[package]]
+name = "libc"
+version = "0.2.186"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "68ab91017fe16c622486840e4c83c9a37afeff978bd239b5293d61ece587de66"
+
+[[package]]
+name = "libm"
+version = "0.2.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b6d2cec3eae94f9f509c767b45932f1ada8350c4bdb85af2fcab4a3c14807981"
+
+[[package]]
+name = "matrixmultiply"
+version = "0.3.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a06de3016e9fae57a36fd14dba131fccf49f74b40b7fbdb472f96e361ec71a08"
+dependencies = [
+ "autocfg",
+ "rawpointer",
+]
+
+[[package]]
+name = "memchr"
+version = "2.8.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "88904434abc2901f197fe8cc55f0445e7ded921dba5911dad2e2b39b48e663c4"
+
+[[package]]
+name = "memoffset"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "488016bfae457b036d996092f6cb448677611ce4449e970ceaf42695203f218a"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "ndarray"
+version = "0.16.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "882ed72dce9365842bf196bdeedf5055305f11fc8c03dee7bb0194a6cad34841"
+dependencies = [
+ "matrixmultiply",
+ "num-complex",
+ "num-integer",
+ "num-traits",
+ "portable-atomic",
+ "portable-atomic-util",
+ "rawpointer",
+]
+
+[[package]]
+name = "num-complex"
+version = "0.4.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "73f88a1307638156682bada9d7604135552957b7818057dcef22705b4d509495"
+dependencies = [
+ "num-traits",
+]
+
+[[package]]
+name = "num-integer"
+version = "0.1.46"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7969661fd2958a5cb096e56c8e1ad0444ac2bbcd0061bd28660485a44879858f"
+dependencies = [
+ "num-traits",
+]
+
+[[package]]
+name = "num-traits"
+version = "0.2.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "numpy"
+version = "0.22.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "edb929bc0da91a4d85ed6c0a84deaa53d411abfb387fc271124f91bf6b89f14e"
+dependencies = [
+ "libc",
+ "ndarray",
+ "num-complex",
+ "num-integer",
+ "num-traits",
+ "pyo3",
+ "rustc-hash",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "portable-atomic"
+version = "1.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c33a9471896f1c69cecef8d20cbe2f7accd12527ce60845ff44c153bb2a21b49"
+
+[[package]]
+name = "portable-atomic-util"
+version = "0.2.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c2a106d1259c23fac8e543272398ae0e3c0b8d33c88ed73d0cc71b0f1d902618"
+dependencies = [
+ "portable-atomic",
+]
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f402062616ab18202ae8319da13fa4279883a2b8a9d9f83f20dbade813ce1884"
+dependencies = [
+ "cfg-if",
+ "indoc",
+ "libc",
+ "memoffset",
+ "once_cell",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+ "unindent",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b14b5775b5ff446dd1056212d778012cbe8a0fbffd368029fd9e25b514479c38"
+dependencies = [
+ "once_cell",
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ab5bcf04a2cdcbb50c7d6105de943f543f9ed92af55818fd17b660390fc8636"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fd24d897903a9e6d80b968368a34e1525aeb719d568dba8b3d4bfa5dc67d453"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "36c011a03ba1e50152b4b394b479826cad97e7a21eb52df179cd91ac411cbfbe"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "pyo3-build-config",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.45"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41f2619966050689382d2b44f664f4bc593e129785a36d6ee376ddf37259b924"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rawpointer"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "60a357793950651c4ed0f3f52338f53b2f809f32d83a07f72909fa13e4c6c1e3"
+
+[[package]]
+name = "rayon"
+version = "1.12.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fb39b166781f92d482534ef4b4b1b2568f42613b53e5b6c160e24cfbfa30926d"
+dependencies = [
+ "either",
+ "rayon-core",
+]
+
+[[package]]
+name = "rayon-core"
+version = "1.13.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "22e18b0f0062d30d4230b2e85ff77fdfe4326feb054b9783a3460d8435c8ab91"
+dependencies = [
+ "crossbeam-deque",
+ "crossbeam-utils",
+]
+
+[[package]]
+name = "rustc-hash"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "08d43f7aa6b08d49f382cde6a7982047c3426db949b1424bc4b7ec9ae12c6ce2"
+
+[[package]]
+name = "rustversion"
+version = "1.0.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b39cdef0fa800fc44525c84ccb54a029961a8215f9619753635a9c0d2538d46d"
+
+[[package]]
+name = "serde"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9a8e94ea7f378bd32cbbd37198a4a91436180c5bb472411e48b5ec2e2124ae9e"
+dependencies = [
+ "serde_core",
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_core"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41d385c7d4ca58e59fc732af25c3983b67ac852c1a25000afe1175de458b67ad"
+dependencies = [
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_derive"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d540f220d3187173da220f885ab66608367b6574e925011a9353e4badda91d79"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "serde_json"
+version = "1.0.150"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e8014e44b4736ed0538adeecded0fce2a272f22dc9578a7eb6b2d9993c74cfb9"
+dependencies = [
+ "itoa",
+ "memchr",
+ "serde",
+ "serde_core",
+ "zmij",
+]
+
+[[package]]
+name = "syn"
+version = "2.0.118"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1b9ae57f904213ebb649ce6895b8a66c66f0203b9319718f69a5612a065b1422"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.12.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "61c41af27dd6d1e27b1b16b489db798443478cef1f06a660c96db617ba5de3b1"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+
+[[package]]
+name = "unindent"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7264e107f553ccae879d21fbea1d6724ac785e8c3bfc762137959b5802826ef3"
+
+[[package]]
+name = "zmij"
+version = "1.0.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b8848ee67ecc8aedbaf3e4122217aff892639231befc6a1b58d29fff4c2cabaa"

haxball_core-1.0.0/Cargo.toml

@@ -0,0 +1,29 @@
+[package]
+name = "haxball_core"
+version = "1.0.0"
+edition = "2021"
+description = "Headless, vectorized Haxball physics core (RocketSim-equivalent for Haxball)."
+license = "MIT"
+repository = "https://github.com/HaxballGym/HaxballGym"
+readme = "README.md"
+keywords = ["haxball", "reinforcement-learning", "physics", "simulation", "rl"]
+categories = ["science", "simulation", "game-development"]
+
+[lib]
+name = "haxball_core"
+# cdylib -> Python extension module via PyO3 / maturin
+# rlib   -> so we can add `cargo bench` / pure-Rust tests later
+crate-type = ["cdylib", "rlib"]
+
+[dependencies]
+pyo3 = { version = "0.22", features = ["extension-module"] }
+numpy = "0.22"
+rayon = "1.10"
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+libm = "0.2.16"
+
+[profile.release]
+opt-level = 3
+lto = "thin"
+codegen-units = 1

haxball_core-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wazarr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

haxball_core-1.0.0/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: haxball_core
+Version: 1.0.0
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Games/Entertainment :: Simulation
+Requires-Dist: numpy>=1.23
+License-File: LICENSE
+Summary: Headless, vectorized Haxball physics core (RocketSim-equivalent for Haxball).
+Keywords: haxball,reinforcement-learning,physics,simulation,rl
+Author-email: Wazarr <jeje_04@live.com>
+License-Expression: MIT
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/HaxballGym/HaxballGym
+Project-URL: Issues, https://github.com/HaxballGym/HaxballGym/issues
+Project-URL: Repository, https://github.com/HaxballGym/HaxballGym
+
+# haxball_core — headless, vectorized Haxball physics
+
+This is the **RocketSim-equivalent for Haxball**: a standalone physics core with
+**no game engine and no rendering**, designed to run thousands of matches in
+parallel for reinforcement learning.
+
+It replaces the Ursina/Panda3D-based simulation in `Ursinaxball`, which made every
+disc a 3D-engine `Entity` and capped throughput at low-thousands of steps/sec for
+a *single* game. The physics math is identical — this is a faithful port of
+Ursinaxball's pure-numpy `fn_base.py`, verified bit-for-bit (see Fidelity below).
+
+## Why this design
+
+RLGym is "a million times faster" than a naive Python clone for one reason: the
+physics lives in a headless native core (**RocketSim**, C++) behind a single
+`TransitionEngine` interface, and is stepped in **batches** so the Python↔native
+boundary is crossed once per *batch of envs*, not once per *game step*.
+
+`haxball_core` copies that win:
+
+- **Rust core, f64 math** — same numbers as the original numpy, native speed.
+- **Batched `VecEnv`** — N matches stepped in parallel with `rayon`, GIL released.
+  One `step(actions)` call advances all N envs.
+- **One source of truth** — the same crate compiles to a Python extension (for
+  training) and, next, to **WASM** (so a human can play the bot in-browser —
+  Haxball is a browser game, so the renderer and the human-play client live there).
+
+## Measured (Apple Silicon, single process)
+
+| Mode | 1v1 | 3v3 |
+|---|---|---|
+| Raw sim (no Python in loop) | ~50M env-steps/s | ~18M env-steps/s |
+| Full `env.step` (obs + reward + done numpy I/O) | ~12.5M env-steps/s | ~6.5M env-steps/s |
+
+Ursinaxball reference: a single game at low-thousands of steps/sec → this is a
+**~1,000–10,000× speedup**, and it scales to 2v2 / 3v3 (the regime that was out of
+reach before).
+
+## Fidelity
+
+`tests/test_fidelity.py` imports Ursinaxball's `fn_base.py` directly (it has no
+ursina import) and feeds 25,000 random inputs through both implementations:
+
+```
+disc_disc OK
+disc_vertex OK
+disc_plane OK
+segment_no_curve OK
+segment_curve OK
+ALL FIDELITY TESTS PASSED — Rust port matches fn_base.py to 1e-9
+```
+
+## Build & run
+
+This crate is the `haxball_core` member of the repo's uv workspace. From the repo
+root:
+
+```bash
+uv sync                                              # builds this crate (maturin) + deps
+uv run rust/haxball_core/tests/test_fidelity.py      # fidelity (1e-9)
+uv run rust/haxball_core/bench.py                    # throughput
+```
+
+Iterating on the Rust? `uv run maturin develop --release` rebuilds in place faster
+than a full `uv sync`.
+
+## Status / what's ported
+
+- [x] All 5 collision resolvers (disc-disc, disc-vertex, disc-plane, segment
+      straight + curved, segment bias) — **verified vs fn_base.py**
+- [x] Integration (`update_discs`), player movement + kick (`resolve_movement`),
+      goal detection (`check_goal`), spawn/reset.
+- [x] Classic stadium (planes + straight ball-area segments + goalposts + goals).
+- [x] Batched `VecEnv` with rayon, obs/reward/done numpy I/O.
+- [ ] Curved goal-net arcs + kickoff-barrier semicircle (math is ported and
+      tested; not yet wired into the classic `World` — minor, affects only
+      in-net ball behavior).
+- [ ] `.hbs` stadium loader (currently the classic stadium is built in code).
+- [ ] WASM target for in-browser play.
+
+## Next (the RLGym playbook, in order)
+
+1. Wrap `VecEnv` in an RLGym-v2-style API: `TransitionEngine` (this core) +
+   `StateMutator` / `ObsBuilder` / `ActionParser` / `RewardFunction` /
+   `DoneCondition` — composable, the env design HaxballGym already half-has.
+2. PettingZoo-parallel multi-agent + a single shared, permutation-invariant
+   policy → 1v1/2v2/3v3 from one network.
+3. Train with PufferLib (highest SPS) or CleanRL PPO, self-play vs a past-policy
+   pool.
+4. Compile to WASM; export the policy to ONNX; play it in the browser.
+

haxball_core-1.0.0/README.md

@@ -0,0 +1,90 @@
+# haxball_core — headless, vectorized Haxball physics
+
+This is the **RocketSim-equivalent for Haxball**: a standalone physics core with
+**no game engine and no rendering**, designed to run thousands of matches in
+parallel for reinforcement learning.
+
+It replaces the Ursina/Panda3D-based simulation in `Ursinaxball`, which made every
+disc a 3D-engine `Entity` and capped throughput at low-thousands of steps/sec for
+a *single* game. The physics math is identical — this is a faithful port of
+Ursinaxball's pure-numpy `fn_base.py`, verified bit-for-bit (see Fidelity below).
+
+## Why this design
+
+RLGym is "a million times faster" than a naive Python clone for one reason: the
+physics lives in a headless native core (**RocketSim**, C++) behind a single
+`TransitionEngine` interface, and is stepped in **batches** so the Python↔native
+boundary is crossed once per *batch of envs*, not once per *game step*.
+
+`haxball_core` copies that win:
+
+- **Rust core, f64 math** — same numbers as the original numpy, native speed.
+- **Batched `VecEnv`** — N matches stepped in parallel with `rayon`, GIL released.
+  One `step(actions)` call advances all N envs.
+- **One source of truth** — the same crate compiles to a Python extension (for
+  training) and, next, to **WASM** (so a human can play the bot in-browser —
+  Haxball is a browser game, so the renderer and the human-play client live there).
+
+## Measured (Apple Silicon, single process)
+
+| Mode | 1v1 | 3v3 |
+|---|---|---|
+| Raw sim (no Python in loop) | ~50M env-steps/s | ~18M env-steps/s |
+| Full `env.step` (obs + reward + done numpy I/O) | ~12.5M env-steps/s | ~6.5M env-steps/s |
+
+Ursinaxball reference: a single game at low-thousands of steps/sec → this is a
+**~1,000–10,000× speedup**, and it scales to 2v2 / 3v3 (the regime that was out of
+reach before).
+
+## Fidelity
+
+`tests/test_fidelity.py` imports Ursinaxball's `fn_base.py` directly (it has no
+ursina import) and feeds 25,000 random inputs through both implementations:
+
+```
+disc_disc OK
+disc_vertex OK
+disc_plane OK
+segment_no_curve OK
+segment_curve OK
+ALL FIDELITY TESTS PASSED — Rust port matches fn_base.py to 1e-9
+```
+
+## Build & run
+
+This crate is the `haxball_core` member of the repo's uv workspace. From the repo
+root:
+
+```bash
+uv sync                                              # builds this crate (maturin) + deps
+uv run rust/haxball_core/tests/test_fidelity.py      # fidelity (1e-9)
+uv run rust/haxball_core/bench.py                    # throughput
+```
+
+Iterating on the Rust? `uv run maturin develop --release` rebuilds in place faster
+than a full `uv sync`.
+
+## Status / what's ported
+
+- [x] All 5 collision resolvers (disc-disc, disc-vertex, disc-plane, segment
+      straight + curved, segment bias) — **verified vs fn_base.py**
+- [x] Integration (`update_discs`), player movement + kick (`resolve_movement`),
+      goal detection (`check_goal`), spawn/reset.
+- [x] Classic stadium (planes + straight ball-area segments + goalposts + goals).
+- [x] Batched `VecEnv` with rayon, obs/reward/done numpy I/O.
+- [ ] Curved goal-net arcs + kickoff-barrier semicircle (math is ported and
+      tested; not yet wired into the classic `World` — minor, affects only
+      in-net ball behavior).
+- [ ] `.hbs` stadium loader (currently the classic stadium is built in code).
+- [ ] WASM target for in-browser play.
+
+## Next (the RLGym playbook, in order)
+
+1. Wrap `VecEnv` in an RLGym-v2-style API: `TransitionEngine` (this core) +
+   `StateMutator` / `ObsBuilder` / `ActionParser` / `RewardFunction` /
+   `DoneCondition` — composable, the env design HaxballGym already half-has.
+2. PettingZoo-parallel multi-agent + a single shared, permutation-invariant
+   policy → 1v1/2v2/3v3 from one network.
+3. Train with PufferLib (highest SPS) or CleanRL PPO, self-play vs a past-policy
+   pool.
+4. Compile to WASM; export the policy to ONNX; play it in the browser.