跳转到内容

Trainz/refs/TrainzBaseSpec

Add links
来自维基教科书，开放世界中的开放书籍
logo
 Trainz 注释参考页
Trainz 资产维护和创建
TOC | 开始 | 乐趣 | AM&C | 创建 | 书内参考文献 | ORP 参考文献:  • 索引 • 容器 • Kinds • 标签 | 附录  • 版本
[e]
KINDs（类型资产组）
和 容器


KIND 层次结构简介

[编辑 | 编辑源代码]

KIND TrainzBaseSpec 为所有 Trainz 资产类型的所有 config.txt ini 文件 提供基本定义。TBS 提供了一些“标准标签”，这些标签对于任何和所有 Trainz 资产都是通用的（或者至少在法律上可以定义）[1]。

  • 其中一些是强制性的，因为它们决定了资产的进一步处理以及 config.txt 文件和其文件夹中的资产数据的解释。
  • 然而，大多数是可选的，并且在大多数子资产中可以省略使用标签的定义行。

父类

[编辑 | 编辑源代码]
  • None, Valid 和大部分对 defacto 父容器定义的所有内容都必要，config.txt 文件是所有 Trainz 数字模型所必需的。KIND TrainzBaseSpec (TBS) 是一个根类，其他 Trainz 资源类都是从它派生的。
  • 之所以说它们是派生的，是因为它们继承了其中列出的参数定义的处理属性（指令）和值，其中最关键的是 kind 标签的值。这个枚举的词语决定了资源的特定kind 声明和要求，这些声明和要求被添加到该资源配置文件中 TBS 的定义中。其他关键的 TBS 定义数据也很重要，例如资源的名称、Kuid 标识符和版本、Trainz 构建值 (TBV) 以及其他具有广泛可变的定义需求、适用性和范围的数据，例如string-table、obsolete-table、kuid-table 和缩略图都是偶然的。字符串值，甚至资源名称和描述在实践中通常完全没有必要，并且可以完全省略。
  • 当声明一个 kind 时，该 kind 成为父类，除了 TBS 中列出的那些数据外，还需要并规定必须在该类中满足的必要的成对数据。
  • 某些参数可能在资源 kind 的情况下保持未定义，特别是对于较旧的 Trainz 构建标签值的常见做法，对于这些标签，内容管理器或内容创建者 Plus (CCP) 工具将分配一个默认值，但在处理它时会显示一条警告消息。TrainzOnline wiki、此处或旧的TC3 时代 内容创建者指南 (CCG) 中的许多标签都会提到一个默认值。
  • 从 TRS2006 和 Trainz Classics (TC1&2) 开始，每个版本的 Content Manager 模块都会施加越来越多的预先承诺错误测试[note 1]，并且每个模块都变得越来越坚定地警告说，当它期望这样的标签-数据对时，这样的标签还没有被定义。

在 TANE 之后发布的版本中，许多这些“昨天默认”的定义行今天会更频繁地生成错误，要求明确的值定义，而这些值在过去加载时是默认的。[note 2] 这比过去的日子要好得多，在过去的日子里，错误的资源定义有时会导致臭名昭著的“蓝屏死机”或更常见的是，使运行时软件崩溃回桌面，导致编辑丢失，并且可能需要重建数据库。

子类

[edit | edit source]

所有 Trainz 定义的数据（内容）都有三个必需的元素：一个 config.txt 文件 用于组织数据，一个标识，即一个 kuid（仅用户名对您毫无用处，但合法资源可以不带名称创建！），最后，一个合法定义的 kind 标签。kind 是负责人，是管弦乐队的指挥，是排长或 CEO 指挥——为之后处理的所有内容设置要求。简而言之，kind 的值，一个小型精选的严格定义的成员限定群体——告诉 Trainz 软件在虚拟世界中要渲染和显示什么，以及如何在该 config.txt 文件中找到将这些资源部分链接在一起的其他部分。
  下面的每个子类都被认为具有TrainzBaseSpec 作为它们的“父类”数据。[note 3] 下面列出的几个 kind，那些带有下划线的 kind 是遗留 kind，早于 TS2009 版本中对 Trainz 数据模型 的更改（即从 2008 年后期开始），N3V 程序员只对这些更改施加了渐进的（增量的）更改。
  目前可以在 N3V Trainz Wiki TrainzOnline 网站此处 的 内容创建者指南 部分找到基于这些遗留 kind 修复资源的详细信息，并附有具有启发性的遗留 Kind 示例此处。强烈建议 Trainz 下载站 的任何用户或任何考虑创建内容的人仔细阅读 CCG。通过了解较旧内容是如何定义的背景历史，可以将其与 TrainzOnline 对同一数据类型的当前报道进行对比和比较，因为这种“过去与现在”的比较通常可以为修复、更改和自定义资源提供有价值的见解。更重要的是，CCG 中的写作是专业制作的，并且更具有解释性——它通常会让你了解如果改变了这一点或那一点，可能会产生扩展的影响，而 Trainz Wiki 却没有提供。TrainzOnline 上发布的 CCG 是 TC1&2/TC3 版本——几个小册子出版的最后一个版本，可以追溯到 1999 年的 Trainz；TC3 CCG 包含来自 TRS2004/TRS2006 和 UTC 数据模型的已更改的 Enginespecs 机车资源，需要进行适当的更新。

TrainzBaseSpec 子类 KINDs（类型资源组）

 


表 I，TBS 标准定义

[edit | edit source]

TBS 标准定义

[edit source]

这些标签和容器是标准定义，几乎可以在所有资源中找到。某些标签是可选的，并且可能不会被内容创建者定义，因为它们的选择。标签是关键字，并且具有分配的单个键值或容器，例如字符串数组或'{' ... '}' 绑定封闭的标签值对或子容器。（在 Trainz 配置文件中声明的所有内容都是成对的，因为即使 '{' ... '}' 也被认为是“键值”。

  • 容器是“键”和“键值”对的集合，以及“TBS 中的上层容器”（与子容器（如缩略图容器内的那些）相对）通常以“-table”结尾。
 kind    "'string-value'"
 trainz-build 'float', 1 位小数
 kuid  <Kuid 编码值>
 username    username "'string-value'"
 username-XX    username-XX "'string-value'"
 description    description "'string-value'"
 description-XX    description-XX "'string-value'"
 kuid-table (容器)

  { 依赖项列表
  按 kuids}

  一个键值表，列出此资源依赖的所有资源。
 obsolete-table (容器)
    {
    }		  kuids 列出此资源替换（使其过时的）资源
 通常没有（为空）[注释 5]
 string-table (容器)
    {
    }		  资源中使用的字符串和消息的键值列表
通常为空，仅在路线和场景中较大。
 string-table (容器[s])
    {  非英语
    语言文本 }		  翻译字符串列表，匹配强制的英语 string-table
 category-region tag 枚举 代码  category-region "'string-array'"  
 category-class tag  category-class "'枚举 string-value'" 
 category-era tag  category-era "'约束字符串数组'"  十年
 category-keyword "'string-array'" 最大长度为 64 字节    category-keyword tag 自然语言搜索关键字
  (替换类型，区域)
 custom-category-list 
 "'string-array'"		  脚本接口功能
 must-have-product-rights 
 "'string-value'"  		  DRM 字符串数组
 must-not-have-product-rights 
 "'string-value'"  		  DRM 字符串数组
 privileges (容器)
    {
    }		  更多 DRM
 thumbnails (容器)
    {
    }		  缩略图容器
 script (文件名)    "'string-value'"
 class (脚本资源类)    "'string-value'", 必须与 script 规范类同步。
 script-include-table
    {
    }		  (列出库脚本的容器)
 extensions (容器)
    {
    }		  资源也使用的正式脚本扩展
 license "'string-value'"  资源创建者的版权声明
 author    "身份 'string-value'"
 organisation    "第三方组身份 'string-value'"
 contact-email    "电子邮件地址 'string-value'"
 contact-website    "作者/组的网页网址 'string-value'"
 member-of-groups (容器)
    {
    }		  此资源所属的 KIND Asset-group 资源列表。

 



