{"id":13759875,"url":"https://github.com/adventuregamestudio/ags","last_synced_at":"2026-04-02T17:06:23.584Z","repository":{"id":3546658,"uuid":"4607043","full_name":"adventuregamestudio/ags","owner":"adventuregamestudio","description":"AGS editor and engine source code","archived":false,"fork":false,"pushed_at":"2026-03-28T07:29:46.000Z","size":138950,"stargazers_count":811,"open_issues_count":288,"forks_count":167,"subscribers_count":40,"default_branch":"master","last_synced_at":"2026-03-28T12:31:46.861Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"mwaterfall/MWFeedParser","license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adventuregamestudio.png","metadata":{"files":{"readme":"README.md","changelog":"Changes.txt","contributing":"CONTRIBUTING.md","funding":null,"license":"License.txt","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":"Copyright.txt","agents":null,"dco":null,"cla":null}},"created_at":"2012-06-09T12:21:04.000Z","updated_at":"2026-03-28T00:10:13.000Z","dependencies_parsed_at":"2026-03-19T21:01:24.606Z","dependency_job_id":null,"html_url":"https://github.com/adventuregamestudio/ags","commit_stats":{"total_commits":6026,"total_committers":54,"mean_commits":111.5925925925926,"dds":0.3874875539329572,"last_synced_commit":"e9c50cdaf8a951f726ecbf9e2ed5e886f20419f2"},"previous_names":[],"tags_count":268,"template":false,"template_full_name":null,"purl":"pkg:github/adventuregamestudio/ags","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adventuregamestudio%2Fags","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adventuregamestudio%2Fags/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adventuregamestudio%2Fags/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adventuregamestudio%2Fags/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adventuregamestudio","download_url":"https://codeload.github.com/adventuregamestudio/ags/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adventuregamestudio%2Fags/sbom","scorecard":{"id":168500,"data":{"date":"2025-08-11","repo":{"name":"github.com/adventuregamestudio/ags","commit":"dde33f1c360d6dc6df525fbc70839d51ee4b15df"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.3,"checks":[{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/build.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":10,"reason":"30 commit(s) and 15 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":0,"reason":"Found 2/21 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Binary-Artifacts","score":2,"reason":"binaries present in source code","details":["Warn: binary detected: Android/agsplayer/gradle/wrapper/gradle-wrapper.jar:1","Warn: binary detected: Android/library/runtime/gradle/wrapper/gradle-wrapper.jar:1","Warn: binary detected: Editor/AGS.Editor/Resources/setup.dat:1","Warn: binary detected: PSP/lib/libaldmb.a:1","Warn: binary detected: PSP/lib/liballeg-main.a:1","Warn: binary detected: PSP/lib/liballeg.a:1","Warn: binary detected: PSP/lib/libdumb.a:1","Warn: binary detected: PSP/lib/libtheoradec.a:1"],"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"License","score":9,"reason":"license file detected","details":["Info: project has a license file: License.txt:0","Warn: project license file does not contain an FSF or OSI license."],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v4.0.0.19 not signed: https://api.github.com/repos/adventuregamestudio/ags/releases/233704494","Warn: release artifact v3.6.2.12 not signed: https://api.github.com/repos/adventuregamestudio/ags/releases/233650081","Warn: release artifact v4.0.0.18 not signed: https://api.github.com/repos/adventuregamestudio/ags/releases/225464844","Warn: release artifact v3.6.2.11 not signed: https://api.github.com/repos/adventuregamestudio/ags/releases/225361001","Warn: release artifact v3.6.2.10 not signed: https://api.github.com/repos/adventuregamestudio/ags/releases/219294410","Warn: release artifact v4.0.0.19 does not have provenance: https://api.github.com/repos/adventuregamestudio/ags/releases/233704494","Warn: release artifact v3.6.2.12 does not have provenance: https://api.github.com/repos/adventuregamestudio/ags/releases/233650081","Warn: release artifact v4.0.0.18 does not have provenance: https://api.github.com/repos/adventuregamestudio/ags/releases/225464844","Warn: release artifact v3.6.2.11 does not have provenance: https://api.github.com/repos/adventuregamestudio/ags/releases/225361001","Warn: release artifact v3.6.2.10 does not have provenance: https://api.github.com/repos/adventuregamestudio/ags/releases/219294410"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Pinned-Dependencies","score":1,"reason":"dependency not pinned by hash detected -- score normalized to 1","details":["Info: Possibly incomplete results: error parsing shell code: a command can only contain words and redirects; encountered (: ci/windows/Dockerfile:4","Info: Possibly incomplete results: error parsing shell code: a command can only contain words and redirects; encountered (: ci/windows/Dockerfile:71-82","Info: Possibly incomplete results: error parsing shell code: a command can only contain words and redirects; encountered (: Editor/AGS.Editor/Resources/agsdefns.sh:0","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yml:31: update your workflow using https://app.stepsecurity.io/secureworkflow/adventuregamestudio/ags/build.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:57: update your workflow using https://app.stepsecurity.io/secureworkflow/adventuregamestudio/ags/build.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yml:59: update your workflow using https://app.stepsecurity.io/secureworkflow/adventuregamestudio/ags/build.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:78: update your workflow using https://app.stepsecurity.io/secureworkflow/adventuregamestudio/ags/build.yml/master?enable=pin","Warn: containerImage not pinned by hash: ci/android/Dockerfile:1: pin your Docker image by updating ghcr.io/cirruslabs/android-sdk:34-ndk to ghcr.io/cirruslabs/android-sdk:34-ndk@sha256:8f3fb92fc5c21ee8b9cfe560947ecd0ded39c1b0df7d20d937b8217c8c57c49b","Warn: containerImage not pinned by hash: ci/emscripten/Dockerfile:3: pin your Docker image by updating ubuntu:noble to ubuntu:noble@sha256:7c06e91f61fa88c08cc74f7e1b7c69ae24910d745357e0dfe1d2c0322aaf20f9","Warn: containerImage not pinned by hash: ci/linux/Dockerfile:3","Warn: containerImage not pinned by hash: ci/windows/Dockerfile:2: pin your Docker image by updating ghcr.io/ericoporto/min-ags-dev-env:2.0.16 to ghcr.io/ericoporto/min-ags-dev-env:2.0.16@sha256:7685e58874307fc97dca51f3d2f8b07ea00fd86a98db559cf818a866cfc0d821","Warn: chocoCommand not pinned by hash: ci/windows/Dockerfile:18-22","Warn: chocoCommand not pinned by hash: ci/windows/Dockerfile:18-22","Info:   0 out of   2 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   2 third-party GitHubAction dependencies pinned","Info:   0 out of   4 containerImage dependencies pinned","Info:   0 out of   2 chocoCommand dependencies pinned","Info:   1 out of   1 nugetCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'","Warn: branch protection not enabled for branch 'ags4'","Warn: branch protection not enabled for branch 'release-3.6.2'","Warn: branch protection not enabled for branch 'release-3.6.1'","Warn: branch protection not enabled for branch 'release-3.6.0'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 13 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-16T15:40:31.178Z","repository_id":3546658,"created_at":"2025-08-16T15:40:31.178Z","updated_at":"2025-08-16T15:40:31.178Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31311129,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":[],"created_at":"2024-08-03T13:01:00.253Z","updated_at":"2026-04-02T17:06:23.561Z","avatar_url":"https://github.com/adventuregamestudio.png","language":"C++","funding_links":[],"categories":["C++","Game Engines"],"sub_categories":["Specialty"],"readme":"\u003cp align=center\u003e\n  \u003cimg src=\"https://avatars.githubusercontent.com/u/1833326\" width=96\u003e\u003c/br\u003e\n  \u003ca target=\"_blank\" href=\"https://cirrus-ci.com/github/adventuregamestudio/ags\" title=\"Build Status\"\u003e\u003cimg src=\"https://api.cirrus-ci.com/github/adventuregamestudio/ags.svg\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n  \n# Adventure Game Studio\n\nAdventure Game Studio (AGS) - is the IDE and the engine meant for creating and running videogames of adventure (aka \"quest\") genre. Created by Chris Jones back in 1999, AGS was open-sourced in 2011. Since then continues to be developed by contributors. Both Editor and Engine are licensed under the Artistic License 2.0; for more details see [License.txt](License.txt). \n\nFor community forums, games and more, go to the website: [www.adventuregamestudio.co.uk](https://www.adventuregamestudio.co.uk)\n\nThe latest stable version of AGS Editor may be found here: [https://www.adventuregamestudio.co.uk/site/ags/](https://www.adventuregamestudio.co.uk/site/ags/)\n\nFor the full list of releases, both stable, betas and others, see our repository's [Releases page](https://github.com/adventuregamestudio/ags/releases).\n\nPlease be aware that, unlike the runtime engine, AGS Editor is only supported on MS Windows (and Windows emulators such as WINE).\n\n\n## Branches and releases\n\nThe [`master`][master-br] branch is where the next planned version is being developed. It may temporarily contain unstable or untested code.\n\nCurrently, `master` corresponds to 3.\\* generation of the engine/IDE and maintains backward compatibility with previous releases - see also [Compatibility](#ags-game-compatibility). According to current plans, this branch should only receive improvements to the backend, system support, and performance. Changes to data formats and game script should be kept to a strict minimum necessary to fill in the critical gaps in the engine's functionality.\n\nThere's an [`ags4`][ags4-br] branch also active where we develop a future version AGS 4.0. There we introduce greater changes and cut much of the old version support.\n\nAccording to our plans, in the future `master` branch will be merged with `ags4`, while the backward compatible generation will remain as the `ags3` branch and only receive fixes and minor enhancements. But there's still some work to do in AGS 3.\\*, so the exact moment that happens is unknown.\n\nFor \"official\" releases we create `release-X.X.X` branches, that is to prepare the code for the final release and continue making patches to that release if a need arises. \n\nBecause of the low number of active developers we tend to only update the one latest release branch. If bugs are found in one of the older versions, then we advise you to update to the latest version first.\n\nPlease note that while the `master` branch may contain changes to game data format and new script functions, we cannot guarantee that these will remain unchanged until the actual release. We only support data formats and script APIs that are in published releases. For that reason, it's best to use one of the actual releases if you'd like to make your own game with this tool.\n\nThere may be other temporary development branches meant for preparing and testing large changes, but these are situational.\n\n## Building and running\n\nTo get started building the AGS engine, see the platform-specific instructions or forum threads:\n\n- [CMAKE](CMAKE.md) - this readme covers the centralized build system using CMake\n- [Android](Android/README.md) ([Forum thread](https://www.adventuregamestudio.co.uk/forums/index.php?topic=59751.0))\n- [iOS](iOS/README.md) ([Forum thread](https://www.adventuregamestudio.co.uk/forums/index.php?topic=46040.0))\n- [Linux](debian/README.md) ([Forum thread](https://www.adventuregamestudio.co.uk/forums/index.php?topic=59750.0))\n- [Mac OS X](OSX/README.md) ([Forum thread](https://www.adventuregamestudio.co.uk/forums/index.php?topic=47264.0))\n- [Windows](Windows/README.md)\n- [Emscripten Web port](Emscripten/README.md) ([Forum thread](https://www.adventuregamestudio.co.uk/forums/index.php?topic=59164.0))\n\nNo longer actively supported, but may work with older code revisions:\n-    [PSP](PSP/README.md) ([Forum thread](https://www.adventuregamestudio.co.uk/forums/index.php?topic=43998.0))\n\nOn desktop systems launching a game is done by either placing an engine executable in the same directory where the game data is and starting the engine up or passing game location as a command-line argument.\n\nFor Android, we have a game launcher app that may run any game, but it's also possible to make a signed APK for your own game (see instructions linked above).\n\nGame configuration is usually found in the `acsetup.cfg` file. On Windows you may also invoke a setup dialog by running the engine with `--setup` argument.\n\nFor the list of available config options and command-line arguments, please refer to [OPTIONS.md](OPTIONS.md).\n\nAGS Editor is currently only supported on Windows, although it may be run using Wine on Linux and OSX.\n\n\n## AGS game compatibility\n\nThis repository now holds two generations of AGS, referred to as \"AGS 3\" and \"AGS 4\".\n\n**The 3rd generation** of AGS may be currently found in the `master` branch (also `ags3`). Its specifics are:\n\n- Supports (imports into the editor and runs by the engine) all versions of AGS games made with AGS 2.50 and up. Note that there may still be compatibility issues with very old games that were not uncovered and fixed yet.\n\n- If you try to run an unsupported game, you will receive an error message reporting the original version of AGS it was made in and data format index, which may be used for reference e.g. when reporting the problem.\n\n- Game saves are compatible between the different platforms if they are created with the same version of the engine. Latest 3.\\* engine should normally read saves made by engine 3.2.0 and above, but that has not been tested for a while.\n\n- Certain games may require engine plugins. If there's no plugin version for a particular platform or a platform-independent replacement, then the game will not load on that platform.\n\n- As of AGS 3.6.0 the Windows engine no longer supports playing **AVI/MPG videos**. The decision to drop this feature was made while moving to a new SDL2 backend, primarily because its implementation was based on using DirectShow interface (Windows-only) and relied on codecs installed on player's system. Other ports were not supporting this ever. If the game tries to play such video, it will simply be skipped. The existing workaround is to convert the avi/mpg video file to OGV, while keeping the full original filename (*including the extension!*): then this file will be instead opened by the integrated OGV player.\n\n**The 4th generation** is found in [`ags4`][ags4-br] branch. It formally supports importing games made with AGS 3.4.1 and above, but only if these do not use any legacy features. The 4.x engine should be able to read saves made with the 3.5.0 engine and above.\n\n\n## Other repositories\n\nThere are other repositories which contain additional resources and may be of interest to you:\n\n- [ags-manual](https://github.com/adventuregamestudio/ags-manual) - holds AGS documentation.\n\n- [ags-templates](https://github.com/adventuregamestudio/ags-templates) - this is where compiled game templates are uploaded in preparation for the Editor's release.\n\n- [ags-template-source](https://github.com/adventuregamestudio/ags-template-source) - this is where template sources are developed - these are essentially AGS game projects.\n\n\n## Contributing\n\nIf you would like to contribute to the project, please read the [CONTRIBUTING.md](CONTRIBUTING.md). Below is a brief summary of the process.\n\n* For the bug fixes or minor code improvements, you need only create a fork of the repository, commit your changes to a branch, and submit a pull request. We will review your commits and may ask you to make alterations to your code if needed before merging it into our repository.\n\n* For new features or other larger contributions, please first open an issue in the [Issue Tracker](https://github.com/adventuregamestudio/ags/issues). There we can discuss the proposed changes with the development team to ensure that they will be consistent with existing program behavior and future development plans.\n\nWe may also accept patch files if you send them to one of the project maintainers.\n\n## Changes from Chris Jones' version of AGS\n\nThis version of AGS contains changes from the version published by Chris Jones. The run-time engine was ported to Android, iOS, Linux, Mac OS X, and PSP and a refactoring effort is underway. Detailed documentation of the changes is provided in the form of the git log of this git repository ([github.com/adventuregamestudio/ags](https://github.com/adventuregamestudio/ags)).\n\n\n## Credits\n\n[Link](Copyright.txt)\n\n[master-br]: https://github.com/adventuregamestudio/ags/tree/master\n[ags4-br]: https://github.com/adventuregamestudio/ags/tree/ags4\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadventuregamestudio%2Fags","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadventuregamestudio%2Fags","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadventuregamestudio%2Fags/lists"}