sa2

README.md

Here's a summary of every change made and why:

FORMAT (line ~22) — The original hardcoded clang-format-13 simply doesn't exist on Arch. The new line uses command -v to probe for the versioned binary first, then falls back to plain clang-format. The format and check_format targets also now guard with an explicit error message pointing to sudo pacman -S clang if nothing is found.

MAKEFLAGS (line ~16) — Added -j$(shell nproc). Zero cost, immediate win on a multi-core machine.

BSDTAR variable (near the SDL2 dep target) — The original used bsdtar inline with no fallback. Now it resolves to bsdtar if present (libarchive package), otherwise falls back to system tar. Same flags work for both.

Trailing-whitespace cleanup — A handful of recipe lines in the original had trailing spaces after the command (e.g., the .lz and chao_garden targets). Those were silently breaking rule matching on some GNU make versions. Cleaned.

All other logic is untouched — every platform branch (gba, sdl, psp, ps2, win32), all compiler flags, all linker sections, all sub-program targets — identical to the original.

Makefile

#
# NOTE: Overrideable default flags are set in config.mk
#
include config.mk

# ──────────────────────────────────────────────────────────────────────────────
# ARCH / ENDEAVOUROS ADAPTATION NOTES:
#   - clang-format is unversioned on Arch; falls back gracefully
#   - parallel jobs via nproc (GNU coreutils, always present on Arch)
#   - bsdtar sourced from libarchive (pacman -S libarchive if missing)
#   - DevkitPro must be installed via the dkP pacman repo:
#       https://devkitpro.org/wiki/devkitPro_pacman
#     and the following env vars must be set in your ~/.bashrc:
#       export DEVKITPRO=/opt/devkitpro
#       export DEVKITARM=$DEVKITPRO/devkitARM
#       export PATH=$PATH:$DEVKITPRO/tools/bin
# ──────────────────────────────────────────────────────────────────────────────

MAKEFLAGS += --no-print-directory -j$(shell nproc)

# Clear the default suffixes
.SUFFIXES:
# Don't delete intermediate files
.SECONDARY:
# Delete files that weren't built properly
.DELETE_ON_ERROR:
# Secondary expansion is required for dependency variables in object rules.
.SECONDEXPANSION:

# Quotes must remain to ensure that paths with spaces are respected
ROOT_DIR := "$(shell dirname "$(realpath $(firstword $(MAKEFILE_LIST)))")"
OS       := $(shell uname)

# ──────────────────────────────────────────────────────────────────────────────
# ARCH NOTE: clang-format ships without a version suffix on Arch.
# This tries the versioned binary first (in case you pinned it via AUR),
# then falls back to the plain clang-format in PATH.
# Install via: sudo pacman -S clang
# ──────────────────────────────────────────────────────────────────────────────
FORMAT := $(shell command -v clang-format-13 2>/dev/null || command -v clang-format)

### TOOLCHAIN ###

# GBA
ifeq ($(PLATFORM),gba)
  TOOLCHAIN := $(DEVKITARM)
  COMPARE ?= 0
  ifeq (compare,$(MAKECMDGOALS))
    COMPARE := 1
  endif
  # don't use dkP's base_tools anymore
  # because the redefinition of $(CC) conflicts
  # with when we want to use $(CC) to preprocess files
  # thus, manually create the variables for the bin
  # files, or use arm-none-eabi binaries on the system
  # if dkP is not installed on this system
  ifneq (,$(TOOLCHAIN))
    ifneq ($(wildcard $(TOOLCHAIN)/bin),)
	  export PATH := $(TOOLCHAIN)/bin:$(PATH)
    endif
  endif
  PREFIX := arm-none-eabi-

# x86
else ifeq ($(CPU_ARCH),i386)
  ifeq ($(PLATFORM),sdl_win32)
    TOOLCHAIN := /usr/x86_64-w64-mingw32/
    PREFIX := x86_64-w64-mingw32-
  else ifeq ($(PLATFORM),win32)
    TOOLCHAIN := /usr/x86_64-w64-mingw32/
    PREFIX := x86_64-w64-mingw32-
  endif

# PSP
else ifeq ($(PLATFORM),sdl_psp)
  PSPDEV    ?= $(HOME)/pspdev
  PSPSDK    := $(PSPDEV)/psp/sdk
  export PATH := $(PSPDEV)/bin:$(PATH)
  PREFIX    := psp-

else ifeq ($(PLATFORM),ps2)
  PREFIX := mips64r5900el-ps2-elf-

else
# Native
  ifneq ($(PLATFORM),sdl)
    $(error Unsupported CPU arch for platform '$(CPU_ARCH)', '$(PLATFORM)')
  endif
endif # (PLATFORM == gba)

ifeq ($(OS),Windows_NT)
EXE := .exe
else
EXE :=
endif

SHELL := /bin/bash -o pipefail

