[工具] [功能MOD必备]调整档说明书浏览器 (TDesc Browser)

TS4调整说明浏览器不是游戏MOD，是可以做为模组作者或是想制作模组的人的实用工具。

描述
scumbumbo（作者）大约在2015年就开发出Tuning Description Browser（调整档说明书浏览器），但是鲜少模组作者知道这项工具，所以scumbumbo决定在2018年于MTS上分享出来，让更多人可以藉由MTS搜寻到这项工具。

如果你读过Tuning Description（简称TDesc，翻译调整档说明书），就会知道TDes是非常可贵却难以阅读的资料，scumbumbo以override_convergence_value这个调整档为举例，TDes是这样说明这个档案（而且在原始文件中还只以一行来表示!）很难阅读对吧？光是从数千行的程式码中，找出特定的XML元素就足以让许多模组作者退却，甚至不愿使用TDesc。


功能

• 从TDesc读取出调整档的文字说明，并且以树状结构呈现。
• 细节视窗会显示出调整档的名称，Python中的类型，完整的文字描述，预设值以及导出的格式。
• 各项专业术语有设置 “帮助” 支援连结到EA官方的模拟市民4自定义内容指南书。
• 搜寻功能，可以输入名称，描述或Python的类型来搜寻相似的内容。
• 可以同时浏览复数TDesc。
• 这项工具软体可以多开视窗，借以比较不同版本之间的TDesc有何差异。
• 不同版本的TDesc皆有编入索引，视窗中有连结可以引导到旧的说明。
  

安装
TS4 Tuning Description浏览器的应用程序有两种模式，独立的* .exe格式或是适用Windows的MSI的安装程序。安装方式相当简单，但是必要的TDesc档案必须自行从EA下载，并且自行设定它的资料夹位置。


TDesc档案的目录结构

• 第一步，为TDesc新增一个资料夹，放在任何磁碟区都可以，可以放在我的文件夹或是桌面上都行。并且取一个适合的名称，scumbumbo的取名比较沉闷但确实叫作“Tuning Descriptions”。
• 从EA官方论坛Mods and CC Technical Discussions下载TDesc，最新的版本通常就是论坛里的最新文章，如果你想要看旧的TDesc，直接在论坛搜寻「TDESCS」。
• 接着在第一步新的资料夹中，你需要再新增子资料夹，依序放入各个版本的TDesc。如果你想比较不同版本之间的差异，就将各个版本的TDesc分别放入不同的子资料夹。EA在论坛中会说明TDesc的版本号，例如 “1.44.77-TDESC.zip”，那表示应该要放入名称是1.44.77资料夹中。
• 将刚才第三步的TDesc压缩档都解压缩，解压缩后的资料夹有许多个，例如AchievementCategories，AchievementCollections等等，资料夹中会放着* .tdesc格式的档案。
• 一旦你的TDesc都设置好之后，就可以启动TS4 Tuning Description Browser，并且选取你在第一步设定的母资料夹的位置。
• 如果你将资料夹移动了，就必须在TS4 Tuning Description Browser的设置重新设定资料夹位置。
  

使用方法
TS4 Tuning Description浏览器使用上相当简单，这个部分只是笔记说明：

• Window → New就可以再开启另一个视窗，多个视窗可以方便阅读不同版本的TDesc。
• Settings（设定）
  
  • Tdesc Root Folder（TDesc的根目录），这个功能可以变更TDesc资料夹的位置。
  • 自动扩展更改的节点，如果启用了这个功能，当你新增调整档或是变更调整档的时候，右侧的树状会自动展开，方便快速查找。
  • 黄色的萤光标示，表示着这个调整档是最近才被载入。
  • 绿色的萤光表示，表示着这个调整档是最近的版本才被新增。
  • 较大的字体（更大的字体），这个功能会让视窗中的文字都变大25％。
    
• Search（搜寻）
  
  • 如果你安装多个版本的TDesc，搜寻功能只会针对最新的版本进行搜寻。
  • 可以输入复数个单词。
  • 和搜寻模式，跳出的搜寻结果表示输入的每个单词是一起出现至少一次。
  • 或搜寻模式，跳出的搜寻结果表示输入的单词至少有一个。
  • 精确匹配搜索模式，跳出的搜索结果包含了元素名称，Python类型，必须是包含了输入的单词才符合这个条件。
  • 搜寻时输入的单词的大小写没有区别。
  • 搜寻时如果不够明确，就会跳出一大堆相似的搜寻结果。
    
  
  

额外感谢注记

• scumbumbo谢谢所有帮助他完成这篇MTS文章的人。
• 应用程序的原始码是来自Shibu Matthew以mav.northwind的名义张贴在codeproject.com的RichTextBoxEx，原始码是Visual Basic，原作者的连结包含在開源码中。