{"id":26932488,"url":"https://github.com/arbitroy/z-fighters","last_synced_at":"2025-04-02T08:26:56.944Z","repository":{"id":284034992,"uuid":"953612414","full_name":"arbitroy/Z-Fighters","owner":"arbitroy","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-31T14:39:56.000Z","size":18639,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-31T16:02:52.490Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/arbitroy.png","metadata":{"files":{"readme":"readme.md","changelog":null,"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":"2025-03-23T18:52:20.000Z","updated_at":"2025-03-31T14:39:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"e2a4bf36-a7f7-4fc8-a359-a3d18178f97f","html_url":"https://github.com/arbitroy/Z-Fighters","commit_stats":null,"previous_names":["arbitroy/z-fighters"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arbitroy%2FZ-Fighters","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arbitroy%2FZ-Fighters/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arbitroy%2FZ-Fighters/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arbitroy%2FZ-Fighters/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arbitroy","download_url":"https://codeload.github.com/arbitroy/Z-Fighters/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246780283,"owners_count":20832562,"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":[],"created_at":"2025-04-02T08:26:55.719Z","updated_at":"2025-04-02T08:26:56.922Z","avatar_url":"https://github.com/arbitroy.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Zombie Fighters\n\nA simple 2D zombie shooting game built with Pygame.\n\n## Project Structure\n\n- `main.py` - The main entry point for the game\n- `game_states.py` - Manages different game states (menu, gameplay, etc.)\n- `player.py` - Player character with movement and shooting mechanics\n- `projectile.py` - Projectiles fired by the player\n- `enemy.py` - Zombie enemy classes\n- `level.py` - Level design and platforms\n- `menu.py` - Menu system (can be run standalone or as part of main.py)\n\n## Controls\n\n- **W/A/S/D** - Move player (up, left, down, right)\n- **Space** - Jump\n- **Left Mouse Button** - Shoot\n- **ESC** - Pause game / Return to previous menu\n\n## Game Features\n\n- State management system for menus, gameplay, pause, and game over\n- Enhanced menu with level selection\n- Player movement, jumping, and shooting mechanics\n- Zombie enemies that follow the player\n- Wave-based enemy spawning\n- Health, scoring, and wave counter systems\n- Basic collision detection\n- Simple placeholder graphics (rectangles and circles)\n\n## How to Run\n\n1. Ensure you have Python and Pygame installed\n2. Run the game with: `python main.py`\n3. Alternatively, you can run just the menu with: `python menu.py`\n\n## Development Roadmap\n\nThis project is following the development plan outlined in \"Zombie Fighters - Development Plan.txt\".\n\nCurrent status:\n- [x] Project Setup and Framework\n- [x] Menu System Enhancement\n- [x] Core Player Mechanics\n- [x] Basic Enemy System\n- [x] Simple Level Design\n- [x] Game Systems (health, score, waves)\n- [x] Basic UI Elements\n- [x] State Integration\n- [ ] Visual Enhancements (placeholders used for now)\n- [ ] Testing and Refinement\n- [x] Documentation\n\n## Next Steps\n\nThe next phase of development should focus on:\n1. Replacing placeholder graphics with sprites\n2. Adding animations\n3. Enhancing level design\n4. Balancing difficulty\n5. Adding sound effects and music\n6. Testing and fixing bugs\n\n## Requirements\n\n- Python 3.x\n- Pygame library\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farbitroy%2Fz-fighters","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farbitroy%2Fz-fighters","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farbitroy%2Fz-fighters/lists"}