{"id":13820686,"url":"https://github.com/tom-mohr/particle-life-app","last_synced_at":"2025-05-15T04:02:55.520Z","repository":{"id":65272603,"uuid":"457123607","full_name":"tom-mohr/particle-life-app","owner":"tom-mohr","description":"🦠 Simulator for a particle system showing life-like behaviour.","archived":false,"fork":false,"pushed_at":"2024-12-19T10:48:53.000Z","size":626,"stargazers_count":852,"open_issues_count":6,"forks_count":75,"subscribers_count":16,"default_branch":"main","last_synced_at":"2025-04-06T23:11:30.599Z","etag":null,"topics":["artificial-life","java","multiagent-systems","particle-life","particle-system"],"latest_commit_sha":null,"homepage":"http://particle-life.com","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tom-mohr.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}},"created_at":"2022-02-08T22:22:58.000Z","updated_at":"2025-03-31T14:31:59.000Z","dependencies_parsed_at":"2023-01-16T03:45:24.165Z","dependency_job_id":"384976b3-be02-4212-a72c-12a81c3789a8","html_url":"https://github.com/tom-mohr/particle-life-app","commit_stats":{"total_commits":103,"total_committers":7,"mean_commits":"14.714285714285714","dds":0.2038834951456311,"last_synced_commit":"4b49898e211defc4c69694ec628918e6b55e1802"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tom-mohr%2Fparticle-life-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tom-mohr%2Fparticle-life-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tom-mohr%2Fparticle-life-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tom-mohr%2Fparticle-life-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tom-mohr","download_url":"https://codeload.github.com/tom-mohr/particle-life-app/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248819380,"owners_count":21166477,"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":["artificial-life","java","multiagent-systems","particle-life","particle-system"],"created_at":"2024-08-04T08:01:07.215Z","updated_at":"2025-04-14T03:58:50.619Z","avatar_url":"https://github.com/tom-mohr.png","language":"Java","funding_links":[],"categories":["Java"],"sub_categories":[],"readme":"# 🦠 Particle Life App\n\nA GUI for the [Particle Life Framework](https://github.com/tom-mohr/particle-life).\n\n- [Download](https://particle-life.com) (.exe for Windows)\n- [Documentation](https://particle-life.com/docs)\n\nJoin the [Discord server](https://discord.gg/Fd64AhKzMD)!\n\n![Screenshot of the App](./readme_assets/app_demo.png)\n\n## Run This App From Source\n\nYou can easily run this app from the source code.\n\nFirst, check that you have\n\n- [Git](https://git-scm.com/downloads) installed.\n- [Java](https://jdk.java.net/19/) installed, with a version of at least 16 and at most 22. (Check your version with `java -version`.)\n\nThen, download the source code:\n```bash\ngit clone https://github.com/tom-mohr/particle-life-app.git\n```\n\nTo run the program, make sure that you navigate into the folder:\n```bash\ncd particle-life-app\n```\n\nThen start the program:\n```bash\n./gradlew run\n```\n\nAfter some time, the program should launch and you should see particles on your screen.\nFeel free to mess with the code!\n\n## Troubleshooting\n\nIf you encounter any problems, ask for help in the [`#tech-support`](https://discord.gg/EVG8XnCn3U) channel on the Discord server.\n\n* `Unsupported class file major version 67` (or similar).\u003cbr\u003e\n  This happens when your installed Java version is higher than 22.\n  Check your current Java version with `java -version`.  You need to uninstall Java and install a version between 16 (including) and 22 (including).\n  Make sure that after installing the new Java version, `java -version` actually outputs the installed version.\n  Restarting the computer sometimes helps.\n\n## How to make a release\n\n- Confirm that everything is working correctly and check in with others that the current state of the main branch is ready for release.\n- Run `./gradlew zipApp` from the project root.\n  This generates the zip file `particle-life-app.zip` in `./build/zipApp/`. It includes the Windows executable (`.exe`) along with other files.\n- Go to the [Releases](https://github.com/tom-mohr/particle-life-app/releases) section of this GitHub repo and click `Draft a new release`.\n- Click `Choose a tag` and type the new version name:\n  - Prefix the version name with the letter `v`. Some good tag names might be `v1.0.0` or `v2.3.4`.\n  - The version name should comply with [semantic versioning](https://semver.org/). Talk to others if you are unsure about what to choose here.\n- Click `Create a new tag`.\n- Set the release title to match the tag name.\n- Use the description to summarize the changes of all commits since the last release.\n- Add the generated `particle-life-app.zip` as an asset to the release.\n- Click `Publish release`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftom-mohr%2Fparticle-life-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftom-mohr%2Fparticle-life-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftom-mohr%2Fparticle-life-app/lists"}