Trainz/AM&C/處理資產錯誤

貢獻作者：Fabartus

處理資產錯誤

'錯誤、故障、故障資產、不良內容、故障內容 在 Trainz 的說法中都是同一個情況的同義詞：資產在分發時帶有格式錯誤的元件、缺少元件，或者儘管在早期 Trainz 版本中有效，但與更新的軟體版本不相容。這種後一種錯誤或故障發生在資產需要調整以符合更新的資產技術水平時，並且是最普遍的。缺少紋理 (元件) 的資產可以 “修補” 並使其工作，即使外觀與內容建立者使用的外觀不完全相同。無論缺陷是什麼，它通常是可以透過對檔案進行簡單的手動編輯來 “修復” 的，最常見的是僅在資產定義資料夾 (這些資料夾是使用作業系統資料夾中的第三方工具開啟的) 中包含的資產文字 ini 檔案內。

目前，這些頁面上最好的錯誤修復建議是在 Trainz/AM%26C/修復資產中找到的，它以文字可搜尋格式涵蓋最常見的錯誤訊息，允許在錯誤訊息中輸入關鍵詞以瞭解如何修復它。

必要的工具

在處理 Trainz 資產方面有效的必要第三方軟體幾乎都可以作為免費軟體獲取。

一個好的文字編輯器是天賜之物，雖然 Windows 有久負盛名的基本文字編輯器 Notepad 可用於簡單編輯，但它缺少許多有用的功能
1. 相反，建議使用免費軟體 程式設計師編輯器 Notepad++，因為它在幾個方面非常有用，最重要的是能夠跨行結束符搜尋和替換 (SAR)，這使得將 CM 生成的資產列表輕鬆轉換為內容管理器相容的逗號分隔列表 (CSL/CSV) kuids。
2. 程式設計師記事本 - 像 Notepad++ 程式設計師記事本和 (接下來推薦的) Crimson 編輯器 允許多檔案編輯，具有超過 Windows 記事本的有用擴充套件搜尋和替換功能，並且各自有自己的優勢。
3. Crimson 編輯器 (著名 Ruby 編輯器的新版本)
Open Office 套件 - 與 Microsoft Office 不同，這個免費的開源軟體包不會打破你的存錢罐，完全相容，並且在這裡推薦有兩個主要用途，涉及電子表格模組的使用
1. 電子表格可以作為有用的平面檔案資料庫；不同的選項卡允許跟蹤不同的專案資產，將 CM 主螢幕生成的選定列表轉換為 CSL。一個 CSL kuids 有許多組織優勢，最重要的是能夠使用不同的資產 kuids 重置一個或多個過濾器，以便在測量員中使用。
2. 將從 CM 主螢幕複製的資產列表貼上到電子表格中作為 CSV 列表，是截斷資產名稱和 kuids 的最快方法。流程是：A) 從 CM 複製資產組；B) ALT+Tab ↹ 到電子表格草稿紙；C) 將複製的資產名稱和它們的 kuids 作為帶有逗號作為分隔符的 CSV 匯入貼上下來。D) 僅複製 kuids 列；E) ALT+Tab ↹ 到 Notepad++ 草稿紙選項卡；F) 將列表貼上下來 (電子表格的每一行都變成帶有單個 kuid 的一行)；G) 在行結束符之間執行 SAR，將 '>\n<kuid' 替換為 '>,<kuid'

熟悉

假設讀者在繼續下面的內容之前，已經閱讀並理解了以下頁面上提供的材料。

PEVtools - 如果你打算在嘗試重新修改需要調整的資產時快速獲得任何成果，而不是感到沮喪，那麼安裝 PEVtools 是必要的。
內容管理器 - 操作內容管理器是資產下載、修復和升級的核心。
何時修復資產或何時升級它們 - 修復和升級資產是同一枚硬幣的兩面，但其中一面需要更多時間和深入的知識。此條目解釋了何時僅修復資產是一種成功的策略，而何時升級是一個更好的主意。

本模組的目標

本模組將使讀者瞭解以下 Trainz 知識主題

