AI-first toolkit for ReSkate (the skate. mod platform): a portable CLI and an opt-in MCP server that scaffold, inspect, validate and package mods, and drive ReSkate Studio's own compiler and Blender tools.
Python standard library only. No game files, no Studio binaries and no character or map assets are in this repository. Blender, the game and Studio are discovered on your PC.
- Clone or download this repository.
- Get ReSkate Studio from the ReSkate project (https://docs.reskate.dev/mods/studio) and put it in a folder named
ReSkate Studio/inside this one, with itsNative/folder beside the executables. The validators, scaffolding and packaging work without it; the map compiler, the Blender converter and cosmetic import need it. - Run
Setup-Forge.cmd(orpowershell -ExecutionPolicy Bypass -File .\Setup-Forge.ps1). It checks the tools and writes MCP connection examples with your paths intolocal-config/. It does not change any installed AI app. - Run
Forge.cmd doctorto see what is ready, thenForge.cmd plan "<what you want to make>"to get a route. - Open this folder in your AI app so
AGENTS.mdis read. To use MCP, add the server fromlocal-config/mcp-servers.jsonorcodex-mcp.toml; its entry point isForge-MCP.cmd.
Nothing here has been verified in game yet: a passing validation or a built package is not proof that a mod loads. See STATE.md.
| MCP tool | Actual functionality |
|---|---|
forge_doctor, forge_studio_probe |
Discover available executables, local paths and compiler help |
forge_studio_launch |
Open your copy of Studio on Windows |
forge_blender_preflight, forge_stage_model |
Audit meshes, rigs, materials and private source assets |
forge_map_import |
Import FBX/GLB/GLTF/OBJ into a fresh editable .blend scene |
forge_map_convert |
Call Studio's authentic Blender converter to write a map handshake |
forge_build_map |
Run reskate_cli.exe compile-map as specified by Studio's bundled BAT; optional deployment |
forge_install_blender_addon |
Install the bundled Skate Map add-on in Blender |
forge_new, forge_adopt_studio, forge_validate |
Manage real source projects and Studio outputs |
forge_package, forge_release_prep, forge_install |
Package, release checks and safe install/apply |
All compiler jobs produce inspectable logs. For a dry run, use --dry-run or MCP dry_run: true.
Honest limitation: cosmetic donor fitting, skinning and final cosmetic build require the Studio UI or a documented unattended cosmetic compiler contract. The Forge can launch Studio and run headless Blender preparation, but cannot claim it completed a whole-body Kitana swap until the final game output is verified.
| Feature | State |
|---|---|
| Analyze split ZIPs without concatenating/extracting gigabytes | Implemented |
| Recognize mods, plugins, game patches, cosmetics and maps in sample ZIP | Implemented (structural classification) |
| Inspect FBX model metadata, bones/meshes and PNG textures in a ZIP | Implemented |
| Stage model privately, with safe ZIP path checks | Implemented |
| Generate Luau plugin and ReSkate park workspaces | Implemented |
| Generate model-swap / map Studio-ready workspaces | Implemented |
Compile an actual map via Studio's reskate_cli.exe on your Windows PC |
Implemented bridge, awaiting live Windows smoke test |
| Drive Studio's real Blender converter and map imports | Implemented bridge, awaiting live Windows smoke test |
| Blender scene diagnostics and optional GLB export | Script ready; requires Blender on your PC |
| Import authentic ReSkate Studio-built patch files | Implemented (no fake stamps) |
| Validate ReSkate/Thunderstore JSON, icon, build stamp and executable bans | Implemented static checks |
| Create repeatable Thunderstore ZIPs, offline release report | Implemented |
| Install into specified ReSkate Mods folder | Implemented: preview by default, --apply explicit |
| Automatically create a full working player model swap from unrelated FBX | Not yet possible without donor rig fit, ReSkate Studio and in-game verification |
| Automatically compile/play-test maps without the installed game or Windows | Not possible in this environment |
| Publish directly to Thunderstore | Deliberately a manual final review/upload step |
cd C:\Path\To\ReSkateForge
.\Forge.cmd doctor
.\Forge.cmd plan "Swap my skater with Kitana"
# Source model analysis and staging; archive remains private
reskateforge inspect-model "C:\Path\To\Kitana.zip" --output kitana-report.json
reskateforge new Kitana_Skater --kind cosmetic --owner YourTeam --description "A custom Kitana-inspired skater outfit"
reskateforge stage-model "C:\Path\To\Kitana.zip" "workspaces\Kitana_Skater\source\kitana"
# After you import/fit/build in ReSkate Studio (Studio's BUILD & INSTALL)
reskateforge adopt-studio workspaces\Kitana_Skater --from "C:\Path\To\StudioBuiltMod"
reskateforge validate workspaces\Kitana_Skater
reskateforge release-prep workspaces\Kitana_Skater
reskateforge package workspaces\Kitana_SkaterCreate a plugin workspace, then validate, package and preview the install. Workspaces are yours and are not committed.
reskateforge new Line_HUD --kind plugin --owner YourTeam --description "Shows the skater's speed"
reskateforge validate workspaces\Line_HUD
reskateforge package workspaces\Line_HUD
reskateforge install workspaces\Line_HUD --mods-dir "C:\Actual\ReSkate\Skate\Mods"
# Review the dry-run path, then explicitly install:
reskateforge install workspaces\Line_HUD --mods-dir "C:\Actual\ReSkate\Skate\Mods" --applyOr drag the ZIP from dist/ onto the launcher's MODS page and turn the plugin on when the permission prompt appears. plugin list in the in-game console (~) shows whether it loaded.
Set RESKATE_OWNER (or put your team name in local-config/owner.txt) to stop passing --owner each time.
reskateforge new My_Map --kind map --owner YourTeam --description "My custom map".- Put your
.blend,.fbx,.glb,.gltf, Skater XL/Unity source insource/. - For source FBX/GLB, run
Forge.cmd map-import "C:\maps\level.fbx" --output "C:\maps\level.blend". Existing.blendscenes work directly. The map converter can also be invoked explicitly withForge.cmd map-convert "C:\maps\level.blend" --output "C:\maps\level-handshake". - Use the included Studio Blender add-on to set collision, grind surfaces, spawn points, materials and lights. If necessary:
Forge.cmd install-blender-addon --output "C:\maps\addon-install.json". - Run
Forge.cmd build-map "C:\maps\level.blend" --output "C:\maps\My_Map_package" --game "C:\Games\ReSkate". Add--deployonly if you want Studio's compiler to deploy the result. This uses the argument contract from the actual bundledBuild Skate Map.bat. - Adopt actual Studio output into your workspace with
Forge.cmd adopt-studio workspaces\My_Map --from "<actual Studio output folder>"; validate/package. For in-session map downloading, publish as Mods + Maps and keep the package map-only.
reskateforge new My_Park --kind park --description "My rail park" creates a valid example JSON structure with a demo object from official documentation. Change placements to your map, or export a real park through ReSkate's Park Editor, then test in game and package. Do not assume the example coordinates suit your location.
Run Setup-Forge.ps1 for MCP configuration using the Forge's exact absolute Windows path. The portable Forge-MCP.cmd is the MCP entry point for clients configured from the generated JSON/TOML. The following direct Python command also works when the agent starts in this folder:
{
"mcpServers": {
"reskateforge": {
"command": "py",
"args": ["-m", "reskateforge", "mcp"]
}
}
}For macOS/Linux change py to python3. The server supports MCP initialization, tools/list, tools/call, ping. In Claude Code/Codex also open this directory so its AGENTS.md and CLAUDE.md are read. Client config schemas differ, so use this JSON's server command/args in your app's own configuration.
Then ask: “Use ReSkateForge to import this map model, compile it through the bundled Studio tools, test what you can and prepare a Thunderstore release.” An agent can run the compiler on Windows; final in-game verification still needs the game itself. Cosmetic swap commands remain limited to verified Blender stages and Studio's GUI.
The included examples/ reports came from your downloaded mods. The private Forge bundle also includes your already-staged Kitana FBX and 76 textures under workspaces/Kitana_Skater/source/; it is not included in any Thunderstore mod package. Your Studio binaries are ignored by Git to prevent accidental public redistribution. An FBX from another game's rig does not automatically match skate.'s skeleton; no full-player swap is claimed until tested and fitted.
Read docs/ARCHITECTURE.md, docs/KITANA.md, docs/RELEASE.md and docs/SOURCES.md for the design, asset findings, release rules and official documentation.