How ccleonos/leonos works
Project type and purpose
• LeonOS is not a typical web or mobile app. It’s a Lua-based operating system image and installer for the ComputerCraft mod in Minecraft.
• Purpose: provide a drop-in “BIOS” (ROM) and standard suite of shells, APIs, utilities, and an installer/updater for in-game computers.
File structure
Top-level:
• installer.lua – fetches and writes the OS image
• unbios.lua – minimal bootloader stub to chain-load LeonOS
• updater.lua – in-game updater for the installed OS
• pack.mcmeta – Minecraft resource-pack metadata
Config & CI:
• .github/workflows/release.yml – automates releases
• .trae/rules – project-specific code/style rules
• .VSCodeCounter – metrics history (editor plugin artifacts)
Core payload under data/computercraft/lua:
• bios.lua – main ROM startup code
• packages/… – example and installed Lua packages for users
• rom/apis/… – exported API libraries (fs, disk, http, rednet, etc.)
• rom/completions/… – shell completion specs
• rom/editors/… – in-game editors
• rom/modules/… – Lua modules for builtin commands and libraries
• rom/programs/… – user-facing shell programs (ls, copy, edit, turtle, etc.)
• rom/startup/… – startup sequence scripts (00_fs.lua → 90_settings.lua)
• update.lua – orchestrates ROM updates
README for additional insights
• Describes how to bootstrap installation via wget run https://…/installer.lua.
• Includes LeonCore’s BLC open-source license.