v0.9.9 2026-03-22 2026-05-27 0

Turboism

面向 Live2D Cubism Editor 的插件,在保证原生体验情况下,提高建模效率。

Windows

下载地址

注意#

由于现实原因, 不一定即时更新这里的博文. 如有事务, 请通过邮箱联系.

支持版本#

  • Cubism Editor 5.3.00
  • Cubism Editor 5.3.02 出于工作流考虑,不再对5.2版本进行更新

免责声明(请务必阅读)#

  • 本项目仅用于技术交流与学习研究用途。
  • 严禁将本项目用于任何违反法律法规、平台规则、软件许可协议(EULA)或侵犯他人权益的行为。
  • 严禁用于盗版传播、绕过授权、破解付费功能、商业侵权等不当用途。
  • 使用者应自行承担因使用本项目产生的一切风险与责任。
  • 若你不认可本声明或所在地法律不允许相关使用方式,请在 24 小时内自行删除本项目及相关文件。

安装与配置#

1. 下载压缩包#

压缩包内应该包括如下内容: image

2. 放置文件#

解压压缩包到任一目录

3. 运行安装程序#

3.1 使用安装包(推荐)#

双击安装.exe进入安装, 因为Cubism Editor默认安装目录位于Program Files, 所以需要管理员写入权限; 如果你安装失败, 请右键->管理员身份运行

3.2 使用脚本进行安装#

上面的安装程序本质上是脚本的打包, 如果你不信任可执行程序, 请使用脚本安装; 当然也需要管理员权限;

在 PowerShell 中进入该目录后执行:

Terminal window
.\configure_turboism.ps1

如果遇到脚本执行限制,可先在当前终端临时放开:

Terminal window
Set-ExecutionPolicy -Scope Process Bypass

3.3 手动安装#

你需要将对应的参数手动复制到cubism的启动脚本中, 假如你使用苹果电脑, 可以尝试使用此方法安装(如果Mac平台和Win平台的.jar相同, 但是你得自己琢磨);

一般来讲, 默认安装目录会位于以下位置:

Terminal window
C:\Program Files\Live2D Cubism 5.x

在你打开对应安装目录后, 你会发现安装目录下存在以下文件:

Terminal window
CubismEditor5_d3d.bat
CubismEditor5.bat

右键记事本(别的文本编辑工具也可以!)编辑, 加入以下代码(这是给Windows的):

  • Windows
Terminal window
-javaagent:"%APPDATA%\Turboism\agent\cubism-hook-agent-latest.jar" ^
-Dcubism.agent.log="%APPDATA%\Turboism\agent_runtime.log" ^
-Dcubism.agent.config="%APPDATA%\Turboism\turboism.config.json" ^
-Dcubism.agent.actionInbox="%APPDATA%\Turboism\agent_actions.txt" ^
-Dcubism.agent.enableOverlayRedButtonInject=true ^
-Dcubism.agent.enableOverlayRedButtonFallbackSync=false ^
-Dcubism.agent.enableOverlayRedButtonAutoShrink=false ^
-Dcubism.agent.redButtonLabel=Copilot ^
-Dcubism.agent.redButtons=Copilot ^
-Dcubism.agent.parameter.qConfirm=true ^
-Dcubism.agent.parameter.editBatch=true ^
-Dcubism.agent.enableActionInbox=false ^
-Dcubism.agent.actionInbox="%APPDATA%\Turboism\agent_actions.txt" ^
-Dcubism.agent.enableSocketBus=true ^
-Dcubism.agent.busHost=127.0.0.1 ^
-Dcubism.agent.busPort=19191 ^
-Dcubism.agent.actionPollMs=30 ^
-Dcubism.agent.logDeformerList=false ^
-Dcubism.agent.traceCallbacks=false ^
-Dcubism.agent.enableWarpModify=false ^
-Dcubism.agent.enableBroadHooks=false ^
-Dcubism.agent.verbose=false ^
-Dcubism.agent.warpTarget=Warp ^
-Dcubism.agent.warpDx=8 ^
-Dcubism.agent.warpDy=0 ^
-Dcubism.agent.cubismVersion=5.3.02 ^
-Dcubism.agent.cubismMajorMinor=5.3 ^
-Dcubism.agent.profile=v5_3 ^
-Djava.locale.providers=COMPAT,SPI ^

如果你修改成功, 脚本可能类似下面这样:

