gpb-to-mxb

Converts PiBoSo GPBikes mods including bikes, tracks, tyres, and gear to MX Bikes format.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/medispis/opencode-config --skill gpb-to-mxb-medispis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gpb-to-mxb
Source: https://github.com/medispis/opencode-config/tree/main/skills/gpb-to-mxb
Command: npx skills add https://github.com/medispis/opencode-config --skill gpb-to-mxb-medispis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Porting GPBikes mods to MX Bikes requires manual handling of incompatible file formats, config rebuilds, and skeleton re-rigging, with no automated converter existing in the community. ## Core Features & Use Cases - Mod Type Detection: Identifies bikes, tracks, tyre packs, gear, and stands from folder structure and file patterns, including unpacking .pkz archives. - Per-Type Conversion Rules: Provides copy/rename/rebuild tables for .edf, .cfg, .hrc, .geom, and .pnt files, including bike .cfg section edits and gfx.cfg retargeting. - Rider Re-Rig Workflow: Documents the full Blender re-rig process from GPB's 25-bone skeleton to MX Bikes' 70-bone riderRIG_* skeleton, with verification commands. - Use Case: You downloaded a GPBikes supermoto bike pack and want it playable in MX Bikes — the skill renames model files, rebuilds configs, fixes tyre friction, and verifies the output with grep checks. ## Quick Start Convert this GPBikes mod folder to MX Bikes format and install it into my MX Bikes mods directory.

Frequently Asked Questions about gpb-to-mxb

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a GPBikes mod to MX Bikes?

Detect the mod type from its folder structure, create the MX Bikes mods target layout, then apply per-type conversion rules. Bikes need model.edf renames and .cfg rebuilds, while riders require a full Blender re-rig to the riderRIG_* skeleton.

Can I copy GPBikes rider files directly into MX Bikes?

No, verbatim copying causes T-pose, detached helmet and boots, and no animation. GPB riders use a 25-bone skeleton while MX Bikes uses 70 riderRIG_* bones, so a manual Blender re-rig plus gfx.cfg, rider.hrc, and .ini rebuilds are required.

What tools are needed for GPB to MXB conversion?

The shared PiBoSo toolchain covers everything: FBX2EDF for model conversion, BikeEd for geometry, EngineEd, TyreEd, PaintEd, and TrackEd. Blender 3.x with an edf2fbx helper is required for rider re-rigging.

Do GPBikes helmets and boots work in MX Bikes without changes?

Yes, helmets and boots are identical between the two games and copy verbatim into mods/helmets/ and mods/boots/. Only riders and suits are incompatible and require re-rigging.

Why does my converted MX Bikes track have no dynamic ruts?

Mesh-only tracks converted via FBX2EDF produce static surfaces without dynamic ruts. Dynamic ruts require rebuilding the terrain as a heightmap in TerrainEd, which involves manual sculpting.