N64 exporter

.gitmodules

@@ -1,3 +1,12 @@
 [submodule "Kha"]
 	path = Kha
 	url = https://github.com/armory3d/Kha
+
+[submodule "lib/libdragon"]
+	path = lib/libdragon
+	url = https://github.com/DragonMinded/libdragon.git
+	branch = preview
+
+[submodule "lib/tiny3d"]
+	path = lib/tiny3d
+	url = https://github.com/HailToDodongo/tiny3d.git

.vscode/settings.json

@@ -5,4 +5,4 @@
 	"[python]": {
 		"editor.insertSpaces": true
 	}
-}
+}

armorcore/Deployment/n64/Makefile.j2

@@ -0,0 +1,75 @@
+BUILD_DIR=build
+
+T3D_INST={tiny3d_path}
+
+include $(N64_INST)/include/n64.mk
+include $(T3D_INST)/t3d.mk
+
+GAME_TITLE := {game_title}
+ROM_NAME := {game_title}
+
+N64_CFLAGS += -std=gnu2x
+
+src = \
+    src/main.c \
+    src/engine.c \
+    src/renderer.c \
+    src/system/signal.c \
+	src/data/models.c \
+    src/data/scenes.c \
+	src/data/traits.c \
+	src/events/trait_events.c \
+	src/iron/object/transform.c \
+	src/iron/object/object.c \
+	src/iron/system/input.c \
+{scene_files}
+
+# Physics sources (conditionally included)
+{physics_sources}
+
+# UI sources (conditionally included)
+{koui_sources}
+
+assets_png = $(wildcard assets/*.png)
+assets_gltf = $(wildcard assets/*.gltf)
+assets_ttf = $(wildcard assets/*.ttf)
+assets_conv = $(addprefix filesystem/,$(notdir $(assets_png:%.png=%.sprite))) \
+			  $(addprefix filesystem/,$(notdir $(assets_ttf:%.ttf=%.font64))) \
+			  $(addprefix filesystem/,$(notdir $(assets_gltf:%.gltf=%.t3dm)))
+
+all: $(ROM_NAME).z64
+
+filesystem/%.sprite: assets/%.png
+	@mkdir -p $(dir $@)
+	@echo "    [SPRITE] $@"
+	$(N64_MKSPRITE) $(MKSPRITE_FLAGS) -o filesystem "$<"
+
+filesystem/%.font64: assets/%.ttf
+	@mkdir -p $(dir $@)
+	@echo "    [FONT] $@"
+	$(N64_MKFONT) $(MKFONT_FLAGS) -o filesystem "$<"
+
+filesystem/%.t3dm: assets/%.gltf
+	@mkdir -p $(dir $@)
+	@echo "    [T3D-MODEL] $@"
+	$(T3D_GLTF_TO_3D) "$<" $@
+	$(N64_BINDIR)/mkasset -c 2 -o filesystem $@
+
+$(BUILD_DIR)/$(ROM_NAME).dfs: $(assets_conv)
+$(BUILD_DIR)/$(ROM_NAME).elf: $(src:%.c=$(BUILD_DIR)/%.o)
+
+$(ROM_NAME).z64: N64_ROM_TITLE=$(GAME_TITLE)
+$(ROM_NAME).z64: $(BUILD_DIR)/$(ROM_NAME).dfs
+
+clean:
+	rm -rf $(BUILD_DIR) *.z64
+	rm -rf filesystem
+
+build_lib:
+	rm -rf $(BUILD_DIR) *.z64
+	make -C $(T3D_INST)
+	make all
+
+-include $(wildcard $(BUILD_DIR)/*.d)
+
+.PHONY: all clean

armorcore/Deployment/n64/src/data/fonts.c.j2

@@ -0,0 +1,61 @@
+#include <libdragon.h>
+#include "fonts.h"
+
+// Font paths (converted from .ttf to .font64 by Makefile)
+static const char *FONT_PATHS[FONT_COUNT] = {{
+{font_paths}
+}};
+
+// rdpq font IDs start at 2 (1 is reserved for libdragon debug font)
+#define FONT_ID_BASE 2
+
+typedef struct {{
+    rdpq_font_t *font;
+    uint8_t loaded;
+}} FontEntry;
+
+static FontEntry g_fonts[FONT_COUNT];
+
+void fonts_init(void)
+{{
+    for (uint8_t i = 0; i < FONT_COUNT; i++) {{
+        g_fonts[i].font = NULL;
+        g_fonts[i].loaded = 0;
+    }}
+}}
+
+void fonts_shutdown(void)
+{{
+    for (uint8_t i = 0; i < FONT_COUNT; i++) {{
+        if (g_fonts[i].loaded) {{
+            if (g_fonts[i].font) {{
+                rdpq_font_free(g_fonts[i].font);
+                g_fonts[i].font = NULL;
+            }}
+            g_fonts[i].loaded = 0;
+        }}
+    }}
+}}
+
+rdpq_font_t *fonts_get(FontId id)
+{{
+    if (id >= FONT_COUNT) {{
+        return NULL;
+    }}
+
+    FontEntry *e = &g_fonts[id];
+    if (!e->loaded) {{
+        const char *path = FONT_PATHS[id];
+        e->font = rdpq_font_load(path);
+        if (e->font) {{
+            rdpq_text_register_font(FONT_ID_BASE + id, e->font);
+            e->loaded = 1;
+        }}
+    }}
+    return e->font;
+}}
+
+uint8_t fonts_get_rdpq_id(FontId id)
+{{
+    return FONT_ID_BASE + id;
+}}

armorcore/Deployment/n64/src/data/fonts.h.j2

@@ -0,0 +1,22 @@
+#pragma once
+
+#include <libdragon.h>
+
+#ifdef __cplusplus
+extern "C" {{
+#endif
+
+typedef enum {{
+{font_enum_entries}
+    FONT_COUNT = {font_count}
+}} FontId;
+
+void fonts_init(void);
+void fonts_shutdown(void);
+
+rdpq_font_t *fonts_get(FontId id);
+uint8_t fonts_get_rdpq_id(FontId id);
+
+#ifdef __cplusplus
+}}
+#endif

armorcore/Deployment/n64/src/data/models.c.j2

@@ -0,0 +1,129 @@
+#include <libdragon.h>
+#include <t3d/t3d.h>
+#include <t3d/t3dmodel.h>
+
+#include "models.h"
+
+static const char *MODEL_PATHS[MODEL_COUNT] = {{
+{mesh_paths}
+}};
+
+typedef struct {{
+    T3DModel *model;
+    rspq_block_t *dpl;
+    uint16_t ref_count;  // Reference count for shared models
+    uint8_t loaded;
+}} ModelEntry;
+
+static ModelEntry g_models[MODEL_COUNT];
+
+void models_init(void)
+{{
+    for (uint8_t i = 0; i < MODEL_COUNT; i++) {{
+        g_models[i].model = NULL;
+		g_models[i].dpl = NULL;
+        g_models[i].ref_count = 0;
+        g_models[i].loaded = 0;
+    }}
+}}
+
+void models_shutdown(void)
+{{
+    for (uint8_t i = 0; i < MODEL_COUNT; i++) {{
+        if (g_models[i].loaded) {{
+            if (g_models[i].model) {{
+                t3d_model_free(g_models[i].model);
+                g_models[i].model = NULL;
+            }}
+            if (g_models[i].dpl) {{
+                rspq_block_free(g_models[i].dpl);
+                g_models[i].dpl = NULL;
+            }}
+            g_models[i].ref_count = 0;
+            g_models[i].loaded = 0;
+        }}
+    }}
+}}
+
+T3DModel *models_get(ModelId id)
+{{
+    if (id < 0 || id >= MODEL_COUNT) {{
+        return NULL;
+    }}
+
+    ModelEntry *e = &g_models[id];
+    if (!e->loaded) {{
+        const char *path = MODEL_PATHS[id];
+        e->model = t3d_model_load(path);
+        if (!e->model) {{
+            debugf("Failed to load model: %s\n", path);
+            return NULL;
+        }}
+		rspq_block_begin();
+		t3d_model_draw(e->model);
+		e->dpl = rspq_block_end();
+		e->loaded = 1;
+    }}
+    e->ref_count++;  // Increment reference count
+    return e->model;
+}}
+
+rspq_block_t *models_get_dpl(ModelId id)
+{{
+    return g_models[id].dpl;
+}}
+
+// Release a reference to a model
+void models_release(ModelId id)
+{{
+    if (id < 0 || id >= MODEL_COUNT) {{
+        return;
+    }}
+    ModelEntry *e = &g_models[id];
+    if (e->ref_count > 0) {{
+        e->ref_count--;
+    }}
+}}
+
+// Unload a model and free its resources.
+// Note: Models are cached by default for performance. Call this explicitly
+// when transitioning between scenes that use different model sets, or when
+// memory pressure requires freeing unused models.
+void models_unload(ModelId id)
+{{
+    if (id < 0 || id >= MODEL_COUNT) {{
+        return;
+    }}
+
+    ModelEntry *e = &g_models[id];
+    if (e->loaded) {{
+        if (e->model) {{
+            t3d_model_free(e->model);
+            e->model = NULL;
+        }}
+        if (e->dpl) {{
+            rspq_block_free(e->dpl);
+            e->dpl = NULL;
+        }}
+        e->ref_count = 0;
+        e->loaded = 0;
+    }}
+}}
+
+// Unload only models with zero references (safe after scene transition)
+void models_unload_unused(void)
+{{
+    for (uint8_t i = 0; i < MODEL_COUNT; i++) {{
+        if (g_models[i].loaded && g_models[i].ref_count == 0) {{
+            models_unload(i);
+        }}
+    }}
+}}
+
+// Unload all models to free memory (useful before scene transitions)
+void models_unload_all(void)
+{{
+    for (uint8_t i = 0; i < MODEL_COUNT; i++) {{
+        models_unload(i);
+    }}
+}}

armorcore/Deployment/n64/src/data/models.h.j2

@@ -0,0 +1,28 @@
+#pragma once
+
+#include <t3d/t3dmodel.h>
+#include <rspq.h>
+
+#ifdef __cplusplus
+extern "C" {{
+#endif
+
+typedef enum {{
+{model_enum_entries}
+    MODEL_COUNT = {model_count}
+}} ModelId;
+
+void models_init(void);
+void models_shutdown(void);
+
+T3DModel *models_get(ModelId id);
+rspq_block_t *models_get_dpl(ModelId id);
+
+void models_release(ModelId id);          // Release a reference to a model
+void models_unload(ModelId id);           // Force unload a model
+void models_unload_unused(void);          // Unload models with zero references
+void models_unload_all(void);             // Unload all models to free memory
+
+#ifdef __cplusplus
+}}
+#endif