How iwnuplynottyan/lura works
Project type and purpose
• Lura is a single‐binary, CLI turn‐based roguelike game written in Go, with support for user‐supplied mods in Lua.
• It provides a text‐based game loop (explore, fight, dialog, buffs), RNG‐driven mechanics, and a debug console.
File structure
• Top‐level Go source files encapsulate the core engine:
• main.go – bootstrap, argument parsing (–debug), entry into game loop
• data.go – model definitions for monsters, weapons, maps (assets/)
• rng.go – random number generator service
• fight.go, dialog.go, buffs.go – key gameplay subsystems
• mods.go – plugin manager for loading/applying Lua mods
• debug.go – REPL‐style debug console overlay
• template – packaging template for Void Linux
• assets/ holds plain‐text maps or scenes (forest.txt, cave.txt)
• Build & deployment files: go.mod/go.sum, Makefile, justfile, flake.nix, shell.nix, PKGBUILD
README for additional insights
• Describes installation methods across OS (Windows, Arch, Nix, Void)
• Documents the mod folder location, Lua API (Monster.new, Weapon.new, removeByName)
• Notes the font dependency (Nerd Fonts)
• Emphasizes debug flag and commands