支持的标签

[edit | edit source]

TrainzBaseSpec 在 config.txt 文件 中支持以下标签。 ∅:  

kind tag

[edit | edit source]
类型：字符串。
字段定义：此 config.txt 文件 代表的资源类型。请参阅索引 种类 和列表：此处（上方）

 

kuid tag

[edit | edit source]
类型：KUID（简短），主要：KUIDs
字段定义：引用此资源的唯一资源 ID。
KUID
'Koolthingz Unique IDentifier'. Trainz 系统软件的资源数据库唯一引用编号，也扩展到 KUID2 格式中的多个版本。Trainz 可升级性和资源模块化设计的核心，因为每个资源都有自己的唯一 kuid 代码，因此可以指定另一个资源中的组件（转向架）或整个火车车厢，并在新资源中选择性地替换两者（重新贴皮或修改卡车）。
  • 基本 KUID 格式：'<kuid:wwwwww:xxxxxx>'，其中 wwwwww 是作者的“Trainz 唯一身份”，xxxxxx 代表作者分配的模型标识代码。
编辑者说明： 但请注意，许多在线网站需要使用单独的数据字段（作者和序列号）进行搜索，内容管理器需要三个或四个冒号分隔的数据字段，但不需要括号——尽管在搜索 API 窗口中，逗号是多个 kuids 的必填分隔符。在完整的 kuid 标签结束括号中聚合数据通常更容易，并且通常更易于阅读。对于剪切和粘贴一个巨大的列表，缓冲区大小限制可能会截断列表的末尾，在这种情况下，在文本编辑器中修剪两个结束括号可能会允许将整个列表放入 API。



  • 大多数 Trainz 资源在其 kuid-table 中指定依赖项列表——其他组件资源，由软件套件的各个部分组装而成，以构成 kuid-table 容器 中可渲染和可使用的资源。
  • 在许多资源的核心，特定标签可以由kuid 引用定义，并使用引用的资源作为一部分。这实际上是如何实现重新贴皮的，并且可以将网格用于资源，尽管更现代的做法建议这种引用应指向网格库资源。
KUID2
KUID 格式的更新和更新跟踪修改版本，允许指定版本号。A <kuid:xxx:yyy> 等同于 <kuid2:xxx:yyy:0>（零修订或版本零，表示原始版本）。
  • 这允许数据项（Trainz 资源）携带资源的固有版本代码。这通常不会与CM Trainz-build 代码（标识软件技术级别）匹配，但表示之前的版本历史。
  • 如果数据库中存在两个资源，那么具有更高后缀代码的 KUID2 资源将覆盖或替换较旧的资源。拥有早期版本并不必要，但 CM 会将缺失的修订链列为缺失的依赖项，对于那些不喜欢 CM 中该功能被污染的人来说这是一个软件错误，或者程序员将其保留为“功能”，无论如何都会降低使用 CM 识别用户缺少哪些内容的效用，并导致用户花费时间手动找出哪些内容实际上是什么。

 

trainz-build tag

[edit | edit source]
主要覆盖范围：trainz-build 标签，缩写：TB & TBV (TB 值)∅
类型： 小数点后一位浮点数 枚举 由 N3V[2] 用于跟踪和识别与演变软件的技术级别相对应的数据类型。
范围： 1.0–4.3 直接对应（'映射onto3rd' Trainz 1.0—TANE-SP1+hf2；预计此值将随着每次新的主要软件升级而增加 0.1。

每个合法值必须与已发布的 Trainz 版本号 完全匹配，以下情况除外

  • 分配给 V1.4 的 TBV 或版本值是 Auran 的 Paintshed 版本，一种也适用于 Microsoft Trainz Simulator (MSTS) 的重绘工具，也作为 TRS2004 辅助软件模块的构建值出现；特别是它的 ContentManager.exe 工具。
  • 1.7 和 2.0 之间的差距要么是外语版本，要么是在经过数小时的挖掘和研究后更有可能的是，Auran 未使用，因为在构建最初 Trainz 的程序员团队看来，TRS2004 版本是第二款 Trainz 产品，无论前台如何炒作营销名称（比如 Trainz UTC，是终极任何东西……真的吗？ 拜托！真的吗！？）
Trainz 版本和相应 Trainz-build 标签 值的系列是 Trainz 1.0=v1.0、Trainz 1+SP1 ⇒ V1.1、Trainz 1.0+SP2 ⇒ V1.2、Trainz 1+SP3 ⇒ V1.3 等（但跳过 1.4 和 1.7–1.9），因此 TRS2004-SP0 = v2.0 然后递增，其中每个从 2.0（TRS2004 无服务包）到当前版本（v3.7 = TS12-SP1、v3.8 = Mac2、3.9=TANE-CE、4.0—4.3 及以后？）递增 0.1。从 2016 年 3 月开始，4.3 及以上版本是 TANE SPs TBDL。
  • 从 v2.0 (TRS2004) 开始，Trainz-build 标签数值已经增加了 23 步，这些步骤是连续的，但不是单调的，因为 Trainz TS09-sp3—TS09-sp4 共享一些 Trainz-build[2] 值；也就是说，在 TS2009 和 TS2010 的联合开发和发布时期，有一些共同共享的 TBV 重叠。
  • 此外，N3V 进军苹果电脑，打断了基于 Windows 的 Trainz 版本 TBV 3.4、3.5、3.6、3.7 和 3.8 在 Windows 和 Mac 操作系统之间的平滑递增。
    注意： 热修复 不会更改版本号。
字段定义： 此资源构建（和归档）到的文件格式版本（不一定与资源使用的技术级别有关），但与在 Content Creator Plus 中创建资源时分配的资源级别相对应——与在 CM 标题栏中找到的一样。
  • 程序员建议此数字通常应设置为创建和测试资源的 Trainz 安装的 Trainz 版本号。相比之下，Content Creator 社区试图将数字设置为尽可能低，以便在下载时为新资源提供尽可能广泛的受众/用户范围。更好的内容创建者将在裸机安装（无添加内容）的对应版本上进行测试，并验证生成的 cdp 是否包含所有相关材料。
  • 一些资源种类根据其trainz-build 版本标签的不同而被截然不同的解析。注意：trainz-build 标签 是强制性的。如果未指定，Trainz 将根据 config.txt_file 的内容尝试以最原始的方式猜测 Trainz 版本，通常解析为 1.3 的 TBV 值。

 

用户名标签

[编辑 | 编辑源代码]
类型： UTF-8 字符串，资源的用户名，必须指定。
字段定义： 此资源的英文人眼可见的名称。

在 TC1&2（v2.7）之后的 trainz-build 中，用户名在编辑资源时也会成为操作系统文件夹名称，并且资源文件名会被忽略，而在 v2-6 配置文件中它具有优先级。根据 N3V games 的 TBS 标准，此字段永远不应该包含非英文文本，除非资源名称是专有名词（例如地名），并且没有英文本地化变体。此值是每个人通常搜索和记住的数据，因此建议保持清晰的名称。

在创建资源时，强烈建议将新建议的名称与 CM 搜索中的几个试用部分名称进行对比，并根据该知识采用与现有可用内容合理匹配的名称。
我们需要容忍多少个“house 2”或“road”资源来进一步混淆我们！？好吧，实际上，我们都会搜索 house 并从图像中选择，但能够指定一个唯一的名称并获得你期望的东西真是太好了！


 
 

用户名-XX 标签

[编辑 | 编辑源代码]
类型： UTF-8 字符串，用户名标签 的替代语言版本。
字段定义：（其中XX 被替换为相应的 本地化代码，表示要使用的语言。）此资源的本地化人眼可见的名称。此字段类似于用户名字段，但表示非英文语言环境。一个资源中可能存在多个用户名-XX 标签，每个支持的语言环境一个。如果不存在适当的“用户名-XX”标签来在给定的最终用户系统上表示此资源，则使用英文用户名标签。

 

描述标签

