Creates Nodes and Edges child-parents.

Retrieve and save current Soulstruct plugin general settings.

Check if any `name_or_game` is the selected `Game`.

Find or create Collection `names[-1]`. If it doesn't exist, create it, nested inside the given `names` hierarchy, starting at `root_collection`.

Sets entry subtype appropriately under supertype properties (e.g. `obj.MSB_PART.entry_subtype`).

Default: raise for unsupported types.

Write `file` to `relative_path` in project directory (if given) and optionally also to game directory if `also_export_to_game` is enabled.

FLVER models can be parsed from a Mesh obj or its optional Armature parent.

Default: raise for unsupported types.

Create an RGBA color tuple from HSV and `alpha` values (all in range [0, 1]).

Create a new `ShaderNodeMath` node with the given operation and inputs. Each input can be a constant `float` or `int` (set as default value) or a

Create a new `bpy.types.Node` of the given type.

Get path of arbitrary file relative to this root. At least one `parts` argument must be given, as this is not permitted to return directories

Get the 'map/{map_stem}' directory path, and optionally further, in the preferred directory. If `smart_map_version_handling` is enabled, this

Searches the `MatDef` for samplers that match the pattern, and returns a single socket output for it. If there are two or more samplers, it c

Check if `smart_map_version_handling` is enabled and return the latest version of the map stem if so.

For FLVER, Blender `obj` could be Mesh or Armature.

Create a Blender `EnumProperty` for selecting DCX compression type. Will default to `default` string, which should be one of the items below. The

Only get cross-game properties or properties for the active game.

Try to get file path relative to project or game directory first, depending on `prefer_import_from_project`, then fall back to the same path r

MSB Parts can be parsed from a Mesh obj or its optional Armature parent.

Check if `smart_map_version_handling` is enabled and return the oldest version of the map stem if so.

Return True if `path` is a valid path to a directory.

Create a fully-represented MSB Part linked to a source model in Blender. Subclasses will override this to set additional Part-specific proper

Constructs a shader node group by appending the node group with the specified name to the open Blender scene. Then, links the shader

Searches the `MatDef` for samplers that match the pattern, and returns a single socket output for it. Only texture alpha is used. If

Create a node group that processes input normal map colors (for given game) to Blender normal colors. Blender expects red to be the X compone

Retrieve the active object as an MSB Part object, or None if it is not a Part.

Get the map stem of the collection that the object is in. Supports multiple containing collections as long as only one looks like a map stem.

Overload for default `Binder` class type detection.

Use annotations of `source_obj.props_name` to copy properties to `dest_obj.props_name`.

Register known game Binders/TPFs to be opened as needed. `flver_source_path` is the path to the Binder file containing the FLVER, or loose FL

Get Armature, Mesh, model name, and `is_part` of active FLVER or MSB Part (Character or Object only).

Get path of arbitrary directory relative to this root. Does NOT check if the directory actually exists. If no parts are given, `root` will be

Find all FLVER Dummy (empty children of root object with expected name). If `operator` is provided, warnings will be logged for any Empty chi

Get the 'map/{map_stem}' directory path, and optionally further, in the preferred directory. Directory must exist, or a `NotADirectoryError`

In this add-on, model names (FLVER, Collision, Navmesh) are always the first part of an object name, before the first space and/or period (so we d

Read a NVMHKT into a Blender mesh object.

Checks if current game is either version of Dark Souls 1.

For MSB Part, Blender `obj` could be Mesh or Armature.

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

Searches the `MatDef` for samplers that match the pattern, and returns a single socket output for it. Texture colors are processed as normals

Create a driver that uses MSB_REGION `prop_axes` (e.g. 'xxz') to drive the matching index of `obj.scale`.

Draw a label showing the detected map. If `use_latest_version` is True, the latest version of the detected map will be shown IF smart map ver

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

Get the `map_stem` MSB path in the preferred `map/MapStudio` directory. MSB file must exist, or a `FileNotFoundError` will be raised.

Return True if `path` is a valid path to a file.

Create a cube mesh with side length 1, with its base at the origin.

Check all FLVER texture stems for any 'mAA_' prefixes and register texures in that map area dir. Required for FLVERs that use 'lazy' texture

Rename object, data, and event entity children.

Set face materials according to their `NVMTriangle` flags. Searches for existing materials on the mesh with names like "Navmesh Flag <flag_name>"

Create 'hi' and/or 'lo' HKX files by splitting given `hkx_model` into submeshes by material, or (if empty), directly from child submesh Mesh o

Create a non-DCX version of file at `dcx_path`.

Duplicate just the `armature` of this FLVER model. Mostly used internally during full duplication. If `child_mesh_obj` is given (e.g. one jus

Load from current animation data of given `armature`.

Retrieve the active object as an MSB Event object, or None if it is not a Event.

Export FLVER from Blender object and return Binder, FLVER, and texture collection. NOTE: Returned Binder does not load FLVER entries automati

Get glob patterns with and/or without '.dcx' extension.

Try to get directory path relative to project or game directory first, depending on `prefer_import_from_project`, then fall back to the same p

Try to find compendium HKX. Div Binders may have multiple, but they should be identical, so we use first.