{"id":15938517,"url":"https://github.com/achoum/exploratron","last_synced_at":"2026-02-19T12:02:30.730Z","repository":{"id":106359055,"uuid":"505205811","full_name":"achoum/exploratron","owner":"achoum","description":"Exploratron is a open-source turn-by-turn sandbox puzzle game with multiple simple mechanics that interact with each other and create complex and interesting emergent gameplay situations.","archived":false,"fork":false,"pushed_at":"2022-12-26T10:01:45.000Z","size":5728,"stargazers_count":4,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-05T02:51:11.692Z","etag":null,"topics":["genetic-algorithm","machine-learning","puzzle","roguelike","sandbox","simulation"],"latest_commit_sha":null,"homepage":"https://achoum.github.io/exploratron","language":"C++","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/achoum.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2022-06-19T19:53:02.000Z","updated_at":"2022-09-17T18:11:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"a0fe719c-1f39-4049-b033-163a1458f768","html_url":"https://github.com/achoum/exploratron","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/achoum/exploratron","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achoum%2Fexploratron","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achoum%2Fexploratron/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achoum%2Fexploratron/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achoum%2Fexploratron/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/achoum","download_url":"https://codeload.github.com/achoum/exploratron/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achoum%2Fexploratron/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29612510,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-19T10:52:55.328Z","status":"ssl_error","status_checked_at":"2026-02-19T10:52:26.323Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6: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":["genetic-algorithm","machine-learning","puzzle","roguelike","sandbox","simulation"],"created_at":"2024-10-07T05:40:36.873Z","updated_at":"2026-02-19T12:02:30.715Z","avatar_url":"https://github.com/achoum.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Exploratron\n\n**Exploration** is a open-source turn-by-turn sandbox puzzle game with multiple simple mechanics that interact with each other and create complex and interesting emergent gameplay situations.\n\n![](docs/game.gif)\n\nExploration is compatible with Linux, Windows and Web browser (using Webassembly).\n\nYou can play the Web browser version [here](https://achoum.github.io/exploratron).\n\n## Compilation from source\n\nRequires _Bazel_.\n\nOn Web browser:\n\n```shell\n./tools/game_wasm.sh\n```\n\nOn Linux:\n\n```shell\n./tools/game_terminal.sh\n```\n\nOn Windows:\n\n```shell\ntools\\game_terminal.bat\n```\n\n## Map creation\n\nMaps are created using [Tiled](https://www.mapeditor.org/download.html). See examples in the `exploratron\\assets\\map` directory.\n\n## Agent training\n\nExploratron is also a framework to train and evaluate agent using Machine Learning.\n\n![](docs/agent_1.gif)\n\nRead, modify and and run `./tools/train_agent.sh` to train and evaluate agents.\n\nSome examples of commands (see `./tools/train_agent.sh` for details):\n\n```shell\n\nLOGDIR=$(pwd)/training_logs\n\nFLAG=\"--config=linux --define=terminal=linux_console\"\n\n# MODE=\"-c dbg\"\nMODE=\"-c opt\"\n\n# Run the evaluation on the \"Gather\" area using the Random controler (no leaning).\nbazel run $MODE --config=linux --define=terminal=linux_console //exploratron/cli:evaluate_main $FLAG -- \\\n    --arena=Gather --controller_key=Random --num_repetitions=100\n\n# Train and evaluate a genetic controller on the \"Gather\" area.\n# Hyper-parameters are available in `exploratron/controller/genetic/genetic.h`\nbazel run $MODE --config=linux //exploratron/controller/genetic:train_main $FLAG -- \\\n    --training_log_base=${LOGDIR}/gather/genetic/r1_\n\n# Train and evaluate a hill climbing controller on the \"Gather\" area.\n# Hyper-parameters are available in `exploratron/controller/hill_climb/hill_climb.h`\nbazel run $MODE --config=linux //exploratron/controller/hill_climbing:train_main $FLAG -- \\\n    --training_log_base=${LOGDIR}/gather/hill_climb/r1_\n\n# Run the evaluation on the \"Gather\" area using the keyboard controler (no leaning).\nbazel run $MODE --config=linux //exploratron/cli:evaluate_main $FLAG -- \\\n    --arena=Gather --controller_key=Keyboard\n```\n\nResults can be compared using the R scipe `./tools/plot_training_logs.R`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fachoum%2Fexploratron","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fachoum%2Fexploratron","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fachoum%2Fexploratron/lists"}