Parse a Blender object into a Mesh and (optional) Armature object.

Find the shared prefix between the old model name and the old instance name, and replace that prefix with the same number of characters from the n

Get DCX type associated with `class_name` for selected game. NOTE: Those should generally only be called for loose files or files inside unco

Detect appropriate wavelet or spline compression based on game.

Create MCG from Blender nodes and edges. `bl_nodes` and `bl_edges` are assumed to be correctly ordered for MCG indexing. This should generall

Create `NVM` from a Blender mesh object. This is much simpler than FLVER or HKX map collision mesh export. Note that the navmesh name is not

Base method for batch-importing FLVER models, which have already been parsed into `flver_sources` and (if in Binders) `flver_source_binders`.

Strip '<DEAD END>' and any other '<' suffix from tight node name (and anything from first period).

Find character TPFs in a given loose folder.

Create getter/setter properties for all `names` within `self.type_properties` in `cls`. `cls` type must have a `type_properties` `PropertyGroup`

Sets viewport object color + selection lock based on state.

Copy pose bone transforms. NOTE: You need to call `context.view_layer.update()` between creating an `Armature` and accessing its `pose`.

Copy UV data from one layer to another for a specific face.

Create a very basic Blender material with a single diffuse `color`. If `wireframe_pixel_width > 0`, the material will also render a wireframe wit

Create box tree (depth first creation order). NOTE: These boxes should be imported for inspection only. They are automatically generated from

Check if FLVER model already exists in Blender.

Duplicate Collision model to a new object. Does not rename (will just add duplicate suffix).

Find a LayerCollection by name, searching recursively through all children of the view layer's root LayerCollection.

Find all LayerCollections whose names FULLY match the regular expression `pattern_str`.

Takes a template like '##_####' and converts `animation_id` int (e.g. 13000) to a string (e.g. 'a01_3000').

Find all FLVER files (with or without DCX) in `binder`. By default, only one FLVER file is allowed. If `allow_multiple` is True, multiple FLVER f

Get property name for active game's image cache directory.

Get property name for MATBINBND path string. Returns empty string if active game does not use MATBINs.

Get property name for MTDBND path string. Returns empty string if active game does not use MTDs.

Get map stem for export based on `obj` name, or fall back to settings map stem.

We 'factor out' any shared prefix of all diffuse texture names, then add MatDef stem, <BC>, and <flags>. As materials have a 63-character nam

Check if import directory path exists.

Read a HKX or two (hi/lo) HKXs into a single Blender mesh, with materials representing res/submeshes.

Must have an active FLVER or Part with an Armature and be working on a game that supports animations.

Just renames object and data.

Register all TPFs in an arbitrary opened Binder (usually the one containing the FLVER) as pending sources.

Keep Object.pass_index aligned with our enum for tint masks.

Batch convert all textures in this collection to DDS format using `texconv`. Returns DDS data and actual DDS format used. TODO: Need

Animation data is easier to export from Blender than import, as we can just read the bone transforms on each frame in Armature space directly

Faster method of adding all bone and (optional) root keyframe data. Constructs `FCurves` with known length and uses `foreach_set` to batch-se

Convert Blender object reference to MSB entry reference. Has wrappers for Part, Event, and Region references. Model references use a separate

This shader is used for objects that don't receive lighting, like the skybox.

Same as the diffuse no-light shader, but also fades out the object past certain viewing angles.

Water shader for PTDE and DS1R. Uses the texture in the normal map sampler as a heightmap, sampled at 3 different tile scales.

Create Blender Mesh with plenty of efficient `foreach_set()` calls to raveled `MergedMesh` arrays. Returns two arrays of bone indices and bone we

Export `MSB` from Blender. Given `map_stem` will be the map stem that is baked into MSB entries, e.g. for SIB paths. It should match the MSB'

Get the appropriate number of draw group properties for the given bit count (128 or 256).

Return a dictionary mapping LayerCollection names to LayerCollection objects, searching recursively.

Detect Part subtype that given model object should be used for. Uses prefix of FLVER model name to resolve FLVER part subtype.

For each cut, get the Armature-space frames for the given `remo_part` or a frame count if not in cut. Each frame maps bone names to a `TRSTra

Get all selected objects that have an MSB Part geometry subtype.

Can be overridden to handle specific missing models (e.g. known DSR vanilla mistakes).

Convert MSB entry reference to Blender object reference (may be a created Empty added now to `missing_collection_name`). Note that we

Create a new `ShaderNodeGroup` of the given name type, or import it from the packaged blend file. Positions group node at the current BSDF_X

Process path with given `dcx_type`, or default game DCX type for file suffix if `dcx_type` is `None`.

Read subtype fields as well as type fields. Skips MSB reference fields, which are read after all Blender entries are created.

Find character TPFs in a TEXBND next to the CHRBND. (Always DCX for games that use it.)

Register TPFBHD Binders and loose TPFs in a specific `map_area_dir` 'mAA' map directory.

Register all loose TPF files in `tpf_dir` as pending sources.

All regions use 'All' subtype.

Find shortest path between two faces in a BMesh using A* algorithm. If `all_faces_passable` is `True`, the cost of each step is simply the distan

Build a shader node tree using shader/sampler information from given `MatDef`.

Checks if the given HKX Binder entry matches the given collision model ID.