Zelder Banner

🌲 Zelder — The Root of All Builds 🦑📦🖤

"The game is the forest. This is the root system."
Beneath the surface, Zoxelder commands your builds with surgical precision — a lean, cryptic harness forged in the fires of C and Bash.
No gods, no GUI — just raw make, cross-compiling your nightmares to life.

✨ Features — The Arcane Powers

• 🛠 Unified Invocation
  Invoke builds with ritualized syntax:

  For any platform and architecture, specify:

  <game_name>-<platform>-<tag>
  # e.g.
  zoxel-linux-static
  zixel-windows-dynamic
  

  For Android builds (architecture implied), simpler:

  <game_name>-android
  # e.g.
  zoxel-android
  

• 🌐 Multi-Platform & Multi-Architecture
  Command your builds across realms — Linux, Windows, Android, WebGL, ARM, x86_64, and beyond.

• 📦 Asset Pipelines
  Within the tools/ sanctum, forge shaders, convert textures, and pack prefabs — all on command.

• 🔍 Debug & Release
  Append the -debug flag to summon symbols and sanity checks, or invoke your release rituals with optimized precision.

🚀 Quickstart — The Summoning Steps

# 1. Clone the ritual circle close to your project
git clone https://codeberg.org/deus/zoxelder.git
cd zoxelder
# 2. Invoke the dependencies ritual (flecs, SDL, and kin)
make deps
# 3. Update the game source — fresh blood for the forge
make update
# 4. Forge your executables
make zoxel-linux-static
make zoxel-windows-dynamic
# make zoxel-android
# make zoxel-webgl
# make zoxel-arm
# Or channel all power at once:
make all
# 5. Cleanse the workshop when finished
make clean

⚠️ Tips from the Abyss:

• Use the -debug flag for builds steeped in symbols and sanity checks.
• Set VERBOSE=1 to reveal every whisper of the build incantations.

🗂 Project Layout — The Structure of Power

zoxelder/
├── and/ # Android-specific rituals and scripts
├── bin/ # Summoned executables and artifacts
├── bsh/ # Bash incantations — automation and builds
├── dep/ # Dependencies and their arcane bindings
├── doc/ # Forbidden tomes and documentation
├── inc/ # Header files — sigils for the C compiler
├── lib/ # Libraries — ancient bindings and third-party magic
├── makefile # The central grimoire, your main command altar
├── readme.md # The manual, your guiding light through the void
├── tch/ # Toolchain helpers and asset forges
├── tst/ # Trials and test arenas
└── zox/ # The engine’s dark heart

🦑 Closing Words — A Prayer to the Sleeper 🦑

Three letters are no mere restriction — they are a dark art. Like haiku scribed in the blood of ancient ones, they hold back the creeping chaos. 🌲⌨️⚡

May your directory trees stay lean, your tab completions swift, and your code forever resist the maddening abyss beyond the stars.

And remember:

In the silence where the stars whisper,
The Sleeper stirs — but so do we.

📜 THE ABYSSAL TO-DO SYSTEM 📜

The grand design awaits your eyes todo

Zelder's make rituals extend beyond builds — they manage your mortal tasks, slaying, delaying, or igniting them within the shadows of your todo.md grimoire.

Invoke your task-related commands thus:

tasks - Runs the task manager new-task - Birth new chaos: conjure a new task into existence start-task - Ignite the AI engines: mark a task as in progress delay-task - Cast into limbo: delay a task to the void done-task - Seal the fate: mark a task as completed remove-task - Excise the corrupted: remove a task forever show-current - Gaze into the void: reveal the current active tasks show-done - Crypt of the completed: list all sealed fates show-tasks - Whispers of unfinished deeds: list pending tasks dump-tasks - Enter the void: reveal all tasks regardless of fate quit - Surrender to the madness: exit the ritual

Each command echoes its deeds to your terminal, keeping you aligned with the abyssal workflow.

Tasks live in doc/tsk/todo.md, marked as:

[ ] Pending [>] In progress [~] Delayed [x] Completed

Tread carefully — the abyss watches, and the Sleeper stirs.