ztmz_pacenote 🎉🎉🎉🎉🎉🎉🎉🎉🎉🎉🎉

• 更新计划。待完成任务。欢迎提PR和Issue。
• github 镜像
• 注意：购买尘埃拉力赛2.0时请务必购买 “年度版”，不要买本体！！！本体缺了大量内容，补买DLC又巨贵无比！！！年度版steam__经常打折__只要30元左右，等不及打折可以去淘宝购买。

演示视频

• 【8岁半小孩用手动H档驾驶B组赛车获全球纪录排行榜第25名，中国第1。DiRT Rally 2（尘埃拉力赛2），汉考克山反向赛道，用时2分53秒85。】
• 理查德伯恩斯拉力赛wrc2017世界纪录

友情链接

• simRallyCn：模拟拉力中文社区

截图

简介

ZTMZ车队路书工具，可以录制和播放Dirt Rally 2.0游戏的路书，车队QQ群：207790761，路书交流群：697673264

白嫖指南 (安装过程请保持网络处于连接状态)

1. 通过下载地址下载最新版的名为 "ZTMZ Club路书工具x.y.z标准版(xxM).exe" 的安装文件双击安装
2. 安装期间如果检测到系统中未安装 dotnet6运行时，安装程序会自动下载并安装，可能会弹出UAC提示框，点击“是”即可
3. 打开游戏
4. 在游戏设置的语音选项(Audio)中关掉原版的路书声音(Speech选项拖到最左边)
5. 开始体验
6. 上述过程出了问题：疑难解答

如何和simhub一起使用

1. 在本工具右上角的设置界面里把UDP端口修改为20778
2. 打开 simhub，选择DR2游戏并点击右侧的 游戏设置
3. 在 UDP Forwarding(端口转发)那里前面的勾勾选上，并添加一条转发到 127.0.0.1的 20778端口的设置（如果已经存在，就只需要勾选上前面的勾即可）
4. 保持simhub处于开启状态，启动本工具即可
5. 本步骤对于想要同时使用其他的工具也适用，比如 Dirt Rally Telemetry工具，它默认监听 10001端口，只需在 simhub里再添加一条转发到 127.0.0.1的 10001端口的记录就行

各种链接

• 下载地址：releases
• 路书录制进度：【腾讯文档】尘埃拉力赛2.0地图路书录制进程
• 路书标记对照表：【腾讯文档】路书对照表
• 视频
  • 版本通用使用教程 (置顶评论有进度条)
  • [2021-08-29 直播录像][尘埃拉力赛2.0] 录制路书阿根廷第一个图Las Juntas并拆分 (置顶评论有进度条)
  • 2.x版本演示视频 by bigboxx
  • 2.x版本录制和播放使用教学（脚本路书） by 草帽不是猫
  • 1.x版本演示视频 by bigboxx
  • 1.x版本录制和播放使用教学（纯语音路书） by 草帽不是猫
  • 1.x版本录制和播放使用说明文档 by bigboxx

文件目录说明 (位于 %userprofile%/Documents/My Games/ZTMZClub)

• codrivers 用来存放语音包，可以根据【腾讯文档】路书对照表并对照其他语音包的格式，在该文件夹下新建文件夹来创建新的语音包
• lang 多语言文件，可以在此处对照其他文件，新建新的语言支持
• profiles 用来存放路书，里面默认有个 default文件夹，可以新建其他文件夹用来存放另一个版本的路书，default文件夹中的 pacenote文件为路书脚本，以地图名命名的一些文件夹中存放的是纯语音路书
• games 用来存放各个游戏的配置以及多语言文件
• Python38 (仅开发版) Python38的运行环境
• speech_model (仅开发版) Vosk语音识别模型

各模块简介

• OnlyR.Core 从github上直接“借鉴”的声音录制代码AntonyCorbett/OnlyR
• ZTMZ.PacenoteTool 主程序，包含界面显示和录制播放的主要逻辑
• ZTMZ.PacenoteTool.Base 基础模块，目前只放了配置文件的加载与保存的逻辑
• ZTMZ.PacenoteTool.ScriptEditor 脚本路书编辑器，用来编辑脚本路书
• ZTMZ.PacenoteTool.AudioBatchProcessor 批量音频文件处理工具，可以用来批量压缩音频文件，批量调整纯语音路书的播放点，批量对音频文件进行掐头去尾的操作。
• ZTMZ.PacenoteTool.AudioPackageManager 语音包管理工具，可以用来创建新的语音包、检查语音包内容完整性、试听语音包内容

项目依赖

• Newtonsoft.Json
• NAudio
• PromptDialog
• AvalonEdit
• WindowsAPICodePack-Shell
• Vosk
• GameOverlay.Net
• CoDriver-Splitter
• Material Design Xaml Toolkit
• Inno Setup
• Inno Setup Chinese Simplified Translation
• NLog

