Skip to content

Releases

v1.1.0

Choose a tag to compare

@brainrom brainrom released this 05 Nov 18:59

vroid-studio-mcp v1.1.0

MCP server for VRoid Studio 2.14.0: lets AI agents create and edit characters in the real editor —
choose presets, tune sliders and colors, frame the camera, and save. It drives the editor's own
internal API through a BepInEx/IL2CPP plugin, so it does not use mouse or OCR automation and
keeps working while the window is minimized.

Changelog

  • Custom presets in the normal preset list — saved Custom-tab items are now listed, previewed and
    applied together with the stock presets, and an agent can create a new named custom preset in one call.
  • Custom item import/export — import and export reusable *.vroidcustomitem files for Hairstyle
    and Outfit. Import can add an item to the library or wear it immediately; export works for the item
    currently worn and for items that are only stored.
  • Applied preset is reported — presets now shows which preset or custom item is currently applied.
  • Safer batch calls — batch operations accept named arguments only and are validated before they run,
    so an unknown or missing argument cannot silently hit the wrong parameter.
  • Clearer argument errors — invalid numbers, ranges and boolean values now return a precise error
    instead of being silently ignored or replaced by a default.
  • More stable long sessions — fixed a memory leak that could grow the app during repeated editing,
    and added diagnostics for troubleshooting.
  • Diagnostics are opt-in — diagnostic file dumps are off by default (dump_artifacts enables them);
    dialog tracing has its own dialog_trace switch.

Install

  1. Install BepInEx 6 (Unity.IL2CPP, Windows x64), build 6.0.0-be.788 into your VRoid Studio
    folder, then launch the game once so BepInEx finishes setting itself up:
    https://builds.bepinex.dev/projects/bepinex_be/788/BepInEx-Unity.IL2CPP-win-x64-6.0.0-be.788%2B5b766a3.zip
  2. Copy from this archive into the VRoid Studio folder:
    • BepInEx/plugins/VroidStudioMcp.dll
    • BepInEx/config/BepInEx.cfg (optional; keeps BepInEx logging off)
  3. Copy the data folders to the VRoid Studio folder (next to VRoidStudio.exe):
    • i18n/ — corrected English labels
    • labels/ — readable preset names
  4. Launch VRoid Studio. The MCP endpoint is then at http://127.0.0.1:17891/mcp.

See README.md (English) or
README.ru.md (Russian) for details.

Archive contents

  • BepInEx/plugins/VroidStudioMcp.dll — the plugin
  • BepInEx/config/BepInEx.cfg — BepInEx config with console/disk logging disabled
  • i18n/en.json — corrected English label overlay
  • labels/10-*.json — preset label overlay
  • README.md, README.ru.md, LICENSE

Notes

  • VRoid Studio and BepInEx are not bundled — install them separately.
  • Requires VRoid Studio 2.14.0 on Windows (or run through Wine).
  • The DLL is built locally, not by CI; the archive's SHA-256 is attached for verification.
  • License: MIT. VRoid Studio is a product of pixiv Inc.; this project is unaffiliated with pixiv.

v1.0.0

Choose a tag to compare

@brainrom brainrom released this 13 Oct 17:01

vroid-studio-mcp v1.0.0

MCP server for VRoid Studio 2.14.0: lets AI agents create and edit characters in the real editor —
choose presets, tune sliders and colors, frame the camera, and save. It drives the editor's own
internal API through a BepInEx/IL2CPP plugin, so it does not use mouse or OCR automation and
keeps working while the window is minimized.

Install

  1. Install BepInEx 6 (Unity.IL2CPP, Windows x64), build 6.0.0-be.788 into your VRoid Studio
    folder, then launch the game once so BepInEx finishes setting itself up:
    https://builds.bepinex.dev/projects/bepinex_be/788/BepInEx-Unity.IL2CPP-win-x64-6.0.0-be.788%2B5b766a3.zip
  2. Copy from this archive into the VRoid Studio folder:
    • BepInEx/plugins/VroidStudioMcp.dll
    • BepInEx/config/BepInEx.cfg (optional; keeps BepInEx logging off)
  3. Copy the data folders to the VRoid Studio folder (next to VRoidStudio.exe):
    • i18n/ — corrected English labels
    • labels/ — readable preset names
  4. Launch VRoid Studio. The MCP endpoint is then at http://127.0.0.1:17891/mcp.

See README.md (English) or
README.ru.md (Russian) for details.

Archive contents

  • BepInEx/plugins/VroidStudioMcp.dll — the plugin
  • BepInEx/config/BepInEx.cfg — BepInEx config with console/disk logging disabled
  • i18n/en.json — corrected English label overlay
  • labels/10-*.json — preset label overlay
  • README.md, README.ru.md, LICENSE

Notes

  • VRoid Studio and BepInEx are not bundled — install them separately.
  • Requires VRoid Studio 2.14.0 on Windows (or run through Wine).
  • The DLL is built locally, not by CI; the archive's SHA-256 is attached for verification.
  • License: MIT. VRoid Studio is a product of pixiv Inc.; this project is unaffiliated with pixiv.