[SM64] Add SM64 C Geo Layout & Level Importer

[jesusyoshi54]

This code adds a fully functional geo layout, and level importer for sm64 decomp code.

All models imported with the operators provided have close to 100% material accuracy (some odd modes are still not supported), and the geo layouts should also be fully imported.

This code can import full level models with objects, collision and graphics all in the correct hierarchy, or each one individually. It can also import actor geo layouts or level object geo layouts.

Currently the code needs further integration into the SM64 codebase, as it currently exists in a rather stand alone manner.

[Reonu]

Tested this on both blender 4.2 and 4.1 Only BoB seems to import without errors (though the UVs are broken), TTC throws a bunch of errors and it imports only the collision. Everything else errors out and either nothing gets imported or only the actors get imported. Inside Castle which is what I'm trying to import doesn't work at all.

[avereyishere]

Python: Traceback (most recent call last):
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\sm64\sm64_level_importer.py", line 2141, in execute
geo_layout = find_actor_models_from_geo(
^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\sm64\sm64_level_importer.py", line 1996, in find_actor_models_from_geo
geo_layout.parse_level_geo(layout_name, scene)
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\sm64\sm64_level_importer.py", line 1395, in parse_level_geo
self.parse_stream_from_start(geo_layout, start, 0)
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\utility_importer.py", line 58, in parse_stream_from_start
self.parse_stream(dat_stream, entry_id, *args, **kwargs)
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\utility_importer.py", line 70, in parse_stream
flow_status = func(cur_macro, *args, **kwargs)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\sm64\sm64_level_importer.py", line 1492, in GEO_OPEN_NODE
GeoChild.parse_stream(self.geo_layouts.get(self.stream), self.stream, depth + 1)
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\utility_importer.py", line 70, in parse_stream
flow_status = func(cur_macro, *args, **kwargs)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\sm64\sm64_level_importer.py", line 1492, in GEO_OPEN_NODE
GeoChild.parse_stream(self.geo_layouts.get(self.stream), self.stream, depth + 1)
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\utility_importer.py", line 70, in parse_stream
flow_status = func(cur_macro, *args, **kwargs)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\sm64\sm64_level_importer.py", line 1492, in GEO_OPEN_NODE
GeoChild.parse_stream(self.geo_layouts.get(self.stream), self.stream, depth + 1)
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\utility_importer.py", line 70, in parse_stream
flow_status = func(cur_macro, *args, **kwargs)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\sm64\sm64_level_importer.py", line 1492, in GEO_OPEN_NODE
GeoChild.parse_stream(self.geo_layouts.get(self.stream), self.stream, depth + 1)
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\utility_importer.py", line 70, in parse_stream
flow_status = func(cur_macro, *args, **kwargs)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\sm64\sm64_level_importer.py", line 1492, in GEO_OPEN_NODE
GeoChild.parse_stream(self.geo_layouts.get(self.stream), self.stream, depth + 1)
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\utility_importer.py", line 70, in parse_stream
flow_status = func(cur_macro, *args, **kwargs)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\sm64\sm64_level_importer.py", line 1492, in GEO_OPEN_NODE
GeoChild.parse_stream(self.geo_layouts.get(self.stream), self.stream, depth + 1)
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\utility_importer.py", line 70, in parse_stream
flow_status = func(cur_macro, *args, **kwargs)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\sm64\sm64_level_importer.py", line 1492, in GEO_OPEN_NODE
GeoChild.parse_stream(self.geo_layouts.get(self.stream), self.stream, depth + 1)
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\utility_importer.py", line 70, in parse_stream
flow_status = func(cur_macro, *args, **kwargs)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\sm64\sm64_level_importer.py", line 1492, in GEO_OPEN_NODE
GeoChild.parse_stream(self.geo_layouts.get(self.stream), self.stream, depth + 1)
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\utility_importer.py", line 70, in parse_stream
flow_status = func(cur_macro, *args, **kwargs)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\sm64\sm64_level_importer.py", line 1492, in GEO_OPEN_NODE
GeoChild.parse_stream(self.geo_layouts.get(self.stream), self.stream, depth + 1)
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\utility_importer.py", line 70, in parse_stream
flow_status = func(cur_macro, *args, **kwargs)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\sm64\sm64_level_importer.py", line 1114, in GEO_ROTATION_NODE
geo_obj = self.GEO_ROTATE(macro, depth)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\sm64\sm64_level_importer.py", line 1122, in GEO_ROTATE
return self.setup_geo_obj("rotate", self.translate_rotate, macro.args[0])
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\sm64\sm64_level_importer.py", line 1361, in setup_geo_obj
self.set_geo_type(geo_obj, geo_cmd)
File "C:\Users\wowiz\AppData\Roaming\Blender Foundation\Blender\4.2\scripts\addons\fast64-KCS-importers\fast64_internal\sm64\sm64_level_importer.py", line 1343, in set_geo_type
geo_obj.sm64_obj_type = geo_cmd
^^^^^^^^^^^^^^^^^^^^^
TypeError: bpy_struct: item.attr = val: enum "Geo Translate/Rotat" not found in ('None', 'Level Root', 'Area Root', 'Object', 'Macro', 'Special', 'Mario Start', 'Whirlpool', 'Water Box', 'Camera Volume', 'Switch', 'Puppycam Volume', 'Geo ASM', 'Geo Branch', 'Geo Translate/Rotate', 'Geo Translate Node', 'Geo Rotation Node', 'Geo Billboard', 'Geo Scale', 'Geo Displaylist', 'Custom Geo Command')

[jesusyoshi54]

yeah I'm aware armatures don't work currently. this is still WIP

[Reonu]

@jesusyoshi54 not sure if you're still working on this, but I tried to import Castle Grounds (from a HackerSM64 3.0 repo in order to avoid macro objects) and it didn't work at all:

Info: Success!
Info: Success!
Info: Deleted 3 object(s)
Traceback (most recent call last):
  File "/home/reonu/.config/blender/4.5/scripts/addons/fast64-main/fast64_internal/sm64/sm64_level_importer.py", line 2394, in execute
    lvl = parse_level_script(
          ^^^^^^^^^^^^^^^^^^^
  File "/home/reonu/.config/blender/4.5/scripts/addons/fast64-main/fast64_internal/sm64/sm64_level_importer.py", line 1870, in parse_level_script
    lvl.parse_level_script(entry, col=col)
  File "/home/reonu/.config/blender/4.5/scripts/addons/fast64-main/fast64_internal/sm64/sm64_level_importer.py", line 317, in parse_level_script
    self.parse_stream_from_start(script_stream, entry, col)
  File "/home/reonu/.config/blender/4.5/scripts/addons/fast64-main/fast64_internal/utility_importer.py", line 57, in parse_stream_from_start
    self.parse_stream(dat_stream, entry_id, *args, **kwargs)
  File "/home/reonu/.config/blender/4.5/scripts/addons/fast64-main/fast64_internal/utility_importer.py", line 67, in parse_stream
    raise Exception(f"Macro {cur_macro} not found in parser function")
Exception: Macro Macro(cmd='#include "levels/castle_grounds/areas/script_vanilla_load.inc.c"    ALLOC_LEVEL_POOL', args=['']) not found in parser function
Error: Python: Traceback (most recent call last):
  File "/home/reonu/.config/blender/4.5/scripts/addons/fast64-main/fast64_internal/sm64/sm64_level_importer.py", line 2394, in execute
    lvl = parse_level_script(
          ^^^^^^^^^^^^^^^^^^^
  File "/home/reonu/.config/blender/4.5/scripts/addons/fast64-main/fast64_internal/sm64/sm64_level_importer.py", line 1870, in parse_level_script
    lvl.parse_level_script(entry, col=col)
  File "/home/reonu/.config/blender/4.5/scripts/addons/fast64-main/fast64_internal/sm64/sm64_level_importer.py", line 317, in parse_level_script
    self.parse_stream_from_start(script_stream, entry, col)
  File "/home/reonu/.config/blender/4.5/scripts/addons/fast64-main/fast64_internal/utility_importer.py", line 57, in parse_stream_from_start
    self.parse_stream(dat_stream, entry_id, *args, **kwargs)
  File "/home/reonu/.config/blender/4.5/scripts/addons/fast64-main/fast64_internal/utility_importer.py", line 67, in parse_stream
    raise Exception(f"Macro {cur_macro} not found in parser function")
Exception: Macro Macro(cmd='#include "levels/castle_grounds/areas/script_vanilla_load.inc.c"    ALLOC_LEVEL_POOL', args=['']) not found in parser function

I'm on blender 4.5.4

[Reonu]

Importing from ultrasm64 does work though