LunaTranslator 模拟器文本支持解析：PS Vita（Vita3K）游戏兼容表与 JIT 挂钩实现-北京尧图网络

LunaTranslator 模拟器文本支持解析PS VitaVita3K游戏兼容表与 JIT 挂钩实现【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslatorLunaTranslator 通过挂钩Hook机制从模拟器进程内部截取游戏文本实现对视觉小说类游戏的内嵌式翻译。本篇以仓库中 docs/emusupportlist/psv.md 为核心系统梳理 LunaTranslator 对 PS Vita 平台的模拟器支持清单175 个标题 ID、183 条记录并结合 vita3k.cpp 与 vita3k_1.cpp 的源码实现讲解 Vita3K 的 JIT 翻译块挂钩原理、版本兼容策略与逐游戏文本过滤规则让读者既能查阅兼容表也能理解其底层工作方式。PSV 在 LunaTranslator 模拟器支持体系中的位置LunaTranslator 通过模拟器支持大量游戏。官方文档将模拟器支持按平台汇总在 docs/emusupportlist/all.md 中并统一嵌入各语言版的模拟器游戏支持页面。其中 PS Vita 平台的对应模拟器为Vita3K要求版本≥ v0.1.9.3339该版本号同时是源码中vita3k::attach_function1()的最低版本门槛。平台支持的模拟器最低版本要求NSyuzu(≥1616) / Eden(MSVC) / Citron(MSVC)PSPPPSSPP ≥ v1.15.0PSVVita3K ≥ v0.1.9.3339PS2PCSX2 ≥ v1.7.4473PS3RPCS3对于表中未列出的游戏官方文档建议向项目提交游戏支持请求issue由社区或开发者补充对应的挂钩数据。兼容表结构与标题 ID 解读psv.md 是一张两列 Markdown 表格列含义示例IDPS Vita 游戏的数字版标题 IDTitle IDPCSG00401Game游戏日文原名ソラ*ユメPS Vita 标题 ID 遵循 PCSx-xxxxx 的地区编码约定PCSG 为日版JapanPCSB 为亚洲版Asia。本表中绝大多数为 PCSG 开头的日版游戏仅有一条 PCSB00985PSYCHO-PASS MANDATORY HAPPINESS为亚洲版记录。值得注意的几点一张表一个挂钩数据库表中的每一个 ID 都对应 vita3k_1.cpp 中emfunctionhooks_1数组里的一条钩子定义{模拟器虚拟地址, {类型, 偏移, 填充, 文本处理函数, 过滤器, 游戏ID}}即这个游戏的文本从哪个模拟器地址读出。部分条目重复出现例如 PCSG00917 同时对应《Starry☆Sky ~Autumn Stories~》与《ワンドオブフォーチュン R》PCSG00789オメルタ CODE:TYCOON 戒、PCSG00855花朧、PCSG00745スカーレッドライダーゼクス、PCSG00618ロミオVSジュリエット全巻パック也各出现两次。这类情况通常源于同一标题 ID 在源数据中存在多条挂钩记录多版本、多文本函数生成脚本原样输出所致。全表共183 条记录、175 个去重后的唯一标题 ID。完整兼容游戏列表日文原名以下为 psv.md 的完整内容逐行继承原表未删减IDGamePCSG00401ソラユメPCSG00271Princess ArthurPCSG00543冴えない彼女の育てかた -blessing flowers-PCSG00689ToLOVEるダークネストゥループリンセスPCSG00789オメルタ CODE:TYCOON 戒PCSG00505大図書館の羊飼い -Library Party-PCSG01049TOKYOヤマノテBOYS for V FAN DISCPCSG00664なないろリンカネーションPCSG00944白と黒のアリスPCSG01192白と黒のアリス -Twilight line-PCSG00458ROOT∞REXXPCSG00663Rear phelesPCSG00062TIME TRAVELERSPCSG00768ヴァルプルガの詩PCSG00591アブナイ☆恋の捜査室 Eternal HappinessPCSG00611絶対迷宮秘密のおやゆび姫PCSG00139フォトカノ KissPCSG00509POSSESSION MAGENTAPCSG00020極限脱出善人シボウデスPCSG01063イケメン戦国◆時をかける恋新たなる出逢いPCSG00766ニル・アドミラリの天秤帝都幻惑綺譚PCSG01014ニル・アドミラリの天秤クロユリ炎陽譚PCSG00755BROTHERS CONFLICT Precious BabyPCSG00469CLOCK ZERO 終焉の一秒 ExTimePCSG00866Collar×MalicePCSG01001Side Kicks!PCSG00299俺たちに翼はないPCSG01259シルヴァリオトリニティ -Beyond the Horizon-PCSG01023追放選挙PCSG01282死神と少女PCSG01268神凪ノ杜五月雨綴りPCSG01194参千世界遊戯 ~MultiUniverse Myself~PCSG01008Marginal #4 Road to GalaxyPCSG00448MARGINAL#4 IDOL OF SUPERNOVAPCSG00935BLACK WOLVES SAGA -Weiβ und Schwarz-PCSG00903New Game! The Challenge Stage!PCSG00829喧嘩番長乙女PCSG00751アルカナ・ファミリア -La storia della Arcana Famiglia- AncoraPCSG00706もし、この世界に神様がいるとするならば。PCSG00696アンジェーリークルトゥールPCSG00648月に寄りそう乙女の作法PCSG00410熱血異能部活譚 Trigger KissPCSG00389バイナリースターPCSG00291アマガミPCSG00216るいは智を呼ぶPCSG00405レンドフルールPCSG00776Muv-LuvPCSG00911Re:BIRTHDAY SONG恋を唄う死神PCSG00912Un:BIRTHDAY SONG 愛を唄う死神PCSG00401ソラ*ユメPCSG01180天涯ニ舞ウ、粋ナ花PCSG00468黒蝶のサイケデリカPCSG00812灰鷹のサイケデリカPCSG00808悠久のティアブレイド -Lost Chronicle-PCSG01075悠久のティアブレイド -Fragments of Memory-PCSG00852マジきゅんっルネッサンスPCSG01066蝶々事件ラブソディックPCSG00477百華夜光PCSG00855花朧戦国伝乱奇PCSG00815サイキックエモーションムーPCSG00402CodeRealize 創世の姫君PCSG00805CodeRealize 祝福の未来PCSG01110Code:Realize 白銀の奇跡PCSG00789オメルタ CODE:TYCOON 戒PCSG01221紅色天井艶妖綺譚二藍PCSG00611絶対迷宮秘密のおやゆび姫PCSG00787鏡界の白雪PCSG00397ニセコイヨメイリPCSG00530DIABOLIK LOVERS DARK FATEPCSG00472DIABOLIK LOVERS VANDEAD CARNIVALPCSG00910DIABOLIK LOVERS LOST EDENPCSG00826DIABOLIK LOVERS LUNATIC PARADEPCSG00272DIABOLIK LOVERS LIMITED V EDITIONPCSG00476DIABOLIK LOVERS MORE,BLOOD LIMITED V EDITIONPCSG00833Norn9 ~Norn Nonette~ Act TunePCSG00431NORN9 VAR COMMONSPCSG01011空蝉の廻PCSG01158真紅の焔真田忍法帳PCSG00991月影の鎖狂爛モラトリアムPCSG00794月影の鎖錯乱パラノイアPCSG00619源氏恋絵巻PCSG00510Starry☆Sky ~Spring Stories~ / Starry Sky ~Spring Stories~PCSG00916Starry☆Sky ~Summer Stories~ / Starry Sky ~Summer Stories~PCSG00917Starry☆Sky ~Autumn Stories~ / Starry Sky ~Autumn Stories~PCSG00918Starry☆Sky ~Winter Stories~ / Starry Sky ~Winter Stories~PCSG00917ワンドオブフォーチュン RPCSG00938ワンドオブフォーチュン時空に沈む黙示録PCSG01208ワンドオブフォーチュン君に捧げるエピローグPCSG00592I DOLL UPCSG00853ピリオドキューブ鳥籠のアマデウスPCSG00855花朧戦国伝乱奇PCSG00618ロミオVSジュリエット全巻パックPCSG00561時の鐘とシンデレラシンデレラシリーズトリプル全巻パックPCSG00614ハートの国のアリスWonderful Wonder WorldPCSG00580新装版魔法使いとご主人様Wizard and The MasterPCSG01167円環のメモーリア -カケラ灯し-PCSG01068ネオアンジェリーク天使の涙PCSG00745スカーレッドライダーゼクス Rev.PCSG01036緋色の欠片おもいいろの記憶PCSG01046嘘月シャングリラPCSG01019罪喰い千の呪い、千の祈り for VPCSG00667LOVE:QUIZ ~恋する乙女のファイナルアンサー~PCSG00420DRAMAtical MurderPCSG01151GALTIA V EditionPCSG00451ハナヤマタよさこいLIVEPCSG01196sweet poolPCSG01065学園CLUB ヒミツのナイトクラブPCSG00654学園K -Wonderful School Days- V EditionPCSG00535学園ヘヴン BOYS LOVE SCRAMBLE!PCSG00585学園ヘヴン2 DOUBLE SCRAMBLE!PCSG00370デュラララ!! 3way standoff -alley- VPCSG00482デュラララ!! RelayPCSG00172神咒神威神楽PCSG01025ツキトモ。 TSUKIUTA. memoriesPCSG01094アイドリッシュセブン Twelve Fantasia!PCSG01159VARIABLE BARRICADEPCSG01114ワールドエンド・シンドロームPCSG01254添いカノぎゅっと抱きしめてPCSG01325アイキスPCSG01250スキとスキとでサンカク恋愛PCSG00428戦場の円舞曲PCSG01139ピオフィオーレの晩鐘PCSG01127千の刃濤、桃花染の皇姫PCSG01247Panic PaletteパニックパレットPCSG01235ノラと皇女と野良猫ハート2PCSG01297IxSHE TellPCSG01204NGPCSG01284Making*LoversPCSG01314LOVE CLEARPCSG01198アマツツミPCSG01197Cafe Cuillere カフェキュイエールPCSG01150CharadeManiacsPCSG01162Collar×Malice -Unlimited-PCSG01122D.S.-Dal Segno-PCSG01002ダンジョンに出会いを求めるのは間違っているだろうかインフィニト・コンバーテPCSG00841ダンジョントラベラーズ闇堕ちの乙女とはじまりの書PCSG00915DYNAMIC CHORD feat.apple-polisher V editionPCSG01202フローラル・フローラブPCSG01249EVE rebirth terrorPCSG01260フルキスPCSG01283アオナツラインPCSG01289軍靴をはいた猫PCSG01218グリザイアファントムトリガー PCSG01253かりぐらし恋愛PCSG01153カタハネ -An call Belle-PCSG01318金色ラブリッチェPCSG01245金色のコルダオクターヴPCSG00425幕末Rock 超魂PCSG01267your diary PCSG00433絶対絶望少女ダンガンロンパ Another EpisodePCSG01266夢現Re:MasterPCSG00502結城友奈は勇者である樹海の記憶PCSG00728終わりのセラフ運命の始まりPCSG01152Dance with Devils My CarolPCSG01092ひめひび -Princess Days-PCSG01144ひめひび続二学期-New Princess Days!!-PCSG00534カエル畑つかまえて・夏千木良参戦PCSG00520カレイドイヴPCSG00595神々の悪戯 InFinitePCSG00449神さまと恋ゴコロPCSG01087キミの瞳にヒットミーPCSG01213古書店街の橋姫々PCSG01178ナデレボPCSG01096猛獣たちとお姫様 in blossomPCSG00417クロガネ回姫譚閃夜一夜PCSG00574スクール・ウォーズ全巻パック本編卒業戦線PCSG00618ロミオVSジュリエット全巻パックPCSG00574スクール・ウォーズ全巻パック本編卒業戦線PCSG00604猛獣使いと王子様 Flower SnowPCSG00526新装版お菓子な島のピーターパンSweet Never LandPCSG01203タユタマ -youre the only one-PCSG01034戦極姫戦雲つらぬく紅蓮の遺志PCSG00481新装版クリムゾン・エンパイアPCSG00914うたの☆プリンスさまっ♪Repeat LOVEPCSG01081うたの☆プリンスさまっ♪Amazing Aria Sweet Serenade LOVEPCSG00745スカーレッドライダーゼクスPCSG00615東京喰種トーキョーグール JAILPCSB00985PSYCHO-PASS MANDATORY HAPPINESSPCSG00769逢魔が刻かくりよの縁PCSG00367Goes!PCSG00382RE:VICE[D]PCSG00640SA7 -Silent Ability Seven-PCSG00780赤い砂堕ちる月兼容表由源码自动生成genemusupportlist.py这张表并非手工维护而是由仓库脚本 genemusupportlist.py 从挂钩源码的注释中自动提取生成。其原理是正则匹配 vita3k_1.cpp 中以// 游戏名开头的注释行若注释行内带//标题ID如// 追放選挙 //PCSG01023直接提取否则取注释后第一条定义中的PCSGxxxxx字符串多个 ID 用连接对应合辑/多 Disc 作品由maketable()拼接出| ID | Game |格式的 Markdown 表格写入docs/emusupportlist/psv.md。同理NSyuzu_1.cpp、PSPppsspp_1.cpp、PS2PCSX2_1.cpp、PS3rpcs3_1.cpp的兼容表也由同一脚本生成。这意味着表中每一个游戏都必然能在vita3k_1.cpp的emfunctionhooks_1数组中找到对应条目——兼容表是挂钩数据库的可读视图。Vita3K 挂钩的底层实现解析模拟器识别与版本门槛vita3k.h 定义了vita3k引擎类check_by CHECK_BY::CUSTOM通过Util::CheckFile(LVita3K.exe)或Util::SearchStringFileInfo(LVita3K PSVita Emulator)识别进程is_engine_certain false即识别存在不确定性可能在非标准命名进程下失败构造时查询版本并将引擎名显示为vita3k x.y.z.w格式。在 vita3k.cpp 的attach_function1()中auto minver std::make_tuple(0u, 1u, 9u, 3339u); if (version version minver) return false;即Vita3K 低于 v0.1.9.3339 时直接放弃挂钩并在attach_function()中弹出模拟器版本不支持的提示——这与 all.md 中≥ v0.1.9.3339的要求完全一致。核心JIT 翻译块挂钩dynarmic RegisterBlockVita3K 是 PS Vita 模拟器游戏 ARM 代码由内部 JITdynarmic动态翻译为 x86-64 执行。LunaTranslator 的切入点是 JIT 的翻译块注册函数EmitX64::RegisterBlock(const IR::LocationDescriptor, CodePtr entrypoint, size_t)// Vita3K\external\dynarmic\src\dynarmic\backend\x64\emit_x64.h // BlockDescriptor EmitX64::RegisterBlock(...)getDoJitAddress()vita3k.cpp通过特征码扫描在进程内存中定位该函数并提供多套备选特征以兼容不同 Vita3K 版本首选 pattern1对应 v0.2.1 4049 附近的版本源码注释给出对应 commitdynarmic 动态链接 libc/stdc备选RegisterBlockSig1再备选PatchBlockSig1/PatchBlockSig2后者标注为 0.1.9 3339 版本所用。挂钩RegisterBlock后每次 JIT 编译出新的翻译块LunaTranslator 都能拿到auto descriptor context-argof(idxDescriptor 1); // r8 auto em_address *(uint32_t *)descriptor; // 虚拟地址 auto entrypoint context-argof(idxEntrypoint 1); // r9翻译块入口随后用em_address查表CheckEmAddrHOOKable若命中 vita3k_1.cpp 中该游戏地址的钩子定义则以entrypoint为断点安装内存钩子文本读取走JITTYPE::VITA3K专用通道codepage 932即 Shift-JIS日版游戏的文本编码。版本适配偏移量与窗口标题识别源码中针对 Vita3K 版本差异做了两处关键适配地址偏移修正addr_offset以是否存在Qt6Core.dll判断是否为 v0.2.1 4000 之后引入 Qt 主界面的版本v0.2.1 4000~4032 之间偏移量额外-0x1000v0.2.1 4033 起为-0xFFC000对 0.1.9 3339 还需对低于 0x80000000 的地址0x80000000归一化。这正是 all.md 要求特定版本以上的原因——挂钩依赖随模拟器变动过低版本无法保证命中。游戏 ID 自动识别trygetgameinwindowtitlevita3k.cpp通过GetWindowText读取 Vita3K 窗口标题形如Vita3K 标题 | (PCSGxxxxx) | ...用|分段并正则提取括号内的标题 ID作为MatchGameId的匹配依据。源码注释特别提醒Vita3K 的 Vulkan 渲染模式下调用 GetWindowText 可能卡住故通过0x3000地址的独立钩子实现轮询而非阻塞读取。64 位专属挂钩由 emulators/CMakeLists.txt 可见vita3k.cpp/vita3k_1.cpp只编译进CMAKE_SIZEOF_VOID_P EQUAL 864 位分支32 位构建仅包含 PPSSPP——这是 JIT 挂钩基于 x86-64 的 dynarmic 后端所决定的架构前提。逐游戏文本处理vita3k_1.cpp 中的过滤器由于各游戏引擎在文本中插入的标记不同换行、ruby 注音、颜色标签、日文半角变体等vita3k_1.cpp 为多个游戏编写了专属文本处理函数FPCSGxxxxx/PCSGxxxxx作为emfuncinfo的hookfunc字段注入。典型示例过滤器目标游戏处理内容FPCSG01023追放選挙移除br、%CF11F、%CFFFF、%K%P、%K%N等引擎控制符FPCSG012820..3死神と少女合并连续换行按对话/旁白/姓名/选项分组去重PCSG00766ニル・アドミラリの天秤等剥离#Ruby[...]注音标签、#n及#[A-Za-z][...]标记过滤纯全角空格行FPCSG00410熱血異能部活譚 Trigger Kiss移除#Pos[...]定位标签并将丸数字①②③…按 Shift-JIS 字节替换为!?、!!、。等标点PCSG00914うたの☆プリンスさまっ♪Repeat LOVE逐段收集以\n结尾的字符串做字节级strReplace修复PCSG01203タユタマ提取#Ruby[...,文本]中正文部分PCSG00401ソラユメ正则规整『...』内部空白PCSG01001/PCSG01247/PCSG01144Side Kicks! 等StringFilter过滤、\n、\c等转义串PCSG00595神々の悪戯 InFinite动态重挂将原钩子置空改为对emu_addr padding的DIRECT_READ轮询读取用于引擎文本不断追加的场景此外同一游戏的多个文本槽位对话、姓名、选项、词典、过场 prolog会在数组中各占一条注释标明用途如// dialogue、// Name、// choices见 vita3k_1.cpp 中 PCSG01282 的四条记录。源码注释还提到 PCSG00543 可以用来锚定不同版本模拟器的偏移量PCSG01268 在 Vita3K v0.2.0 下两条 UTF-16 地址失效、需退回第三条 UTF-8 地址——这些注释说明兼容数据本身也随模拟器版本演化做过校正。使用方式与注意事项准备环境安装 64 位版 LunaTranslatorPSV 挂钩仅随 64 位构建发布并准备 ≥ v0.1.9.3339 的 Vita3K。启动模拟器先运行 Vita3K 并加载目标游戏确保窗口标题正常显示游戏名与括号内的标题 IDVita3K 游戏名 | (PCSGxxxxx)LunaTranslator 据此自动匹配挂钩。开启文本挂钩在 LunaTranslator 中选择对应文本源模拟器挂钩模式确认引擎识别为vita3k x.y.z.w若版本过低会提示模拟器版本不支持。查阅支持情况核对上表是否包含你的游戏未列出的游戏可向项目提交游戏支持请求等待补充挂钩数据。渲染模式提醒Vita3K 使用 Vulkan 渲染时窗口标题读取可能异常源码已注明如遇识别失败可尝试切换渲染后端后重试。小结LunaTranslator 对 PS Vita 平台的支持以 psv.md 这份 175 个标题 ID 的兼容表为入口背后是 vita3k.cpp 对 dynarmic JITRegisterBlock的特征码挂钩、按版本浮动的地址偏移适配、窗口标题驱动的游戏 ID 识别以及 vita3k_1.cpp 中逐游戏定制的文本清洗过滤器。三者共同构成了一条识别模拟器 → 挂入 JIT → 匹配游戏 → 清洗文本的完整链路兼容表则是该链路可读、可检索的对外视图。读者既可以直接用表检索自己游戏的适配状态也可以顺藤摸瓜进入源码理解每个标题 ID 背后具体的挂钩实现。【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