我們將介紹一個基本的火車車廂資料模型，經典的 Trainz 1.3，並以此來介紹原始資料模型將內容放置的位置以及自那以後內容的變化。
作為初始目標，我們將向您展示如何修復一個不太損壞的資產。
在將資產修復到 Trainz 對 TB V2.3 的需求後（TRS2004–TRS2006 令人滿意），您將學習到最常用的修復步驟，可以修復 DLS 上大多數舊內容。簡而言之，它歸結為用更新的資料模型結構（縮圖、網格表和轉向架容器）調整原始 Trainz 實踐，這些結構（在大多數情況下）滿足 N3V Games 開發的 TRSs 時代後的 Trainz 的需求，該時代打破了程式碼建立者 Greg Lane 及其程式設計師安裝的相容性程式碼。（這就是為什麼這些資產在 TRS&ndashTC 版本中執行良好的原因。

編輯注： 如果您要修補 V1.3 到 V1.5 的資產，使其在 TS09 及更高版本中同時透過驗證和提交，通常需要新增網格表容器、縮圖容器，以及對於火車車廂，新增轉向架容器。除了縮圖，這就是 V2.0 資產的食譜，縮圖是在 V2.5 (TRS2006-SP0) 中新增的。鑑於此，您最好從計劃升級 trainz-build 開始！該資產肯定不再適用於 Trainz 1.3 了！

有些 Trainzer 會說“大不了！現在您擁有一份紙輪廂車的私人副本……我羞於使用” 考慮給這個可憐蟲送花，或者至少給一根線索棒。她顯然不明白過時表的用途。在過時表中新增 100073 和 100074（以及其他幾個）

obsolete-table {
  0                        <kuid:-1:100073> 
  1                        <kuid:-1:100074> 
}

新使用者應該注意，config.txt 檔案中的裸 KUID（100073，廂車轉向架或卡車）預設設定為 作者 #-1 ... 這是原始的 Auran 使用者標識。他們使用其他幾個，包括所有負的使用者標識值。

再說一次，就像擁有實體模型套件的模型鐵路愛好者一樣，DLS 都是一個巨大的“套件部件” 源，我們可以透過一些實驗和大膽，將新的模型“套件化”。

編輯注： 學習修復舊資產可以使它們在我們想象力的工程可能需要它們的地方變得可用，包括滿足昨日路線構建者/會話編寫者的想象力，為你們開啟這些路線供你們利用。 學習如何使用扳手和調整調諧，建立您自己專用資產的步驟變得更加小，而且一點也不陡峭。

評估舊模型

我們將在下面使用未更改的配置，帶新 Trainzer 瀏覽資產的正常功能

kuid                                    <kuid:55290:638>
origin                                  "USA"
engine                                  1
category-region-0                       "US"
category-era-0                          "1970s"
category-era-1                          "1980s"
category-era-2                          "1990s"
category-era-3                          "2000s"
category-class                          "AL"

running-numbers
{
}
name                                    "Loco CONRAIL QUALITY WEATHERED SD40-2 "
bogey                                   <kuid:-12:3535>
bogey-1                                 <kuid:-12:3535>
bogey-2                                 <kuid:58377:50012>
bogey-3                                 <kuid:58377:50013>
mass                                    135000
company                                 "CONRAIL RAILWAY"
kind                                    "traincar"
interior                                <kuid:-1:101475>
trainz-build                            1.3
fonts                                   0
smoke_shade                             1
smoke_random                            2.5
smoke_slowlife                          6
smoke_fastlife                          0.8
smoke_height                            1.7
smoke_fastspeed                         1.6
enginespec                              <kuid:58377:51022>
enginesound                             <kuid:-1:42003001>
hornsound                               <kuid:-1:42003101>

smoke0
{
  attachment                            "a.mainex0"
  mode                                  "time"
  color                                 40,40,40,120
  accel                                 0,0,0
  rate                                  20
  velocity                              3
  lifetime                              2.5
  minsize                               0.3
  maxsize                               2
}

smoke1
{
  attachment                            "a.mainex1"
  mode                                  "time"
  color                                 40,40,40,120
  accel                                 0,0,0
  rate                                  20
  velocity                              3
  lifetime                              3.5
  minsize                               0.3
  maxsize                               2
}

smoke2
{
  attachment                            "a.mainex2"
  mode                                  "time"
  color                                 40,40,40,120
  accel                                 0,0,0
  rate                                  20
  velocity                              3
  lifetime                              2.5
  minsize                               0.3
  maxsize                               2
}
description                             "CONRAIL QUALITY SD40-2. Model was created by Prjindigo, Roger Crouch and the paintwork was created by Sean Pope
"
asset-filename                          "CONRAILQwSD40-2"
username                                "CONRAIL QUALITY WEATHERED SD40-2 "
author                                  
organisation                            
contact-email                           
contact-website                         
license                                 

