{"id":51639800,"url":"https://github.com/kai9987kai/interactive-agents","last_synced_at":"2026-07-13T18:03:14.159Z","repository":{"id":364140618,"uuid":"1266578432","full_name":"kai9987kai/interactive-agents","owner":"kai9987kai","description":"An experimental browser-based agent simulation where autonomous creatures survive, reproduce, fight threats, navigate complex polygon obstacles, and react to changing environmental events. The simulation also includes a playable commander agent so the user can directly interact with the ecosystem in real time.","archived":false,"fork":false,"pushed_at":"2026-06-11T19:14:30.000Z","size":22,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-11T21:08:30.079Z","etag":null,"topics":["browser-based","experimental","simulation"],"latest_commit_sha":null,"homepage":"https://www.kai9987kai.co.uk/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kai9987kai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-11T18:49:56.000Z","updated_at":"2026-06-11T19:14:34.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kai9987kai/interactive-agents","commit_stats":null,"previous_names":["kai9987kai/interactive-agents"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/kai9987kai/interactive-agents","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kai9987kai%2Finteractive-agents","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kai9987kai%2Finteractive-agents/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kai9987kai%2Finteractive-agents/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kai9987kai%2Finteractive-agents/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kai9987kai","download_url":"https://codeload.github.com/kai9987kai/interactive-agents/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kai9987kai%2Finteractive-agents/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35430963,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-13T02:00:06.543Z","response_time":119,"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":["browser-based","experimental","simulation"],"created_at":"2026-07-13T18:03:13.319Z","updated_at":"2026-07-13T18:03:14.153Z","avatar_url":"https://github.com/kai9987kai.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Advanced Playable Multi-Agent Ecosystem\n\nAn experimental browser-based agent simulation where autonomous creatures survive, reproduce, fight threats, navigate complex polygon obstacles, and react to changing environmental events. The simulation also includes a playable commander agent so the user can directly interact with the ecosystem in real time.\n\n## Overview\n\nThis project expands a simple multi-agent canvas simulation into a more interactive ecosystem sandbox. Agents move independently, collect food, avoid or fight threats, reproduce, and respond to events. The player controls a stronger commander-style agent that can shoot, shield, rally nearby agents, and place beacons.\n\nThe whole project runs from a single HTML file, making it easy to test, modify, upload, or host on GitHub Pages.\n\n## Features\n\n* Playable commander agent with movement, aiming, shooting, shield pulse, rally command, and beacon placement.\n* Autonomous AI agents that wander, seek food, avoid danger, reproduce, and follow rally signals.\n* Threat enemies that hunt agents and the player, including stronger boss-style enemies during events.\n* Projectile combat with collision detection, damage, particles, and score tracking.\n* Complex random polygon obstacles instead of simple circles, with collision handling.\n* Environmental zones, including water, forest, radiation, and thermal areas.\n* Random world events, such as meteor showers, electric storms, blood moon attacks, healing rain, resource blooms, and gravity rifts.\n* Dynamic HUD showing agents, threats, food, player health, energy, and score.\n* Interactive controls panel for reset, pause, event triggering, ally spawning, speed, and event rate.\n* Mini-map for quickly viewing the world state.\n* Touch support for mobile-style interaction.\n* No external libraries required.\n\n## Controls\n\n| Action               | Input                  |\n| -------------------- | ---------------------- |\n| Move player          | `WASD` or arrow keys   |\n| Aim                  | Mouse movement         |\n| Shoot                | Left mouse click / tap |\n| Shield pulse         | `Space`                |\n| Rally nearby agents  | `E`                    |\n| Drop rally beacon    | `F`                    |\n| Pause simulation     | Pause button           |\n| Trigger random event | Trigger Event button   |\n| Spawn extra allies   | Spawn Allies button    |\n| Reset simulation     | Reset button           |\n\n## How to Run\n\n1. Download or clone the project.\n2. Open `advanced_playable_agent_sim.html` in any modern browser.\n3. Move the commander agent with `WASD` or arrow keys.\n4. Aim with the mouse and click to shoot threats.\n5. Use rally and beacon abilities to influence the swarm.\n\nNo build tools, server, package manager, or installation steps are required.\n\n## Gameplay Goal\n\nThere is no fixed win screen. The aim is to survive, protect the agent population, collect score by destroying threats, and manage the ecosystem through dangerous random events.\n\n## Ideas for Future Development\n\n* Add evolution traits that pass from parent agents to offspring.\n* Add team colours and agent roles such as healer, scout, defender, and builder.\n* Add a save/load system using `localStorage`.\n* Add a research mode with charts for population, deaths, reproduction, and threat pressure.\n* Add neural-network or reinforcement-learning behaviour for agents.\n* Add terrain editing tools so the player can draw walls, water, forests, and hazards.\n* Add sound effects and music-reactive events.\n* Add difficulty modes and challenge scenarios.\n\n## License\n\nThis project is open for learning, experimentation, remixing, and personal use. Add your preferred license file if publishing it as a public repository.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkai9987kai%2Finteractive-agents","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkai9987kai%2Finteractive-agents","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkai9987kai%2Finteractive-agents/lists"}