PyLibMS 4.1.7__tar.gz → 4.2.1__tar.gz

pylibms-4.2.1/MANIFEST.in

@@ -0,0 +1 @@
+include README.md LICENSE

{pylibms-4.1.7 → pylibms-4.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyLibMS
-Version: 4.1.7
+Version: 4.2.1
 Summary: Python library built for the libMessageStudio (LMS) proprietary file formats from Nintendo. Supports MSBT, MSBP, and MSBF.
 Author: AbdyyEee
 License-Expression: MIT
@@ -23,7 +23,7 @@ Dynamic: license-file
 [![Python Versions](https://img.shields.io/pypi/pyversions/PyLibMS)](https://pypi.org/project/PyLibMS/) 
 [![PyPI version](https://badge.fury.io/py/PyLibMS.svg)](https://badge.fury.io/py/PyLibMS)
 
-PyLibMS is a library built for Python 3.10 and above for the libMessageStudio (LMS) proprietary file formats from Nintendo. 
+PyLibMS is a library built in Python 3.10 and above for reading and writing of libMessageStudio (LMS) proprietary file formats from Nintendo. 
 
 The following is supported
 | Format | Read | Write | Configuration Support                                                                     |
@@ -41,24 +41,45 @@ and examples.
 
 ## Reading
 
-MSBT/MSBF
+### MSBT
 
 ```py
 from lms.message.msbtio import read_msbt_path
+
+msbt = read_msbt_path("Text.msbt")
+```
+
+### MSBP
+```py
+from lms.project.msbpread import read_msbp_path
+
+msbp = read_msbp_path("Project.msbp")
+```
+
+
+### MSBF
+```py
 from lms.flowchart.msbfio import read_msbf_path
 
-msbt = read_msbt_path("Game.msbt")
-msbf = read_msbf_path("Game_Flowchart.msbf")
+msbf = read_msbf_path("Flowchart.msbf")
 ```
 
+
 ## Writing
+There is no writing for `MSBP` files as most of the time it acts as leftover metadata and not actually loaded by games.
 
+### MSBT
 ```py
 from lms.message.msbtio import write_msbt_path
+
+write_msbt_path("Out_text.msbt")
+```
+
+### MSBF
+```py
 from lms.flowchart.msbfio import write_msbf_path
 
-write_msbt_path("Out_Game.msbt")
-write_msbf_path("Out_Game_Flowchart.msbt")
+write_msbf_path("Out_Flowchart.msbf")
 ```
 
 # Adding/Editing Presets

{pylibms-4.1.7 → pylibms-4.2.1}/PyLibMS.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyLibMS
-Version: 4.1.7
+Version: 4.2.1
 Summary: Python library built for the libMessageStudio (LMS) proprietary file formats from Nintendo. Supports MSBT, MSBP, and MSBF.
 Author: AbdyyEee
 License-Expression: MIT
@@ -23,7 +23,7 @@ Dynamic: license-file
 [![Python Versions](https://img.shields.io/pypi/pyversions/PyLibMS)](https://pypi.org/project/PyLibMS/) 
 [![PyPI version](https://badge.fury.io/py/PyLibMS.svg)](https://badge.fury.io/py/PyLibMS)
 
-PyLibMS is a library built for Python 3.10 and above for the libMessageStudio (LMS) proprietary file formats from Nintendo. 
+PyLibMS is a library built in Python 3.10 and above for reading and writing of libMessageStudio (LMS) proprietary file formats from Nintendo. 
 
 The following is supported
 | Format | Read | Write | Configuration Support                                                                     |
@@ -41,24 +41,45 @@ and examples.
 
 ## Reading
 
-MSBT/MSBF
+### MSBT
 
 ```py
 from lms.message.msbtio import read_msbt_path
+
+msbt = read_msbt_path("Text.msbt")
+```
+
+### MSBP
+```py
+from lms.project.msbpread import read_msbp_path
+
+msbp = read_msbp_path("Project.msbp")
+```
+
+
+### MSBF
+```py
 from lms.flowchart.msbfio import read_msbf_path
 
-msbt = read_msbt_path("Game.msbt")
-msbf = read_msbf_path("Game_Flowchart.msbf")
+msbf = read_msbf_path("Flowchart.msbf")
 ```
 
+
 ## Writing
+There is no writing for `MSBP` files as most of the time it acts as leftover metadata and not actually loaded by games.
 
+### MSBT
 ```py
 from lms.message.msbtio import write_msbt_path
+
+write_msbt_path("Out_text.msbt")
+```
+
+### MSBF
+```py
 from lms.flowchart.msbfio import write_msbf_path
 
-write_msbt_path("Out_Game.msbt")
-write_msbf_path("Out_Game_Flowchart.msbt")
+write_msbf_path("Out_Flowchart.msbf")
 ```
 
 # Adding/Editing Presets

{pylibms-4.1.7 → pylibms-4.2.1}/README.md

@@ -2,7 +2,7 @@
 [![Python Versions](https://img.shields.io/pypi/pyversions/PyLibMS)](https://pypi.org/project/PyLibMS/) 
 [![PyPI version](https://badge.fury.io/py/PyLibMS.svg)](https://badge.fury.io/py/PyLibMS)
 
-PyLibMS is a library built for Python 3.10 and above for the libMessageStudio (LMS) proprietary file formats from Nintendo. 
+PyLibMS is a library built in Python 3.10 and above for reading and writing of libMessageStudio (LMS) proprietary file formats from Nintendo. 
 
 The following is supported
 | Format | Read | Write | Configuration Support                                                                     |
@@ -20,24 +20,45 @@ and examples.
 
 ## Reading
 
-MSBT/MSBF
+### MSBT
 
 ```py
 from lms.message.msbtio import read_msbt_path
+
+msbt = read_msbt_path("Text.msbt")
+```
+
+### MSBP
+```py
+from lms.project.msbpread import read_msbp_path
+
+msbp = read_msbp_path("Project.msbp")
+```
+
+
+### MSBF
+```py
 from lms.flowchart.msbfio import read_msbf_path
 
-msbt = read_msbt_path("Game.msbt")
-msbf = read_msbf_path("Game_Flowchart.msbf")
+msbf = read_msbf_path("Flowchart.msbf")
 ```
 
+
 ## Writing
+There is no writing for `MSBP` files as most of the time it acts as leftover metadata and not actually loaded by games.
 
+### MSBT
 ```py
 from lms.message.msbtio import write_msbt_path
+
+write_msbt_path("Out_text.msbt")
+```
+
+### MSBF
+```py
 from lms.flowchart.msbfio import write_msbf_path
 
-write_msbt_path("Out_Game.msbt")
-write_msbf_path("Out_Game_Flowchart.msbt")
+write_msbf_path("Out_Flowchart.msbf")
 ```
 
 # Adding/Editing Presets

{pylibms-4.1.7 → pylibms-4.2.1}/lms/common/field/io.py

@@ -8,7 +8,8 @@ from lms.fileio.io import FileReader, FileWriter
 from lms.titleconfig.definitions.value import ValueDefinition
 
 
-def read_field(reader: FileReader, definition: ValueDefinition) -> LMS_Field:
+def read_field(reader: FileReader, definition: ValueDefinition,
+               read_variable_width_value: Callable | None = None) -> LMS_Field:
     # String is excluded as their reading varies between MSBT/MSBF
     match definition.datatype:
         case LMS_DataType.UINT8:
@@ -26,17 +27,23 @@ def read_field(reader: FileReader, definition: ValueDefinition) -> LMS_Field:
         case LMS_DataType.FLOAT32:
             value = reader.read_float32()
         case LMS_DataType.LIST:
-            index = reader.read_uint8()
+            if read_variable_width_value is not None:
+                index = read_variable_width_value()
+            else:
+                index = reader.read_uint8()
             value = definition.list_items[index]
         case LMS_DataType.BOOL:
-            value = bool(reader.read_uint8())
+            if read_variable_width_value is not None:
+                value = bool(read_variable_width_value())
+            else:
+                value = bool(reader.read_uint8())
         case LMS_DataType.BYTES:
             value = reader.read_bytes(1)
 
     return LMS_Field(value, definition)  # type: ignore
 
 
-def write_field(writer: FileWriter, field: LMS_Field) -> None:
+def write_field(writer: FileWriter, field: LMS_Field, write_variable_width_value: Callable | None = None) -> None:
     if is_number_datatype(field.value, field.datatype):
         write_functions: dict[LMS_DataType, Callable] = {
             LMS_DataType.UINT8: writer.write_uint8,
@@ -51,10 +58,17 @@ def write_field(writer: FileWriter, field: LMS_Field) -> None:
         return
 
     if is_list_datatype(field.value, field.datatype):
-        writer.write_uint8(field.list_items.index(field.value))
+        value = field.list_items.index(field.value)
+        if write_variable_width_value is not None:
+            write_variable_width_value(value)
+        else:
+            writer.write_uint8(value)
     elif is_bytes_datatype(field.value, field.datatype):
         writer.write_bytes(field.value)
     elif is_bool_datatype(field.value, field.datatype):
-        writer.write_uint8(bool(field.value))
+        if write_variable_width_value is not None:
+            write_variable_width_value(bool(field.value))
+        else:
+            writer.write_uint8(bool(field.value))
     else:
         raise ValueError(f"Unsupported datatype: {field.datatype}")

{pylibms-4.1.7 → pylibms-4.2.1}/lms/flowchart/definitions/flowchart.py

@@ -16,6 +16,7 @@ class LMS_Flowchart:
             for node in entry_point.get_descendents():
                 self._nodes[node.id] = node
 
+
     def __iter__(self) -> Iterator[LMS_BaseNode]:
         return iter(self._nodes.values())
 

{pylibms-4.1.7 → pylibms-4.2.1}/lms/flowchart/definitions/node.py

@@ -27,15 +27,14 @@ class LMS_BaseNode:
                  id: int | None,
                  node_type: LMS_NodeType,
                  parameter_type: LMS_NodeParameterType,
-                 parameter_value: LMS_NodeParameter | None,
-                 stream_next_id: int | None = None):
+                 parameter_value: LMS_NodeParameter | None):
         self.id = id
         self._node_type = node_type
 
         self._parameter_type = parameter_type
         self._parameter_value = parameter_value
 
-        self._stream_next_id: int | None = stream_next_id
+        self._stream_next_id: int | None = None
         self._next_node: LMS_BaseNode | None = None
 
     @property
@@ -76,14 +75,6 @@ class LMS_BaseNode:
         if not isinstance(value, self._parameter_type.builtin_type):
             raise TypeError(f"Wrong value provided! Expected {self._parameter_type.builtin_type} got {type(value)}")
 
-        sliced_datatype = {
-            LMS_NodeParameterType.PARAM_16_16: (LMS_DataType.UINT16, LMS_DataType.UINT16),
-            LMS_NodeParameterType.PARAM_16_8_8: (LMS_DataType.UINT16, LMS_DataType.UINT8, LMS_DataType.UINT8),
-            LMS_NodeParameterType.PARAM_8_8_16: (LMS_DataType.UINT8, LMS_DataType.UINT8, LMS_DataType.UINT16),
-            LMS_NodeParameterType.PARAM_8_8_8_8: (LMS_DataType.UINT8, LMS_DataType.UINT8, LMS_DataType.UINT8,
-                                                  LMS_DataType.UINT8)
-        }
-
         match self._parameter_type:
             case LMS_NodeParameterType.STRING:
                 self._parameter_value = value
@@ -92,7 +83,8 @@ class LMS_BaseNode:
                 self._parameter_value = value
             case _:
                 for i, parameter in enumerate(value):
-                    verify_number_from_datatype(parameter, sliced_datatype[self._parameter_type][i])
+                    verify_number_from_datatype(parameter,
+                                                self._parameter_type.sliced_datatype[self._parameter_type][i])
 
         self._parameter_value = value
 
@@ -100,8 +92,6 @@ class LMS_BaseNode:
         """Set the next node for the instance.
 
         :param node: the node object, None for no next node."""
-        # Once next_node is properly set, stream_id is never accessed again
-        # While it does become stale, there is no point to altering it afterward
         self._next_node = node
         return node
 
@@ -143,7 +133,6 @@ class LMS_MessageNode(LMS_BaseNode):
 
     def __init__(self,
                  id: int | None,
-                 stream_next_node: int,
                  msbt_index: int,
                  label_index: int,
                  msbt: MSBT | None = None
@@ -153,7 +142,6 @@ class LMS_MessageNode(LMS_BaseNode):
             LMS_NodeType.MESSAGE,
             LMS_NodeParameterType.NONE,
             None,
-            stream_next_node
         )
 
         self.msbt_index = msbt_index
@@ -211,13 +199,20 @@ class LMS_BranchNode(LMS_BaseNode):
             LMS_NodeType.BRANCH,
             parameter_type,
             parameter_value,
-            NO_NEXT_NODE
         )
 
         self._condition_id = condition_id
         self._branches: dict[int, LMS_BaseNode | None] = {}
         self._definition = definition
 
+    def __repr__(self):
+        if self._definition is None:
+            return super().__repr__()
+        return f"{self._definition.name}({ {field.name: field.value for field in self._parameter_value} } {self.id}"
+
+    def set_next_node(self, node: LMS_BaseNode | None) -> LMS_BaseNode | None:
+        raise NotImplementedError("Use function set_branch_case to alter the flow of a branch node!")
+
     @classmethod
     def new(cls,
             parameter_type: LMS_NodeParameterType,
@@ -345,19 +340,22 @@ class LMS_EventNode(LMS_BaseNode):
                  parameter_type: LMS_NodeParameterType,
                  parameter_value: LMS_FieldMap | int | str | tuple[int, ...],
                  action_id: int,
-                 stream_next_id: int | None = None,
                  definition: NodeDefinition | None = None,
                  ):
         super().__init__(
             id,
             LMS_NodeType.EVENT,
             parameter_type,
-            parameter_value,
-            stream_next_id)
+            parameter_value)
 
         self._action_id = action_id
         self._definition = definition
 
+    def __repr__(self):
+        if self._definition is None:
+            return super().__repr__()
+        return f"{self._definition.name}({ {field.name: field.value for field in self._parameter_value} } {self.id}"
+
     @classmethod
     def new(cls, parameter_type: LMS_NodeParameterType, parameter_value: int | str | tuple[int, ...], action_id: int):
         """
@@ -409,13 +407,12 @@ class LMS_EntryNode(LMS_BaseNode):
     Class that represents an entry node. Node that is at the start of a flowchart.
     """
 
-    def __init__(self, id: int, stream_next_id=None, flowchart_name: str = ""):
+    def __init__(self, id: int, flowchart_name: str = ""):
         super().__init__(
             id,
             LMS_NodeType.ENTRY,
             LMS_NodeParameterType.NONE,
-            None,
-            stream_next_id)
+            None)
 
         self.flowchart_name = flowchart_name
 
@@ -425,13 +422,12 @@ class LMS_JumpNode(LMS_BaseNode):
     Class that represents a jump node. Node that jumps to another flowchart.
     """
 
-    def __init__(self, id: int, next_flowchart_id: int, unknown_short0a: int):
+    def __init__(self, id: int, unknown_short0a: int):
         super().__init__(
             id,
             LMS_NodeType.JUMP,
             LMS_NodeParameterType.NONE,
-            None,
-            next_flowchart_id)
+            None)
 
         self.next_flowchart: LMS_EntryNode | None = None
 

{pylibms-4.1.7 → pylibms-4.2.1}/lms/flowchart/definitions/node_type.py

@@ -1,7 +1,7 @@
-from typing import Type
 from enum import IntEnum
+from typing import Type
 
-from lms.common.lms_exceptions import LMS_Error
+from lms.common.field.lms_datatype import LMS_DataType
 
 PARAMETER_ALIASES = {
     "p32_0": "PARAM_32_0",
@@ -53,8 +53,27 @@ class LMS_NodeParameterType(IntEnum):
     PARAM_32_1 = 6
     NONE = -1
 
+    @property
+    def sliced_datatype(self) -> tuple[LMS_DataType, ...]:
+        """The parameter type split into the raw datatypes. Not valid for STRING."""
+        if self in [
+            LMS_NodeParameterType.NONE,
+            LMS_NodeParameterType.STRING]:
+            raise TypeError(f"There is no sliced datatypes for {self} parameter types!")
+
+        return {
+            LMS_NodeParameterType.PARAM_32_0: (LMS_DataType.UINT32,),
+            LMS_NodeParameterType.PARAM_16_16: (LMS_DataType.UINT16, LMS_DataType.UINT16),
+            LMS_NodeParameterType.PARAM_16_8_8: (LMS_DataType.UINT16, LMS_DataType.UINT8, LMS_DataType.UINT8),
+            LMS_NodeParameterType.PARAM_8_8_16: (LMS_DataType.UINT8, LMS_DataType.UINT8, LMS_DataType.UINT16),
+            LMS_NodeParameterType.PARAM_8_8_8_8: (LMS_DataType.UINT8, LMS_DataType.UINT8, LMS_DataType.UINT8,
+                                                  LMS_DataType.UINT8),
+            LMS_NodeParameterType.PARAM_32_1: (LMS_DataType.UINT32,)
+        }[self]
+
     @property
     def value_count(self) -> int:
+        """Amount of values the parameter holds."""
         if self is LMS_NodeParameterType.NONE:
             raise TypeError("There is no value count for NONE parameter types!")
 
@@ -70,6 +89,7 @@ class LMS_NodeParameterType(IntEnum):
 
     @property
     def builtin_type(self) -> Type[int] | Type[tuple[int, ...]] | Type[str]:
+        """The builtin type of the parameter type."""
         if self is LMS_NodeParameterType.NONE:
             raise TypeError("There is no builtin type for NONE parameter types!")
 

{pylibms-4.1.7 → pylibms-4.2.1}/lms/flowchart/flw3.py

@@ -1,4 +1,5 @@
 from lms.common.field.io import read_field, write_field
+from lms.common.field.lms_datatype import LMS_DataType
 from lms.common.field.lms_field import LMS_FieldMap, LMS_Field
 from lms.common.lms_exceptions import LMS_Error
 from lms.fileio.io import FileReader, FileWriter
@@ -13,6 +14,8 @@ NO_NEXT_NODE = 0xFFFF
 FLW3_HEADER_SIZE = 16
 NODE_SIZE = 16
 
+VARIABLE_WIDTH_DATATYPES = (LMS_DataType.BOOL, LMS_DataType.LIST)
+
 
 def read_flw3(reader: FileReader, config: NodeConfig | None, msbt: MSBT | None, ) -> tuple[
     int, dict[int, LMS_EntryNode]]:
@@ -25,6 +28,8 @@ def read_flw3(reader: FileReader, config: NodeConfig | None, msbt: MSBT | None,
 
     nodes: list[LMS_BaseNode] = []
     entry_nodes: list[LMS_EntryNode] = []
+
+    next_id_map: dict[LMS_BaseNode, int | None] = {}
     branch_metadata: dict[LMS_BranchNode, dict] = {}
 
     for i in range(node_count):
@@ -42,7 +47,7 @@ def read_flw3(reader: FileReader, config: NodeConfig | None, msbt: MSBT | None,
                 stream_next_id = read_next_node_id(reader)
                 file_index = reader.read_uint16()
                 message_index = reader.read_uint16()
-                node = LMS_MessageNode(i, stream_next_id, file_index, message_index, msbt)
+                node = LMS_MessageNode(i, file_index, message_index, msbt)
                 reader.skip(2)
             case LMS_NodeType.BRANCH:
                 # There is no next node id as the next node is determined by the branches
@@ -75,27 +80,29 @@ def read_flw3(reader: FileReader, config: NodeConfig | None, msbt: MSBT | None,
                 definition = get_config_definition(config, LMS_NodeType.EVENT, parameter_type, event_id)
                 parameter_value = evaluate_node_parameter(reader, section_start, parameter_type, definition)
 
-                node = LMS_EventNode(i, parameter_type, parameter_value, event_id, stream_next_id, definition)
+                node = LMS_EventNode(i, parameter_type, parameter_value, event_id, definition)
                 reader.seek(end)
             case LMS_NodeType.ENTRY:
                 reader.seek(node_data)
                 stream_next_id = read_next_node_id(reader)
-                node = LMS_EntryNode(i, stream_next_id)
+                node = LMS_EntryNode(i)
                 entry_nodes.append(node)
                 reader.skip(6)
             case LMS_NodeType.JUMP:
                 reader.seek(node_data)
-                next_flowchart_id = read_next_node_id(reader)
+                stream_next_id = read_next_node_id(reader)
                 unknown_short0a = reader.read_uint16()
-                node = LMS_JumpNode(i, next_flowchart_id, unknown_short0a)
+                node = LMS_JumpNode(i, unknown_short0a)
                 reader.skip(4)
 
+        next_id_map[node] = stream_next_id
         nodes.append(node)
 
     node_map: dict[int, LMS_BaseNode] = {node.id: node for node in nodes}
     branch_ids = [read_next_node_id(reader) for _ in range(branch_table_id_count)]
 
     for node in nodes:
+        next_node_id = next_id_map[node]
 
         if isinstance(node, LMS_BranchNode):
             case_count, starting_index = branch_metadata[node]
@@ -109,13 +116,13 @@ def read_flw3(reader: FileReader, config: NodeConfig | None, msbt: MSBT | None,
 
             continue
         elif isinstance(node, LMS_JumpNode):
-            node.next_flowchart = node_map[node.next_node_id]
+            node.next_flowchart = node_map[next_node_id]
             continue
 
-        if node.next_node_id is None:
+        if next_node_id is None:
             continue
 
-        node.set_next_node(node_map[node.next_node_id])
+        node.set_next_node(node_map[next_node_id])
 
     return node_count, entry_nodes
 
@@ -155,8 +162,10 @@ def evaluate_node_parameter(reader: FileReader,
                 param_definition.name: LMS_Field(value, param_definition)
             })
 
-        for param_definition in definition.parameter_definitions:
-            result[param_definition.name] = read_field(reader, param_definition)
+        for i, param_definition in enumerate(definition.parameter_definitions):
+            stream_map = {1: reader.read_uint8, 2: reader.read_uint16, 4: reader.read_uint32}
+            result[param_definition.name] = read_field(reader, param_definition,
+                                                       stream_map[parameter_type.sliced_datatype[i].stream_size])
 
         return LMS_FieldMap(result)
     else:
@@ -297,8 +306,13 @@ def write_node_parameter(writer: FileWriter,
                          value: LMS_NodeParameter,
                          parameter_type: LMS_NodeParameterType) -> None:
     if isinstance(value, LMS_FieldMap):
-        for field in value:
-            write_field(writer, field)
+        for i, field in enumerate(value):
+            # In MSBF files there could be a case where naturally one bit datatypes take up 2/4 bits.
+            if field.datatype in VARIABLE_WIDTH_DATATYPES:
+                stream_map = {1: writer.write_uint8, 2: writer.write_uint16, 3: writer.write_uint32}
+                write_field(writer, field, stream_map[parameter_type.sliced_datatype[i].stream_size])
+            else:
+                write_field(writer, field)
         return
 
     match parameter_type:

{pylibms-4.1.7 → pylibms-4.2.1}/lms/flowchart/msbf.py

@@ -63,17 +63,13 @@ class MSBF:
         """The flowcharts of the MSBF instance."""
         return MappingProxyType({flowchart.name: flowchart for flowchart in self._flowcharts})
 
-    @property
-    def global_node_id(self) -> int:
-        """Current node ID count."""
-        return self._global_node_id
-
     def set_global_id_count(self, value: int) -> None:
-        if value < self._global_node_id:
-            raise ValueError("Cannot decrease global node ID below existing count.")
         self._global_node_id = value
 
     def generate_next_id(self) -> int:
+        """
+        Lazy generation for the next ID of a node. IDs are normalized properly when the msbf file is being written.
+        """
         next_id = self._global_node_id
         self._global_node_id += 1
         return next_id
@@ -97,7 +93,7 @@ class MSBF:
     def delete_flowchart(self, name: str):
         """Delete a flowchart from the MSBF instance."""
 
-        if name not in self._flowcharts:
+        if name not in self.flowcharts:
             raise KeyError(f"Flowchart with name {name} does not exist!")
 
         del self._flowcharts[name]

{pylibms-4.1.7 → pylibms-4.2.1}/lms/titleconfig/definitions/nodes.py

@@ -55,11 +55,13 @@ class NodeDefinition:
     type: LMS_NodeType.BRANCH | LMS_NodeType.EVENT
     parameter_type: LMS_NodeParameterType
     parameter_definitions: tuple[ValueDefinition, ...]
+    case_format: str | None
     next_node_dependency: bool = False
 
     @classmethod
     def from_dict(cls, id: int, node_type: LMS_NodeType, data: dict) -> NodeDefinition:
 
+        description = data.get("description", "")
         converted_parameters: list[ValueDefinition] = []
         parameter_type = LMS_NodeParameterType.from_string(data["parameter_type"])
 
@@ -83,15 +85,19 @@ class NodeDefinition:
                             (LMS_DataType.UINT8, LMS_DataType.UINT8, LMS_DataType.UINT8, LMS_DataType.UINT8)[i]
                     case LMS_NodeParameterType.STRING:
                         datatype_from_dict = LMS_DataType.STRING
-                definition = ValueDefinition(parameter["name"], data.get("description", ""), datatype_from_dict,
+                definition = ValueDefinition(parameter["name"], description, datatype_from_dict,
                                              list_items)
             else:
-                definition = ValueDefinition(parameter["name"], data["description"],
+                definition = ValueDefinition(parameter["name"], description,
                                              LMS_DataType.from_string(datatype_from_dict),
                                              list_items)
 
             converted_parameters.append(definition)
 
+        # case_format is only for branch nodesa
+        if (case_format := data.get("case_format", None)) is not None and type == LMS_NodeType.EVENT:
+            raise ValueError("There may only be case_format for branch nodes!")
+
         return NodeDefinition(
             name=data["name"],
             id=id,
@@ -99,5 +105,6 @@ class NodeDefinition:
             type=node_type,
             parameter_type=parameter_type,
             parameter_definitions=converted_parameters,
+            case_format=case_format,
             next_node_dependency=data.get("next_node_dependency", False)
         )

{pylibms-4.1.7 → pylibms-4.2.1}/lms/titleconfig/presets/Tomodachi Life NA-EU.yaml

@@ -8,6 +8,7 @@ node_definitions:
         - name: exp
     - id: 1
       name: SwitchVariable
+      case_format: "var == $case"
       parameter_type: string
       parameters:
         - name: var
@@ -28,6 +29,11 @@ node_definitions:
       parameter_type: string
       parameters:
         - name: var
+    - id: 82
+      name: SetFlag
+      parameter_type: p32_1
+      parameters:
+        - name: flag
     - id: 90
       name: LoadSEGroup
       parameter_type: string

{pylibms-4.1.7 → pylibms-4.2.1}/pyproject.toml

@@ -7,7 +7,7 @@ include = ["lms*"]
 
 [project]
 name = "PyLibMS"
-version = "4.1.7"
+version = "4.2.1"
 requires-python = ">=3.10"
 description = "Python library built for the libMessageStudio (LMS) proprietary file formats from Nintendo. Supports MSBT, MSBP, and MSBF."
 readme = "README.md"

pylibms-4.1.7/MANIFEST.in

@@ -1,2 +0,0 @@
-include README.md LICENSE
-recursive-include lms/titleconfig/presets *.yaml