Trainz/KUIDs

返回顶部

← 上一页 AM&C

↑ Trainz，Trainz入门 — 元素索引，附录 ↓

资源下一页 →

Trainz学员基础知识

Trainz资源维护与创建

TOC | 开始 | 乐趣 | AM&C | 创建 | 书内参考 | ORP参考： • 索引 • 容器 • 种类 • 标签 | 附录 • 版本

词汇表

HKeys-CM

HKeys-DVR

HKeys-SUR

HKeys-WIN

鼠标使用

符号

KUID

思考要点

各种资源名称和KUID，如
内容管理器中“全部复制”可能给您的结果

Highland Valley SD38 No23, <kuid:62941:123>
Sub Station, <kuid:58973:27012>
GW Malt Sec5, <kuid2:97212:5200:1>
ken, <kuid:119692:840>
mack-truck, <kuid2:50567:15770:1>
fred2, <kuid:50567:15717>
Erie covered hopper Mfx2, <kuid:58422:1067>
Tanker MBLX (FUEL), <kuid2:64038:151024:1>
Tanker UTLX 950423(LARS), <kuid2:113556:61005:1>
Tanker ExxonMobil (FUEL), <kuid2:64038:151023:1>

仅供参考，Fred是现在用于列车尾部（以前是车尾）的红光发射仪器包。现代的Fred包含RFID电路和GPS，并与驾驶室中的接收仪器通信数据——如今，甚至包括后视摄像头视图——让工程师准确知道他的列车尾部在路线上的位置。

KUID是在创建资源时分配给它的唯一标识符。TRS2006手册将它们称为源自Kool Things Unique Identifier Data的助记符，Trainz依靠它们来理清事物并组合正确的子资源以呈现3D虚拟世界。KUID的核心部分是作者的Trainz ID代码编号，这将是他创建的每个资源的共同点。这是kuid在第一个分隔符——冒号“:”字符之后的第一个部分。没有kuid代码，就没有资源。Trainz将读取一个没有kuid的配置文件并立即报告几个错误之一，最常见的是——"警告：无法读取<文件夹名>处的资源配置文件"而不是“资源没有有效的kuid”。

此KUID功能是在最初的Trainz 0.9 Beta原型中引入的，目的是将资源组件文件组织到单独的文件夹中，并为了便于对资源进行编目，因为最早版本的后来成为下载站（在线免费资源库）的资源需要一个内置的数据结构来跟踪多个相似资源之间的差异，以及一种可靠的方法来使用正确的指定资源——因为如果仅使用资源名称作为那个时代的硬盘数据原始组织中的文件夹名称，太多名称可能会互相覆盖。解决方案是不依赖可能重叠的名称，而是通过使用kuid派生名称编码的文件夹来组织文件文件夹（将冒号（ ':' ）字符替换为空格）。请参阅您..\UserData\local\hashfolders目录中的文件夹。

识别

Kuid（基本kuid）格式: <kuid : 作者ID# : 基本Kuid索引 >
Kuid2格式: <kuid2 : 作者ID# : 基本Kuid索引 : 版本后缀>

还需要某种方法让用户能够区分不同版本的资源——区分有效的试验版本和无效的版本。在早期开发中设想了过时的表格，但在实践中，这些表格存在某些缺点，因为它们的用途会永远“破坏”资源标识符代码。这种需求催生了扩展的kuid，也就是Kuid2格式，因为随着Trainz 1.0的一系列服务包的发布，追踪特定资源修订版的问题变得越来越重要。可以说，Trainz正在经历磨合期和成长烦恼，但它正在快速发展和成熟。到UTC（如其他地方所述，也可以算作Trainz 1.0的第四个服务包），这两种方法都已到位，软件已训练到能够识别kuid2和kuid格式，以及过时的表格遗留版本。

此外，还希望能够识别资源的原始作者，以及根据国际法谁拥有其版权，以便Auran能够维护其所有权。有两个版本：KUID和KUID2。Trainz的TRS2006之前版本需要手动创建资源，因此必须手动分配KUID。在TRS2006及更高版本中，当您点击“新建资源”或“克隆资源”时，CMP会自动分配KUID。

