{"id":22201909,"url":"https://github.com/cuhhub/npc-system","last_synced_at":"2025-08-30T17:10:37.269Z","repository":{"id":215504404,"uuid":"739099739","full_name":"cuhHub/NPC-System","owner":"cuhHub","description":"NPCs that can talk to you. Built for Stormworks: Build and Rescue.","archived":false,"fork":false,"pushed_at":"2024-05-16T04:59:42.000Z","size":365,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-25T00:46:46.213Z","etag":null,"topics":["addon","lua","mod","npcsystem","stormworks"],"latest_commit_sha":null,"homepage":"https://discord.gg/zTQxaZjwDr","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cuhHub.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-01-04T19:13:07.000Z","updated_at":"2024-05-16T04:59:45.000Z","dependencies_parsed_at":"2024-12-02T16:11:38.368Z","dependency_job_id":null,"html_url":"https://github.com/cuhHub/NPC-System","commit_stats":null,"previous_names":["cuh4/npcdialogdemo","cuhhub/npcdialogdemo","cuhhub/npc-system"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cuhHub/NPC-System","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cuhHub%2FNPC-System","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cuhHub%2FNPC-System/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cuhHub%2FNPC-System/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cuhHub%2FNPC-System/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cuhHub","download_url":"https://codeload.github.com/cuhHub/NPC-System/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cuhHub%2FNPC-System/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272878320,"owners_count":25008336,"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","status":"online","status_checked_at":"2025-08-30T02:00:09.474Z","response_time":77,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["addon","lua","mod","npcsystem","stormworks"],"created_at":"2024-12-02T16:11:34.322Z","updated_at":"2025-08-30T17:10:37.250Z","avatar_url":"https://github.com/cuhHub.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Game Screenshot](imgs/readme_topimage.png)\n\n---\n\n# NPC System\n\n## 📚 Overview\nThis repo contains a library that allows you to create NPCs that you can interact with. Built for Stormworks: Build and Rescue.\n\nUtilizes [Aurora Framework by Cuh4](https://github.com/Cuh4/AuroraFramework).\n\n## 😔 Limitations\n- NPCs are not persistent. If you create a NPC, and then reload the addon, the NPC will have to be created again\n- To start a conversation with a NPC, you can only say one thing. After that, you can say multiple things to progress through the conversation depending on the NPC's dialog.\n- Dialogs cannot be natively linked to one another. Each dialog has their own route.\n\n## ❓ Requirements\n- **Python 3.11+**\n- **Stormworks: Build and Rescue** (game)\n\n## 💻 Setup\n1) Run `git clone \"https://github.com/cuhHub/NPC-System.git\"`\n2) Create a `playlist.xml` file containing the content below.\n```xml\n\u003c?xml version=\"1.0\" encoding=\"UTF-8\"?\u003e\n\u003cplaylist file_store=\"4\" name=\"Addon Name Here\"\u003e\n    \u003clocations\u003e\n        \u003clocations/\u003e\n    \u003c/locations\u003e\n\u003c/playlist\u003e\n```\n3) Run `py combiner.py` (or run `combiner.bat`) to create a `script.lua` file. Feel free to close it once it has been created.\n4) Run `sync.bat` to automatically replicate the addon into your Stormworks' addons folder.\n5) Create a save with the addon enabled.\n\n## ✨ Credit\n- [**Cuh4**](https://discord.com/users/1141077132915777616) ([GitHub](https://github.com/Cuh4))","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcuhhub%2Fnpc-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcuhhub%2Fnpc-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcuhhub%2Fnpc-system/lists"}