[编辑 | 编辑源代码]
类型： UTF-8 多行字符串，提供资源的清晰语言描述。
字段定义： 此资源的英文人眼可见的描述性摘要。

描述在内容管理器“资源详细信息”窗格中可见，用于阐明资源名称、提供规格以及经常包含一些历史信息。

N3V 的 Chris Bergmann 已经声明此字段应该保持简短（1-2 段）的描述资源的简短说明，并通过info-url 页面提供扩展的详细信息，但可以容忍相当长的文本块。有些人使用块的底部作为版本更改记录。

此字段必须由英文描述性文本组成，尽管文本可能引用非英文专有名词，如其他地方所述。其他语言翻译或源文本应放置在众多可能的替代语言本地化标签之一中（参见 description-xx 标签）。 

description-XX 标签

[编辑 | 编辑源代码]
类型： UTF-8 多行字符串，描述标签.
字段定义：（其中XX 被替换为相应的 本地化代码，表示要使用的语言。）此资源的本地化人眼可见的描述性摘要。此字段类似于描述字段，但表示非英文语言环境。一个资源中可能存在多个description-XX 标签，每个支持的语言环境一个。如果不存在适当的“description-XX”标签来在给定的最终用户系统上表示此资源，则使用英文描述标签。

 

字符串表容器

[编辑 | 编辑源代码]
类型： UTF-8 字符串列表容器，字符串表容器.
字段定义： 英文字符串的键值列表。每个键都是一个有意义的脚本标识符，映射到二进制数据并被二进制数据引用。每个值都是一个英文字符串。英文字符串可能包含或引用非英文专有名词作为标识符。由非英语母语人士创作的资源必须在需要时创建没有后缀的字符串表容器。软件只链接到和引用字符串表容器中没有后缀的名称和值，这将让西班牙语、法语、德语、捷克语、荷兰语……日语作者感到十分沮丧。换句话说，带后缀的字符串表仅仅是为了翻译目的，这在用非英语编写地图时会导致问题——没有 string-table-en 来提供反向翻译的表格。同样，username-en 和 description-en 也一样。这三者的缺失表明了一种过时且傲慢和对世界动态缺乏敏感性的态度。

  其他语言通过类似的字符串表（例如 string-table-XX）来支持，其本地化代码后缀 (XX) 与描述和用户名关键字/标签的国际化后缀匹配，但这些语言键入的字符串表容器在左侧条目中始终具有相同的键值。 

  • 这些左侧的键或标签既用作'本地索引关键字'，又用作'语言之间的等效表'。
  • 左侧栏将始终包含内容创作者赋予“特殊”名称的对象，例如可能被引用的信号名称、轨道标记和行业、连接点等等，并且将在驾驶员和测量员模块的“查找公用设施”（CTRL+F ) 功能小程序中出现。
  • 相反地，索引侧也不会列出地点的默认名称，例如在构建路线图时，由随机数自动索引的无数个连接点（即毫无意义的混乱。如果重要，路线构建 CC 会给它命名！）；但会自动包含可能临时的资产，例如火车车的默认名称。如果重命名，这些名称将取代其对应的默认名称。
  • 它的主要用途是针对那些旨在与脚本引用接口并获取可变属性的对象，例如火车站或行业需要的或准备在行业发货的产品数量，或者由交互式火车车（滚动行业到脚本）和其他可配置资产运载，这些资产就像一个通用的广告牌风格的标志一样简单，只需进行一些高度调整和角度扭转，就可以放置在库存建筑或行业的立面前面，以便在建筑上放置不同的商业名称。换句话说，这是一种可配置的场景。
  • 总体而言，在路线图或布局中，这些左侧栏名称对应于地图资产上的命名对象，这也是大多数字符串表出现的地方（从字面上看，由大型路线种类图中的数千个条目填充）。
  • 在某些资产中，该默认名称被挂钩到软件脚本中，因此字符串表变得特别重要，而不是令人厌烦。（见下文）
  • 在每种类型的资产中使用字符串表类型始终是合法的，就像描述标签、trainz-build 标签和种类标签一样。与它们不同，它不必存在或定义，并且绝非强制性。封装在字符串表容器中的值只有在代码期望它们结合时才具有功能或效果。
  • 在其他资产中，同样以那个假设的可编程商业标志为例，如果字符串表要与软件接口，则必须给它一个默认名称。所有地图可放置资产都可以命名或重命名，但“特殊名称”必须在脚本和字符串表索引值中匹配。大多数可配置资产定义了一个接口变量，用于替换默认名称作为索引或查找表，该表引用脚本和资产的二进制数据。其他变量也可能在可编程资产中定义。这些变量都可以通过脚本引用，但正是索引值使它进入地图或会话字符串表，当需要驾驶员或会话创建者可变性时，这一切使它们协同工作。
  • 相反，如果没有系统软件知道索引中命名项目的所在位置，则对象的脚本可能不会有任何触发、条件检查或更新能力。这是 2000 年代Trainz 1.0中对象的特征，而不是 2003 年发布的TRS2004之后更现代的 Trainz 铁路模拟器。（从那时起，我们已经走过了很长的路！)
  • 有一些资产只能作为一组一起工作。在这种情况下，在地图或会话层中对每个资产进行命名，使它们能够一起运作。例如，考虑一个具有五条轨道的公路平交道，其中两条轨道偏离连接点，并与贯通轨道形成所谓的“钻石交叉”。如何设置信号，以便任何铁路交通都关闭公路道口，或者使用钻石交叉禁止其他火车穿过正在穿越道口的火车。道路和铁路信号以及道岔和道口都必须协同工作。某些“ATLS 系统”资产及其脚本通过字符串表结合起来，可以使这个复杂的系统发挥作用。
  • 有关更多信息，请参见 string-table-XX。

 

string-table-XX 容器

[edit | edit source]
类型： UTF-8 字符串列表容器，本地化字符串表，每个后缀对应于除英语之外的语言。
字段定义：（其中XX被替换为适当的本地化代码，表示所代表的语言。）此字段类似于字符串表字段，但表示非英语语言环境。

英语字符串表（无后缀）是强制性的，其他本地化语言在资产作者的要求下是可选的。提交到 DLS 然后在与 Trainz 版本捆绑的路线中使用的许多资产通常会被翻译，并为 description-XX 和字符串表提供完整的本地化翻译集。特别是，与版本捆绑的路线和会话将在每次零售版本发布时接受专业翻译成多种语言。

请注意，字符串表的左侧栏是相同的，因为它是一个映射的符号表，并且索引到二进制数据（例如网格、会话或路线文件）。只有使用名称，即两个元素中的右侧或数据元素被本地化并由运行时本地化软件替换。如果需要，这些名称可以在英语字符串表中手动编辑，以获得更友好的名称。索引或左侧引用栏语法绝不能以任何方式更改，因此在数据栏中更改名称时，请注意全局 SAR 规范。

资产中可能存在多个string-table-XX标签，每个支持的语言一个。每个标签都应该包含一个字符串列表，其键与字符串表列表中的键相同，但值不同。如果不存在适当的“string-table-XX”标签来表示给定最终用户系统上的此资产，或者该列表中缺少适当的字符串，则将引用英语字符串表容器。 

kuid-table 容器

[edit | edit source]

