Add asset, resource system, mesh formats, color, SDL3 display and example game

Asset directory with CMake add_asset (extension dispatched), plain file asset access, resource/resource manager with async load thread and text loader, URI utilities, mesh format helpers, generated color header, and example game hooks wired through the engine. Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Add fresh CMake/platform scaffolding, core engine, and SDL3 window
2026-11-07 20:12:40 -06:00 · 2026-11-07 17:02:14 -06:00 · 2026-11-07 16:33:26 -06:00 · 2026-09-25 10:23:38 -05:00 · 2026-09-25 09:57:48 -05:00 · 2026-09-22 18:44:45 -05:00
1070 changed files with 2873 additions and 83029 deletions
@@ -1,49 +0,0 @@
-name: Setup devkitPro
-description: Install devkitPro with GameCube/Wii packages on an Ubuntu runner
-
-runs:
-  using: composite
-  steps:
-    - name: Install apt dependencies
-      shell: bash
-      run: |
-        sudo apt-get update
-        sudo apt-get install -y \
-          cmake \
-          python3 \
-          python3-pip \
-          python3-polib \
-          python3-pil \
-          python3-dotenv \
-          python3-pyqt5 \
-          python3-opengl \
-          xorriso
-    - name: Install devkitPro pacman
-      shell: bash
-      run: |
-        sudo ln -sf /proc/self/mounts /etc/mtab
-        wget https://apt.devkitpro.org/install-devkitpro-pacman \
-          -O /tmp/install-devkitpro-pacman
-        echo "=== installer script contents ==="
-        cat /tmp/install-devkitpro-pacman
-        echo "================================="
-        chmod +x /tmp/install-devkitpro-pacman
-        sudo /tmp/install-devkitpro-pacman
-        echo "DEVKITPRO=/opt/devkitpro" >> $GITHUB_ENV
-        echo "DEVKITPPC=/opt/devkitpro/devkitPPC" >> $GITHUB_ENV
-        echo "/opt/devkitpro/tools/bin" >> $GITHUB_PATH
-        echo "/opt/devkitpro/devkitPPC/bin" >> $GITHUB_PATH
-    - name: Install devkitPro GameCube/Wii packages
-      shell: bash
-      run: |
-        sudo dkp-pacman -S --needed --noconfirm \
-          gamecube-dev \
-          gamecube-sdl2 \
-          ppc-liblzma \
-          ppc-libzip \
-          libogc2 \
-          gamecube-tools \
-          ppc-libmad \
-          ppc-zlib-ng \
-          ppc-bzip2 \
-          ppc-zstd
@@ -1,20 +0,0 @@
-name: Setup pspdev
-description: Install the pspdev PSP toolchain on an Ubuntu runner
-
-runs:
-  using: composite
-  steps:
-    - name: Install dependencies
-      shell: bash
-      run: |
-        sudo apt-get update
-        sudo apt-get install -y cmake python3 python3-pip python3-dotenv
-    - name: Install pspdev toolchain
-      shell: bash
-      run: |
-        wget -q \
-          https://github.com/pspdev/pspdev/releases/latest/download/pspdev-ubuntu-latest-x86_64.tar.gz \
-          -O /tmp/pspdev.tar.gz
-        sudo tar -xzf /tmp/pspdev.tar.gz -C /usr/local
-        echo "PSPDEV=/usr/local/pspdev" >> $GITHUB_ENV
-        echo "/usr/local/pspdev/bin" >> $GITHUB_PATH
@@ -1,247 +0,0 @@
-name: Build Dusk
-on:
-  push:
-    tags:
-      - '*'
-jobs:
-  build-linux:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-      - name: Install dependencies
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y \
-            build-essential \
-            cmake \
-            python3 \
-            python3-pip \
-            python3-polib \
-            python3-pil \
-            libsdl2-dev \
-            libgl1-mesa-dev \
-            libzip-dev \
-            python3-dotenv \
-            python3-pyqt5 \
-            python3-opengl \
-            xz-utils \
-            liblzma-dev \
-            libbz2-dev \
-            zlib1g-dev \
-            git \
-            libssl-dev
-      - name: Build Linux
-        run: ./scripts/build-linux.sh
-      - name: Upload Linux binary
-        uses: actions/upload-artifact@v3
-        with:
-          name: dusk-linux
-          path: build-linux/Dusk
-          if-no-files-found: error
-
-  build-psp:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-      - name: Setup pspdev
-        uses: ./.github/actions/setup-pspdev
-      - name: Build PSP
-        run: ./scripts/build-psp.sh
-      - name: Move EBOOT.PBP to Dusk subfolder
-        run: |
-          mkdir -p ./git-artifcats/Dusk/PSP/GAME/Dusk
-          cp build-psp/EBOOT.PBP ./git-artifcats/Dusk/PSP/GAME/Dusk/EBOOT.PBP
-      - name: Upload PSP binary
-        uses: actions/upload-artifact@v3
-        with:
-          name: dusk-psp
-          path: ./git-artifcats/Dusk
-          if-no-files-found: error
-
-  build-knulli:
-    runs-on: ubuntu-latest
-    container:
-      image: debian:trixie
-    steps:
-      - name: Install Node.js
-        run: apt-get update && apt-get install -y nodejs
-      - name: Checkout repository
-        uses: actions/checkout@v4
-      - name: Install dependencies
-        run: |
-          dpkg --add-architecture arm64
-          apt-get update
-          apt-get install -y --no-install-recommends \
-            crossbuild-essential-arm64 \
-            ca-certificates \
-            pkg-config \
-            cmake \
-            make \
-            ninja-build \
-            git \
-            file \
-            python3 \
-            python3-pip \
-            python3-polib \
-            python3-pil \
-            python3-dotenv \
-            python3-pyqt5 \
-            python3-opengl \
-            liblua5.4-dev:arm64 \
-            xz-utils:arm64 \
-            libbz2-dev:arm64 \
-            zlib1g-dev:arm64 \
-            libzip-dev:arm64 \
-            libssl-dev:arm64 \
-            libsdl2-dev:arm64 \
-            liblzma-dev:arm64 \
-            libopengl0:arm64 \
-            libgl1:arm64 \
-            libegl1:arm64 \
-            libgles2:arm64 \
-            libgl1-mesa-dev:arm64
-      - name: Build Knulli
-        run: ./scripts/build-knulli.sh
-      - name: Move output to Dusk subfolder
-        run: |
-          mkdir -p ./git-artifcats/Dusk
-          cp -r build-knulli/dusk ./git-artifcats/Dusk
-      - name: Upload Knulli binary
-        uses: actions/upload-artifact@v3
-        with:
-          name: dusk-knulli
-          path: ./git-artifcats/Dusk
-          if-no-files-found: error
-
-  build-gamecube:
-    runs-on: ubuntu-latest
-    container:
-      image: ghcr.io/extremscorner/libogc2:latest
-    steps:
-      - name: Install Node.js
-        run: apt-get update && apt-get install -y nodejs
-      - name: Checkout repository
-        uses: actions/checkout@v4
-      - name: Install additional dependencies
-        run: |
-          apt-get install -y \
-            python3-pip python3-polib python3-pil \
-            python3-dotenv python3-pyqt5 python3-opengl
-          dkp-pacman -Syu --noconfirm
-          dkp-pacman -S --needed --noconfirm \
-            gamecube-sdl2 ppc-liblzma ppc-libzip \
-            gamecube-tools ppc-libmad ppc-zlib-ng ppc-bzip2 ppc-zstd
-      - name: Build GameCube
-        run: ./scripts/build-gamecube.sh
-      - name: Copy output files
-        run: |
-          mkdir -p ./git-artifcats/Dusk
-          cp build-gamecube/Dusk.dol ./git-artifcats/Dusk/Dusk.dol
-          cp build-gamecube/dusk.dsk ./git-artifcats/Dusk/dusk.dsk
-      - name: Upload GameCube binary
-        uses: actions/upload-artifact@v3
-        with:
-          name: dusk-gamecube
-          path: ./git-artifcats/Dusk
-          if-no-files-found: error
-
-  build-gamecube-iso:
-    runs-on: ubuntu-latest
-    container:
-      image: ghcr.io/extremscorner/libogc2:latest
-    steps:
-      - name: Install Node.js
-        run: apt-get update && apt-get install -y nodejs
-      - name: Checkout repository
-        uses: actions/checkout@v4
-      - name: Install additional dependencies
-        run: |
-          apt-get install -y \
-            python3-pip python3-polib python3-pil \
-            python3-dotenv python3-pyqt5 python3-opengl xorriso
-          dkp-pacman -Syu --noconfirm
-          dkp-pacman -S --needed --noconfirm \
-            gamecube-sdl2 ppc-liblzma ppc-libzip \
-            gamecube-tools ppc-libmad ppc-zlib-ng ppc-bzip2 ppc-zstd
-      - name: Build GameCube ISO
-        run: ./scripts/build-gamecube-iso.sh
-      - name: Copy output files
-        run: |
-          mkdir -p ./git-artifcats/Dusk
-          cp build-gamecube-iso/Dusk-NTSC-J.iso ./git-artifcats/Dusk/Dusk-NTSC-J.iso
-          cp build-gamecube-iso/Dusk-NTSC-U.iso ./git-artifcats/Dusk/Dusk-NTSC-U.iso
-          cp build-gamecube-iso/Dusk-PAL.iso    ./git-artifcats/Dusk/Dusk-PAL.iso
-      - name: Upload GameCube ISO
-        uses: actions/upload-artifact@v3
-        with:
-          name: dusk-gamecube-iso
-          path: ./git-artifcats/Dusk
-          if-no-files-found: error
-
-  build-wii:
-    runs-on: ubuntu-latest
-    container:
-      image: ghcr.io/extremscorner/libogc2:latest
-    steps:
-      - name: Install Node.js
-        run: apt-get update && apt-get install -y nodejs
-      - name: Checkout repository
-        uses: actions/checkout@v4
-      - name: Install additional dependencies
-        run: |
-          apt-get install -y \
-            python3-pip python3-polib python3-pil \
-            python3-dotenv python3-pyqt5 python3-opengl
-          dkp-pacman -Syu --noconfirm
-          dkp-pacman -S --needed --noconfirm \
-            gamecube-sdl2 ppc-liblzma ppc-libzip \
-            gamecube-tools ppc-libmad ppc-zlib-ng ppc-bzip2 ppc-zstd
-      - name: Build Wii
-        run: ./scripts/build-wii.sh
-      - name: Copy output files
-        run: |
-          mkdir -p ./git-artifcats/Dusk/apps/Dusk
-          cp build-wii/boot.dol ./git-artifcats/Dusk/apps/Dusk/boot.dol
-          cp build-wii/dusk.dsk ./git-artifcats/Dusk/apps/Dusk/dusk.dsk
-          cp build-wii/meta.xml ./git-artifcats/Dusk/apps/Dusk/meta.xml
-      - name: Upload Wii binary
-        uses: actions/upload-artifact@v3
-        with:
-          name: dusk-wii
-          path: ./git-artifcats/Dusk
-          if-no-files-found: error
-
-  build-wii-iso:
-    runs-on: ubuntu-latest
-    container:
-      image: ghcr.io/extremscorner/libogc2:latest
-    steps:
-      - name: Install Node.js
-        run: apt-get update && apt-get install -y nodejs
-      - name: Checkout repository
-        uses: actions/checkout@v4
-      - name: Install additional dependencies
-        run: |
-          apt-get install -y \
-            python3-pip python3-polib python3-pil \
-            python3-dotenv python3-pyqt5 python3-opengl xorriso
-          dkp-pacman -Syu --noconfirm
-          dkp-pacman -S --needed --noconfirm \
-            gamecube-sdl2 ppc-liblzma ppc-libzip \
-            gamecube-tools ppc-libmad ppc-zlib-ng ppc-bzip2 ppc-zstd
-      - name: Build Wii ISO
-        run: ./scripts/build-wii-iso.sh
-      - name: Copy output files
-        run: |
-          mkdir -p ./git-artifcats/Dusk
-          cp build-wii-iso/Dusk-NTSC-J.iso ./git-artifcats/Dusk/Dusk-NTSC-J.iso
-          cp build-wii-iso/Dusk-NTSC-U.iso ./git-artifcats/Dusk/Dusk-NTSC-U.iso
-          cp build-wii-iso/Dusk-PAL.iso    ./git-artifcats/Dusk/Dusk-PAL.iso
-      - name: Upload Wii ISO
-        uses: actions/upload-artifact@v3
-        with:
-          name: dusk-wii-iso
-          path: ./git-artifcats/Dusk
-          if-no-files-found: error
@@ -1,35 +0,0 @@
-name: Test Dusk
-on:
-  pull_request:
-    branches:
-      - main
-jobs:
-  run-tests:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-      - name: Install dependencies
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y \
-            build-essential \
-            cmake \
-            python3 \
-            python3-pip \
-            python3-polib \
-            python3-pil \
-            libsdl2-dev \
-            libgl1-mesa-dev \
-            libzip-dev \
-            python3-dotenv \
-            python3-pyqt5 \
-            python3-opengl \
-            xz-utils \
-            liblzma-dev \
-            libbz2-dev \
-            zlib1g-dev \
-            git \
-            libssl-dev
-      - name: Run tests
-        run: ./scripts/test-linux.sh
@@ -1,155 +1,98 @@
-# Copyright (c) 2025 Dominic Masters
+# Copyright (c) 2026 Dominic Masters
 #
 # This software is released under the MIT License.
 # https://opensource.org/licenses/MIT