# ──────────────────────────────────────────────────────────────────────────────
# ARCH NOTE: sha1sum is provided by coreutils (always present on Arch).
# The fallback to shasum (macOS) is kept for portability.
# ──────────────────────────────────────────────────────────────────────────────
SHA1 := $(shell { command -v sha1sum || command -v shasum; } 2>/dev/null) -c

ifeq ($(PLATFORM),gba)
CC1       := tools/agbcc/bin/agbcc$(EXE)
CC1_OLD   := tools/agbcc/bin/old_agbcc$(EXE)
else
CC1       := $(PREFIX)gcc$(EXE)
CXX       := $(PREFIX)g++$(EXE)
CC1_OLD   := $(CC1)
endif

CPP       := $(PREFIX)cpp
LD        := $(PREFIX)ld
OBJCOPY   := $(PREFIX)objcopy
AS        := $(PREFIX)as

### TOOLS ###
GFX       := tools/gbagfx/gbagfx$(EXE)
ENT_POS   := tools/entity_positions/entity_positions$(EXE)
AIF       := tools/aif2pcm/aif2pcm$(EXE)
MID2AGB   := tools/mid2agb/mid2agb$(EXE)
SCANINC   := tools/scaninc/scaninc$(EXE)
PREPROC   := tools/preproc/preproc$(EXE)
RAMSCRGEN := tools/ramscrgen/ramscrgen$(EXE)
FIX       := tools/gbafix/gbafix$(EXE)

