{"id":28406875,"url":"https://github.com/jonasgeiler/3d-soft-engine-lua","last_synced_at":"2025-06-29T09:32:28.348Z","repository":{"id":46688422,"uuid":"125738928","full_name":"jonasgeiler/3d-soft-engine-lua","owner":"jonasgeiler","description":"🧪 A simple 3D engine written in Lua using using lua-fenster.","archived":false,"fork":false,"pushed_at":"2025-03-20T13:37:05.000Z","size":518,"stargazers_count":9,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-22T23:46:04.963Z","etag":null,"topics":["3d","3d-engine","3d-graphics","3d-soft-engine","computer-graphics","experiment","graphics","lua","lua-fenster","soft-engine"],"latest_commit_sha":null,"homepage":"https://www.davrous.com/2013/06/13/tutorial-series-learning-how-to-write-a-3d-soft-engine-from-scratch-in-c-typescript-or-javascript","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jonasgeiler.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"jonasgeiler","ko_fi":"jonasgeiler","liberapay":"jonasgeiler"}},"created_at":"2018-03-18T15:27:01.000Z","updated_at":"2025-03-20T13:37:08.000Z","dependencies_parsed_at":"2024-06-03T14:08:52.726Z","dependency_job_id":"98fe601e-22e0-4688-b304-c1d339ea14ae","html_url":"https://github.com/jonasgeiler/3d-soft-engine-lua","commit_stats":null,"previous_names":["jonasgeiler/softengine.lua","jonasgeiler/3d-rasterizer-lua"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/jonasgeiler/3d-soft-engine-lua","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasgeiler%2F3d-soft-engine-lua","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasgeiler%2F3d-soft-engine-lua/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasgeiler%2F3d-soft-engine-lua/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasgeiler%2F3d-soft-engine-lua/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jonasgeiler","download_url":"https://codeload.github.com/jonasgeiler/3d-soft-engine-lua/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasgeiler%2F3d-soft-engine-lua/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262569747,"owners_count":23330275,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d","3d-engine","3d-graphics","3d-soft-engine","computer-graphics","experiment","graphics","lua","lua-fenster","soft-engine"],"created_at":"2025-06-01T23:10:20.357Z","updated_at":"2025-06-29T09:32:28.340Z","avatar_url":"https://github.com/jonasgeiler.png","language":"Lua","readme":"# 3d-soft-engine-lua\n\n\u003e A simple 3D engine written in Lua using\n\u003e using [lua-fenster](https://github.com/jonasgeiler/lua-fenster).\n\nSome time ago I wanted to learn more about 3D engines, so I read this tutorial\nseries by David Rousset and then translated the TypeScript code from the\ntutorial series into Lua:\n[Tutorial series: learning how to write a 3D soft engine from scratch in C#, TypeScript or JavaScript](https://www.davrous.com/2013/06/13/tutorial-series-learning-how-to-write-a-3d-soft-engine-from-scratch-in-c-typescript-or-javascript/)\n\nThis 3D engine is obviously not production-ready or really anything to be taken\nseriously, but I had a lot of fun writing it!  \nIt runs completely on the CPU and doesn't utilize any sort of hardware\nacceleration or graphics library like OpenGL, therefore the term \"soft engine\".\n\nThis is actually a rework of a very old project of mine, which used\n[LÖVE2D](https://love2d.org/) instead of\n[lua-fenster](https://github.com/jonasgeiler/lua-fenster) (my own GUI library).  \nIf you want to see the old version, check out the\n[`old-love2d-version`](https://github.com/jonasgeiler/3d-soft-engine-lua/tree/old-love2d-version)\ntag.  \nThe code is a bit messy though.\n\n## Screenshots\n\n![Screenshot - Monkey](https://github.com/jonasgeiler/3d-soft-engine-lua/assets/10259118/20ba15aa-7e18-4a91-abb3-a485d3b83396)\n![Screenshot - Teapot](https://github.com/jonasgeiler/3d-soft-engine-lua/assets/10259118/44c0f02f-049e-4c3c-978b-12b9f6df1c68)\n![Screenshot - Torus](https://github.com/jonasgeiler/3d-soft-engine-lua/assets/10259118/dfff8735-3f32-4b61-a0f3-0897d64c9dad)\n\n## Requirements\n\n- [LuaJIT 2.1](https://luajit.org/) (_**highly recommended**_) or [Lua 5.1](https://www.lua.org/) (newer Lua versions might work but not tested)\n  \u003e **💡 Tip:** On Arch Linux, you can easily install both with `pacman -S luajit lua51`.\n- [LuaRocks](https://luarocks.org/)\n  \u003e **💡 Tip:** On Arch Linux, you can easily install it with `pacman -S luarocks`.\n  \u003e\n  \u003e **💬 Important:** Make sure you configure LuaRocks to use Lua 5.1 (even when you use LuaJIT 2.1)\n  \u003e by either using the `--lua-version=5.1` flag every time, or by configuring it with `luarocks config lua_version 5.1`.\n\n## How to try\n\nDownload the repository and install the dependencies with `luarocks`:\n\n```shell\n$ luarocks install --only-deps 3d-soft-engine-dev-1.rockspec\n\n# OR, manually install dependencies:\n$ luarocks install fenster\n$ luarocks install dkjson\n```\n\nAfterwards, run [`main.lua`](./main.lua):\n\n```shell\n$ luajit ./main.lua\n\n# OR, slower:\n$ lua5.1 ./main.lua\n```\n\nFeel free to play around with the [`main.lua`](./main.lua) file,\ntrying out different models and such.\n","funding_links":["https://github.com/sponsors/jonasgeiler","https://ko-fi.com/jonasgeiler","https://liberapay.com/jonasgeiler"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonasgeiler%2F3d-soft-engine-lua","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjonasgeiler%2F3d-soft-engine-lua","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonasgeiler%2F3d-soft-engine-lua/lists"}