-# Setup
 cmake_minimum_required(VERSION 3.13)

 set(CMAKE_C_STANDARD 11)
 set(CMAKE_C_STANDARD_REQUIRED ON)
-set(CMAKE_MODULE_PATH
-  ${CMAKE_MODULE_PATH}
-  ${CMAKE_CURRENT_SOURCE_DIR}/cmake/modules
-)
-cmake_policy(SET CMP0079 NEW)
-# set(FETCHCONTENT_UPDATES_DISCONNECTED ON)

-option(DUSK_BUILD_TESTS "Enable tests" OFF)
-option(DUSK_NETWORK "Enable network support" ON)
-
-set(DUSK_GAME_NAME "Dusk" CACHE STRING "Game display name")
-set(DUSK_GAME_AUTHOR "YourWishes" CACHE STRING "Game author / coder")
-set(DUSK_GAME_SHORT_DESCRIPTION "Dusk game" CACHE STRING "One-line description")
-set(DUSK_GAME_LONG_DESCRIPTION
-  "No description yet." CACHE STRING "Full description"
-)
-
-# Prep cache
-set(DUSK_CACHE_TARGET "dusk-target")
-
-# Build variables
+# Directories
 set(DUSK_ROOT_DIR "${CMAKE_SOURCE_DIR}")