kuid-table
{
  0                                     <kuid:-12:3535>
  1                                     <kuid:58377:51022>
  2                                     <kuid:58377:50012>
  3                                     <kuid:58377:50013>
  4                                     <kuid:-1:101475>
  5                                     <kuid:-1:42003001>
  6                                     <kuid:-1:42003101>
}

什麼是/不重要

TB 值鍵範圍	零售或服務包版本等效	TB 值目標
v1.3—v1.5	Trainz、Trainz 1.3，直至 Trainz UTC	2.3-2.6
v2.0—v2.4	TRS2004 及其 4 個 SP	2.4, 2.5-2.7
v2.5—v2.6	TRS2006 及其 1 個 SP	2.6-2.9
v2.7—v2.8	TC1&2—TC3*	2.9-3.0
v2.9—v3.3	TS2009 & TS2010 每個 + 4 個 SP	3.5-3.7

乍一看，許多機車和火車車廂資產對於希望修復有故障資產的新 Trainzer 來說似乎非常複雜。trainz-build 值的意義鮮為人知，即使是自 Trainz 最初版本以來就參與其中的許多內容創作者也是如此。關鍵是要理解 Greg Lane 和原始程式設計團隊在 2003 年至 2004 年期間開發了資產的更復雜資料結構，並且它們從那時起變化不大，只是增加了額外的功能。

請記住，“TB”表示 trainz-build，而 v#.# 是 trainz-build 標籤的值，此外，N3V 遊戲選擇實施升級的倒退方式，您的內容管理器 (CM) 驗證程式生成的所有資產故障列表都依賴於其各自 config.txt 檔案中分配給 trainz-build 標籤行的值。這意味著在特定最小閾值下使資產無故障，應該會使資產在所有後續版本中正常工作。事實上，該閾值通常很低；符合 “理想” v2.0-v2.4 資料模型 定義通常會導致資產在直至 TS12-SP1 （TBv3.7；這些資產應該與新的 TANE 資料模型一起工作）的版本中正常工作。將大多數其他資產修復為 v2.6 故障測試需求，會為少數孤獨的例外情況帶來類似的成功，儘管事實上 N3V 管理層人為地將上傳所需的最小 TB 值向上推。 (結果是 P.O.'d 內容創作者，N3V 希望他們無償地奉獻自己的時間，每隔幾年就一次又一次地更新數百個資產，沒有任何正當理由或需求！)
1. 資料模型的下一個重大變化是 N3V 首次進軍新的技術功能，這主要影響機車——某些配置標籤和以前使用的標籤被移到 KIND 的不同組合中，或者被認定不需要定義而被刪除^{[注 1]}
2. 下一個重大變化是 TS2009-TS2010，當時程式設計師將舊的內容創作者指南準則形式化到 TrainzOnline Wiki 中，我們現在依靠它來獲得有關要修復的內容和修復方法的技術指導。不幸的是，它很少更新，而且在需要之前不會提前宣佈更改，而 DLS 審查軟體在沒有通知的情況下更新到 Windwalkr 當前的偏好。^{[注 2]}
克服混淆的首要關鍵是瞭解 CM 在提供指示 config.txt 檔案需要細心呵護 (TLC) 的故障訊息方面相當出色，這意味著您大部分時間都可以忽略它沒有抱怨的行。
第二件有助於輕鬆應對變化演變的事情是認識到您可以在更改檔案之前進行備份，我們強烈建議您將此實踐培養成一種習慣。
1. 根據您使用的文字編輯器，這可能需要在開啟檔案之前或之後完成。
  1. 要在開啟之前進行備份，LMB 點選其 Windows 資料夾中的檔案，鍵入 CTRL+C，然後點選資料夾中任何檔案或資料夾之外的位置，然後使用 CTRL+V （貼上），Windows 將克隆原始檔案。然後，您可以按照以下替代方法的詳細說明對其進行重新命名。
  2. 從經濟角度考慮（假設我們開啟一個預設使用 TB v1.3 的舊資產），我們更傾向於使用 Notepad++ 開啟檔案，輸入 ⇧ Shift+ALT+Tab ↹（後退一個視窗），將焦點返回到檔案資料夾（檔案仍將被選中並高亮顯示），然後按下 F2（Windows 重新命名）並在“.txt”副檔名之前插入字串 "v1-3.orgFlawed" 或者僅僅 "v1-3.org"。當然，如果資產最初是 v2.1 或 v2.2，則相應調整“.org”名稱。
    1. 最後，按下 ALT+Tab ↹（前進）回到 Notepad++，當它重新獲得 Windows 焦點時，將顯示一個 彈出訊息框： "檔案 config.txt 已被移動或刪除。保留檔案在編輯器中？" 我們建議您使用左鍵單擊“是”。
    2. 這種技巧可以讓你同時記錄儲存檔案的狀態，並保留其原始歷史記錄（日期時間戳），這在某些情況下可能會有用，同時允許你以一種提醒你為什麼現在需要它的方式重新命名檔案。當你儲存一個更改時，它會有一個同樣有效的日期時間戳。你可以立即按下 CTRL+S 儲存它，重建資料夾中的 config.txt 檔案，或者等到你更改了內容（我們的建議，畢竟你已經備份了！）。
    3. 在使用給定的 trainz-build 標籤級別加上一個提升（參見表格右側列出的目標級別的建議）修復資產後，我們將建議一個後續步驟，因為我們將逐步將已修復的資產檔案集演變為完全升級的檔案集，透過類似於“config.v2-3a.PRLM.txt”、“config.v2-3b.OK.txt”、“config.v2-6a.OK.txt”……、“config.v2-9.near.txt”……、config.txt. →（大概是 v3.7 或更高）的表示法。
