wzrdbrain 0.3.0

A simple library to generate trick combinations and moves for wizard style inline skating.

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, producing sequences that flow naturally.

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

Category	Examples	Count
Base	Predator, Predator One	4
Turn	Parallel Turn, Tree Turn	4
Transition	Gazelle, Lion, Lion S, Gazelle S, 180, 360, 540	22
Pivot	Toe Pivot, Heel Pivot (all direction/stance combos)	8
Swivel	Stunami, UFO Swivel	4
Manual	Toe/Heel Press, Toe/Heel Roll	8
Slide	Parallel, Soul, Acid, Mizu, Star, Fast, Back	14

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. 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 Python or JavaScript libraries

For developers

This library is available in both Python and JavaScript.

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 (Open): front → front
# Front Gazelle (Open): front → back
# Back Lion (Open): back → front

Each trick dict contains id, name, category, stage, entry and exit state objects.

JavaScript usage

You can use the ES6 module directly from the JSDelivr CDN.

import { generateCombo } from 'https://cdn.jsdelivr.net/gh/nazroll/wzrdbrain@v0.3.0/src/wzrdbrain/wzrdbrain.js';

const combo = generateCombo(3);
combo.forEach(trick => {
    console.log(`${trick.name}: ${trick.entry.direction} → ${trick.exit.direction}`);
});

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.