-set(DUSK_BUILD_DIR "${CMAKE_BINARY_DIR}")
 set(DUSK_SOURCES_DIR "${DUSK_ROOT_DIR}/src")
-set(DUSK_TEST_DIR "${DUSK_ROOT_DIR}/test")
-set(DUSK_TEMP_DIR "${DUSK_BUILD_DIR}/temp")
-set(DUSK_TOOLS_DIR "${DUSK_ROOT_DIR}/tools")
-set(DUSK_DATA_DIR "${DUSK_ROOT_DIR}/data")
 set(DUSK_ASSETS_DIR "${DUSK_ROOT_DIR}/assets")
-set(DUSK_BUILT_ASSETS_DIR "${DUSK_BUILD_DIR}/built_assets"
-  CACHE INTERNAL ${DUSK_CACHE_TARGET}
-)
-set(DUSK_GENERATED_HEADERS_DIR "${DUSK_BUILD_DIR}/generated")
-set(DUSK_BUILD_BINARY ${DUSK_BUILD_DIR}/Dusk
-  CACHE INTERNAL ${DUSK_CACHE_TARGET}
-)
-set(DUSK_ASSETS "" CACHE INTERNAL ${DUSK_CACHE_TARGET})
-set(DUSK_LIBRARY_TARGET_NAME "DuskCore" CACHE INTERNAL ${DUSK_CACHE_TARGET})
-set(DUSK_BINARY_TARGET_NAME "Dusk" CACHE INTERNAL ${DUSK_CACHE_TARGET})
-set(DUSK_ASSETS_ZIP "${DUSK_BUILD_DIR}/dusk.dsk"
-  CACHE INTERNAL ${DUSK_CACHE_TARGET}
-)
-
-if(NOT DEFINED DUSK_TARGET_SYSTEM)
-  set(DUSK_TARGET_SYSTEM "linux")
-endif()
-
-# Create directories
+set(DUSK_BUILT_ASSETS_DIR "${CMAKE_BINARY_DIR}/assets")
+set(DUSK_GENERATED_HEADERS_DIR "${CMAKE_BINARY_DIR}/generated")
 file(MAKE_DIRECTORY ${DUSK_GENERATED_HEADERS_DIR})