關鍵的一點是，對於大多數資產而言，通常沒有必要將較舊的資產 修復並演變 到 v2.0 之後，或者對於某些需要針對 TS09 和 TS10 進行特殊 TLC 的特殊情況，可以將它們修復並演變到 v2.9–3.3 之後。
下一個幫助初學者的因素是認識到事物的順序（除了容器大括號內部，即使在其中，很多內容也可以根據需要重新排序），完全無關緊要。要麼資產的種類必須包含 Trainz 需要的所有宣告和定義，要麼 Trainz 會因錯誤而報錯。
1. 這意味著如果你想以某種順序分析資產因素，你可以隨意移動行。只是儘量不要丟失任何行，除非那就是修復方法！
2. 這種自由意味著你可以將相關資料分組在一起 [例如，所有包含“ory-”（即“category-”）的三個標籤，或者所有引用行的 kuid（部件或元件，例如轉向架），或者所有包含“name”的標籤等等]，以幫助你更好地理解正在發生的事情，讓你感覺更舒適。
3. 作為一個一般的策略，在修復時，我更傾向於將所有在 TBv 級別提升時通常會被更改或刪除的標籤移動到文字描述塊附近，在那裡我新增一個關於我為了更改作者資產而做了什麼的更改記錄。你可能不覺得有必要，也不理解我這樣新增字尾 [“-a”表示修改，“-aR”表示修復，“-aRu”表示修復和升級，“-aRus”表示加上螢幕截圖。類似地，“-aS”表示我僅僅添加了一個螢幕截圖，“aCmd”表示我克隆了它併為更早的 Trainz 版本修改了它]。記錄你做了什麼以及為什麼是一個“好的程式設計師”的做法，毫無疑問，這是一種我們正在維護的軟體形式^{[note 3]}
請隨意大膽嘗試和實驗。上面提到的“config.v2-3a.PRLM.txt”表示一種這種哲學上的策略變化，它將到目前為止的修復複製到安全的地方，然後進行更大膽的操作，使用新的容器和標籤將資產跳躍到高於最初目標的 TBval。一旦你對 KIND 型別常用和預期的標籤感到熟悉，你應該做同樣的事情。
待續

主題 2

主題 3

主題 4

主題 5 及以上

*在 trainzoptions.txt（TR04—TS12）中設定“freeintcam”開關引數，或在 TANE 及更高版本中勾選具有相同功能的複選框（釋放內部攝像頭），會更改鍵盤箭頭鍵的功能，將其從旋轉和傾斜功能改為將攝像頭位置左右滑動或前後滑動。Freeintcam 模式允許使用者將許多攝像頭完全移出駕駛室，或移到更具優勢的觀看（和滑鼠控制）角度。

