Move Controller Axis Split

A BepInEx add-on that replaces MoveControllerKOI's combined Move XZ pad with separate horizontal Move X and Move Z controls.

Requirements

• Koikatsu CharaStudio
• BepInEx 5
• MoveControllerKOI 1.7.1.1 or 1.7.1.2

The original MoveControllerKOI DLL and assets are neither bundled nor modified.

Installation

1. Keep the original MoveControllerKOI.dll installed.
2. Extract the release ZIP into the Koikatsu game directory, or copy MoveControllerAxisSplit.dll to BepInEx\plugins.
3. Start CharaStudio and open the Move Controller window.

Behavior

• The upper half of the original XZ area becomes Move X.
• The lower half becomes Move Z.
• Both controls use horizontal mouse dragging.
• Move X changes only the world X coordinate, independent of camera angle.
• Move Z changes only the world Z coordinate, independent of camera angle.
• Existing Move Controller sensitivity, accessory, IK, multi-selection, and Undo/Redo behavior is retained.
• Uniform resize with right-button dragging remains available on both controls.

F1 Plugin Settings can disable the add-on, adjust the gap between controls, invert the Z drag direction, and enable debug logging. Disabling the add-on restores the original XZ pad at runtime.

The add-on connects to MoveControllerKOI through runtime reflection rather than redistributing or rebuilding it. Versions after 1.7.1.2 may work if the required internal structure remains compatible, but are outside the tested support range.

Building

The project targets .NET Framework 3.5 and requires BepInEx and Unity reference assemblies from a legally installed Koikatsu environment. MoveControllerKOI is not a compile-time reference.

.\build.ps1 -GameDir 'D:\Games\Koikatsu'

Alternatively, set the KOIKATSU_DIR environment variable before running build.ps1. To inspect a locally installed MoveControllerKOI contract, run:

.\verify-contract.ps1 -GameDir 'D:\Games\Koikatsu'

Troubleshooting

Enable Debug logging in F1 Plugin Settings and inspect BepInEx\LogOutput.log. When reporting a problem, include the MoveControllerKOI version and the relevant log excerpt.

License

This project is licensed under the MIT License.

Author

TailorofTeyvat

This is an unofficial community add-on and is not affiliated with the game or the original/port authors.