本项目参考的项目

• CrewChiefV4
• dr2_logger
• Dirt Telemetry Tool
• NGPCarMenu

如何贡献代码

1. Fork本项目并使用git下载源码
2. 安装.net 6.0 SDK
3. 使用visual studio 2022或JetBrains Rider通过根目录的ZTMZ.PacenoteTool.sln文件打开本项目，或者直接用VSCode打开本项目文件夹
4. 运行.\build.bat命令编译项目，运行.\builddebug.bat编译调试版本
5. 将之前最新版本的路书工具安装后，从 %userprofile%\My Games\ZTMZClub\ 目录中，将codrivers和profiles目录拷贝到项目的bin\Release\net6.0-windows\目录下
6. 下载安装Inno Setup，并设置系统的Path环境变量，增加ICSS.exe文件所在的目录，默认安装应该是C:\Program Files (x86)\Inno Setup 6
7. 从GitHub上安装Inno Setup的中文语言包。具体为下载ChineseSimplified.isl文件放到C:\Program Files (x86)\Inno Setup 6\Languages目录下
8. 运行.\package.bat进行打包，可以在Output目录找到打包好的安装包
9. 做出修改调试运行无误后，打包项目为exe包并本地安装测试通过后，将代码推送至gitee，再创建PR到本项目

脚本路书编写小技巧

• 在英文输入法状态下输入 ,(逗号)或者 /(左斜杠)，即可展开候选路书标记框
• 对于用来修饰弯道的标记，比如 /dont_cut(不要切弯)，可以使用 /(左斜杠)而不是 ,(逗号)作为起始，虽然使用 ,不影响实际使用，但使用 /可以提升阅读体验
• 在候选路书标记框展开后可以继续输入路书标记，来过滤框里的候选标记。
• 在候选路书标记框展开时可以用方向键 ↑和 ↓来对候选标记进行选中
• 选中后按 Enter键或者 Tab键，即可自动补全标记
• 如果想要选择的标记处于第一的位置，无需选择，直接按 Enter或 Tab即可

例如：想要输入 5_left(左五)，只需依次键入 , 5 Enter三个按键即可完成左五的输入； 如果想要输入 5_right(右五)，只需依次键入 , 5 ↓ Enter即可（因为左5是第二个候选），或者键入 , 5 _ r Enter也可以

如何贡献脚本路书（方法1）

1. 加入路书录制群
2. 选定要录制的路书，并在【腾讯文档】尘埃拉力赛2.0地图路书录制进程文档中对应的赛道标记好自己的名字，标记好录制状态（进行中）
3. 录制完成后上传到群文件，或在脚本路书工具中点击分享至ftp，并修改上述文档中对应的赛道录制状态为已完成

如何贡献脚本路书（方法2）

1. Fork脚本路书项目：dr2_pacenote_scripts
2. 创建issue申请录制某(几)条赛道的路书
3. 使用本工具录制路书完成后提交PR到路书项目

如何贡献脚本路书语音包

1. 在【腾讯文档】路书对照表中，对corner, detail, number 三张表中的每个标记都录制一段语音，以标记名称作为文件名，录制内容可以自由发挥
2. 参考工具中现有的语音包的格式，default语音包是个比较好的例子，使用工具主界面左下角的语音包管理工具对语音包完整性进行检查
3. 如果对有个标记希望有多个语音随机播放，可以在以标记为名的文件夹中放置多个语音文件，参考 圣沙蒙VK 语音包中的detail_start_stage的形式即可
4. 录制好语音后联系群内的 bigboxx 大佬
5. 非常建议使用ogg格式声音文件，而不是mp3！！！！mp3有bug！！！连wmv格式都比mp3好！！！！

项目计划

鸣谢

• 小贤少少 为车队的付出
• Meeke777 的路书实现思路
• Greened U幻想最初 的初始路书标记整理
• Bigboxx 对路书工具的建议和语音包的制作
• 圣沙蒙VK 的语音包和语音路书的录制
• 紫藤林沫 的语音包录制
• 拉稀车手老王 的语音包录制
• 权威Authority 的语音包录制
• wha1ing 的语音包录制
• Hippopo 的语音包录制和路书校对
• 大李子小妖 的语音包录制
• mesa 的英文tts语音包录制
• 南沢いずみ 的天津话语音包录制
• 左衛門 的路书校对
• 以及各位大佬的路书录制：（按字母顺序）
  • HanXu
  • Hippopo
  • 回家的誘いをかける
  • 栗悟饭とカメハメ波
  • Meeke777
  • O.Z. (Gliese-436b)
  • Silenig
  • smoke (DR2略略略)
  • Zexx