註釋、腳註和參考文獻

Config.txt 檔案在 Trainz 資產中無處不在，因為沒有資產可以在沒有這種型別的計算機科學容器的情況下定義。在編輯或建立 Trainz 內容時，必須始終牢記關鍵字-值對。 TrainzBaseSpec 包含在定義資產的 config.txt 檔案中最常見的容器和值。

註釋

↑ 一個優秀的程式設計團隊會知道，應該像忽略註釋行一樣忽略這些標籤。而 N3V 的 Windwalkr 選擇了對抗（在 TS2009 的變更中，他甚至將註釋從合法專案中移除，變得更加對抗），從而迫使數千使用者修復實際上不需要修復的資產。只是一個不再使用的標籤。
↑ 將 DLS 稽核升級到尚未推出的本地故障測試軟體（即使用者的 CM）意味著受影響的不是 Windwalkr 的時間，而是眾多使用者的時間。好傢伙，是吧。一個合格的專業人士會編寫一個翻譯過濾器，並在執行中修復必要的更改……花費幾個小時將舊的實踐更新到最新，但是，嘿，這不會浪費他的時間！
↑ 不幸的是，大多數我們可以透過手工或甚至使用指令碼和 Asset-X 成功實現的更改，在資料模型需求發生變化時，應該自動進行翻譯。對於之後每次重大的變更（基本上是 V2.0），N3V 應該提供一個簡單的工具，將每個資料模型修改為下一個版本的需要。這些所謂的過濾器一旦編寫，就永遠有效，為下一個版本中可能需要的少量變更提供一個新的基礎級別進行翻譯，因此下一個平臺只需要那個過濾器，以及一些註釋，以保留舊的公式。這種演進可以無限期地持續下去，並且在每個平臺上，CM 作為輸入所接受的輸出將是一個“當前的 TBval 資產”，其中包含程式設計師的要求或期望的一切，簡化並簡化他們的能力，並減少他們隔離資料型別問題導致的故障所花費的時間。這些問題將在預處理、翻譯和驗證中被捕獲，而不是在驗證和太晚的回溯翻譯之後被捕獲！

腳註

參考文獻

Trainz 列印版或 pdf 檔案手冊，適用版本 - 通常位於 ..\extras 或 ..\extras\manuals 資料夾
TrainzOnline Wiki Config.txt 檔案頁面以及其他頁面
TrainzOnline Wiki: 內容建立者指南頁面（各種）
各種 CCG 和 Auran 網站

[1] 一個優秀的程式設計團隊會知道，應該像忽略註釋行一樣忽略這些標籤。而 N3V 的 Windwalkr 選擇了對抗（在 TS2009 的變更中，他甚至將註釋從合法專案中移除，變得更加對抗），從而迫使數千使用者修復實際上不需要修復的資產。只是一個不再使用的標籤。

[2] 將 DLS 稽核升級到尚未推出的本地故障測試軟體（即使用者的 CM）意味著受影響的不是 Windwalkr 的時間，而是眾多使用者的時間。好傢伙，是吧。一個合格的專業人士會編寫一個翻譯過濾器，並在執行中修復必要的更改……花費幾個小時將舊的實踐更新到最新，但是，嘿，這不會浪費他的時間！

[3] 不幸的是，大多數我們可以透過手工或甚至使用指令碼和 Asset-X 成功實現的更改，在資料模型需求發生變化時，應該自動進行翻譯。對於之後每次重大的變更（基本上是 V2.0），N3V 應該提供一個簡單的工具，將每個資料模型修改為下一個版本的需要。這些所謂的過濾器一旦編寫，就永遠有效，為下一個版本中可能需要的少量變更提供一個新的基礎級別進行翻譯，因此下一個平臺只需要那個過濾器，以及一些註釋，以保留舊的公式。這種演進可以無限期地持續下去，並且在每個平臺上，CM 作為輸入所接受的輸出將是一個“當前的 TBval 資產”，其中包含程式設計師的要求或期望的一切，簡化並簡化他們的能力，並減少他們隔離資料型別問題導致的故障所花費的時間。這些問題將在預處理、翻譯和驗證中被捕獲，而不是在驗證和太晚的回溯翻譯之後被捕獲！

[注 1]

[注 2]

[note 3]