Trainz/KUIDs

返回頂部

← 上一個 AM&C

↑ Trainz，Trainz入門 — 元素索引，附錄 ↓

資源下一個 →

Trainz新手基礎知識

Trainz資源維護與建立

TOC | 開始 | 樂趣 | AM&C | 建立 | 書內參考 | ORP參考： • 索引 • 容器 • 種類 • 標籤 | 附錄 • 版本

詞彙表

HKeys-CM

HKeys-DVR

HKeys-SUR

HKeys-WIN

滑鼠使用

符號

KUID

思考點

各種資源名稱和KUIDs，例如
在內容管理器中複製所有內容可能會給您

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派生名稱編碼的資料夾（用空格替換冒號（':'）字元）來組織檔案資料夾，在早期的Trainz（甚至現在）中也是如此。請參閱您..\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等。一些CCs將型別品牌擴充套件到轉向架等部件，或者可能為這種部件型別設定一個組。
如果使用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內容時，必須始終牢記關鍵字-值對。 TrainzBaseSpec包含在定義資產的config.txt檔案中最為常見的數值和容器。

註釋

↑ 一些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版本將拒絕任何嘗試開啟檔案進行編輯，然後僅透過重新提交來升級其KUID的嘗試。但是，可以使用兩種方法達到相同的效果。
• 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版本將拒絕任何嘗試開啟檔案進行編輯，然後僅透過重新提交來升級其KUID的嘗試。但是，可以使用兩種方法達到相同的效果。
• 1) 更改配置檔案的kuid，然後將資料夾拖放到CM中，因為舊的kuid被“標記”為“已開啟以供編輯”，軟體只是將資料夾和資料視為匯入的資產。然後可以重新編輯回原始kuid並獨立提交，或者假設它沒有錯誤，可以只鍵入CTRL+R並恢復到原始的更改前版本。如果恢復一個開啟以供編輯的檔案，在移動或刪除其資料夾之前重新提交它似乎不是必需的，但可能比不這樣做更安全。
• 2) 將資料夾複製到另一個目錄，然後在那裡更改kuid，同時透過在原始kuid下提交更新的表單來測試改進。這有利於在新增更新的kuid版本之前，對提交進行全面測試。

[註釋 1]

[註釋 2]