{"id":15722504,"url":"https://github.com/insality/defold-quest","last_synced_at":"2025-05-13T03:59:45.437Z","repository":{"id":251493712,"uuid":"837582945","full_name":"Insality/defold-quest","owner":"Insality","description":"Defold Quest System","archived":false,"fork":false,"pushed_at":"2025-04-30T20:44:44.000Z","size":904,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-13T03:59:39.683Z","etag":null,"topics":["defold","defold-extension","defold-library","defold-module","quest"],"latest_commit_sha":null,"homepage":"","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/Insality.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"insality","ko_fi":"insality","buy_me_a_coffee":"insality"}},"created_at":"2024-08-03T12:00:17.000Z","updated_at":"2025-05-06T04:56:36.000Z","dependencies_parsed_at":"2024-08-03T13:32:42.642Z","dependency_job_id":"98bcf4b4-d884-4be4-beb8-f3ca90b29c28","html_url":"https://github.com/Insality/defold-quest","commit_stats":null,"previous_names":["insality/defold-quest"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Insality%2Fdefold-quest","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Insality%2Fdefold-quest/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Insality%2Fdefold-quest/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Insality%2Fdefold-quest/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Insality","download_url":"https://codeload.github.com/Insality/defold-quest/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253870860,"owners_count":21976612,"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":["defold","defold-extension","defold-library","defold-module","quest"],"created_at":"2024-10-03T22:08:11.874Z","updated_at":"2025-05-13T03:59:45.429Z","avatar_url":"https://github.com/Insality.png","language":"Lua","funding_links":["https://github.com/sponsors/insality","https://ko-fi.com/insality","https://buymeacoffee.com/insality","https://www.buymeacoffee.com/insality"],"categories":[],"sub_categories":[],"readme":"![](media/logo.png)\n\n[![GitHub release (latest by date)](https://img.shields.io/github/v/tag/insality/defold-quest?style=for-the-badge\u0026label=Release)](https://github.com/Insality/defold-quest/tags)\n[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/insality/defold-quest/ci-workflow.yml?branch=master\u0026style=for-the-badge)](https://github.com/Insality/defold-quest/actions)\n[![codecov](https://img.shields.io/codecov/c/github/Insality/defold-quest?style=for-the-badge)](https://codecov.io/gh/Insality/defold-quest)\n\n[![Github-sponsors](https://img.shields.io/badge/sponsor-30363D?style=for-the-badge\u0026logo=GitHub-Sponsors\u0026logoColor=#EA4AAA)](https://github.com/sponsors/insality) [![Ko-Fi](https://img.shields.io/badge/Ko--fi-F16061?style=for-the-badge\u0026logo=ko-fi\u0026logoColor=white)](https://ko-fi.com/insality) [![BuyMeACoffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge\u0026logo=buy-me-a-coffee\u0026logoColor=black)](https://www.buymeacoffee.com/insality)\n\n\n# Disclaimer\n\nThe library in development stage. May be not fully tested and README may be not full. If you have any questions, please, create an issue. This library is an adoptation of [Quest](https://github.com/Insality/defold-eva/blob/master/eva/modules/quest.lua) module from my [Defold-Eva](https://github.com/Insality/defold-eva) library.\n\n\n# Quest\n\n**Quest** - module is a comprehensive system for managing quests in a game. It allows for the registration, tracking, and completion of quests, with various events and callbacks to handle quest-related activities.\n\n\n## Features\n\n- **Quest Management** - Create, start, and complete quests with ease.\n- **Quest Progress** - Track the progress of quests and their tasks.\n- **Quest Events** - Listen for quest-related events and adjust it for your needs.\n\n\n## Setup\n\n### [Dependency](https://www.defold.com/manuals/libraries/)\n\nOpen your `game.project` file and add the following line to the dependencies field under the project section:\n\n**[Defold Event](https://github.com/Insality/defold-event)**\n\n```\nhttps://github.com/Insality/defold-event/archive/refs/tags/11.zip\n```\n\n**[Defold Quest](https://github.com/Insality/defold-quest/archive/refs/tags/1.zip)**\n\n```\nhttps://github.com/Insality/defold-quest/archive/refs/tags/1.zip\n```\n\nAfter that, select `Project ▸ Fetch Libraries` to update [library dependencies]((https://defold.com/manuals/libraries/#setting-up-library-dependencies)). This happens automatically whenever you open a project so you will only need to do this if the dependencies change without re-opening the project.\n\n### Library Size\n\n\u003e **Note:** The library size is calculated based on the build report per platform\n\n| Platform         | Library Size |\n| ---------------- | ------------ |\n| HTML5            | **3.91 KB**  |\n| Desktop / Mobile | **7.57 KB**  |\n\n\n## API Reference\n\n### Quick API Reference\n\n```lua\nquest.init(quest_config_path)\nquest.reset_state()\n\n-- Events\nquest.on_quest_register -- event (quest_id, quest_config)\nquest.on_quest_start -- event (quest_id, quest_config)\nquest.on_quest_completed -- event (quest_id, quest_config)\nquest.on_quest_progress -- event (quest_id, quest_config, delta, total, task_index)\nquest.on_quest_task_completed -- event (quest_id, quest_config, task_index)\nquest.is_can_start -- event (quest_id, quest_config): boolean\nquest.is_can_complete -- event (quest_id, quest_config): boolean\nquest.is_can_event -- event (quest_id, quest_config): boolean\n\nquest.quest_event(action, object, amount)\nquest.get_current(category)\nquest.get_progress(quest_id)\nquest.get_completed(category)\nquest.is_active(quest_id)\nquest.is_completed(quest_id)\nquest.is_current_with_task(action, object)\nquest.is_can_start_quest(quest_id)\nquest.start_quest(quest_id)\nquest.is_can_complete_quest(quest_id)\nquest.complete_quest(quest_id)\nquest.force_complete_quest(quest_id)\nquest.reset_progress(quest_id)\nquest.get_quest_config(quest_id)\nquest.update_quests()\nquest.set_logger(logger_instance)\n```\n\n### API Reference\n\nRead the [API Reference](API_REFERENCE.md) file to see the full API documentation for the module.\n\n## Use Cases\n\nRead the [Use Cases](USE_CASES.md) file to see several examples of how to use the this module in your Defold game development projects.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Issues and Suggestions\n\nFor any issues, questions, or suggestions, please [create an issue](https://github.com/Insality/defold-quest/issues).\n\n## 👏 Contributors\n\n\u003ca href=\"https://github.com/Insality/defold-quest/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contributors-img.web.app/image?repo=insality/defold-quest\"/\u003e\n\u003c/a\u003e\n\n## ❤️ Support project ❤️\n\nYour donation helps me stay engaged in creating valuable projects for **Defold**. If you appreciate what I'm doing, please consider supporting me!\n\n[![Github-sponsors](https://img.shields.io/badge/sponsor-30363D?style=for-the-badge\u0026logo=GitHub-Sponsors\u0026logoColor=#EA4AAA)](https://github.com/sponsors/insality) [![Ko-Fi](https://img.shields.io/badge/Ko--fi-F16061?style=for-the-badge\u0026logo=ko-fi\u0026logoColor=white)](https://ko-fi.com/insality) [![BuyMeACoffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge\u0026logo=buy-me-a-coffee\u0026logoColor=black)](https://www.buymeacoffee.com/insality)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finsality%2Fdefold-quest","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finsality%2Fdefold-quest","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finsality%2Fdefold-quest/lists"}