SCSP-localify

简体中文 | English

偶像大师 闪耀色彩 棱镜之歌 DMM 版 本地化插件。

注意：使用外部插件属于违反游戏条款的行为。若使用插件后账号被封禁，造成的后果由用户自行承担。

使用说明：

• 将插件本体解压到游戏安装目录内即可 (version.dll 和 imasscprism.exe 在同一级目录)
• 启动游戏后看见控制台（需打开enableConsole ）即安装成功

功能列表

• dump 文本
• 汉化、替换字体
• 解锁帧数
• 切换窗口不暂停
• Free Camera 自由视角
• Live MV 相关 (在 GUI 中修改)
  • 自由选择服装，可以穿别人的衣服
  • 允许相同偶像登场
  • 手动编辑登场偶像，可以选择未解锁偶像
• 角色身体参数实时修改，可修改 身高、头部、胸部、手臂、手掌 大小 (在 GUI 中修改)

配置说明

• 配置项位于 scsp-config.json 文件中

配置项	类型	默认值	说明
enableConsole	Bool	true	是否开启控制台
enableVSync	Bool	false	是否启用垂直同步
maxFps	Int	60	最大帧数 当启用 enableVSync 时，此项配置失效
3DResolutionScale	Float	1.0	3D 渲染分辨率倍率
localifyBasePath	String	scsp_localify	本地化文件目录
hotKey	String (Char)	u	按下 Ctrl + 此项配置的热键，打开插件 GUI
dumpUntransLyrics	Bool	false	dump 未翻译的歌词
dumpUntransLocal2	Bool	false	dump 未翻译的文本
autoDumpAllJson	Bool	false	dump 所有游戏加载的 JSON
extraAssetBundlePaths	String[]	["scsp_localify/scsp-bundle"]	自定义数据包路径 此设置已过时 使用 asset_bundle_path::asset_path 格式对具体要使用的资源进行指定。
customFontPath	String	scsp_localify/scsp-bundle::assets/font/sbtphumminge-regular.ttf	自定义数据包中字体路径 用于替换游戏内置字体
blockOutOfFocus	Bool	true	拦截窗口失焦事件 切换到其它窗口后不会触发游戏暂停
baseFreeCamera	BaseFreeCamera Object	BaseFreeCamera	自由视角配置
unlockPIdolAndSCharaEvents	Bool	false	解锁 角色 - 一览 中的P卡和S卡事件
startResolution	Resolution Object	Resolution	启动游戏初始分辨率

BaseFreeCamera

配置项	类型	默认值	说明
enable	Bool	false	启用自由视角
moveStep	Float	50	摄像机移动速度
mouseSpeed	Float	35	鼠标移动视角灵敏度

Resolution

配置项	类型	默认值	说明
w	Int	1280	窗口宽度
h	Int	720	窗口高度
isFull	Bool	false	是否全屏

自由视角说明 (Free Camera)

• 将 scsp-config.json 中 baseFreeCamera - enable 设置为 true 即可。
• 生效范围：所有 3D 场景。包括但不限于主页、故事、Live

由于游戏v2.6.1的引擎升级，自由视角目前仍存在尚未完全修复的BUG

自由视角操作方法

• 移动: W, S, A, D

• 上移: Space，下移: Ctrl

• 摄像头复位: R

• 视角转动:

  • 键盘: ↑, ↓, ←, →
  • 鼠标:
    • 按 ` 键（数字键最左边，TAB 键上方）切换
    • 或者按住鼠标右键

• 调整视场角 (FOV)

  • 键盘: Q, E
  • 或者鼠标滚轮

Live MV 功能说明

• 在开启 Save & Replace costume changes 选项后打开后可以记录所有服装变化，打开游戏内的试用按钮后也可以记录未解锁的服装，或在DressOrder界面中选择私服，并在MV播放时自动应用所记录的服装信息；在子窗口 "Saved Costume Data" 中可以通过 Remove 按钮移除不需要的记录以取消
• 在开启 Save & Replace costume changes 后再开启 Override MV unit idols 选项，在 "Override MvUnit Idols" 子窗口中通过 Slot X 按钮进行保存上一次修改时的服装信息，不同槽位可以记录同一个偶像以实现相同偶像登场并使用不同服装，无记录的位置将继承当前编队中的原始信息
• "Override MvUnit Idols" 子窗口中可以通过点击数据直接编辑JSON数据进行手动修改（备注：当直接编辑CharaId时，建议使用1（默认）作为HairId的值以避免游戏卡住）

如何汉化

• 将 dumps 目录内的 Json 文件汉化后，放进 scsp_localify 目录即可。
• 汉化仓库：SCSPTranslationData 欢迎各位贡献自己的翻译~

自行 dump 原文

• 游戏内的 UI 文本大致可以分为三类。

  • 1、通过游戏内的 Localify 接口加载

  • 2、不通过 Localify接口加载

  • 3、直接通过 Json 加载（这部分不止文本，还有其它诸如镜头数据、人物动作等，插件也支持替换。）

• 第一类对应 localify.json

• 第二类对应 local2.json 和 lyrics.json

• 除此之外的文件都对应第三类

• （UI 文本一部分走 Localify，一部分不走，很奇怪。）

故事和部分 UI 文本 dump

登录游戏后，进入故事阅读界面，按下 ctrl + u，会弹出控制窗口，勾选 Waiting Extract Text，然后点击任意故事标题，之后会自动 dump 故事文本和 localify.json

歌词和另一部分 UI 文本 dump

将 scsp-config.json 内 dumpUntransLyrics 和 dumpUntransLocal2 设置为 true，然后打开游戏。插件会实时将未翻译的部分 dump 到 Json 中。

如何编译

• 安装 conan 2、cmake
• 运行 generate.bat 获取依赖包
• 通过 build/ImasSCSP-localify.sln 使用 Visual Studio 2022 进行编译

预处理器命令 __SAFETYHOOK

什么是safetyhook以及为什么要使用

safetyhook相比默认的minhook在插入hook时有更高的成功率。

如果插件因为MH_ERROR_MEMORY_ALLOC而无法成功插入hook，就可以尝试safetyhook。

如何编译并使用safetyhook

• 在 deps/safetyhook 路径下运行 cmake . -B build -G "Visual Studio 17 2022" 初始化safetyhook工程（需要手动创建build文件夹）
• 在Release模式下编译 deps/safetyhook/build/safetyhook.sln
• 在当前工程中添加引用
  • C/C++ - General | Additional Include Directories: ..\deps\safetyhook\include
  • Linker - General | Additional Library Directories: ..\deps\safetyhook\build\Release, ..\deps\safetyhook\build\_deps\zydis-build\Release
  • Linker - Input | Additional Dependencies: Zydis.lib, safetyhook.lib
• 在 C/C++ - Preprocessor | Preprocessor Definitions 下添加: __SAFETYHOOK