原始格式的KUID如下所示: <KUID:123456:123456>.

KUID的第一个数字元素是作者的用户ID。可以通过用户的Planet Auran个人资料访问用户ID。用户在注册Planet Auran时会被分配一个用户ID，并且用户ID会以随机数字顺序分配。大多数用户ID要么是5位数，要么是6位数，其中5位数占主导地位。但一些早期的用户ID可能只有4位数或更少。有几个用户ID只有个位数的作者代码。
KUID的第二个数字元素是由作者设置的唯一编号，可以是任意位数，通常是6位左右，并且通常会进行编码，以便前几位数字表示创建的数字资源的类别或类型（例如，10表示火车车厢[滚动库存]，因此101的前缀为平板车，102为40' 箱车，103为refer，等等。一些CC将类型品牌扩展到诸如转向架之类的部件，或者可能为这类部件类型设置一个组。
如果使用CM/CMP创建或克隆资源，CMP会为每个用户安装分配递增的编号，默认情况下在1xxx范围内（开始）。例如，您创建的第一个内容可能是对内置标准路线或会话的更改，因此，如果您的用户标识符为“123456”，则kuid可能会创建为<KUID:123456:1001>，依此类推。
TrainzUtil 可用于更改下一个生成的 KUID 起始值，然后 CM 会在为新的资源 KUID 代码分配时生成高于该值的下一个空闲数字。提示：在给定情况下，由于路线始终具有默认会话，因此路线修改将生成以 1001 和 1002 结尾的两个连续 KUID。

对于 KUID，如果作者将资源上传到 DLS，其 KUID 为 <KUID:123456:100001>，并且他们希望更新它，则需要为更新后的资源分配一个新的 KUID，例如 <KUID:123456:100002>。要替换 DLS 上的资源编号 100001，必须在新资源的配置文件的 obsolete-table 部分中记录过时的资源的 KUID。（在其他地方讨论）。这可能会让人感到困惑，因此 KUID2 被设计为解决此问题。

KUID2

KUID2 的格式与 KUID 略有不同。: <KUID2:123456:123456:1>，其中额外的字段是基于零的版本索引。

与之前一样，前两个数字元素是作者的用户 ID 和资源的唯一标识符。第三个数字是资源的版本号，可以高达“127”。KUID2 实际上是基于零的，因此 <KUID2:123456:123456:0> 与 <KUID:123456:123456> 相同——尽管 N3V 的程序员在何时承认等效性方面存在不一致，因此有效。^{[注释 1]}

现在只需递增版本号即可更新资源。KUID2 的巧妙之处在于它们也可以应用于具有 KUID 的资源。例如，如果我们采用资源 <KUID:123456:100001> 并希望更新到 KUID2，则只需更改更新后资源的KUID 标签使其读取 <KUID2:123456:100001:1>，DLS 就会自动将原始资源标记为已过时（在CM 搜索窗格的术语中为“已过时”；CM 与DLS 通信并跟踪是否有更新的资源可用）。^{[注释 2]} 在本地，每个用户的 CM/CMP 安装程序都会检测此类更新，并通知所有拥有该资源过时 KUID 版本的用户有更新版本可用。由于TS2009 CM 也以可视方式显示此信息，因此使用符号将其更新到 KUID2 版本。

*在 trainzoptions.txt (TR04—TS12) 中设置“freeintcam”开关参数或在 TANE 及更高版本中选中具有相同功能的复选框（释放内部摄像头），将键盘方向键的功能从旋转和倾斜功能更改为前后或左右滑动摄像头位置。Freeintcam 模式使用户能够将许多摄像头完全移出驾驶室或移至更有利于观看（和鼠标控制）的角度。

注释、脚注和参考文献

Config.txt 文件在 Trainz 资源中是普遍存在的，因为没有一个资源可以在没有这种类型的计算机科学容器的情况下进行定义。在编辑或创建 Trainz 内容时，必须始终牢记关键字-键值对。在定义资源的 config.txt 文件中最常见的TrainzBaseSpec包含值和容器。

注释