kuid-table   {
 numberit_library                      <kuid2:75134:99003:7>
 0                                     <kuid:-3:10164>
 1                                     <kuid:-1:42004201>
 2                                     <kuid2:50567:11155:1>
 3                                     <kuid2:58422:50120:1>
 4                                     <kuid:-3:10003>
 5                                     <kuid2:30671:94407101:1>
 6                                     <kuid2:87907:94407101:1>
 7                                     <kuid2:87907:94407103:1>
 8                                     <kuid2:87907:94407105:1>
 9                                     <kuid2:30671:9870190:1>
 10                                    <kuid2:30671:94407100:1>
 11                                    <kuid2:87907:94407100:1>
 12                                    <kuid2:87907:94407102:1>
 13                                    <kuid2:87907:94407104:1>
 14                                    <kuid:-3:10013>
 15                                    <kuid2:60318:10008:1>
 16                                    <kuid2:60318:10010:2>
 17                                    <kuid2:189041:301:1>
 18                                    <kuid2:50567:11121:1>
 19                                    <kuid2:30671:9840820:1>
 20                                    <kuid2:30671:9870899:1>
 21                                    <kuid2:50567:12646:3>
 22                                    <kuid2:124017:30000:2>
 23                                    <kuid2:124017:30001:2>
 24                                    <kuid2:124017:30002:2>
 25                                    <kuid2:124017:30003:2>
 lodi_icon                             <kuid2:124017:35000:1>
 lodi_lib                              <kuid2:124017:40000:1>
 26                                    <kuid2:30671:69006:1>
 27                                    <kuid2:124017:35000:1>
 28                                    <kuid2:30671:90810901:1>
 29                                    <kuid2:30671:9081290:1>
 30                                    <kuid2:60318:10009:1>
}
类型： KUID 列表容器，与已弃用表容器（下文）的格式相同。一个虚拟参数 + 一个（依赖）kuid
字段定义：划分依赖于此资产的资产列表的键值。

 

通常
只有具有子组件或备选选择（货物）的资产才会具有长度可观的 kuid-table。大多数具有子组件的资产只有几个。
  • 其次，由于有时内部关键字是“自动定义”的，而仅仅列为没有名称的数字，作为占位符参数，伪关键字可以是任何唯一的值（通常是零索引的连续整数。[notes 1]）它们可以被命名也可以不被命名，这取决于用户或作者的偏好。
  • 此表中的条目有两个目的
    ‌ 首先：确保游戏系统知道该依赖项，以便安装和加载此资产将成功安装和加载任何依赖项，以及
    ‌ 其次：允许脚本找到相关的子资产。
  • 仅应将一级依赖项包含在 kuid-table 中——具有其自身依赖项的子级或部分资产将在该子资产的验证和数据库提交过程中处理。
  • 循环依赖是非法的。
  • 如果某个资产也被标记为此资产的已弃用版本，则该资产不能列为依赖项。（Trainz 资产索引（历史上为 assets.tdx 文件）中的 kuid 只有一个替换 kuid 插槽，这将创建一个需要自身旧版本的循环定义！）
  • 类似地，某个资产不能被列为其自身的依赖项。[OTOH，这已被体验过（即，在 TSxx CMs 中已成功提交的无故障资产中见证过）将地图和会话在安装之间移植，使用 GSARS 更改 kuid，以便重叠不会覆盖目标安装中已经使用相同 kuid 的资产，而不会看到错误消息。] 是否也起作用了，需要比我更勇敢或更愚蠢的人！——Fabartus，编辑。
格式 (所有值均为 <kuid:aaaaa.bbbbb> 格式)
kuid-table {
 0            Kuid-1
 1            Kuid-2
 3            Kuid-3
 ...          kuid-ii
 N-1          Kuid-N
 }
大多数用户的第一份内容将是自动克隆内置路线及其关联的会话。通常是因为想要修改某些东西。检查路线或会话的 kuid-table 将使新老 Trainzer 能够获得路线中资产的可编辑列表。这些可以很容易地变成样式表“过滤器”（一个选择列表），允许使用与原始作者相同的资产添加和修改路线... 或者在你自己的扩展中复制他的样式。


  • 对这些虚拟参数事实的真正有用的利用是将复杂滚动库存资产中的产品 kuid 成对。一辆货车可能包含各种各样的产品... 获得授权将你自己的作者 ID 分配给你自己的系列，并使用不同的装载集，这可能是你第一次创建有意义的內容！考虑一辆货车，允许产品容器，kuid 列表可以包含以下条目
...  {

Animal_chickens		<kuid:-25:230>

Animal_Horses		<kuid:-25:236>

Animal_Cows		<kuid:-25:239>

Animal_Piggies		<kuid:-25:238>

Animal_Sheep_Flock	<kuid:-25:240>

} ...

注意连接单词的下划线... 两个符号，键和值！我们让学生去弄清楚在哪里将 kuid 添加到装载和允许的产品队列表条目中。（欢迎，但这是更改名称的好理由！保持清晰几乎是制作资产的整个战斗！） 

obsolete-table 容器

[edit | edit source]
类型： KUID 列表容器，与Kuid-table 容器的格式相同。
字段定义：一个“占位符键—键值”列表，其中包含由此资产废弃的资产。尝试加载此列表中的任何资产将导致加载此资产而不是该资产。
  • 此外：两个资产都标记第三个资产为已弃用是非法的，除非这两个资产中的一个也标记另一个为已弃用。[note 6]
  • 循环已弃用引用是非法的。
  • 所有比此资产的KUID2版本编号低的版本都被认为是过时的，无需列入此列表。同时，一个具有更高Kuid2的新改进资产与其前身绝不应列出相同的前身（例如原始版本！）到“中间”的中间前身，因为这些值被用作替代项表条目，并且只有一个资产可以替换为早期版本。（数组只保存一个值，不能用两个值替换一个！）
  • 将此资产的更高编号的KUID2版本标记为过时是非法的，因为这会创建隐式的循环引用。
  • 此列表中引用的资产必须与此资产具有相同的创建者，才能通过DLS上传过程进行审核和接受，此限制在您的本地版本中不适用，例如，它可用于将大型火车车组上所有旧的纸质车轮kuid替换为图形更美观且更新的车轮。

 

category-region 标签

[edit | edit source]
用途：在CM和Surveyor中过滤（搜索条件）
类型：枚举字符串或字符串数组。
字段定义：由分号（';'）分隔的两个字符类别区域标签代码列表。字符串中不应该存在其他字符（包括空格等）。此资产被认为与每个指定的区域相关 - 这对于火车车组种类和信号种类资产最为相关，但可以为任何资产提供。
示例
category-region "CA;US"
category-region "CA;MX;US"（北美国家，加拿大、墨西哥、美国）
category-region "CA;CS;DE;MX;US;VE;AU;FR;IN;IT;JP;KR;ES;AR;AT;BE;CH;DK;IE;EE;NL; NO;NZ;PA;PL;PR;PT;RO;RU;SE;SK;UA;UK"（大多数第一世界国家）

 

category-class tag

[edit | edit source]
用途：在CM和Surveyor中过滤（搜索条件）；与KIND声明一起确定CM软件如何处理资产，以及Surveyor在何处列出资产。
类型：枚举字符串。
字段定义：一个单一的2-3个字符类别分类代码，它描述了此内容项。类别分类标签用于提供超出资产种类隐含内容的额外人类子分类。每个Trainz资产的类别分类标签有助于描述资产在游戏中的“意图”，而不是资产的内部结构。
内容创建者指南（CCG）针对TRS2006和Trainz Classics的CCG解释了这些分类代表一个标准化的系统，用于指代各种类型的机车、滚动库存、场景、样条线和工业资产。类别分类代码在搜索和/或过滤适合的资产以制作成会话或路线（布局）中的内容时变得对所有Trainz玩家很重要。


 

请注意，许多类别分类代码仅与特定资产种类相关 - 类别分类代码不得应用于不适当种类的资产。

示例
    category-class "XBG" 箱车 - 来自PRR 60'
    category-class "BR" 铁路（非功能性场景） - 可能是一栋建筑
    category-class "BIN" 具有产品处理功能的工业资产

 

category-era tag

[edit | edit source]
用途：在CM和Surveyor中过滤（搜索条件）
类型：枚举格式字符串数组。
字段定义：由分号（';'）分隔的五个字符年代代码列表。
  • 每个年代代码代表一个十年，由一个四位数的整数组成，然后必须以's' 结尾 (例如 "1990s;2000s;2010s"), 从而创建一个枚举软件标记（值），该标记必须与一个指定的合法年代代码完全匹配。
  • 字符串中不应该存在其他字符（包括空格等），包括（尤其是在字符串末尾）在结束双引号字符之前。
  • 允许的年份范围是 1800-2010s[note 7]
  • 此资产的唯一意义是对其他人来说，即该资产被认为在指定的年代范围内是有效的和适当相关的，并且内容管理器将接受指定适用年份的搜索过滤器。

 