Terminal window
@echo off
setlocal
cd /d "%~dp0"
rem *********************************************************************
rem Live2D Cubism ver 5.3.02
rem *********************************************************************
rem ** Java VM
set JAVA_EXE=app\jre\bin\java.exe
rem ** Memory Size
rem set MAX_MEMORY=4000
rem set MAXMEMORY=-Xmx%MAX_MEMORY%m
set MAXMEMORY=-Xms1024m -Xmx4096m -XX:MaxDirectMemorySize=1024m -XX:MaxMetaspaceSize=512m
rem ** Library JAR file
set CLASS_PATH=app\lib\Live2D_Cubism.jar;app\lib\annotations-13.0.jar;app\lib\basicplayer3.0.jar;app\lib\commons-beanutils-1.9.4.jar;app\lib\commons-collections4-4.4.jar;app\lib\commons-lang3-3.13.0.jar;app\lib\commons-logging-api.jar;app\lib\commons-text-1.11.0.jar;app\lib\flatlaf-3.2.2.jar;app\lib\flatlaf-extras-3.2.2.jar;app\lib\Java-WebSocket-1.5.4.jar;app\lib\javax.activation-1.2.0.jar;app\lib\jdom-1.1.jar;app\lib\jl1.0.jar;app\lib\jna-5.6.0.jar;app\lib\jna-platform-5.6.0.jar;app\lib\jogg-0.0.7.jar;app\lib\jorbis-0.0.15.jar;app\lib\jpen-2.jar;app\lib\json-simple-1.1.jar;app\lib\jsonic-1.3.10.jar;app\lib\jsvg-1.2.0.jar;app\lib\kotlin-reflect-1.7.21.jar;app\lib\kotlin-stdlib-1.7.21.jar;app\lib\kotlin-stdlib-common-1.7.21.jar;app\lib\kotlin-stdlib-jdk7-1.7.21.jar;app\lib\kotlin-stdlib-jdk8-1.7.21.jar;app\lib\Live2DCubismCore.jar;app\lib\Live2DCubismMotionSync.jar;app\lib\Live2DCubismPFUtils.jar;app\lib\log4j-api-2.17.1.jar;app\lib\log4j-core-2.17.1.jar;app\lib\log4j-iostreams-2.17.1.jar;app\lib\log4j-jcl-2.17.1.jar;app\lib\log4j-jul-2.17.1.jar;app\lib\mp3spi1.9.4.jar;app\lib\onnxruntime-1.13.1.jar;app\lib\opencsv-5.9.jar;app\lib\rlm1603.jar;app\lib\slf4j-api-2.0.6.jar;app\lib\slf4j-simple-2.0.6.jar;app\lib\tritonus_share.jar;app\lib\vorbisspi1.0.2.jar;app\lib\jogl\gluegen-rt.jar;app\lib\jogl\jocl.jar;app\lib\jogl\jogl-all.jar
rem ** Native library directory
set NATIVE_PATH=app\dll64;app\dll64\windows-amd64
rem ** Add DLL Directory to PATH
set PATH="%PATH%;%~dp0app\dll64;"
if exist ProxyConfig.bat call ProxyConfig.bat
%JAVA_EXE% ^
-classpath "%CLASS_PATH%" ^
-Djava.library.path="%NATIVE_PATH%" ^
-Djogamp.gluegen.UseTempJarCache=false ^
-Dsun.java2d.d3d=false ^
-Duser.language=zh ^
%MAXMEMORY% ^
-showversion ^
--add-exports=java.base/jdk.internal.org.objectweb.asm=ALL-UNNAMED ^
-javaagent:"%APPDATA%\Turboism\agent\cubism-hook-agent-latest.jar" ^
-Dcubism.agent.log="%APPDATA%\Turboism\agent_runtime.log" ^
-Dcubism.agent.config="%APPDATA%\Turboism\turboism.config.json" ^
-Dcubism.agent.actionInbox="%APPDATA%\Turboism\agent_actions.txt" ^
-Dcubism.agent.enableOverlayRedButtonInject=true ^
-Dcubism.agent.enableOverlayRedButtonFallbackSync=false ^
-Dcubism.agent.enableOverlayRedButtonAutoShrink=false ^
-Dcubism.agent.redButtonLabel=Copilot ^
-Dcubism.agent.redButtons=Copilot ^
-Dcubism.agent.parameter.qConfirm=true ^
-Dcubism.agent.parameter.editBatch=true ^
-Dcubism.agent.enableActionInbox=false ^
-Dcubism.agent.actionInbox="%APPDATA%\Turboism\agent_actions.txt" ^
-Dcubism.agent.enableSocketBus=true ^
-Dcubism.agent.busHost=127.0.0.1 ^
-Dcubism.agent.busPort=19191 ^
-Dcubism.agent.actionPollMs=30 ^
-Dcubism.agent.logDeformerList=false ^
-Dcubism.agent.traceCallbacks=false ^
-Dcubism.agent.enableWarpModify=false ^
-Dcubism.agent.enableBroadHooks=false ^
-Dcubism.agent.verbose=false ^
-Dcubism.agent.warpTarget=Warp ^
-Dcubism.agent.warpDx=8 ^
-Dcubism.agent.warpDy=0 ^
-Dcubism.agent.cubismVersion=5.3.02 ^
-Dcubism.agent.cubismMajorMinor=5.3 ^
-Dcubism.agent.profile=v5_3 ^
-Djava.locale.providers=COMPAT,SPI ^
com.live2d.cubism.CECubismEditorApp ^
"%~f1"

