wzrdbrain

wzrdbrain is a physics-aware combo generator for wizard skating. It models moves as state transitions — each trick transforms the skater's physical state (direction, edge, stance, weight point) so generated combinations are actually executable, not just random names.

If you're a wizard skater, the best way to use this project is through the Rocker'd Magic Moves app!

The app is powered by this library and works on your phone, even offline.

Logic makes magic.

How it works

Every move in the library defines an entry state (what the skater needs to be doing) and an exit state (what the skater ends up doing). The combo generator chains moves by matching exit states to entry states across all four physical dimensions (direction, edge, stance, weight point), producing sequences that flow naturally.

Matching uses a three-tier cascade: it prefers a fully continuous link (direction + point + edge + stance), falls back to matching direction + point, then to direction alone — so it never dead-ends. Each trick reports how continuous its link is via a transition field (start, linked, edge_shift, or reset), so the output is honest about where the skater makes an implicit adjustment.

Move names follow the Front/Back [Open|Closed] Move convention (e.g. Front Open Gazelle), and the whole library is validated against the move schema at load time — a typo in the data fails at import instead of silently generating broken combos.

The move library (moves.json) contains 68 move variants across 7 categories:

Contributing

We welcome contributions! wzrdbrain is an open-source project, and we encourage the community to help in many ways.

Want to add a new trick?

This is the most common way for skaters to contribute! Add a new move entry to src/wzrdbrain/moves.json with its entry/exit states. Name it following the Front/Back [Open|Closed] Move convention — the library is validated at load time, so any invalid state value is caught the moment the tests run. See the research doc for the state model and edge conventions.

To get started, please read our contributing guide which will walk you through the process.

Other ways to contribute

• Report bugs and suggest features
• Improve documentation
• Submit code improvements for the library

For developers

Python usage

Install the package from PyPI:

pip install wzrdbrain

Use generate_combo to get a list of trick dictionaries with full state information.

from wzrdbrain import generate_combo

combo = generate_combo(3)
for trick in combo:
    print(f"{trick['name']}: {trick['entry']['direction']} → {trick['exit']['direction']}")
# Example output:
# Front Predator: front → front
# Front Open Gazelle: front → back
# Back Open Lion: back → front

Each trick dict contains id, name, category, stage, a transition annotation describing its link to the previous trick (start/linked/edge_shift/reset), and entry/exit state objects. The exit object includes direction, edge, stance, point, plus lead_foot and feet.

Skaters who prefer "fakie"/"forward" wording can switch the display style with terminology="fakie" — trick names render as Forward Open Gazelle / Fakie Open Lion while ids and state values stay unchanged:

combo = generate_combo(3, terminology="fakie")

To practice a specific move, pass trick= and the combo is guaranteed to include it — matching is case-insensitive, understands fakie wording, and forgives small typos:

combo = generate_combo(3, trick="Front Open Gazelle")

JavaScript

Earlier releases shipped an auto-generated JavaScript port. It was removed to cut maintenance; if you need it, pin the last release that included it via JSDelivr:

https://cdn.jsdelivr.net/gh/nazroll/wzrdbrain@v0.4.1/src/wzrdbrain/wzrdbrain.js

Credits

Many thanks to the wizard skating community for their valuable feedback and support. Special thanks to:

• Billy Arlew: for being a reliable source of inspiration and as a domain knowledge expert on the wizard skating tricks dictionary.
• Eelco Soesman: for being a supportive Slightly Rockerd crew and early tester.
• Bas Bavinck: for being the beacon of wizardry with his book and supporting this project.

License

This project is licensed under the Apache-2.0 Open Source Software License. See the LICENSE file for details.