{"id":26367277,"url":"https://github.com/rickelmedias/bomberonline","last_synced_at":"2026-04-20T13:02:19.820Z","repository":{"id":279308398,"uuid":"938336941","full_name":"rickelmedias/BomberOnline","owner":"rickelmedias","description":"An Online Bomberman clone using Phaser with Typescript for client and FastAPI with Python for server.","archived":false,"fork":false,"pushed_at":"2025-03-14T21:40:56.000Z","size":766,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-14T22:28:34.577Z","etag":null,"topics":["design-patterns","fastapi","phaserjs","solid","websocket"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/rickelmedias.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-02-24T19:46:29.000Z","updated_at":"2025-03-14T21:41:00.000Z","dependencies_parsed_at":"2025-02-24T23:19:10.107Z","dependency_job_id":"d9680b5e-531d-4682-bf43-e4bdc70ed66b","html_url":"https://github.com/rickelmedias/BomberOnline","commit_stats":null,"previous_names":["rickelmedias/bomberonline"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rickelmedias%2FBomberOnline","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rickelmedias%2FBomberOnline/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rickelmedias%2FBomberOnline/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rickelmedias%2FBomberOnline/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rickelmedias","download_url":"https://codeload.github.com/rickelmedias/BomberOnline/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243933456,"owners_count":20370988,"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":["design-patterns","fastapi","phaserjs","solid","websocket"],"created_at":"2025-03-16T21:16:04.954Z","updated_at":"2026-04-20T13:02:14.777Z","avatar_url":"https://github.com/rickelmedias.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bomberman Online\n\nBomberman Online is an educational project that implements an online Bomberman clone. The application consists of a client built with TypeScript and Phaser, and a server developed in Python using FastAPI.\n\n\u003e **Note:**  \n\u003e The spritesheets were obtained from [Spriters Resource](https://www.spriters-resource.com/nes/bomberman/) and the BetterVCR font from [Dafont](https://www.dafont.com/better-vcr.font). This project is for educational purposes only and is not intended for commercial use. Proper credit to the original rights holders is recommended.\n\n\n## Youtube Overview\n\n[![BomberOnline Youtube Overview](https://img.youtube.com/vi/oLfkm_ia6xI/0.jpg)](https://www.youtube.com/watch?v=oLfkm_ia6xI)\n\n---\n\n## Getting Started\n\nThe project is organized into two main directories:\n\n- **[bomberman-client](./bomberman-client/):** Contains the client application (TypeScript/Phaser).\n- **[bomberman-server](./bomberman-server/):** Contains the server application (Python/FastAPI).\n\nA `docker-compose.yml` file at the root of the project allows you to run both the client and server together with a single command:\n\n```bash\ndocker-compose up --build\n```\n\n---\n\n## Overview\n\nA demonstration video is included in the repository – please see the video below for a walkthrough of the project.\n\nFor more detailed information about each component, please refer to the individual README files in the `bomberman-client` and `bomberman-server` directories.\n\n##### Setting Enviroment _(Terminal)_\n- [x] __Feat__: Setting up __Typescript__ | __Nodejs__ | __Phaser__\n- [x] __Feat__: Setting up __Python__ Environment | __FastAPI__\n\n##### Typescript Development _(Code .ts)_\n- [x] __Feat__: Develop game using Typescript with _Phaser_ _(GameScene.ts)_\n    - [x] __Feat__: Grid Based Movement _(Player.ts)_\n    - [x] __Feat__: Grid Bomb Placement _(Bomb.ts)_\n    - [x] __Feat__: Explosion Propagation _(Explosion.ts)_\n    - [x] __Feat__: Collision Objects _(Box.ts, Block.ts)_\n    - [x] __Feat__: Explosion Destroy _Box.ts \u0026 Player.ts_\n- [x] __Bug Fix__: Collision not working properly\n    - [x] __Feat__: Develop Debug Boxes to Understand the Collision better\n    - [x] __Fix__: Check collisions and Fix the Code\n\n##### Python Development  _(Code .py)_\n- [x] __Feat__: Develop game server using Python with _FastAPI_\n    - [x] __Feat__: Websockets for Communication between players \n    - [x] __Feat__: Join Handle to control the room, because to play is needed two players looking match in the same room code _(join)_\n    - [x] __Feat__: Spawn Handle to control the spawn of Players _(request_spawns)_\n    - [x] __Feat__: Develop more handles for all the game actions _(move, place bomb, bomb explosion, die)_\n\n##### Integrations Client/Server and Improvements _(Code)_\n- [x] __Feat__: Integration between Client _(Typescript game)_ and Server _(Python FastAPI server)_\n    - [x] __Feat__: Create a custom lobby to search a match usign username and room code\n    - [x] __Refactor__: Refactoring of the Code for both thinking about the Modularization and Good Practices\n    - [x] __Refactor__: Use of Modularization, Design Pattern and SOLID to improve the code separating big code with a lot of responsabilities in modules _(specially the GameScene.ts that was doing a lot of things)_\n    - [x] __Feat__: Develop handlers to exchange informations between clients using the server _(websocket)_\n\n##### Visual Improvements  _(Code)_\n- [x] __Feat__: Improve the Design of the Game and Lobby\n    - [x] __Feat__: Search for Sprites, Load and Create\n    - [x] __Feat__: Change the Entities Code to be a Sprite instead Blocks\n    - [x] __Refactor__: Improve the Lobby code\n    - [x] __Feat__: Design and Develop full custom Lobby\n\n##### Final Step _(Clean Code)_\n- [x] __Feat__: Fine-tuning on Client and Server for more Modularization, Code Cleaner and some short implementations\n- [x] __Test__: Tests and Validations\n\n##### Infrastructure _(Docker)_\n- [x] __Feat__: Containerization of Client and Server\n    - [x] __Feat__: Nginx (Client)\n    - [x] __Feat__: Nodejs (Client)\n    - [x] __Feat__: Python (Server)\n- [x] __Test__: Test Containers Running Manually and Separated\n- [x] __Feat__: Docker-compose.yaml to run easilly both applications integrated\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frickelmedias%2Fbomberonline","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frickelmedias%2Fbomberonline","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frickelmedias%2Fbomberonline/lists"}