Tested on v0.8.0

Tested generated gltf files with https://github.khronos.org/glTF-Validator/ & they come back with a bunch of errors.
Am trying to debug why specific files, DE's pc010305 for example, seem to crash the Unreal 5 editor (something about EXCEPTION_ACCESS_VIOLATION reading address 0x00000001ffffffff), while other files don't have that issue.

Pyra's hooded alt has some sort of skeleton retargeting in the asm file. The hooded skeleton defines a few additional bones not present in the normal skeleton.

This requires finding a shader decompiler that's easy to build and use as an external tool similar to Ryujinx.ShaderTools. xc3_shader will need additional tests to make sure that the GLSL syntax works with the existing analysis code.

This requires additional research to differentiate between emission and hair specular that both use the output texture at index 5.

• gltf
• xc3_wgpu

When replacing certain model textures, such as Mythra's hair textures, the in-game shader effects will "blend" the color of the new texture with the color it was originally designed to accent. The ability to edit these materials should hopefully improve the look of certain texture replacements in-game.

Material Shaders for Massive Melee Mythra's Hair

Massive Melee Mythra's (Right) hair texture replaced with with Pyra-Style Mythra's (Left)

Sword Fighter Class jacket textures replaced with Noah's Color 2 jacket textures (Noah's Color 2 Outfit used for Comparison)

• read/write idcm files
• add collision types to xc3_model

User provides a folder, xc3_gltf processes all the wimdo/wismhd files.

Getting this error when attempting to load DE's Colony 9(ma0101) & Bionis Leg(ma0301). Seems to be an issue affecting only certain maps.

0: Error: no variants matched at 0x1298
           Unexpected value for enum: 9
 1: While parsing field 'data_type' in VertexAttribute
     at xc3_lib\src\vertex.rs:95
 2: While parsing field 'attributes' in VertexBufferDescriptor
     at xc3_lib\src\vertex.rs:82
 3: While parsing field 'vertex_buffers' in VertexData
     at xc3_lib\src\vertex.rs:21

The xc3_lib appears to already support reading and writing wilay (LAHD) textures. Extending the xc3_tex programme to include this support for this file format would enable users to more easily modify menu/UI images.

Currently I am unaware of any other programme that enables users to generate wilay textures - only ones that write them out to png (eg. XbTool). Therefore, there remains a need for someone to make such support accessible to modders.

• not all entries are BC
• some uncompressed xc2 animations index out of range

These can contain embedded Mxmd models and will be helpful for testing formats. Effects are complicated to render, so the focus should just be on read/write support.

Not sure if it's because xc3_lib hasn't been updated since v2.2.0 dropped, but I've been unable to properly replace the textures of the Leisure Time models (tested only with Mio and Sena's so far). Loading the edited models in-game via Layered FS causes the game to freeze, and Noesis gives the following error when it tries to preview them (though xc3_viewer seems to have no problems reading/previewing them).

NB. I'm using Xenoblade Chronicles 2 as my example as this appears to be the easiest to test and handles the problem cleaner. On XC3 the issue may crash the game