示例
category-era              "1920s;1930s;1940s;1950s"

 

缩略图容器

[edit | edit source]
用途：在CM和Surveyor中过滤（搜索条件）
类型：缩略图容器.
字段定义：用于在整个游戏环境（包括在游戏中、在内容管理器中以及在下载站上）的二维预览框、列表和图标形式中表示此资产的缩略图。每个数据集都包含在一个子容器中（通常）使用占位符参数作为键名或标签。[note 8] 惯例使这些成为 0 索引整数，但该值可以是任何可以评估为字符串的非空文本值。（参见下面的第二个示例）
一个实际的示例
(来自资产修复编辑[3])
thumbnails {
	0 {
		width					240
		height					180
		image					"$Screenshot (240)(kuid 68787 25222).jpg"
	}
	1 {
		width					512
		height					512
		image					"$Screenshot (512)(kuid 68787 25222).jpg"
	}
}

另一个常见的大小是调车场和勘察员资产选择 API 中使用的 128x64 '图标'，它应该具有Alpha蒙版或非常浅的背景。许多较旧的资产没有使用 jpg 文件，而是列出了 _art 子文件夹中的 .tga 文件（Targa 真彩色）（Trainz 1.0 - TC3 惯例：_art、_body 和 _shadow 是由早期 Trainz 数据模型要求命名的“资产文件名后缀”（过时的标签-<值> 对）强制的三个子文件夹），如下所示[note 9]

thumbnails
{
  Icons
  {
    width 128
    height 64
    image "40ft_boxcar_art\40ft_boxcar_art_icon.texture"
  }
 CM
 {
   width 240
   height 180
   image "$screenshot PRR 40ft_boxcar (240).jpg"
 }
 DLS1
 {
   width 512
   height 512
   image "40ft_boxcar_art\40ft_boxcar_art_512.texture"
 }
 DLS2
 {
   width 512
   height 512
   image "$screenshot PRR 40ft_boxcar (512).jpg"
 }
}

没有适当的缩略图容器上传的资产在 TS2009 和 TS2010 的早期版本中标记没有缩略图容器的资产为错误。补丁后来将其变成了警告。[note 10] 这种做法在 TS12 的一个热修补程序中被放弃，此前用户社区对此提出了很多抱怨。
 • 如果缺少缩略图容器的资产（即使具有过时的拇指标签）后来在新构建的内置路线或会话中被选择，该资产通常将作为一个没有图像的项目进行分发 - 如果没有被 texture.txt 或 config.txt 缩略图容器正确引用，它们将被剥离出来。[note 11]  

软件链接

[edit | edit source]

info-url 标签

[edit | edit source]
类型：URL 字符串。
字段定义：指向资产的在线描述、资产说明（帮助）或 TrainzOnline wiki 上其他帮助页面的链接，用于在嵌入式专用 N3V 浏览器中使用。该 URL 必须解析到Trainz Online 安全区域内的站点。目前，嵌入式浏览器接受三个域
     auran.com
    ts2009.com
    ts2010.com

此外，建议使用自定义Trainz 短 URL格式来防止 URL 受到未来网站布局变更的影响，而不是直接链接到这些域。“短 URL”是 Trainz 特定的 URL，它们通过允许内容创建者引用 N3V 网站上的特定页面来防止内容受到未来影响，而无需依赖于特定的网页布局。短 URL 用于游戏内使用，例如 info-url 链接，它们仅在嵌入式网页浏览器中有效，在任何外部网页浏览器中均无效。在存在此标签的情况下，游戏内按钮将允许用户查看资产描述或帮助，而无需离开游戏环境。

这对于驾驶员访问路线图、指南或会话说明或澄清非常有价值。

建议在任何情况下，如果资产提供类似的功能但外观略有不同，则使用通用组页面来表示整类资产。这将减少创建、维护和本地化此类文档的时间和成本。

 

必须拥有产品权利标签

[编辑 | 编辑源代码]
类型： ASCII 字符串。
字段定义：必需的产品权利列表，以分号 (;) 分隔。如果本地安装没有必需的产品权利，则某些游戏系统可能无法加载资产。

 

不得拥有产品权利标签

[编辑 | 编辑源代码]
类型： ASCII 字符串。
字段定义：冲突的产品权利列表，以分号 (;) 分隔。如果本地安装具有列出的产品权利之一，则某些游戏系统可能无法加载资产。

 

权限容器

[编辑 | 编辑源代码]
类型：权限容器 是一种 DRM（数字版权管理）和复制保护实现，由一些作者使用，它也可以称为权限 DRM 容器。DRM 指的是数字版权管理，这就是它实现的功能。如果已定义，则某些参数甚至会阻止查看资产的config.txt 文件。
字段定义：一组由资产创建者设置的权限，用于控制如何操作该资产。
privileges {
  is-payware-content 0 
  permit-listing 1
  permit-edit 1
  permit-commit 1
}

  上面的容器使用默认值设置，这意味着

0) 这不是付费软件，因此其他字段具有相关性[当付费软件编辑和提交将为零时，但允许列出]；

允许

1) 查看资产的config.txt 文件，
2) 编辑资产，包括查看其主文件夹中组件文件的内容，
3) 将任何更改重新保存到资产（将重新验证的资产提交（提交）到数据库）。

 

脚本标签

[编辑 | 编辑源代码]
类型：字符串文件名。
字段定义：指示该资产的主脚本文件的路径，如果有的话。该路径应始终以“.gs”扩展名结尾 - 运行时将尝试添加或替换“.gs”扩展名，如果路径具有其他扩展名。

 

类标签

[编辑 | 编辑源代码]
类型：字符串。
字段定义：指示要加载为该资产主类的脚本类名称（如果有）。此类从该资产的主脚本文件加载。

 

脚本包含表容器

[编辑 | 编辑源代码]
类型：KUID 参数列表及其相应的名称作为键。
字段定义：一个键值表，其中包含在编译该资产的脚本文件时搜索脚本包含的脚本化资产。键（一个变量，因此不是一个标签）当前未使用，但必须是唯一的；值指示要包含的资产的 KUID。

脚本包含表容器 是 KIND TrainzBaseSpec（简而言之，所有资产）派生的任何资产都可以使用的顶级config.txt 文件 条目。此容器允许资产直接包含另一个资产的脚本 来自父资产的脚本文件，使用N3V TrainzScript 的Script_Include_Directive。

相关

扩展容器是具有特定命名约定的自定义标签或子容器列表。

S-I-T 容器支持的标签

[编辑 | 编辑源代码]

此容器是脚本化资产名称及其 KUID 的简单键值表，在编译资产的脚本文件时会搜索这些资产以进行脚本包含。键或标签名称当前未使用（即是一个占位符参数）进行搜索；值指示要包含的资产的 KUID。能够搜索和识别键名称是内容创建者请求的功能，因此建议使用脚本文件名而不是数字虚拟标签名称作为最佳实践，因为它比 KUID 引用传递了更多信息。

S-I-T 容器验证

[编辑 | 编辑源代码]

通常最好将此类引用限制为KIND 库 资产，但这并非强制性要求，可以引用任何资产。

S-I-T 容器示例

[编辑 | 编辑源代码]
script-include-table {
                       a-key        <kuid:nnnn:nnnnn>
                       enginespec   <kuid2:www:xxxxx:yy>
                       anim-doors   <kuid:tttt:uuuuuu>
                     }

 

扩展容器

[编辑 | 编辑源代码]
类型：扩展容器。
字段定义：一组扩展属性，它们为脚本提供超出为该资产类型定义的Config.txt 文件 规范的附加信息。在创建新的扩展时，应注意遵守扩展命名指南，并在为现有扩展提供数据时遵守扩展创建者的指南。Auran 保留根据扩展创建者的指南在以后的日期添加对扩展容器 中特定条目的验证的权利。

 