↑ 某些 N3V Trainz 版本会在 CM KUID 输入窗口中显示 <KUID2:123456:123456:0> 和 <KUID:123456:123456> 相同，而其他版本则对其进行不同的处理，如果在搜索中使用 KUID2 格式，则会忽略数据库中的基本 KUID 形式。
• 经过刻意测试，在配置文件中使用 KUID2 形式作为标识符值是完全可以接受的（在新资源和旧修改的资源中），并且所有版本的 N3V 软件都正确地将其归档。
• 因此，许多人在创建资源时仅使用 KUID2 格式，并且如果保留手动维护的 Trainz 外部数据库（带有源文件的 OS 文件夹）存档，则使用格式“kuid2 xxxx yyyy n;v#-#; assetname”，因为当所有资源都使用 KUID2 语法编码时，这使得创建基于 KUID 可搜索的存档文件夹更加简单。（然后字母数字排序可以无故障地工作。）
• 此类存档还允许搜索以在需要修复或新资源时找到纹理；并且是初始化新 Trainz 版本或重建旧版安装的资源。
↑ N3V 的 CM 版本将拒绝任何尝试打开文件进行编辑，然后仅通过重新提交它来升级它。但是，可以使用两种方法来获得相同的效果。
• 1) 更改配置文件的 KUID，然后将文件夹拖放到 CM 中，由于较旧的 KUID 被“标记”为“已打开以供编辑”，因此软件只是将文件夹和数据视为导入的资源。然后可以重新编辑原始 KUID 并独立提交，或者假设它没有错误，可以只键入CTRL+R 并还原到原始的更改前版本。如果还原一个已打开以供编辑的文件，在移动或删除其文件夹之前重新提交似乎不是必需的，但可能是比这样做更安全的。
• 2) 将文件夹复制到另一个目录，然后在那里更改 KUID，同时通过在原始 KUID 下提交更新的表单来测试改进。这具有在添加更新的 KUID 版本之前对提交进行全面测试的优点。

脚注

参考文献

Trainz 印刷版或pdf 文件手册，适用版本 - 通常位于 ..\extras 或 ..\extras\manuals 文件夹中
TrainzOnline Wiki Config.txt 文件页面和其他各种页面
TrainzOnline Wiki：内容创建者指南页面（各种）
各种CCG 和 Auran 网站

[1] 某些 N3V Trainz 版本会在 CM KUID 输入窗口中显示 <KUID2:123456:123456:0> 和 <KUID:123456:123456> 相同，而其他版本则对其进行不同的处理，如果在搜索中使用 KUID2 格式，则会忽略数据库中的基本 KUID 形式。
• 经过刻意测试，在配置文件中使用 KUID2 形式作为标识符值是完全可以接受的（在新资源和旧修改的资源中），并且所有版本的 N3V 软件都正确地将其归档。
• 因此，许多人在创建资源时仅使用 KUID2 格式，并且如果保留手动维护的 Trainz 外部数据库（带有源文件的 OS 文件夹）存档，则使用格式“kuid2 xxxx yyyy n;v#-#; assetname”，因为当所有资源都使用 KUID2 语法编码时，这使得创建基于 KUID 可搜索的存档文件夹更加简单。（然后字母数字排序可以无故障地工作。）
• 此类存档还允许搜索以在需要修复或新资源时找到纹理；并且是初始化新 Trainz 版本或重建旧版安装的资源。

[2] N3V 的 CM 版本将拒绝任何尝试打开文件进行编辑，然后仅通过重新提交它来升级它。但是，可以使用两种方法来获得相同的效果。
• 1) 更改配置文件的 KUID，然后将文件夹拖放到 CM 中，由于较旧的 KUID 被“标记”为“已打开以供编辑”，因此软件只是将文件夹和数据视为导入的资源。然后可以重新编辑原始 KUID 并独立提交，或者假设它没有错误，可以只键入CTRL+R 并还原到原始的更改前版本。如果还原一个已打开以供编辑的文件，在移动或删除其文件夹之前重新提交似乎不是必需的，但可能是比这样做更安全的。
• 2) 将文件夹复制到另一个目录，然后在那里更改 KUID，同时通过在原始 KUID 下提交更新的表单来测试改进。这具有在添加更新的 KUID 版本之前对提交进行全面测试的优点。

[注释 1]

[注释 2]