The addition of .wilay support to xc3_tex has enabled the successful export and re-import of various images in the 'menu\images' directory (thank you!). Examples include the thumbnails in the events theatre or the blade character images - these successfully show up in game.
However, wilay files which contain a single image with multiple icons or images drawn on it fail to display in-game when re-imported. Examples include character portrait image sheet or button icons layout sheet (I've used the buttons as an example image below as the character sheet contains spoilers for some people).

I have tested all of the above with unedited dds images output by xc3_tex - ie. I have tried re-importing the exact image that xc3_tex has outputted without modifying it in anyway. This should rule out any issue that could be created by the user modifying the image and re-saving.

In the example image below, you can see that a modified mythra (fim_bl_002.wilay) is displaying successfully, while character portraits in the top right (mnu_facel.wilay) and button icons in the bottom right (button.wilay) are failing to show:

The LAGP file rebuilding is still missing some data in the original file when saving.

Wilay images located in 'menu\layout' fail to process with the following error:

thread 'main' panicked at xc3_tex\src\main.rs:79:76:
called `Result::unwrap()` on an `Err` value: bad magic at 0x0: [76, 65, 80, 83]

Ideally adding support for whatever is different about these files would be nice, though if this is not a short term fix then perhaps a cleaner error message could be helpful so people understand that these files are different and as yet unsupported, even though they share the same file extension.

Not sure if this is an issue specific to XCDE Alvis' model (np860109), or if it extends to other NPC models as well, but editing any of Alvis' textures appears to cause the game to freeze upon the edited model's load. The .wimdo and .wismt don't appear corrupted, as they load just fine in Noesis, but I still assume something went wrong. Below is the main texture I'm trying to edit in:

np860109.16.NP860101_NEC_COL

I know xc1 isn't officially supported by wgpu_batch, but here's an error that shows up frequently when processing xb1 enemies.
examples: en150112, en150106, en150101
ERROR [xc3_wgpu::material] Expected 2D texture but found dimension D3.

• create the folder on export

Many files fail to rebuild 1:1 due to version differences compared to Xenoblade 2. Examples include menu/image/icon_button.wilay and menu/image/icon_button_y.wilay.

Bushes, grass, etc

Scale doesn't appear to be inherited correctly on the arms. It may be helpful to check the animations in each game for non unit scale to see how this is supposed to be handled. This can also be checked with references in game and matching the scale in Blender for known animations.

Some wilay files contain multiple images (eg. mnu032_button_push_main.wilay). When these files are re-compiled some of the images contained within the wilay appear offset when displayed onscreen, while others may be offset outside the visible screen.

Here are the contents of the mnu032_button_push_main.wilay when extracted:

The first image is the background, the second is a glow around the background, followed by pairs of buttons for swapping between the non-depressed and depressed states.

The original file should show these all layered on top of each other as below (ie. background, ring around border, 5th image [non-depressed B]):

The re-compiled file shows the first image in the correct position (the background) but is then failing to show the ring around border on-screen (it may be offset somewhere outside the visible screen?) then shows the fourth image (depressed button A) offset from the first. It also appears to fail to toggle between depressed and non-depressed states - possibly because the actual button that should be shown on screen are the 'B' pair which may be offset somewhere else...

I can confirm that this still happens even when I do not edit or reorder any of the images, but simply extract, then immediately recompile the wilay without any change.

Tested on v0.7.0

img0103_1.0, img0103_2.0, img0103_3.0

mf03_map01_ma2401_f01_map.0

npg_photo14.0

User reported error when running xc3_gltf 0.2.0.

Some models are split across multiple files. This applies to all supported games. One approach is to add model loading functions that take an iterator of paths. Loading a single model can call this function internally with std::iter::once. Merging a ModelRoot should also merge the skeletons. Skeleton merging can be tested with unit tests.

• load_models and load_models_legacy
• merge ModelRoot
• support multiple files for xc3_gltf and xc3_viewer

Read/write support for xc3_lib for the event/*.beb and event/*.beh formats. The basic steps are outlined below. Please comment if you plan on working on this or need additional help. Cutscenes aren't something I'm prioritizing, so I may not get around to this for a while.

• add src/beb.rs with a Beb struct and src/beh.rs with a Beh struct to xc3_lib
• create structs for the file formats using the other modules as a reference (unk fields are fine)
• add beb::Beb and beh::Beh to file_read_impl and file_write_full_impl in lib.rs to add read/write helpers
• test the reading and writing in a separate CLI project or by adding a main.rs file (please don't commit this)
• add test cases to xc3_test for testing read/write for all files (optional)

Useful Links:
https://github.com/ScanMountGoat/xc3_lib/blob/main/DEVELOPMENT.md
https://docs.rs/binrw/latest/binrw/
https://github.com/ScanMountGoat/xc3_lib/blob/main/Offsets.md