Repairing assets for T:ANE

Repairing assets for Trainz:A New Era (T:ANE)

Purpose

The purpose of this page is to assist content creators correct errors and warnings found in TS12 compliant assets for T:ANE.

Discussion

TS12 compliant assets are supposed to be equally compliant for T:ANE. However, T:ANE has introduced stricter compliance and that may throw up errors and warnings not previously seen in TS12.

This page is not intended to identify or correct issues with T:ANE itself. Bugs, deficiencies or any other problems should be reported via the T:ANE reporting system or via Trainz T:ANE forums.

Sunset Clause

This is not intended to be a permanent page. Request it be removed when T:ANE content creation documentation is available on the WiKi or when it has outlived its usefulness.

Errors

Texture Errors

Texture cannot be loaded:

Typical error message:

- failed to open binary texture 'bb_main_bogey.texture' for 'd:/tane/tane-ce-userdata/original/hash-C0/kuid2 186372 110002 3'

- Texture 'bb_main_bogey.texture' is missing or could not be loaded in mesh 'bb_bogey_export_lopo_v1.im', material 'bb.m.reflect'.

Solutions:

1. AssetX has a command called "Repair/Repair Textures" that should clear most problems. See notes below regarding AssetX and T:ANE.

2. Option 1 didn't work for a bogey asset for the author (PCAS1986) although it was cleared by increasing the kuid number and recommitting the asset. However, this doesn't seem like a valid solution.

Invalid MIP count:

Typical error message:

- binary texture file 'carriage-normal.texture' has invalid mip count for 'd:/tane/userdata/local/hash-92/kuid 186372 100298'

Solution:

One or more of the texture dimensions exceeds 2048. You may have to resize. Currently, it is not known if this will be a T:ANE limitation.

Mesh Errors:

Typical error message:

- Invalid position data - LoadE2MeshObject> 50ft flatcar_body/med50ft flatcar_body.im: Chunk:0 invalid - Unable to load indexed mesh '50ft flatcar_body/50ft flatcar_body.lm'

Solution/Explanation:

One or more of the vertex coordinates is not a number or is more than 5km from the origin of the model.

Warnings

LOD

Typical warning:

! The low-detail meshes total more than 500 polygons. This may have a negative impact on performance.

Solution:

The lowest level mesh should be reduced to a simple box form with as little detail as possible. Guidelines on LOD can be found at Modeling_Guidelines#Level_Of_Detail.

AssetX and T:ANE

Currently, AssetX is not optimised for T:ANE (build 3.9) and particularly for newer tags such as those used for procedural track.

You can use the current version of AssetX with TANE for most repairs.

To do this you should:

1. Set your build number in AssetX to 3.7 or 3.8

2. Set one of your Home Folders to (TANE-Path)\UserData\editing

3. Use the T:ANE Content Manager to open the asset for edit, this should make the asset appear in AssetX

4. Carry out your repairs.

5. Use T:ANE Content Manager to commit the asset.