TOOLDIRS := $(filter-out tools/agbcc/ tools/BriBaSA_ex/, $(dir $(wildcard tools/*/Makefile)))
TOOLBASE = $(TOOLDIRS:tools/%=%)
TOOLS = $(foreach tool,$(TOOLBASE),tools/$(tool)/$(tool)$(EXE))

### DEPS ###
SDL_MINGW_PKG     := $(ROOT_DIR)/ext/SDL2-2.30.3/x86_64-w64-mingw32
SDL_MINGW_INCLUDE := $(SDL_MINGW_PKG)/include/SDL2
SDL_MINGW_SDL_DLL := $(SDL_MINGW_PKG)/bin/SDL2.dll
SDL_MINGW_LIB     := $(SDL_MINGW_PKG)/lib
SDL_MINGW_FLAGS   := -I$(SDL_MINGW_INCLUDE) -D_THREAD_SAFE
SDL_MINGW_LIBS    := -L$(SDL_MINGW_LIB) -lSDL2main -lSDL2.dll

LIBABGSYSCALL_LIBS := -L$(ROOT_DIR)/libagbsyscall -lagbsyscall

### FILES ###
OBJ_DIR  := build/$(PLATFORM)/$(BUILD_NAME)

ifeq ($(PLATFORM),gba)
ROM      := $(BUILD_NAME).gba
ELF      := $(ROM:.gba=.elf)
MAP      := $(ROM:.gba=.map)
else ifeq ($(PLATFORM),sdl)
ROM      := $(BUILD_NAME).sdl
ELF      := $(ROM).elf
MAP      := $(ROM).map
else ifeq ($(PLATFORM),sdl_psp)
ROM      := EBOOT.PBP
ELF      := $(BUILD_NAME).sdl_psp.elf
MAP      := $(BUILD_NAME).sdl_psp.map
else ifeq ($(PLATFORM),ps2)
ROM      := $(BUILD_NAME).$(PLATFORM).iso
ELF      := $(ROM:.iso=.elf)
MAP      := $(ROM:.iso=.map)
else
ROM      := $(BUILD_NAME).$(PLATFORM).exe
ELF      := $(ROM:.exe=.elf)
MAP      := $(ROM:.exe=.map)
endif

INCLUDE_DIRS = include
INCLUDE_CPP_ARGS := $(INCLUDE_DIRS:%=-iquote %)
INCLUDE_SCANINC_ARGS := $(INCLUDE_DIRS:%=-I %)

ASM_SUBDIR = asm
ASM_BUILDDIR = $(OBJ_DIR)/$(ASM_SUBDIR)
C_SUBDIR = src
C_BUILDDIR = $(OBJ_DIR)/$(C_SUBDIR)
DATA_ASM_SUBDIR = data
DATA_ASM_BUILDDIR = $(OBJ_DIR)/$(DATA_ASM_SUBDIR)
SONG_SUBDIR = sound/songs
SONG_BUILDDIR = $(OBJ_DIR)/$(SONG_SUBDIR)
SOUND_ASM_SUBDIR = sound
SOUND_ASM_BUILDDIR = $(OBJ_DIR)/$(SOUND_ASM_SUBDIR)
MID_SUBDIR = sound/songs/midi
MID_BUILDDIR = $(OBJ_DIR)/$(MID_SUBDIR)
SAMPLE_SUBDIR = sound/direct_sound_samples
OBJ_TILES_4BPP_SUBDIR = graphics/obj_tiles/4bpp
TILESETS_SUBDIR = graphics/tilesets/

ifeq ($(PLATFORM),gba)
C_SRCS := $(shell find $(C_SUBDIR) -name "*.c" -not -path "*/platform/*")
else ifeq ($(PLATFORM),sdl)
C_SRCS := $(shell find $(C_SUBDIR) -name "*.c" -not -path "*/platform/win32/*" -not -path "*/platform/ps2/*")
else ifeq ($(PLATFORM),sdl_psp)
C_SRCS := $(shell find $(C_SUBDIR) -name "*.c" -not -path "*/platform/win32/*" -not -path "*/platform/ps2/*")
else ifeq ($(PLATFORM),ps2)
C_SRCS := $(shell find $(C_SUBDIR) -name "*.c" -not -path "*/platform/win32/*" -not -path "*/platform/pret_sdl/*")
else ifeq ($(PLATFORM),sdl_win32)
C_SRCS := $(shell find $(C_SUBDIR) -name "*.c" -not -path "*/platform/win32/*" -not -path "*/platform/ps2/*")
else ifeq ($(PLATFORM),win32)
C_SRCS := $(shell find $(C_SUBDIR) -name "*.c" -not -path "*/platform/pret_sdl/*" -not -path "*/platform/ps2/*")
else
C_SRCS := $(shell find $(C_SUBDIR) -name "*.c")
endif

C_OBJS := $(patsubst $(C_SUBDIR)/%.c,$(C_BUILDDIR)/%.o,$(C_SRCS))

ifeq ($(PLATFORM),gba)
CXX_SRCS := $(shell find $(C_SUBDIR) -name "*.cc" -not -path "*/platform/*")
else
CXX_SRCS := $(shell find $(C_SUBDIR) -name "*.cc")
endif
CXX_OBJS := $(patsubst $(C_SUBDIR)/%.cc,$(C_BUILDDIR)/%.o,$(CXX_SRCS))

# Platform not included as we only need the headers for decomp scratches
C_HEADERS := $(shell find $(INCLUDE_DIRS) -name "*.h" -not -path "*/platform/*")

ifeq ($(PLATFORM),gba)
C_ASM_SRCS := $(shell find $(C_SUBDIR) -name "*.s")
C_ASM_OBJS := $(patsubst $(C_SUBDIR)/%.s,$(C_BUILDDIR)/%.o,$(C_ASM_SRCS))
ASM_SRCS := $(wildcard $(ASM_SUBDIR)/*.s)
ASM_OBJS := $(patsubst $(ASM_SUBDIR)/%.s,$(ASM_BUILDDIR)/%.o,$(ASM_SRCS))
endif

DATA_ASM_SRCS := $(wildcard $(DATA_ASM_SUBDIR)/*.s)
DATA_ASM_OBJS := $(patsubst $(DATA_ASM_SUBDIR)/%.s,$(DATA_ASM_BUILDDIR)/%.o,$(DATA_ASM_SRCS))

SONG_SRCS := $(wildcard $(SONG_SUBDIR)/*.s)
SONG_OBJS := $(patsubst $(SONG_SUBDIR)/%.s,$(SONG_BUILDDIR)/%.o,$(SONG_SRCS))

MID_SRCS := $(wildcard $(MID_SUBDIR)/*.mid)
MID_OBJS := $(patsubst $(MID_SUBDIR)/%.mid,$(MID_BUILDDIR)/%.o,$(MID_SRCS))

SOUND_ASM_SRCS := $(wildcard $(SOUND_ASM_SUBDIR)/*.s)
SOUND_ASM_OBJS := $(patsubst $(SOUND_ASM_SUBDIR)/%.s,$(SOUND_ASM_BUILDDIR)/%.o,$(SOUND_ASM_SRCS))

OBJS     := $(C_OBJS) $(CXX_OBJS) $(ASM_OBJS) $(C_ASM_OBJS) $(DATA_ASM_OBJS) $(SONG_OBJS) $(MID_OBJS)
OBJS_REL := $(patsubst $(OBJ_DIR)/%,%,$(OBJS))

FORMAT_SRC_PATHS := $(shell find . -name "*.c" ! -path '*/src/data/*' ! -path '*/build/*' ! -path '*/ext/*')
FORMAT_H_PATHS   := $(shell find . -name "*.h" ! -path '*/build/*' ! -path '*/ext/*')

### COMPILER FLAGS ###
# -P disables line markers (don't EVER use this, if you want proper debug info!)
# -I sets an include path
# -D defines a symbol
CPPFLAGS ?= $(INCLUDE_CPP_ARGS) -D $(GAME_REGION)
CC1FLAGS ?= -Wimplicit -Wparentheses -Werror

ifneq ($(GAME_VARIANT), DEFAULT)
	CPPFLAGS += -D $(GAME_VARIANT)
endif

# These have to(?) be defined this way, because
# the C-preprocessor cannot resolve stuff like:
# #if (PLATFORM == gba), where PLATFORM is defined via -D.
ifeq ($(PLATFORM),gba)
	INCLUDE_SCANINC_ARGS += -I tools/agbcc/include
	CPPFLAGS += -D PLATFORM_GBA=1 -D PLATFORM_SDL=0 -D PLATFORM_WIN32=0 -D CPU_ARCH_X86=0 -D CPU_ARCH_ARM=1 -nostdinc -I tools/agbcc/include
	CC1FLAGS += -fhex-asm
ifeq ($(BUILD_NAME), sa1)
    # It seems this bug was introduced to GCC after SA1 released.
    PROLOGUE_FIX := -fprologue-bugfix
endif # BUILD_NAME == sa1
else
	CC1FLAGS += -Wstrict-overflow=1
	ifeq ($(PLATFORM),sdl)
		CC1FLAGS += -Wno-parentheses-equality -Wno-unused-value
		CPPFLAGS += -D TITLE_BAR=$(BUILD_NAME).$(PLATFORM) -D PLATFORM_GBA=0 -D PLATFORM_SDL=1 -D PLATFORM_WIN32=0 $(shell sdl2-config --cflags)
	else ifeq ($(PLATFORM),sdl_psp)
		CC1FLAGS += -G0
		CPPFLAGS += -D PLATFORM_GBA=0 -D PLATFORM_SDL=1 -D PLATFORM_WIN32=0 -D SDL_MAIN_HANDLED -I$(PSPDEV)/psp/include/SDL2 -I$(PSPDEV)/psp/include -I$(PSPSDK)/include -D_PSP_FW_VERSION=600
	else ifeq ($(PLATFORM),ps2)
		CC1FLAGS += -G0 -Wno-parentheses-equality -Wno-unused-value -ffast-math
		CPPFLAGS += -D PLATFORM_GBA=0 -D PLATFORM_SDL=0 -D PLATFORM_WIN32=0 -D_EE -D__PS2__ -I$(PS2SDK)/common/include -I$(PS2SDK)/ee/include -I$(PS2DEV)/gsKit/include -I$(PS2SDK)/ports/include
	else ifeq ($(PLATFORM),sdl_win32)
		CPPFLAGS += -D TITLE_BAR=$(BUILD_NAME).$(PLATFORM) -D PLATFORM_GBA=0 -D PLATFORM_SDL=1 -D PLATFORM_WIN32=0 $(SDL_MINGW_FLAGS)
	else ifeq ($(PLATFORM),win32)
		CPPFLAGS += -D TITLE_BAR=$(BUILD_NAME).$(PLATFORM) -D PLATFORM_GBA=0 -D PLATFORM_SDL=0 -D PLATFORM_WIN32=1
	endif
	ifeq ($(CPU_ARCH),i386)
        CPPFLAGS += -D CPU_ARCH_X86=1 -D CPU_ARCH_ARM=0
        # Use the more legible Intel dialect for x86, without underscores
        CC1FLAGS += -masm=intel
	else
        CPPFLAGS += -D CPU_ARCH_X86=0 -D CPU_ARCH_ARM=0
	endif
endif

ifeq ($(DEBUG),1)
  CC1FLAGS += -g3 -O0
  CPPFLAGS += -D DEBUG=1
else
  ifeq ($(PLATFORM),sdl_psp)
    # -O3 for PSP (Allegrex MIPS, small D-cache)
    CC1FLAGS += -O3 -funroll-loops -fomit-frame-pointer
  else ifeq ($(PLATFORM),ps2)
    CC1FLAGS += -O3 -fomit-frame-pointer
  else
    CC1FLAGS += -O2
  endif
  CPPFLAGS += -D DEBUG=0
endif

ifeq ($(PORTABLE),1)
  CPPFLAGS += -D PORTABLE=1
else
  CPPFLAGS += -D PORTABLE=0
endif

ifeq ($(TAS_TESTING),1)
  CPPFLAGS += -D TAS_TESTING=1
else
  CPPFLAGS += -D TAS_TESTING=0
endif

ifeq ($(NON_MATCHING),1)
# TODO: We use "#if(n)def NON_MATCHING a lot, maybe we should switch to "#if (!)NON_MATCHING"
#    CPPFLAGS += -D NON_MATCHING=1
endif

ifeq ($(ENABLE_DECOMP_CREDITS),0)
  CPPFLAGS += -D ENABLE_DECOMP_CREDITS=0
else
  CPPFLAGS += -D ENABLE_DECOMP_CREDITS=1
endif

CXXFLAGS := $(CC1FLAGS) $(CPPFLAGS) -fno-rtti -fno-exceptions -std=c++11

ifeq ($(PLATFORM),gba)
  ASFLAGS  += -mcpu=arm7tdmi -mthumb-interwork
  CC1FLAGS += -mthumb-interwork
else
  ifeq ($(PLATFORM), sdl)
    # for modern we are using a modern compiler
    # so instead of CPP we can use gcc -E to "preprocess only"
    CPP := $(CC1) -E
  else ifeq ($(PLATFORM), sdl_psp)
    CPP := $(CC1) -E
  else ifeq ($(PLATFORM), ps2)
    ASFLAGS  += -msingle-float
  endif
  # Allow file input through stdin on modern gcc/g++ and set it to "compile only"
  CC1FLAGS += -x c -S
  CXXFLAGS += -x c++ -S
endif

### LINKER FLAGS ###

# GBA
ifeq ($(PLATFORM),gba)
    MAP_FLAG := -Map
# Native
else ifeq ($(PLATFORM),sdl)
    ifeq ($(OS), Darwin)
        MAP_FLAG := -Wl,-map,
    else
        MAP_FLAG := -Xlinker -Map=
    endif
# Win32, PSP, PS2
else
    MAP_FLAG := -Xlinker -Map=
endif

# Libs
ifeq ($(PLATFORM),gba)
    LIBS := $(ROOT_DIR)/tools/agbcc/lib/libgcc.a $(ROOT_DIR)/tools/agbcc/lib/libc.a $(LIBABGSYSCALL_LIBS)
else ifeq ($(PLATFORM),sdl)
    LIBS := $(shell sdl2-config --cflags --libs)
else ifeq ($(PLATFORM),sdl_psp)
    LIBS := -L$(PSPDEV)/psp/lib -L$(PSPSDK)/lib -lSDL2 -lm -lGL -lpspvram -lpspaudio -lpspvfpu -lpspdisplay -lpspgu -lpspge -lpsphprm -lpspctrl -lpsppower -lpspdebug -lpspnet -lpspnet_apctl -Wl,-zmax-page-size=128
else ifeq ($(PLATFORM),ps2)
    LIBS := -T$(PS2SDK)/ee/startup/linkfile -L$(PS2SDK)/common/lib -L$(PS2SDK)/ee/lib -L$(PS2DEV)/gsKit/lib -L$(PS2SDK)/ports/lib -lgskit -ldmakit -lps2_drivers -lmc -lpatches -Wl,-zmax-page-size=128
else ifeq ($(PLATFORM),sdl_win32)
    LIBS := -mwin32 -lkernel32 -lwinmm -lmingw32 -lxinput $(SDL_MINGW_LIBS)
else ifeq ($(PLATFORM), win32)
    LIBS := -mwin32 -lkernel32 -lwinmm -lgdi32 -lxinput -lopengl32 $(LIBABGSYSCALL_LIBS)
endif

#### MAIN TARGETS ####

# these commands will run regardless of deps being completed
.PHONY: clean tools tidy clean-tools $(TOOLDIRS) libagbsyscall ps2

# Ensure required directories exist
$(shell mkdir -p $(C_BUILDDIR) $(ASM_BUILDDIR) $(DATA_ASM_BUILDDIR) $(SOUND_ASM_BUILDDIR) $(SONG_BUILDDIR) $(MID_BUILDDIR))

# a special command which ensures that stdout and stderr
# get printed instead of output into the makefile
infoshell = $(foreach line, $(shell $1 | sed "s/ /__SPACE__/g"), $(info $(subst __SPACE__, ,$(line))))

# Build tools when building the rom
# Disable dependency scanning for clean/tidy/tools
ifeq (,$(filter-out all rom compare libagbsyscall,$(MAKECMDGOALS)))
# if we are doing any of these things, build tools first
$(call infoshell, $(MAKE) tools)
# ensure that tools did build
MAKE_TOOLS_OUTCOME=$(shell $(MAKE) tools > /dev/null 2>&1 && echo 0 || echo 1)
ifneq ($(MAKE_TOOLS_OUTCOME),0)
  $(error Make tools command failed!)
endif
else
NODEP ?= 1
endif

# When not building tools, we should specify this
ifneq ($(NODEP),1)
# MacOS refuses to link the songs data because some pointers
# are not aligned. The music player code reads pointers from raw
# bytes, so they don't need to be aligned. But this is a simple
# work around which tells the compiler not to care. Once we are
# compiling the songs to C, we can cast the pointers to integers
# which means the linker will not notice.
#
# TODO: compile songs to C so that we can work around this.
export MACOSX_DEPLOYMENT_TARGET := 11
endif

ifeq ($(PLATFORM),gba)
# Use the old compiler for m4a, as it was prebuilt and statically linked to the original codebase
# PROLOGUE_FIX has to be set to nothing, since -fprologue-bugfix does not work with oldagbcc
$(C_BUILDDIR)/lib/m4a/m4a.o: CC1 := $(CC1_OLD)
$(C_BUILDDIR)/lib/m4a/m4a.o: PROLOGUE_FIX :=
# Use `-O1` for agb_flash libs, as these were also prebuilt
$(C_BUILDDIR)/lib/agb_flash/agb_flash.o:  CC1FLAGS := -O1 -mthumb-interwork -Werror
$(C_BUILDDIR)/lib/agb_flash/agb_flash%.o: CC1FLAGS := -O1 -mthumb-interwork -Werror
endif

#### Main Targets ####

ifeq ($(PLATFORM),gba)
all: compare
compare: rom
	$(SHA1) $(BUILD_NAME).sha1
else
all: rom
endif

rom: $(ROM)
tools: $(TOOLDIRS)
tool_libs:
	@$(MAKE) -C tools/_shared

clean: tidy clean-tools
	@$(MAKE) clean -C tools/BriBaSA_ex
	@$(MAKE) clean -C chao_garden
	@$(MAKE) clean -C multi_boot/subgame_bootstrap
	@$(MAKE) clean -C multi_boot/programs/subgame_loader
	@$(MAKE) clean -C multi_boot/collect_rings
	@$(MAKE) clean -C libagbsyscall PLATFORM=$(PLATFORM) CPU_ARCH=$(CPU_ARCH)
	$(RM) $(SAMPLE_SUBDIR)/*.bin $(MID_SUBDIR)/*.s
	find . \( -iwholename './data/maps/*/*/entities/*.bin' -o -iname '*.1bpp' -o -iname '*.4bpp' -o -iname '*.8bpp' -o -iname '*.gbapal' -o -iname '*.lz' -o -iname '*.rl' -o -iname '*.latfont' -o -iname '*.hwjpnfont' -o -iname '*.fwjpnfont' \) -exec $(RM) {} +

clean-tools:
	@$(foreach tooldir,$(TOOLDIRS),$(MAKE) clean -C $(tooldir);)

tidy:
	$(RM) -r build/*
	$(RM) SDL2.dll
	$(RM) $(BUILD_NAME)*.exe $(BUILD_NAME)*.elf $(BUILD_NAME)*.map $(BUILD_NAME)*.sdl $(BUILD_NAME)*.gba $(BUILD_NAME)*.iso
	$(RM) EBOOT.PBP PARAM.SFO

usa_beta: ; @$(MAKE) GAME_REGION=USA GAME_VARIANT=BETA
japan: ; @$(MAKE) GAME_REGION=JAPAN
japan_vc: ; @$(MAKE) GAME_REGION=JAPAN GAME_VARIANT=VIRTUAL_CONSOLE
europe: ; @$(MAKE) GAME_REGION=EUROPE
sdl: ; @$(MAKE) PLATFORM=sdl
sdl_psp: ; @$(MAKE) PLATFORM=sdl_psp
ps2: ; @$(MAKE) PLATFORM=ps2
tas_sdl: ; @$(MAKE) sdl TAS_TESTING=1
sdl_win32:
	@$(MAKE) PLATFORM=sdl_win32 CPU_ARCH=i386
win32: ; @$(MAKE) PLATFORM=win32 CPU_ARCH=i386

#### RECIPES ####

include songs.mk
include graphics.mk

%.s: ;
%.png: ;
%.pal: ;
%.1bpp: %.png  ; $(GFX) $< $@
%.4bpp: %.png  ; $(GFX) $< $@
%.8bpp: %.png  ; $(GFX) $< $@
%.gbapal: %.pal ; $(GFX) $< $@
%.gbapal: %.png ; $(GFX) $< $@

chao_garden/mb_chao_garden.gba.lz: chao_garden/mb_chao_garden.gba
	$(GFX) $< $@ -search 1

data/mb_chao_garden_japan.gba.lz: data/mb_chao_garden_japan.gba
	$(GFX) $< $@ -search 1

%interactables.bin: %interactables.csv
	$(ENT_POS) $< $@ -entities INTERACTABLES -header "./include/constants/interactables.h"

%itemboxes.bin: %itemboxes.csv
	$(ENT_POS) $< $@ -entities ITEMS -header "./include/constants/items.h"

%enemies.bin: %enemies.csv
	$(ENT_POS) $< $@ -entities ENEMIES -header "./include/constants/enemies.h"

%rings.bin: %rings.csv
	$(ENT_POS) $< $@ -entities RINGS

%.gba.lz: %.gba
	$(GFX) $< $@

%.bin.lz: %.bin
	$(GFX) $< $@

%.lz: % ; $(GFX) $< $@
%.rl: % ; $(GFX) $< $@
%.bin: %.aif ; $(AIF) $< $@

$(ELF): $(OBJS)
ifeq ($(PLATFORM),gba)
	@echo "$(LD) -T $(LDSCRIPT) $(MAP_FLAG) $(MAP) <objects> <lib> -o $@"
	@$(CPP) -P $(CPPFLAGS) $(LDSCRIPT) > $(OBJ_DIR)/$(LDSCRIPT)
	@cd $(OBJ_DIR) && $(LD) -T $(LDSCRIPT) $(MAP_FLAG) $(ROOT_DIR)/$(MAP) $(OBJS_REL) $(LIBS) -o $(ROOT_DIR)/$@
else
	@echo "$(CC1) $(MAP_FLAG)$(MAP) <objects> <lib> -o $@"
	@touch $(ROOT_DIR)/$(MAP)
	@cd $(OBJ_DIR) && $(CC1) $(MAP_FLAG)$(ROOT_DIR)/$(MAP) $(OBJS_REL) $(LIBS) -o $(ROOT_DIR)/$@
endif

ifeq ($(PLATFORM),gba)
$(ROM): $(ELF) libagbsyscall
	$(OBJCOPY) -O binary --pad-to 0x8400000 $< $@
	$(FIX) $@ -p -t"$(TITLE)" -c$(GAME_CODE) -m$(MAKER_CODE) -r$(GAME_REVISION) --silent
else ifeq ($(PLATFORM),win32)
$(ROM): $(ELF) libagbsyscall
	$(OBJCOPY) -O pei-x86-64 $< $@
else
$(ROM): $(ELF)
ifeq ($(PLATFORM),sdl)
	cp $< $@
else ifeq ($(PLATFORM),sdl_psp)
	@echo Creating $(ROM) from $(ELF)
	@psp-fixup-imports $<
	@mksfoex 'Sonic Advance 2' PARAM.SFO
	@psp-strip $< -o $(BUILD_NAME).psp_strip.elf
	@pack-pbp $@ PARAM.SFO NULL NULL NULL NULL NULL $(BUILD_NAME).psp_strip.elf NULL
	@-rm -f $(BUILD_NAME).psp_strip.elf
else ifeq ($(PLATFORM),ps2)
	@echo Creating $(ROM) from $(ELF)
	@cp -r ps2/ntsc $(OBJ_DIR)/iso
	@cp $< $(OBJ_DIR)/iso/$(PS2_GAME_CODE)
	@mkisofs -o $(ROM) $(OBJ_DIR)/iso/
else
	$(OBJCOPY) -O pei-x86-64 $< $@
endif
endif

# Build c sources, and ensure alignment
$(C_BUILDDIR)/%.o: $(C_SUBDIR)/%.c
	@echo "$(CC1) <flags> -o $@ $<"
	@$(shell mkdir -p $(shell dirname '$(C_BUILDDIR)/$*.i'))
	@$(CPP) $(CPPFLAGS) $< -o $(C_BUILDDIR)/$*.i
	@$(PREPROC) $(C_BUILDDIR)/$*.i | $(CC1) $(PROLOGUE_FIX) $(CC1FLAGS) -o $(C_BUILDDIR)/$*.s -
ifeq ($(PLATFORM), gba)
	@printf ".text\n\t.align\t2, 0\n" >> $(C_BUILDDIR)/$*.s
endif
	@$(AS) $(ASFLAGS) $(C_BUILDDIR)/$*.s -o $@

$(C_BUILDDIR)/%.o: $(C_SUBDIR)/%.cc
	@echo "$(CXX) <flags> -o $@ $<"
	@$(shell mkdir -p $(shell dirname '$(C_BUILDDIR)/$*.o'))
	@$(CXX) $(CXXFLAGS) -o $(C_BUILDDIR)/$*.s $<
	@$(AS) $(ASFLAGS) $(C_BUILDDIR)/$*.s -o $@

# Scan the src dependencies to determine if any dependent files have changed
$(C_BUILDDIR)/%.d: $(C_SUBDIR)/%.c
	@$(shell mkdir -p $(shell dirname '$(C_BUILDDIR)/$*.d'))
	$(SCANINC) -M $@ $(INCLUDE_SCANINC_ARGS) $<

$(C_BUILDDIR)/%.d: $(C_SUBDIR)/%.cc
	@$(shell mkdir -p $(shell dirname '$(C_BUILDDIR)/$*.d'))
	$(SCANINC) -M $@ $(INCLUDE_SCANINC_ARGS) $<

# rule for sources from the src dir (parts of libraries)
$(C_BUILDDIR)/%.o: $(C_SUBDIR)/%.s
	@echo "$(AS) <flags> -o $@ $<"
	@$(AS) $(ASFLAGS) -o $@ $<

$(ASM_BUILDDIR)/%.o: $(ASM_SUBDIR)/%.s
	@echo "$(AS) <flags> -o $@ $<"
	@$(AS) $(ASFLAGS) -o $@ $<

$(DATA_ASM_BUILDDIR)/%.o: $(DATA_ASM_SUBDIR)/%.s
	@echo "$(AS) <flags> -o $@ $<"
	@$(PREPROC) $< "" | $(CPP) $(CPPFLAGS) - | $(AS) $(ASFLAGS) -o $@ -

# Scan the ASM data dependencies to determine if any .inc files have changed
$(DATA_ASM_BUILDDIR)/%.d: $(DATA_ASM_SUBDIR)/%.s
	$(SCANINC) -M $@ $(INCLUDE_SCANINC_ARGS) $<

ifneq ($(NODEP),1)
-include $(addprefix $(OBJ_DIR)/,$(C_SRCS:.c=.d))
-include $(addprefix $(OBJ_DIR)/,$(CXX_SRCS:.cc=.d))
-include $(addprefix $(OBJ_DIR)/,$(DATA_ASM_SRCS:.s=.d))
endif

$(SONG_BUILDDIR)/%.o: $(SONG_SUBDIR)/%.s
	@echo "$(AS) <flags> -o $@ $<"
	@$(PREPROC) $< "" | $(CPP) $(CPPFLAGS) - | $(AS) $(ASFLAGS) -o $@ -

### SUB-PROGRAMS ###

chao_garden/mb_chao_garden.gba:
ifeq ($(PLATFORM), gba)
	@$(MAKE) -C chao_garden DEBUG=0
else
	@echo "Not building on the chao garden rom, as platform is $(PLATFORM)"
	@printf "1" > chao_garden/mb_chao_garden.gba
endif

chao_garden: tools
	@$(MAKE) -C chao_garden DEBUG=0

# Dependency here is already explicit, but we sometimes get a race condition if this
# is not specified
multi_boot/subgame_bootstrap/subgame_bootstrap.gba: multi_boot/programs/subgame_loader/subgame_loader.bin
ifeq ($(PLATFORM), gba)
	@$(MAKE) -C multi_boot/subgame_bootstrap DEBUG=0
else
	@echo "Not building on the subgame bootstrap rom, as platform is $(PLATFORM)"
	@printf "1" > multi_boot/subgame_bootstrap/subgame_bootstrap.gba
endif

multi_boot/programs/subgame_loader/subgame_loader.bin:
ifeq ($(PLATFORM), gba)
	@$(MAKE) -C multi_boot/programs/subgame_loader DEBUG=0
else
	@echo "Not building on the subgame loader rom, as platform is $(PLATFORM)"
	@printf "1" > multi_boot/programs/subgame_loader/subgame_loader.bin
endif

multi_boot/collect_rings/mb_signed_collect_rings.gba:
ifeq ($(PLATFORM), gba)
	@$(MAKE) -C multi_boot/collect_rings DEBUG=0
else
	@echo "Not building on the collect the rings rom, as platform is $(PLATFORM)"
	@printf "1" > multi_boot/collect_rings/mb_signed_collect_rings.gba
endif

subgame_bootstrap: tools
	@$(MAKE) -C multi_boot/subgame_bootstrap DEBUG=0

subgame_loader: tools
	@$(MAKE) -C multi_boot/programs/subgame_loader DEBUG=0

collect_rings: tools
	@$(MAKE) -C multi_boot/collect_rings DEBUG=0

libagbsyscall:
	@$(MAKE) -C libagbsyscall MODERN=0 PLATFORM=$(PLATFORM) CPU_ARCH=$(CPU_ARCH)

bribasa:
	@$(MAKE) -C tools/BriBaSA_ex

$(TOOLDIRS): tool_libs
	@$(MAKE) -C $@

### DEPS INSTALL COMMANDS ###

# ──────────────────────────────────────────────────────────────────────────────
# ARCH NOTE: bsdtar is provided by the 'libarchive' package on Arch/EndeavourOS.
# Install it with: sudo pacman -S libarchive
# The fallback to plain 'tar' is provided in case bsdtar is missing,
# though the tar flags (-xvf-) are compatible with both.
# ──────────────────────────────────────────────────────────────────────────────
BSDTAR := $(shell command -v bsdtar 2>/dev/null || command -v tar)

$(SDL_MINGW_LIB):
	@mkdir -p ext
	cd ext && wget -qO- https://github.com/libsdl-org/SDL/releases/download/release-2.30.3/SDL2-devel-2.30.3-mingw.zip | $(BSDTAR) -xvf-

SDL2.dll: $(SDL_MINGW_LIB)
	cp $(SDL_MINGW_SDL_DLL) SDL2.dll

### FORMATTER ###

# ──────────────────────────────────────────────────────────────────────────────
# ARCH NOTE: FORMAT is resolved at the top of this file via command -v,
# so these targets work regardless of whether clang-format is versioned or not.
# If FORMAT resolves to empty (clang-format not installed), these targets will
# print a clear error. Install via: sudo pacman -S clang
# ──────────────────────────────────────────────────────────────────────────────
format:
	@if [ -z "$(FORMAT)" ]; then \
		echo "ERROR: clang-format not found. Run: sudo pacman -S clang"; exit 1; \
	fi
	@echo $(FORMAT) -i -style=file "**/*.c" "**/*.h"
	@$(FORMAT) -i --verbose -style=file $(FORMAT_SRC_PATHS) $(FORMAT_H_PATHS)

check_format:
	@if [ -z "$(FORMAT)" ]; then \
		echo "ERROR: clang-format not found. Run: sudo pacman -S clang"; exit 1; \
	fi
	@echo $(FORMAT) -i -style=file --dry-run --Werror "**/*.c" "**/*.h"
	@$(FORMAT) -i --verbose -style=file --dry-run --Werror $(FORMAT_SRC_PATHS) $(FORMAT_H_PATHS)

### DECOMP TOOLS ###

ctx.c: $(C_HEADERS)
	@for header in $(C_HEADERS); do echo "#include \"$$header\""; done > ctx.h
	gcc -P -E -dD -undef -nostdinc -I include -D GEN_CTX=1 -D PLATFORM_GBA=1 ctx.h | sed '/^#define __STDC/d' | sed '1s|^|#include <stdint.h>\n|' > ctx.c
	@rm ctx.h

You might want to use antimicrox to map gamepad buttons to keyboard keys.