-file(MAKE_DIRECTORY ${DUSK_TEMP_DIR})
-file(MAKE_DIRECTORY ${DUSK_BUILT_ASSETS_DIR})

-# Required build packages
-find_package(Python3 COMPONENTS Interpreter REQUIRED)
+project(DuskCore VERSION 1.0.0 LANGUAGES C)

-# Init Project.
-project(${DUSK_LIBRARY_TARGET_NAME}
-  VERSION 1.0.0
-  LANGUAGES C
+# Work out the target platform unless one was given explicitly.
+include(${DUSK_ROOT_DIR}/cmake/determineplatform.cmake)
+
+# Platform defaults and definitions (sets DUSK_DEFAULT_* and
+# DUSK_PLATFORM_DIRS / DUSK_PLATFORM_DEFINITIONS).
+set(DUSK_TARGET_FILE
+  "${DUSK_ROOT_DIR}/cmake/${DUSK_TARGET_SYSTEM}/target.cmake"
 )
+if(NOT EXISTS "${DUSK_TARGET_FILE}")
+  message(FATAL_ERROR "Unknown DUSK_TARGET_SYSTEM: ${DUSK_TARGET_SYSTEM}")
+endif()
+include("${DUSK_TARGET_FILE}")

-# Either, create library and binary separately (used for tests), or make them
-# one in the same so all code is in the binary only.
-# Binary Executable
-add_executable(${DUSK_BINARY_TARGET_NAME} ${DUSK_SOURCES_DIR}/dusk/null.c)
+# All options and their defaults.
+include(${DUSK_ROOT_DIR}/cmake/option.cmake)
+
+# Targets. Tests split the code into a library plus the binary, otherwise all
+# code is compiled straight into the binary.
+set(DUSK_BINARY_TARGET_NAME "Dusk")
+add_executable(${DUSK_BINARY_TARGET_NAME})

 if(DUSK_BUILD_TESTS)
-  # MainLibrary
+  set(DUSK_LIBRARY_TARGET_NAME "DuskCore")
  add_library(${DUSK_LIBRARY_TARGET_NAME} STATIC)
-
-  # Link library to binary
-  target_link_libraries(${DUSK_BINARY_TARGET_NAME}
-    PUBLIC
+  target_link_libraries(${DUSK_BINARY_TARGET_NAME} PUBLIC
    ${DUSK_LIBRARY_TARGET_NAME}
  )
 else()
-  set(DUSK_LIBRARY_TARGET_NAME "${DUSK_BINARY_TARGET_NAME}"
-    CACHE INTERNAL ${DUSK_CACHE_TARGET}
-  )
+  set(DUSK_LIBRARY_TARGET_NAME "${DUSK_BINARY_TARGET_NAME}")
 endif()

-if(NOT DEFINED DUSK_VERSION)
-  string(TIMESTAMP DUSK_VERSION "debug-%y%m%d%H%M%S")
-endif()
-
-# Definitions
-target_compile_definitions(${DUSK_LIBRARY_TARGET_NAME}
-  PUBLIC
+target_compile_definitions(${DUSK_LIBRARY_TARGET_NAME} PUBLIC
  DUSK_TARGET_SYSTEM="${DUSK_TARGET_SYSTEM}"
  DUSK_GAME_NAME="${DUSK_GAME_NAME}"
  DUSK_GAME_AUTHOR="${DUSK_GAME_AUTHOR}"
-    DUSK_GAME_SHORT_DESCRIPTION="${DUSK_GAME_SHORT_DESCRIPTION}"
-    DUSK_GAME_LONG_DESCRIPTION="${DUSK_GAME_LONG_DESCRIPTION}"
  DUSK_VERSION="${DUSK_VERSION}"
 )

-if(DUSK_NETWORK)
 target_compile_definitions(${DUSK_LIBRARY_TARGET_NAME} PUBLIC
-    DUSK_NETWORK
+  ${DUSK_PLATFORM_DEFINITIONS}
 )
+foreach(OPT ASSERTIONS_FAKED BACKTRACE TRACK_MEMORY NETWORK)
+  if(DUSK_${OPT})
+    target_compile_definitions(${DUSK_LIBRARY_TARGET_NAME} PUBLIC DUSK_${OPT})
+  endif()
+endforeach()
+
+if(DUSK_BACKTRACE)
+  target_link_options(${DUSK_LIBRARY_TARGET_NAME} PUBLIC -rdynamic)
 endif()

-# Toolchains
-include(cmake/targets/${DUSK_TARGET_SYSTEM}.cmake)
-
-# Add tools
+# Tools (run during the build to generate headers)
 add_subdirectory(tools)
-
-# Include generated headers from tools.
 target_include_directories(${DUSK_LIBRARY_TARGET_NAME} PUBLIC
  ${DUSK_GENERATED_HEADERS_DIR}
 )

-# Add main code
-add_subdirectory(${DUSK_SOURCES_DIR})
+# Core engine code
+add_subdirectory(${DUSK_SOURCES_DIR}/dusk)

-# Include generated headers
-target_include_directories(${DUSK_LIBRARY_TARGET_NAME} PUBLIC
-  ${DUSK_GENERATED_HEADERS_DIR}
-)
+# Assets, copied into <build>/assets
+include(${DUSK_ROOT_DIR}/cmake/asset/asset.cmake)
+# Separate binary dir, so <build>/assets only contains built assets.
+add_subdirectory(${DUSK_ROOT_DIR}/assets ${CMAKE_BINARY_DIR}/assets_cmake)
+dusk_assets_finalize(DuskAssets)
+add_dependencies(${DUSK_LIBRARY_TARGET_NAME} DuskAssets)
+
+# Game code
+add_subdirectory(${DUSK_SOURCES_DIR}/${DUSK_GAME})
+
+# Platform code
+foreach(DIR ${DUSK_PLATFORM_DIRS})
+  add_subdirectory(${DUSK_SOURCES_DIR}/${DIR})
+endforeach()

-# Handle tests
 if(DUSK_BUILD_TESTS)
  enable_testing()
-  add_subdirectory(test)
 endif()
-
-# Build assets. Runs unconditionally on every build (rather than being
-# gated behind a custom_command's file-level DEPENDS list) because
-# CONFIGURE_DEPENDS globs only pick up added/removed files on the next
-# CMake configure, so that approach could miss/lag a rebuild behind an
-# asset edit. tools.asset.pack itself decides whether anything actually
-# changed (see its manifest check) and no-ops quickly when nothing did,
-# so this stays cheap on a build where assets are untouched.
-add_custom_target(DUSK_ASSETS_BUILT ALL
-  COMMAND ${CMAKE_COMMAND} -E make_directory "${DUSK_ASSETS_DIR}"
-  COMMAND ${Python3_EXECUTABLE} -m tools.asset.pack
-    --input "${DUSK_ASSETS_DIR}"
-    --output "${DUSK_ASSETS_ZIP}"
-  WORKING_DIRECTORY "${DUSK_ROOT_DIR}"
-  BYPRODUCTS "${DUSK_ASSETS_ZIP}"
-  COMMENT "Packing assets into dusk.dsk"
-  VERBATIM
-)
-add_dependencies(${DUSK_LIBRARY_TARGET_NAME} DUSK_ASSETS_BUILT)
@@ -1,26 +0,0 @@
-# Dusk
-RPG Game Project, small and able to run on a PSP.
-
-# Building
-Each build target has different requirements. You can take a look at the git
-workflow to see how the builds are done for each target. In addition, for
-accessing the editor and building the game on your host system, install the
-following packages, depending on your system;
-
-Fedora;
-```
-sudo dnf install git make gcc cmake python python-polib python3-pillow python3-dotenv python3-numpy python-qt5 python3-pyopengl SDL2-devel zlib-devel libzip-devel bzip2-devel openssl-devel lzma-sdk-devel xz xz-devel lua-devel libmad-devel
-```
-`libmad-devel` (used for MP3 decoding) is GPL-licensed and ships in the
-[RPM Fusion](https://rpmfusion.org/) free repository rather than Fedora's
-base repos - make sure RPM Fusion is enabled first.
-
-Ubuntu;
-```
-sudo apt-get install git build-essential gcc python python-polib python3-pillow python3-dotenv python3-numpy python3-pyqt5 python3-opengl libmad0-dev
-```
-
-Arch Linux;
-```
-sudo pacman -S git base-devel gcc python python-polib python-pillow python-dotenv python-numpy python-pyqt5 python-opengl libmad
-```
@@ -2,3 +2,5 @@
 #
 # This software is released under the MIT License.
 # https://opensource.org/licenses/MIT
+
+add_asset(cube.obj)
@@ -0,0 +1,42 @@
+# Unit cube, centered on the origin, with per face normals and UVs.
+o Cube
+
+v -0.5 -0.5 -0.5
+v  0.5 -0.5 -0.5
+v  0.5  0.5 -0.5
+v -0.5  0.5 -0.5
+v -0.5 -0.5  0.5
+v  0.5 -0.5  0.5
+v  0.5  0.5  0.5
+v -0.5  0.5  0.5
+
+vt 0.0 0.0
+vt 1.0 0.0
+vt 1.0 1.0
+vt 0.0 1.0
+
+vn  0.0  0.0 -1.0
+vn  0.0  0.0  1.0
+vn -1.0  0.0  0.0
+vn  1.0  0.0  0.0
+vn  0.0 -1.0  0.0
+vn  0.0  1.0  0.0
+
+# Back (-Z)
+f 2/1/1 1/2/1 4/3/1
+f 2/1/1 4/3/1 3/4/1
+# Front (+Z)
+f 5/1/2 6/2/2 7/3/2
+f 5/1/2 7/3/2 8/4/2
+# Left (-X)
+f 1/1/3 5/2/3 8/3/3
+f 1/1/3 8/3/3 4/4/3
+# Right (+X)
+f 6/1/4 2/2/4 3/3/4
+f 6/1/4 3/3/4 7/4/4
+# Bottom (-Y)
+f 1/1/5 2/2/5 6/3/5
+f 1/1/5 6/3/5 5/4/5
+# Top (+Y)
+f 8/1/6 7/2/6 3/3/6
+f 8/1/6 3/3/6 4/4/6
@@ -1,68 +0,0 @@
-{
-  "items": [
-    // First thing, try and find a save device, used for settings and what not.
-    {
-      "type": "MODAL",
-      "title": "initial.checking_save.title",
-      "message": "initial.checking_save.message"
-    },
-    {
-      "type": "WAIT",
-      "seconds": 0.2
-    },
-    {
-      "type": "SAVE_DEVICE_CHECK",
-      "successMarker": "CONTINUE",
-      "failureMarker": "SAVE_DEVICE_NOT_FOUND"
-    },
-
-    // No save device found
-    {
-      "type": "MARKER",
-      "name": "SAVE_DEVICE_NOT_FOUND"
-    },
-    {
-      "type": "MODAL_CLOSE"
-    },
-    {
-      "type": "MODAL_OPTIONS_MARKERS",
-      "title": "initial.no_device.title",
-      "message": "initial.no_device.message",
-      "options": [
-        {
-          "text": "initial.no_device.retry",
-          "marker": "SAVE_DEVICE_RETRY"
-        },
-        {
-          "text": "initial.no_device.continue",
-          "marker": "CONTINUE"
-        }
-      ]
-    },
-
-    // Save device not found, user to retry, just close modal and loop
-    {
-      "type": "MARKER",
-      "name": "SAVE_DEVICE_RETRY"
-    },
-    {
-      "type": "MODAL_CLOSE"
-    },
-    {
-      "type": "RESTART"
-    },
-
-    // Save device found (or continuing without one)
-    {
-      "type": "MARKER",
-      "name": "CONTINUE"
-    },
-    {
-      "type": "MODAL_CLOSE"
-    },
-    {
-      "type": "CUTSCENE",
-      "name": "main_menu"
-    }
-  ]
-}
@@ -1,140 +0,0 @@
-{
-  "items": [
-    {
-      "type": "MARKER",
-      "name": "MAIN_MENU_IDLE"
-    },
-    {
-      "type": "UI_SHOW",
-      "name": "main_menu"
-    },
-
-    // Options button goes here - no options screen yet, so this is just
-    // an alias landing right back on the idle loop below.
-    {
-      "type": "MARKER",
-      "name": "OPTIONS"
-    },
-    {
-      "type": "IDLE"
-    },
-
-    // New Game button goes here.
-    {
-      "type": "MARKER",
-      "name": "NEW_GAME"
-    },
-    {
-      "type": "MODAL",
-      "title": "main_menu.checking_save.title",
-      "message": "main_menu.checking_save.message"
-    },
-    {
-      "type": "WAIT",
-      "seconds": 0.2
-    },
-    {
-      "type": "SAVE_DEVICE_CHECK",
-      "successMarker": "SAVE_DEVICE_FOUND",
-      "failureMarker": "SAVE_DEVICE_NOT_FOUND"
-    },
-
-    // Save device not found
-    {
-      "type": "MARKER",
-      "name": "SAVE_DEVICE_NOT_FOUND"
-    },
-    {
-      "type": "MODAL_CLOSE"
-    },
-    {
-      "type": "MODAL_OPTIONS_MARKERS",
-      "title": "main_menu.no_device.title",
-      "message": "main_menu.no_device.message",
-      "options": [
-        {
-          "text": "main_menu.no_device.retry",
-          "marker": "NEW_GAME"
-        },
-        {
-          "text": "main_menu.no_device.continue",
-          "marker": "SAVE_DEVICE_FOUND"
-        }
-      ]
-    },
-
-    // Save data failed to load (e.g. corrupt/unreadable) - only option is
-    // to retry, no "continue without saving" here since we already know a
-    // device is present.
-    {
-      "type": "MARKER",
-      "name": "LOAD_ERROR"
-    },
-    {
-      "type": "MODAL_OPTIONS_MARKERS",
-      "title": "main_menu.save_load_error.title",
-      "message": "main_menu.save_load_error.message",
-      "options": [
-        {
-          "text": "main_menu.save_load_error.retry",
-          "marker": "NEW_GAME"
-        }
-      ]
-    },
-
-    // Quit Game button goes here. Cancelling jumps back to
-    // MAIN_MENU_IDLE; confirming falls through to QUIT_GAME, which
-    // ends the process directly.
-    {
-      "type": "MARKER",
-      "name": "QUIT"
-    },
-    {
-      "type": "MODAL_OPTIONS_MARKERS",
-      "title": "main_menu.quit_confirm",
-      "options": [
-        {
-          "text": "ui.confirm.confirm",
-          "marker": "QUIT_CONFIRMED"
-        },
-        {
-          "text": "ui.confirm.cancel",
-          "marker": "MAIN_MENU_IDLE"
-        }
-      ]
-    },
-    
-    {
-      "type": "MARKER",
-      "name": "QUIT_CONFIRMED"
-    },
-    {
-      "type": "QUIT_GAME"
-    },
-
-    // main menu just listens for cutscene ending to show the select save modal
-    // so we have that here.
-    {
-      "type": "MARKER",
-      "name": "SAVE_DEVICE_FOUND"
-    },
-    {
-      "type": "MODAL_CLOSE"
-    },
-    {
-      "type": "SAVE_LOAD_ALL_SLOTS",
-      "successMarker": "LOADED",
-      "failureMarker": "LOAD_ERROR"
-    },
-
-    // Must be the very last item - falling off the end here is what
-    // completes the cutscene and fires uiMainMenuOpenSelectSave (see
-    // cutsceneSystemSetOnComplete in ui/screen/mainmenu/uimainmenu.c).
-    // Placing this anywhere earlier would fall through into whatever
-    // comes next instead (e.g. the QUIT block, if placed just before it).
-    {
-      "type": "MARKER",
-      "name": "LOADED"
-    }
-  ]
-}
@@ -1,270 +0,0 @@
-msgid ""
-msgstr ""
-"Project-Id-Version: ExampleApp 1.0\n"
-"Language: en\n"
-"Content-Type: text/plain; charset=UTF-8\n"
-"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : n==2 ? 1 : (n<7 ? 2 : 3));\n"
-
-# Initial Scene
-msgid "initial.checking_save.title"
-msgstr "Checking for save data"
-
-msgid "initial.checking_save.message"
-msgstr "Please wait..."
-
-msgid "initial.no_device.title"
-msgstr "No Save Device Found"
-
-msgid "initial.no_device.message"
-msgstr "Could not find a save device, ensure it is connected and try again. You can continue, but progress will not be saved."
-
-msgid "initial.no_device.retry"
-msgstr "Try again"
-
-msgid "initial.no_device.continue"
-msgstr "Continue without saving"
-
-
-# Main Menu Scene
-msgid "main_menu.start_game"
-msgstr "Start Game"
-
-msgid "main_menu.options"
-msgstr "Options"
-
-msgid "main_menu.quit"
-msgstr "Quit Game"
-
-msgid "main_menu.quit_confirm"
-msgstr "Are you sure you want to quit?"
-
-msgid "main_menu.checking_save.title"
-msgstr "Checking for save data"
-
-msgid "main_menu.checking_save.message"
-msgstr "Please wait..."
-
-msgid "main_menu.no_device.title"
-msgstr "No Save Device Found"
-
-msgid "main_menu.no_device.message"
-msgstr "Could not find a save device, ensure it is connected and try again. You can continue, but progress will not be saved."
-
-msgid "main_menu.no_device.retry"
-msgstr "Try again"
-
-msgid "main_menu.no_device.continue"
-msgstr "Continue without saving"
-
-msgid "main_menu.save_load_error.title"
-msgstr "Error"
-
-msgid "main_menu.save_load_error.message"
-msgstr "Failed to load save data. Please try again."
-
-msgid "main_menu.save_load_error.retry"
-msgstr "Try Again"
-
-
-# Select Save Screen
-msgid "ui.select_save.title"
-msgstr "Select Save"
-
-msgid "ui.select_save.empty"
-msgstr "Empty Slot"
-
-msgid "ui.select_save.slot_format"
-msgstr "%s  Lv.%d  %s"
-
-msgid "ui.select_save.delete_mode"
-msgstr "Delete a Save"
-
-msgid "ui.select_save.delete_confirm"
-msgstr "Are you sure you want to delete this save?"
-
-msgid "ui.select_save.name_title"
-msgstr "Enter game save file name"
-
-msgid "ui.save_slot.number_format"
-msgstr "Slot %d"
-
-
-
-
-
-
-
-
-
-
-
-#: ui/menu.c:10
-msgid "ui.title"
-msgstr ""
-"Welcome"
-
-msgid "save.linux.mkdirp_failed"
-msgstr "Failed to create save directory, check the disk is not full or write-protected."
-
-#: src/dusk/ui/frame/settings/uisettings.c
-msgid "ui.settings.tabs.general"
-msgstr "General"
-
-#: src/dusk/ui/frame/settings/uisettings.c
-msgid "ui.settings.tabs.input"
-msgstr "Input"
-
-#: src/dusk/ui/frame/settings/uisettings.c
-msgid "ui.settings.tabs.display"
-msgstr "Display"
-
-#: src/dusk/ui/frame/settings/uisettings.c
-msgid "ui.settings.tabs.audio"
-msgstr "Audio"
-
-msgid "ui.settings.input.deadzone"
-msgstr "Deadzone"
-
-#: src/dusk/ui/frame/settings/uisettingsgeneral.c
-msgid "ui.settings.general.language"
-msgstr "Language"
-
-msgid "ui.settings.general.language_detail"
-msgstr "Takes effect after restarting the application."
-
-#: src/dusk/ui/frame/settings/uisettings.c
-msgid "ui.settings.apply"
-msgstr "Apply"
-
-#: src/dusk/ui/frame/uiconfirm.c
-msgid "ui.confirm.discard_changes"
-msgstr "Discard unsaved changes?"
-
-#: src/dusk/ui/frame/game/uigamemenu.c
-msgid "ui.game_menu.characters"
-msgstr "Characters"
-
-#: src/dusk/ui/frame/game/uigamemenu.c
-msgid "ui.game_menu.items"
-msgstr "Items"
-
-#: src/dusk/ui/frame/game/uigamemenu.c
-msgid "ui.game_menu.settings"
-msgstr "Settings"
-
-#: src/dusk/ui/frame/game/uigamemenu.c
-msgid "ui.game_menu.save"
-msgstr "Save"
-
-#: src/dusk/ui/frame/game/uigamemenu.c
-msgid "ui.game_menu.save_success"
-msgstr "Game saved."
-
-#: src/dusk/ui/frame/game/uigamemenu.c
-msgid "ui.game_menu.save_cancelled"
-msgstr "Save cancelled."
-
-#: src/dusk/ui/frame/game/uigamemenu.c
-msgid "ui.game_menu.save_unavailable"
-msgstr "Can't save - no save device found."
-
-#: src/dusk/ui/frame/game/uigamemenu.c
-msgid "ui.game_menu.save_temporary"
-msgstr "This session is temporary - no save device was found, so saving is disabled."
-
-#: src/dusk/ui/frame/game/uigamemenu.c
-msgid "ui.game_menu.save_create_confirm"
-msgstr "No save data found. Create a new save?"
-
-#: src/dusk/ui/frame/game/uigamemenu.c
-msgid "ui.game_menu.save_failed_format"
-msgstr "Save failed: %s"
-
-#: src/dusk/ui/frame/game/uigamemenu.c
-msgid "ui.game_menu.save_check_failed_format"
-msgstr "Can't save: %s"
-
-#: src/dusk/ui/frame/initial/uiinitialnocard.c
-msgid "ui.initial.no_card.message"
-msgstr "No save device found. You can continue, but\nprogress will not be saved."
-
-#: src/dusk/ui/frame/initial/uiinitialnocard.c
-msgid "ui.initial.no_card.retry"
-msgstr "Retry"
-
-#: src/dusk/ui/frame/initial/uiinitialnocard.c
-msgid "ui.initial.no_card.continue"
-msgstr "Continue Anyway"
-
-#: src/dusk/ui/frame/initial/uiinitialcreatesave.c
-msgid "ui.initial.create_save.message"
-msgstr "No save data found. Create a new save?"
-
-#: src/dusk/ui/frame/initial/uiinitialcreatesave.c
-msgid "ui.initial.create_save.yes"
-msgstr "Yes"
-
-#: src/dusk/ui/frame/initial/uiinitialcreatesave.c
-msgid "ui.initial.create_save.no"
-msgstr "No"
-
-#: src/dusk/ui/frame/uiconfirm.c
-msgid "ui.confirm.confirm"
-msgstr "Confirm"
-
-#: src/dusk/ui/frame/uiconfirm.c
-msgid "ui.confirm.cancel"
-msgstr "Cancel"
-
-#: src/dusk/ui/frame/battle/uibattlemenu.c
-msgid "ui.battle.menu.attack"
-msgstr "Attack"
-
-#: src/dusk/ui/frame/battle/uibattlemenu.c
-msgid "ui.battle.menu.flee"
-msgstr "Flee"
-
-#: src/dusk/ui/frame/battle/uibattlemenu.c
-msgid "ui.battle.menu.target_format"
-msgstr "Enemy %u (%u/%u HP)"
-
-#: src/dusk/ui/frame/battle/uibattlehud.c
-msgid "ui.battle.hud.hp_format"
-msgstr "HP %u/%u"
-
-#: src/dusk/ui/frame/battle/uibattlehud.c
-msgid "ui.battle.hud.mp_format"
-msgstr "MP %u/%u"
-
-#: src/dusk/ui/frame/settings/uisettingsaudio.c
-msgid "ui.settings.audio.placeholder"
-msgstr "No audio settings yet"
-
-#: src/dusk/ui/frame/settings/uisettingsdisplay.c
-msgid "ui.settings.display.placeholder"
-msgstr "No display settings yet"
-
-#: src/dusk/ui/frame/settings/uisettingsinput.c
-msgid "ui.settings.input.placeholder"
-msgstr "No input settings yet"
-
-#: src/dusk/ui/frame/backpack/uibackpack.c
-msgid "ui.backpack.category_format"
-msgstr "Category %u"
-
-#: src/dusk/ui/overlay/uiloading.c
-msgid "ui.loading.text"
-msgstr "loading"
-
-#: src/dusk/ui/overlay/uiautosave.c
-msgid "ui.autosave.saving"
-msgstr "SAVING"
-
-msgid "item.potion.name"
-msgstr "Potion"
-
-msgid "item.potato.name"
-msgstr "Potato"
-
-msgid "item.apple.name"
-msgstr "Apple"
@@ -1,4 +0,0 @@
-{
-  "mesh": "meshes/buildings/house_1_1.dmf",
-  "color": [255, 0, 255, 255]
-}
@@ -1,4 +0,0 @@
-{
-  "mesh": "meshes/buildings/house_1_2.dmf",
-  "color": [255, 0, 255, 255]
-}
@@ -1,4 +0,0 @@
-{
-  "mesh": "meshes/buildings/house_1_3.dmf",
-  "color": [255, 0, 255, 255]
-}
@@ -1,4 +0,0 @@
-{
-  "mesh": "meshes/buildings/house_1_4.dmf",
-  "color": [255, 0, 255, 255]
-}
@@ -1,4 +0,0 @@
-{
-  "mesh": "meshes/buildings/house_1_5.dmf",
-  "color": [255, 0, 255, 255]
-}
@@ -1,4 +0,0 @@
-{
-  "mesh": "meshes/buildings/house_1_6.dmf",
-  "color": [255, 0, 255, 255]
-}
@@ -1,4 +0,0 @@
-{
-  "mesh": "meshes/buildings/house_1_7.dmf",
-  "color": [255, 0, 255, 255]
-}
@@ -1,4 +0,0 @@
-{
-  "mesh": "meshes/buildings/house_1_8.dmf",
-  "color": [255, 0, 255, 255]
-}
@@ -1,4 +0,0 @@
-{
-  "mesh": "meshes/buildings/house_2_1.dmf",
-  "color": [255, 0, 255, 255]
-}
@@ -1,4 +0,0 @@
-{
-  "mesh": "meshes/buildings/house_2_2.dmf",
-  "color": [255, 0, 255, 255]
-}
@@ -1,4 +0,0 @@
-{
-  "mesh": "meshes/buildings/house_2_3.dmf",
-  "color": [255, 0, 255, 255]
-}