更新且不太常见

[编辑 | 编辑源代码]

以下关键词是相对较新的发展，在旧的资产中不会有类似物或存在。 

类别关键词标签

[编辑 | 编辑源代码]
类型：UTF-8 字符串。
字段定义：自然语言关键词列表，以分号 (;) 分隔。字符串中不应存在其他字符（包括空格或不相关的标点符号）。这些关键词是资产关键词搜索的基础。资产的用户名 不必在类别关键词列表中重复。
  • 各种默认搜索关键词 会根据资产类型（KIND+类别-类）自动提供，因此不需要，可能也不应该重复。 Ø
  • 该标签可能不会以空字符串 ("") 或空白形式存在于标签之后 - 这些情况会导致故障。
  • 明显用途：公司如 ATSF、Santa Fe 和 AT&SF、B&O、Chessie、CSX、NS、PRR 或 NYC 等，而平板车、货车、料斗车等基本类型应该是自动的。桥接键如下沉式、井车和侧卸（换句话说，修改器）可能应该用于增强自动关键词生成的有限智能。自动生成的术语的重复不应该令人担忧。

 

{{anchor|custom-category-list 容器|自定义类别列表容器|custom-category-list 标签|自定义类别列表标签|custom-category-list 字符串|自定义类别列表字符串|自定义类别列表容器|custom-category-list 容器

custom-category-list

[编辑 | 编辑源代码]
类型：ASCII 字符串数组容器。
字段定义：自定义类别标识符列表，以分号 (;) 分隔。每个自定义类别标识符 应该是一个简短的（例如 3-6 个字符）字母数字标记。字符串中不应存在其他字符（包括空格）。
  • 这些自定义类别用于使脚本能够快速定位特定类别的资产。强烈建议谨慎引入新的自定义类别标识符。
  • custom-category-list 标签值的总字符数不应超过 64 个。除非存在仅能通过 custom-category-list 方法完成的现有特定脚本需求，否则应将此标签保留为空白。

 

所属组容器

[编辑 | 编辑源代码]
最低版本：V3.5 及更高版本
类型: 成员组容器 成对的 占位符参数 和 资产组 kuids。
字段定义: 此资产所属的 KIND_Asset-group 资产列表。有关如何以及何时使用此列表的详细信息，请参阅 KIND KIND 资产组 文档。

该容器包含一个 KIND 资产组 KUID 的常规列表。此包含声明，此后，特别是在搜索操作中（包括脚本接口和 TrainzUtil），此资产将被视为每个列出的资产组的成员。

如果未为给定的“成员组”容器指定任何条目，或者如果资产省略了“成员组”容器，则模拟器软件可能会根据资产的 Config.txt 文件指定一些默认资产组。模拟器不同版本之间的确切行为可能会发生变化，但是当前逻辑在 此处 描述。 

可选的已弃用标签

[编辑 | 编辑源代码]
以下标签对于任何资产都不必强制要求，许多资产都将其留空。
从历史上看，识别和许可标签从 Trainz 0.9（Beta）开始。

 

许可证

[编辑 | 编辑源代码]
类型: UTF-8 多行字符串。（通过程序员法令弃用。）
字段定义: 描述资产创建者希望如何使用此资产的许可证。最常见的是许可证声明禁止在任何付费路线、依赖资产（例如转向架、耦合器等火车部件）或重绘中使用受版权保护的资产，包括在任何付费运营的网站上分发资产。（这在理论上对于 DLS 也是正确的。FCT 费用用于更快的访问和无限下载，而不是访问资产。）
license 标签的含义不明确，N3V 不建议使用它，但它的出现早于 N3V 的管理 6-7 年。
上传到 下载站 或提供用于包含到游戏中的内容可能受特定重新分发合同或许可协议的约束，该协议优先于此字段中的任何文本。许可证字段不提供本地化支持。许可证字段的文本未经 Auran 或 N3V 验证或强制执行，可能或可能不具有法律约束力。
另一方面，Planet Auran 的历史表明，有人通过将他人的内容用作自己的内容来侵犯版权，可能会导致其从 Auran 网站被快速封禁并失去下载站权限等，最终被永久封禁。此外，社区将严厉打击其他用户侵犯他人版权的行为，并避开违规者并忽略 DLS 上允许保留的任何资产。
总之，实验和修改资产对于试图攀登陡峭内容创作学习曲线的 Trainzer 来说是一种被接受的甚至是被认可的生活方式（每个人都希望有更多内容创建者！），但如果资产有依赖部分，特别是网格、脚本、纹理，这些是知识产权 - 在上传你的作品之前，请获得使用属于他人的这些部分的许可。
通过“kuid 引用”指定的资产部分不应包含在此声明中 - 使用通用耦合器、转向架或基本火车车厢网格（Auran 发行了多种标准类型，许多作者默认使用它们，通过对网格进行 kuid 引用，例如检查 Boxcars（英国：封闭货车或货厢）的依赖项 - 超过一半可能使用对 Auran 在 Trainz 1.0 中发布的基本网格的 kuid 引用！）


 

作者标签

[编辑 | 编辑源代码]
类型: UTF-8 字符串。（弃用，有利于可更新的 Planet Auran 数据库。）
字段定义: 作者的姓名或标志。不建议使用此字段，因为可以通过编程确定归属。

 

组织标签

[编辑 | 编辑源代码]
请注意英国的拼写，北美拼写“organization”也可以使用！
类型: UTF-8 字符串。（弃用，有利于可更新的 Planet Auran 数据库。）
字段定义: 负责创建此资产的组织的名称或标志。不建议使用此字段，因为可以通过编程确定归属。

 

联系电子邮件标签

[编辑 | 编辑源代码]
类型: 字符串，电子邮件地址。（弃用，有利于可更新的 Planet Auran 数据库。）
字段定义: 此资产创建者的联系电子邮件地址。不建议使用此字段，因为可以通过编程确定归属，并且可以针对创建者的 Auran 帐户 Planet Auran 帐户 注册联系信息，他们可以在那里根据需要限制或更新这些信息。

 

联系网站标签

[编辑 | 编辑源代码]
类型: URL 字符串。（弃用，有利于可更新的 Planet Auran 数据库。）
字段定义: 此资产创建者的联系网站。不建议使用此字段，因为可以通过编程确定归属，并且可以针对创建者的 [联系信息] 注册 Auran 帐户 Planet Auran 帐户，他们可以在那里根据需要限制或更新这些信息。

 

已弃用的标签

[编辑 | 编辑源代码]
以下“标签列表”是“事实上的” 因为它们的“使用惯例”早于上述列出的 TBS 标签的正式编制，但不是使用它们的规范，并且确实也早于 TrainzBaseSpec 一词的创造（于 2008-2009 年与 TrainzOnline Wiki 一起推出），或其在 N3V Wiki 页面 中的正式定义 11:32，2009 年 5 月 12 日[4]。


 

  • 在初始编译之后，在数据模型的较早版本中发现的一些常见但现在已弃用的标签已添加到下面，例如在许多桥梁资产中发现的 bendy 及其下面的朋友。

 

编者注: 这些“TrainzBaseSpec 标签”在某些情况下，通过程序员法令，在 TB V2.7 中已过时（主要是那些与机车 KIND 相关的标签），并且在所有情况下，在 TS2009-SP0 之后，以及所有N3V Games 版本之后（尽管许多用户在其中的一些标签中发现了实用性，但它会给内容创建者带来的时间损失，也不能够在预处理操作中忽略那些不再有用的标签）并且如果资产被打开以进行编辑，并且通过将 trainz-build 标签 提升到 V2.9 及更高版本 数据模型，则会生成故障（错误消息）：
  • 资产可以升级到 V2.8 以及之前本地版本，并且通常可以正常运行，即使在进行了几代数据模型元素改进之后，它们也能正常运行。以这种方式，许多资产可以与 TRS2004 或 TRS2006 数据建模一起使用，但仍符合 TS 版本的内部处理和渲染。
  • 例如，大多数 TRS 时代之前的模型资产（v1.0–v2.3）可以通过添加一个网格表来使其在 TS 版本中正常工作，以替换自 TS 版本以来一直被忽略的“资产文件名”的旧效果，以使用原始 Trainz 数据模型 的文件夹分组来定义路径，使用带有后缀“_art”，“_body”和“_shadow”的子文件夹和名称（其中由资产名称加后缀定义的字符串设置了资产组件的路径）。
  • 相反，通常具有 TBs v2.9 及更高版本的 TS 版本资产可以通过了解这些标签的效果和使用以及稍微明智地更改以消除 texture.txt 修饰符行（例如，需要注释掉 AlphaHint 等）来进行回溯以与早期数据模型一起使用，这些行不被早期版本理解。


  • asset-name、name 和 name-XX — V1.3–v2.8 — 历史上在几乎所有 v1.3-v2.0 资产中都可以找到。虽然“asset-name”一直保留下来，直到 v2.8 都没有引起任何抱怨，但在 v2.5 之后却被弃用；因此在 v1.5 之后，资产的 config.txt 文件中唯一需要的、想要或认可的名称是 username-XX 变体。

 

Asset-name

[编辑 | 编辑源代码]

Asset-name 是 Trainz 1.x--TRS2004 Trainz 时代资产的 **主要文件夹名称**，并且通常是 CM 在打开文件以进行编辑时打开的文件夹的名称；在如今的早期数据模型资产中，通常会发现 asset-name 也用于早期 Trainz 时代的子文件夹系统，为火车车厢资产提供子文件夹名称 'asset-name_art'、'asset-name_body'、'asset-name_shadow'。在修复此类资产时，大多数情况下，该值可以用从资源文件复制并粘贴的 SAR 代替。这种替换通常会正确定义和链接资产的子文件夹（用于车身、阴影和艺术作品），因为早期方案中的文件名基于 asset-name 标签。 

bendy 标签

[编辑 | 编辑源代码]
范围：在 轨道或桥梁资产 中找到，在 v2.9 标准之前，样条对象经历了重大变化，变成了统一的数据模型定义，放弃了混合中的一些先前 KIND，而所有样条对象都在 kind track 下统一。

 

casts-shadow 标签

[编辑 | 编辑源代码]
参见上面的 bendy，已弃用/过时的 TS2009 之前的传统 kind track 标签。

 

name 和 name-XX 标签

[编辑 | 编辑源代码]
  • 'name' 和 'name-XX' 是早期数据模型中较长的 username 和 username-XX 标签的早期形式，XX 代表英文 'name tag'（或今天的 'username' 标签）非英语语言翻译的 ISO 两字母后缀；'XX' 形式与 description-XX 一样，是 '本地化' 支持其他语言用户友好值的组成部分。
  • 在最古老的 Trainz 时代（v1.0-v2.4）资产中，用 username 和 username-XX 替换 name 和 name-XX，或者如果存在 username，则直接删除。
    • 如果资产的 trainz-build 版本为 v2.7 或更高，则 name-XX 会导致错误。有趣的是，即使在 TS12 这样的后期版本中，name-XX 标签也会在 Surveyor 工具的搜索列表中显示为资产名称，如果没有出现，则会出现 TrainzBaseSpec。

 

注意：Username（英文）是 DLS 上的官方资产名称，不应使用外语；在 TB v2.5 之后（TRS2006-SP0，它也取代并替换了 CM 打开文件夹以进行编辑时的 'asset-name'。

根据惯例，子文件夹名称将使用以 username/asset-name 字段开头的路径规范名称，并使用 _art、_body 和 _shadow 后缀作为正常命名约定的一部分。这可能是 3ds Max 和 gmax 约定延续到 Trainz 中，Trainz 与图形开发软件具有历史联系。（Gmax 与 Trainz 版本 V0.9—v2.4 捆绑在一起）


 

category-era-nn 标签

[编辑 | 编辑源代码]
被 category-era 标签 取代
  • category-era-nn — V1.3–v2.8 s.a. {tag: category-era-0, category-era-1, category-era-2, ...} —以前使用数字后缀的日期系统——在历史记录中，几乎所有可追溯日期的资产（直至 TBV 2.0 （甚至在 TBV 2.8 构建的资产中！））都有此日期系统，当时引入了当前的 category-era 字符串数组，将这些标签合并到单个 config.txt 行中[注释 12]。虽然在 Surveyor 中无法直接访问，但在 TR06 和 CMP 之后，可以定义一个过滤器来选择日期范围，并将该过滤器与区域和类型一起使用，以便在 Surveyor 中验证可以在 Surveyor 的放置和选择工具中列出的资产。在 TS09 及其之后版本中，此标签被弃用，TS09 使用较短的 category-era 标签 字符串数组 放在一行中，而不是使用多个带 '-nn' 后缀的标签-值对。
  • 字符串数组中的空格会导致错误；所有值必须以 's' 结尾，并包含四个数字，例如 1880s;1950s;2010s（对于某些类型的女性服装来说可能完全合适，这些服装会流行起来，然后又过时！）。不幸的是，目前无法定义范围，但这已经被用户社区请求了。
  • 使用字符串数组类型的 category-era 标签 替换，标签中不包含空格，日期代码之间用分号隔开；这些代码以完整的四位数年代数字加 's'（小写字母 s）后缀的形式给出。

 

category-region-nn 标签

[编辑 | 编辑源代码]
被 category-region 标签 取代
  • 类型 category-region-nn — V1.3–v2.8 —在历史上几乎所有需要本地化的资产中都能找到。这些标签已被 category-region 标签中的 两个字母枚举的 ISO 国家代码的 '字符串数组' 所取代。
  • 使用字符串数组类型的 category-region 替换，标签中不包含空格，两个字符的国家代码之间用分号隔开，这些代码在参考标签部分进行了枚举；这些代码以两个大写字母的形式给出，组成 枚举 代码，代码之间用 ';' 分隔符隔开，但在最后一个代码之前（末尾引号之前）没有分隔符。
  • 字符串数组中的任何 空格（包括末尾引号之前的空格）都会导致读取错误和故障消息。

 

  • region —TBS V1.3–v2.8 的有效部分，作为内置过滤器和地图资产自定义本地化标识符（kuid）；现在，唯一合法的标签用法是在 kind map（布局）资产中。
作为以前的过滤器修饰符，此标签在历史上几乎所有资产中都能找到，但它在车辆、景观、样条资产、轨道类型（包括隧道和桥梁）和具有某种程度本地化的路旁资产中尤其普遍。
  • 地图资产仍然保留关键字 Region，该关键字是在地图配置中定义的，但其用途相反——作为 kind region kuid 引用。因此，Region 在 Maps 中是必需的，并且自 TS2012 以来，与标签类型一样，在大量资产中，它曾经作为 TRS 系列版本 Surveyor 工具窗口的 '分组数据' '快速过滤器' 出现，现在已不再合法。
  • 在 TRS2009 之后，任何以文本字符串形式出现的 region 标签都已过时，因为在程序员看来，他们用 Pick List 替换了 Surveyor 工具中 '类型和区域' 字符串值的 粗略过滤 组选择器。这两个标签都有一些优点和缺点，并且都追溯到 Trainz 0.9 Beta 版本。

 

shadows 标签

[编辑 | 编辑源代码]
参见上面的 bendy，已弃用/过时的 TS2009 之前的传统 kind track 资产模式控制标签。

 

thumbnail 标签

[编辑 | 编辑源代码]

缩略图标签是早期缩略图容器（上面也有简要介绍）的单视图实现。Trainz 早期的 N3V 编程版本会找到一个 .jpg 文件，最好大小为 240x180 像素，位于主资产根目录、资产名称_art 文件夹或资产名称_body 文件夹中，并将其用于在 CMP 和 DLS 中显示资产（如果已上传）。自 v2.0（TRS2004-SP0）引入了缩略图容器后，该标签在 TRS2006 期间已弃用。在较旧的已修复资产中，如果TBV 保持在 v2.4 以下，则缩略图通常仍然可以在较新的 CM 中工作，前提是它位于 _art 子文件夹中，并且资产名称与用户名匹配。 

类型标签

[edit | edit source]
  • type — V1.3–v2.8 — 以前的过滤器修饰符，在几乎所有资产中都有历史记录，但在滚动库存、场景、脊椎、轨道类型（包括隧道和桥梁）和路边资产中尤为普遍。
  • 类型标签与“区域标签”一样，在 Trainz 0.9—TC3 版本中用作“Surveyor 中的组过滤器”，它与区域结合使用，可以提供更小的资产选择（工具组）。自TS2009 删除了这些本地可点击过滤器的功能和使用，转而采用一种新的、更繁琐的过滤器。这使得工具选择变得快速简单，而不是在工具选项卡之间切换时缓慢并暂停——如今的 TANE 之前的版本在工具选项卡之间来回切换时，往往会被重新加载整个选择列表所淹没。
  • 类型和区域都默认为“全部”，从而提供与 TS09 及更高版本中的工具相同的超大型列表。
  • TRS2006 分支（即 TC3）之后，所有类型标签都已过时，因为在程序员看来，他们在 Surveyor 工具中用TS09Pick List 和过滤器替换了“类型和区域”的粗略过滤组选择器，但没有为用户提供保存多个 Pick List 或轻松加载在 CM 中定义和细化的过滤器的功能。

 

备注

[edit | edit source]
  1. ↑ 资产提交（TANE 的提交）是将内容整合到数据库中并将其交叉引用到 DB 索引中的过程和步骤，以便可以在运行时模块中访问它。
  2. ↑ 验证资产的一种方法是，除了这些值之外，其他一切都正常，方法是将 TBV 降至 2.5-3.7 范围，看看这些消息是否消失。您可能需要多次降低 TBV 直到足够低，反之亦然，较旧的 TBV 无法识别的较新的关键字可能会显示不同的错误消息。尽管如此，也不要害怕尝试——即使失败，也会产生知识和经验，而且你无法破坏任何东西！如果是这样，您可以确信，只提供一个值就是问题的解决方案。通常，一些现代需求只需要关键字对，因此在标签后面添加空白行，或在容器的标签后面添加一组空的花括号就可以满足需求，而错误测试则有些过于严格。
  3. ↑ 注意：此列表在 N3V TrainzOnline Wiki 上已“维基化”，这意味着第一个字母在“KIND”一词之后已大写，而 config.txt 文件中的实际数据标签名称全部为小写文本。该维基还使用双引号来表示一些术语，我们将在本文档中避免这种做法。
  4. ↑ “kind consist” 并不经常直接看到，它只存在于菜单和内容管理器列表中。
  5. ↑ 必须谨慎使用过时表，它最常见于 Auran 编写的资产中。该表将较旧的 KUID 替换为较新的 KUID，大多数内容创建者都适当地使用 kuid 的 Kuid2 形式来取代较旧的版本。相比之下，N3V 过度使用了过时表来更新新发布的内置资产，这会导致很多混淆，并且无法获得预期看到的结果。（例如，TS10 和 TS12 中许多不错的“翻转树”被速度树取代，而速度树并非路线创建者所需要或希望的。在跨安装过程中，这也会导致缺少依赖项，直到找到包含过时表的资产。
     • 此外，Assets.tdx 数据库索引中每个 kuid 只支持一个过时条目，用 Kuid2 版本替换 kuid 可能会导致问题（即您将看到哪个？）。
     • 过时表的一个绝佳用法是升级使用特定部件（尤其是转向架）的一系列资产。添加混合的 kuid 以更现代的转向架替换，可以极大地改善路线或会话的外观，只需进行一次编辑（前提是转向架等兼容且尺寸合适！）。
  6. ↑ 最近将一个过时的资产导入 TANE 的经验表明，至少有五个备选的 kuid 替代了这个可怜的翻转树资产。似乎随着速度树的引入所带来的混乱以及 TANE 的大修，它积极地寻求最合适的更新资产，现在 ContentManager 进程允许存在多个不同 kuid 的资产来替换同一个 kuid。作为一种良好的做法，只有在绝对必要时才使用过时表...例如，用您要上传到 DLS 的依赖资产中不需要的付费资产来替代，或者在网站上自行发布。
  7. ↑ 关于类别时代标签范围：已知有效的安全播放。其他“未来十年”的值应该在依赖它们之前进行测试。
  8. ↑ 许多容器在列表中使用虚拟/占位符名称。这些名称可以是描述性词语，只要它们不包含空格字符即可。在短语构造的名称中使用下划线或句点可以保留可读性并显著增强清晰度。例如，一辆货运车厢可能装载 45 种合法产品类型。这些将在依赖项容器中列出。使用 Coal、granite、crushed_limestone 等可以更容易地维护和更改表格。Jes Sayin' 作为程序员，自 1976 年以来一直从事编程
  9. ↑ 在第二个缩略图容器示例中，还有一个第二个大小为 512x512 的图像，一个额外的图像。DLS 将使用哪个图像尚不清楚。还可以包含更大的图像尺寸，通过电子邮件聊天，T:ANE 可能支持更大的图像尺寸，该尺寸将在预览操作或 DLS 列表中使用。N3V Games 通常不发布此类信息。
  10. ↑ 早期的做法可以追溯到 Trainz 1.x，当时使用关键字/标签“thumb”以及带引号的 pathspec 引用指向运行时菜单的 240x180 缩略图图像。art 文件夹包含一个带有 Alpha 遮罩的 512x512 tga（通常是 bmp 文件，但格式正确的 tga 可以用作自 Alpha 遮罩），以及 64x128 菜单图标图像及其控制的 texture.txt 文件。
  11. ↑ 在 2014-2015 年冬季与前版本经理 James Moody 的私人电子邮件对话中，就这个问题而言，DLS 上传验证软件很可能已被修改，以强制执行正确的缩略图容器。
  12. ↑ 关于类别时代 nn 与类别时代标签值：TRS 会接受两种形式的类别时代数据；但TS2009-SP0 及更高版本创建了错误，这些错误来自以前合法的关键字值对，并试图迫使内容创建者更改程序员故意破坏的所有资产。后来，DLS 上传软件强制执行了转换，但这要好得多，因为第一个操作导致了许多人浪费了大量时间来修复那些不必要的修复，而这些修复应该在验证较旧的 trainz 构建资产时通过软件预过滤器进行自动实现。这些操作实际上保证了较旧的资产下载将存在错误。这是 N3V 程序员所做过的最愚蠢、最傲慢的事情之一，而 Auran 更有经验的软件人员永远不会如此轻率地对待社区的时间成本。

参考资料

[edit | edit source]
  • 本页面的主要内容取自 N3V TrainzOnline Wiki 上的KIND_TrainzBaseSpec。Yesterdayz-Trainz 用户组的成员添加了增强信息。

脚注

[edit | edit source]
  1. ↑ N3V 的KIND_TrainzBaseSpec，作为未经增强的源页面，缺少历史信息（标签），可在此处找到；访问日期=2014 年夏季
  2. ↑ a b "Trainz-build" 标签 直接链接
  3. ↑ 根据 fabartus，2014 年夏季；很可能是在添加此示例的同一天。
  4. ↑ Christoph Bergman，N3V Games 首席程序员，又名“Windwalkr”，KIND TrainzBaseSpec 历史 页面。
本参考页面改编自TrainzOnline Wiki，根据CC-BY-SA 3.0 许可。本页面可能会包含比同一主题的源页面更多的文字解释、说明、历史或示例。
TrainzOnline Wiki 主要由程序员或知识渊博的 内容创作者 维护，并且可能包含有关当前 trainz-build 代码 标准的更新信息，这些标准随着软件功能的增加而不断变化。



取自 "https://wikibooks.cn/w/index.php?title=Trainz/refs/TrainzBaseSpec&oldid=4409651#kuid-table_container"
华夏公益教科书