{"id":43505180,"url":"https://github.com/bymehul/vnefall","last_synced_at":"2026-02-06T15:03:08.874Z","repository":{"id":335896646,"uuid":"1147425603","full_name":"bymehul/vnefall","owner":"bymehul","description":"vnefall is a simple, visual novel engine built in Odin .","archived":false,"fork":false,"pushed_at":"2026-02-04T14:02:07.000Z","size":33715,"stargazers_count":11,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-02-05T23:44:45.212Z","etag":null,"topics":["cross-platform","game-engine","lightweight","minimal","odin","odin-lang","opengl","scripting-language","sdl2","visual-novel","visual-novel-engine"],"latest_commit_sha":null,"homepage":"","language":"Odin","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/bymehul.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-01T18:15:21.000Z","updated_at":"2026-02-05T22:39:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"6d3051ed-149d-4699-9c1a-8f07ee0cec74","html_url":"https://github.com/bymehul/vnefall","commit_stats":null,"previous_names":["bymehul/inkframe","bymehul/vnefall"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/bymehul/vnefall","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bymehul%2Fvnefall","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bymehul%2Fvnefall/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bymehul%2Fvnefall/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bymehul%2Fvnefall/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bymehul","download_url":"https://codeload.github.com/bymehul/vnefall/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bymehul%2Fvnefall/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29165711,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-06T14:37:12.680Z","status":"ssl_error","status_checked_at":"2026-02-06T14:36:22.973Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["cross-platform","game-engine","lightweight","minimal","odin","odin-lang","opengl","scripting-language","sdl2","visual-novel","visual-novel-engine"],"created_at":"2026-02-03T12:10:55.172Z","updated_at":"2026-02-06T15:03:08.869Z","avatar_url":"https://github.com/bymehul.png","language":"Odin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vnefall\n\nVnefall is a simple, no-nonsense visual novel engine. It's built in Odin using SDL2 and OpenGL 3.3.\n\n![Vnefall Demo](demo_vnefall.gif)\n\n## Features\n- **Branching Dialogue**: Full support for labels, jumps, and player choices.\n- **Configuration System**: Portable `config.vnef` file for resolution, colors, and paths.\n- **Virtual Resolution**: Design once, it scales automatically to any screen.\n- **Simple Syntax**: Commands like `say`, `bg`, `char`, `choice`, `set`, and `if`.\n- **Audio Support**: Background music with looping support.\n- **Sthiti Persistence**: Fast, native Save/Load system for story progress.\n- **Character Stacking**: Responsive scaling and Z-index control for sprites.\n\n## How to get started\n\n### Just want to run it? (Linux)\nIf you're on Linux, grab the `vnefall` binary from the [Releases](https://github.com/bymehul/vnefall/releases) page. Run the new high-quality demo:\n```bash\nchmod +x vnefall\n./vnefall assets/scripts/demo_game.vnef\n```\n\n### Want to build from source?\n*(Note: Windows and Mac versions are currently untested).*\n\nYou'll need the [Odin Compiler](https://odin-lang.org/) and SDL2 libraries.\n\n**Linux (Ubuntu/Debian):**\n```bash\n# Install dependencies\nsudo apt install libsdl2-dev libsdl2-mixer-dev libsdl2-ttf-dev\n\n# Build (v1.2.0)\n./build.sh\n./vnefall assets/scripts/v120_char_pro.vnef\n```\n\n**Windows:**\nInstall Odin, download the SDL2 development libs, and run:\n```powershell\nodin build src -out:vnefall.exe\n./vnefall.exe assets/scripts/demo.vnef\n```\n\n**Mac:**\n```bash\nbrew install sdl2 sdl2_mixer\nodin build src -out:vnefall\n./vnefall assets/scripts/demo.vnef\n```\n\n## Writing your own story\n\nScripts are just simple text files ending in `.vnef`. You can change backgrounds, play music, and write dialogue without touching a single line of code.\n\nSee the [detailed command guide](docs/commands/) for all available commands.\n\nHere's what a script looks like:\n```vnef\nbg room.png\nsay Alice \"Welcome to the new Vnefall!\"\n\nchoice_add \"Go to the Night\" see_night\nchoice_add \"Stay in Day\" stay_day\nchoice_show\n\nlabel see_night:\n    bg night.png\n    say Alice \"The night is cool.\"\n    jump end_story\n\nlabel stay_day:\n    say Alice \"Sunlight is nice too.\"\n\nlabel end_story:\n    say Alice \"Thanks for playing!\"\n    end\n```\n\n## Controls\n- **Click / Space / Enter**: Next line.\n- **Escape**: Quit.\n\n## Contributing\nCheck out [CONTRIBUTING.md](CONTRIBUTING.md) for the guide. We like clean, readable code with simple logic.\n\n## License\nThis project is licensed under the [MIT License](LICENSE). \n\nI am also planning to transition to a **dual-licensing** model in the future to support long-term development.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbymehul%2Fvnefall","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbymehul%2Fvnefall","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbymehul%2Fvnefall/lists"}