Files
darman 45b246c1d7 docs: Initialize comprehensive project documentation
Migrates existing GDD and engine design notes from HacknPlan into a new Obsidian vault.

This establishes a centralized, version-controlled knowledge base covering engine architecture, game constraints, design decisions, and open questions.
2026-09-24 23:55:48 +02:00

2.3 KiB

tags
tags
decisions
open

Open Questions

  • Scripting language: Lua 5.4, Luau or AngelScript? To be settled by the spike in Scripting#Decision spike.
  • Data format for stat blocks: only needed if AngelScript wins (TOML or JSON).
  • glTF loader: cgltf or fastgltf? Check nixpkgs availability and versions. See Assets.
  • Camera projection: fixed-pitch perspective (current default) or orthographic isometric? See Rendering#Camera.
  • Art direction: PBR-lite or toon shading? This affects the material model in Rendering.
  • Modding: will user-made content be supported? This affects how strict the script sandbox must be.
  • Target platforms beyond Linux and Windows: macOS would require SDL_shadercross (MSL).
  • Save model: save at map nodes only (seed, stream states, deck), or mid-combat too?

From the GDD import

Found while importing the GDD (2026-09-24). Each one touches an engine decision made before the import. None have been changed yet.

  • Fixed lanes vs. an open field with walls. Stages und Mapgröße prefers an open field where the player steers enemies with walls. That conflicts with Decision Log#Grid with fixed lanes. If adopted, it needs flow-field pathfinding and re-pathing when walls are placed.
  • RTS units in the siege phase. Card Types#Deploy, Units and Einheiten Karten oder Spawn Gebäude describe friendly units that fight, persist across rounds and level up. The engine currently has no unit AI, friendly movement or melee combat.
  • Card play during the wave. Gameplay Loop#Siege Phase allows attack and special cards while enemies attack. The loop supports this, but card targeting and effects must work against a running simulation.
  • Stages (before the wall / on the wall / inside the base) and towers limited to certain stages. See Stages und Mapgröße.
  • Quadrants / "Himmelsrichtungen" (Hellcard-style pie spaces) as card target areas. See the comment in Card Types.
  • Corpses as entities for the Necromancer's raise mechanics. See Characters#Necromancer.
  • Run structure: multiple levels, or a roguelike/lite with an endless or long siege and a final boss? See Stages und Mapgröße. This affects the save model and Randomness.