LunaTranslator 模拟器文本支持解析：PS Vita（Vita3K）游戏兼容表与 JIT 挂钩实现

相关推荐

向现有 ScyllaDB 集群添加新数据中心（DC）：完整操作指南与源码级原理解析

多目标哈里斯鹰算法优化MPC实现风电功率波动平抑的Matlab实践

SEO查询报告怎么读？从数据到可执行优化方案的转化指南

更多资讯

NTRU-397格基密码实现与解密失败调试

SmartDNS 家庭网络优化实战：让每台设备拿到最快的 IP

Spring AI 工具调用入参校验与异常兜底策略

ESP-IDF 中 NimBLE 主机协议栈（NimBLE Host API）深入解析：架构、线程模型与编程指南

服务器变慢排查实录：一次Crontab引发的IO瓶颈与Linux性能分析

Encore 与 AI 工具集成实战：LLM 规则自动生成与本地 MCP Server 深度指南

今日更新

基于高阶循环谱的MPSK载波频率估计与MATLAB实现

MiniPdf方：.NET开源Office转PDF的高效解决方案

Solon AI v3.10：Java全栈智能体开发框架解析

本周精选

AI驱动的自动化专利分析平台技术解析

LeetCode-Go 题解：1252. Cells with Odd Values in a Matrix（奇数值单元格计数）双解法剖析

在线答疑系统Java毕设实战：Spring Boot前后端分离与状态流转

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？