此文档涵盖了 bd2wg 的基本使用方式, 以及一些有助于更好使用的内容.
前往Releases 页面下载最新版本.
选择对应平台的包, 解压, 使用时直接运行 bd2wg-cli.exe 即可.
上面这张截图展示了 bd2wg-cli 的全部使用流程.
运行程序后, 在 story: 输入脚本路径, 在 outdir: 输入导出位置, 在 redirect: 输入复用规则即可开始执行.
Warning
若您不是在编辑界面取得脚本, 而是爬取发布的故事而来, 请只保留 post/storySource 下属的全部字段.
一个合法的 Bestdori 脚本应由至少 actions, bgm, background 组成.
对于导出路径 outdir, 请注意是否需要在尾部追加 game/ 目录.
导出位置将会生成 scene, figure, background, bgm, vocal 目录.
导出将会覆盖重名内容, 请重点关注 scene/start.txt.
程序运行时发生的错误会在每个流程完成后统一呈现.
由于转译的宽容性, 以及下载的重试操作, 基本不会发生致命错误.
请您一定要仔细阅读报错内容, 这将有助于您了解严重程度以及处理方式, 例如:
-
若转译发生错误, 您可能只需要微调原脚本 / 生成的脚本.
-
若下载发生错误, 有可能是资源本身存在问题. 否则, 您可以根据 url 和写入路径手动下载.
模型复用是 v1.2.0 新增的功能, 支持用户复用 WebGAL 引擎现有的本地人物模型.
在开始的 redirect: 按照 [<rule>, ...] 的格式输入规则集, 程序将加载 ./assets/redirect/<rule>.xml 对应的复用规则 (若不需要, 输入 [] 或不输入).
规则集 xml 格式见 redirect.xsd.
若您有意向编写 xml 复用脚本, 还请参考模板字符串的文档: template-parse.
-
对于每个
model, 若通过match的正则, 正则将捕获模型名到model. -
接着, 在
costumes中按照指定语法生成模型路径, 并顺序寻找存在且格式规范的模型配置. -
若通过, 将生成复用器, 同时此次转移中该模型将固定选用此复用器 (以后可能会变); 若否, 则不复用, 回退到从 Bestdori 获取.
-
选择多个规则集, 或单个规则集内存在多个
match匹配项时, 程序将按顺序遍历, 直到成功生成复用器. -
复用器复用表情 / 动作时, 会将名称捕获到
expression/motion, 按照模板串依次生成名称映射. 若模型配置文件存在对应条目, 则使用; 否则报错.
上面这张图展示了使用 Edge 开发者工具爬取已发布故事脚本的过程 (请注意框出的内容).