5. 验证是否生效#

正常启动程序即可, 理论上会自动运行

0.9.3#

杂项#

  • 配置脚本中增加跳过开屏Splash/更新检查/更新主页(每次有新版本弹出来的弹窗)
  • 代码整理

0.9.1#

面板#

  • 增加参数/变形器列表右键菜单
  • 增强浮窗Dock逻辑
  • 参数列表支持名称过滤

变形器#

  • 快捷对称轴镜像

动画#

  • 支持场景顺序和名称过滤

0.9.0#

面板#

  • 增加浮窗Dock, 每个tab都可以独立到单独窗口
  • 增加自定义Todo Tab, 可以为每个工程单独保存文本信息

杂项#

  • 增加画布重设功能, 按下按钮自动设置画布大小
  • 增加作者信息
  • 增加PSD重导入图层关系修复(未测试)

0.8.0#

参数#

  • 批量参数调整/复制
  • 批量控制点反转/调整/变更
  • 批量设置模型参数支持融合变形Morph和结合Combine的导入导出
  • 参数锁定

面板#

  • 自定义tab
  • 部件面板自定义右键菜单
  • 变形器面板自定义右键菜单

曲面变形器#

  • 自定义红框按钮

Artmesh#

  • 自动从PSD导入剪切关系
  • 顶点编辑的镜像功能支持旋转镜像轴
  • 四等分阈值保护, 网格编辑时, 如果四等分超出阈值会进行警告(ps. 如果不想因为四等分卡死,最好不要设置太高)

杂项#

  • 工程和运行时文件各自独立保存路径
  • 最近工程加入预览图, 支持主题
  • 加入内存限制(未测试)

截图#

Turboism 截图 1 Turboism 截图 2 Turboism 截图 4 Turboism 截图 6 Turboism 截图 7 Turboism 截图 8 Turboism 截图 9 Turboism 截图 9 Turboism 截图 10 Turboism 截图 11 Turboism 截图 12 Turboism 截图 13 Turboism 截图 14 Turboism 截图 15 Turboism 截图 16 Turboism 截图 17 Turboism 截图 18 Turboism 截图 18

更新记录#

2026/5/23#

  • 新增自定义主题系统:4 个内置主题(Mint/Paper/Slate/Nord)、主题管理器对话框、继承链、图标着色
  • 插件系统框架建设:12 功能模块清单化、PluginManager 完整生命周期、SPI 服务层(8 个扩展点)、内联 JSON 解析器
  • 图标系统增强:T-logo 设计、运行时着色、资源桥接拦截点
  • 变形器镜像增强:扭曲补偿、保留子级默认关键帧
  • 架构文档补全:Cubism 渲染管线、性能字节码验证、内存爆炸调查

2026/4/21#

  • 整理为 1.0.0 版本说明
  • 新增性能优化开关、导出前纹理图集预处理优化与性能统计入口
  • 默认参数列表编辑器支持分组/颜色,并补充工程级配置持久化
  • Scene / Log / Dock / Todo 等面板工作流继续增强,PSD 重导修复链路纳入正式版本

2026/3/24#

  • 5.2/5.3支持
  • 批量设置模型参数支持融合变形Morph和结合Combine的导入导出

2026/3/25#

  • 实现了弯曲变形器/物体的自定义红框按钮

2026/3/31#

  • 实现了自定义部件栏的右键菜单
  • 实现了自定义变形器栏的右键菜单

2026/4/1#

  • 实现了自动从PSD导入剪切关系

2026/4/2#

  • 实现了顶点编辑旋转轴支持
  • 实现了参数锁定
  • 实现了工程和运行时文件各自独立保存路径
  • 实现了最近工程预览图

2026/4/3#

  • 实现了四等分阈值保护
  • 内存限制

2026/4/4#

  • 更新配置脚本
  • 为剪切关系导入加入限制

2026/4/6#

  • 实现了浮窗Dock
  • 实现了画布一键重设

2026/4/8#

  • 实现了浮窗Dock增强
  • 实现了变形器对称编辑
  • 实现了动画场景面板排序

2026/4/9#

  • 实现了参数过滤
  • 实现了变形器对称编辑增强

提需求#

在这里评论或者发邮件给我

支持我#

爱发电