{"id":19409537,"url":"https://github.com/constance012/silly_ninja","last_synced_at":"2026-02-25T13:37:04.583Z","repository":{"id":232023376,"uuid":"783272917","full_name":"constance012/Silly_Ninja","owner":"constance012","description":"A multiplayer co-op platformer made with Pygame. Networking implemented with Socket","archived":false,"fork":false,"pushed_at":"2024-06-02T04:43:11.000Z","size":38929,"stargazers_count":2,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-12T13:59:53.596Z","etag":null,"topics":["2d","game","game-2d","game-development","gamedev","multiplayer","multiplayer-game","networking","networking-in-python","pixel-art","python","python3","socket","socket-programming"],"latest_commit_sha":null,"homepage":"","language":"Python","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/constance012.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2024-04-07T12:35:58.000Z","updated_at":"2024-08-05T05:14:15.000Z","dependencies_parsed_at":"2024-06-02T05:44:56.134Z","dependency_job_id":null,"html_url":"https://github.com/constance012/Silly_Ninja","commit_stats":null,"previous_names":["constance012/silly_ninja"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/constance012%2FSilly_Ninja","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/constance012%2FSilly_Ninja/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/constance012%2FSilly_Ninja/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/constance012%2FSilly_Ninja/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/constance012","download_url":"https://codeload.github.com/constance012/Silly_Ninja/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247455369,"owners_count":20941694,"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":["2d","game","game-2d","game-development","gamedev","multiplayer","multiplayer-game","networking","networking-in-python","pixel-art","python","python3","socket","socket-programming"],"created_at":"2024-11-10T12:11:50.451Z","updated_at":"2025-10-30T05:45:04.498Z","avatar_url":"https://github.com/constance012.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SILLY NINJA - MULTIPLAYER CO-OP GAME\n\n## DESCRIPTION\nYou're a ninja on a land full of bad guys, but even worse, they're armed with guns. You have nothing but your own ninja spirit, can that be a weapon to deal with them? Or perharps, bring over some of your fellow ninjas could be a good option to consider.\n\nA _multiplayer_, _co-op_ game made with __Pygame__, networking was made possible with __Socket__, assets credit goes to _DaFluffyPotato_.\n\n## CONTROLS\n### Game:\n- A, Left Arrow: Move to the left\n- D, Right Arrow: Move to the right\n- Space, Up Arrow: Jump\n- L.Shift, R.Shift: Dash/Attack\n- ESC: Back out\n### Map Editor:\n- W, A, S, D or Arrow Keys: Pan the camera around\n- Left Click: Place tiles at the mouse position\n- Right Click: Delete tiles at the mouse position\n- G: Toggle snap to grid\n- Scroll Wheel: Circle tile groups\n- Shift + Scroll Wheel: Circle tile variant within current group\n- Ctrl + S: Save current map\n- Ctrl + R: Auto-format placed ruled tiles\n- ESC: Exit edit mode\n\n## REQUIRED EXTERNAL MODULES\nInstall modules by the command `python -m pip install [module_name]` or `python3 -m pip install [module_name]`.\n- pygame\n- PyInstaller\n- pyperclip\n- gtk (Linux only)\n- PyQt4 (Linux only)\n\n## INSTALLATION\n### From Source\n- Clone the repo with `git clone https://github.com/constance012/Silly_Ninja.git`.\n- Install all required modules from the above section.\n- Navigate to `Silly Ninja\\assets\\fonts` and install all required fonts.\n- Run these following commands:\n```\ncd Silly_Ninja/‘Silly Ninja’\nFor Windows: python silly_ninja.py\nFor Linux: python3 silly_ninja.py\n```\n### From Executables (Windows only for now)\n- Download the [___lastest release___](https://github.com/constance012/Silly_Ninja/releases).\n- Extract the content.\n- Navigate to the `fonts` folder and install all required fonts.\n- If you want to open the map editor, go to `executables/map_editor_win_x64` and run `map_editor.exe`.\n- For the game, go to `executables/silly_ninja_win_x64` and run `silly_ninja.exe`.\n \n## MULTIPLAYER INSTRUCTION\nBecause the game only supports multiplayer through Local Area Network (LAN), there're couple of ways to establish connections and play with your friends:\n- You and your friends must be on the same network or Wifi, so that the host's IP can be discovered by other clients.\n- Using third party software that provide the ability to create your own virtual networks, such as _Hamachi_, _RadminVPN_ or _ZeroTier_,... just to name a few. Then you and your friend can join the same network and establish connection. This is actually the prefer method because y'all can connect to each other from anywhere on the globe, as long as your device remain in that said virtual network.\n\nAfter that, open the game and press the `Join` or `Host` button, depends on your situation:\n- For the host, enter local IP on your network to the `IP` field, and enter a port number to the `Port` field (must be greater than 1000). After that, choose a nickname and press `Start`, you'll be in the lobby if the server starts successfully.\n- For the client, enter the Host's IP and port to both fields. After that, pick a nickname and press `Join`, you'll be in the lobby if the connection establishes successfully.\n- After all clients have joined the lobby and ready, indicates by their slots borders turn green, the Host then can start the game by pressing the `Launch` button.\n\n## KNOWN ISSUES\n- Levels are currently be order by ID as an integer. So when you create a new level using the Map Editor, its ID must be an integer that goes after the last level in the `assets/maps` folder, otherwise the game will crashes on level transitions.\n- Levels are __NOT__ synced between machines on multiplayer mode, so if you make a new level or delete an existing one using the Map Editor. Then those new changes won't be shared across multiple devices in multiplayer mode, resulting in weird behaviors or even crashes during runtime. This issue has been acknowledged by us and will be fixed on future update. The current workaround is to have the host send his level files to all the clients before hosting a session.\n\n## NOTES\n- Ensure that all required libraries, modules are installed if you want to compile and run the game directly from source.\n- For executables, only the fonts are required.\n\n## CREDITS\nSpecial thanks to [___DaFluffyPotato___](https://www.youtube.com/@DaFluffyPotato) for the gorgeous image assets and audio.\n\n## CONTRIBUTIONS\n@Hikiyoshi - Programmer, Tester, Level Design.  \n@constance012 - Programmer, Networking, UI Design.\n\n## IN GAME CAPTURES\n![Main Menu](https://private-user-images.githubusercontent.com/96867270/331322071-fd2297b5-96d2-4295-a5b2-c379cd95bbae.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MTU5Mjg1ODQsIm5iZiI6MTcxNTkyODI4NCwicGF0aCI6Ii85Njg2NzI3MC8zMzEzMjIwNzEtZmQyMjk3YjUtOTZkMi00Mjk1LWE1YjItYzM3OWNkOTViYmFlLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA1MTclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwNTE3VDA2NDQ0NFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTQwMTEzMzdkMDNmYTZjY2RlZWFiMDcwZmJmOGFiNzI0Mjk3MjFhN2EzZGIzMzI3NjM5MzllMmZiOTJiNTA0MzImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.SO71XJMyowEFEOrW6aiBVu96MoTp70aUoU63SA7zrPI)  \n![In Game](https://private-user-images.githubusercontent.com/96867270/331322655-547c06de-fefa-4a28-b791-44b873f484e3.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MTU5Mjg1ODQsIm5iZiI6MTcxNTkyODI4NCwicGF0aCI6Ii85Njg2NzI3MC8zMzEzMjI2NTUtNTQ3YzA2ZGUtZmVmYS00YTI4LWI3OTEtNDRiODczZjQ4NGUzLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA1MTclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwNTE3VDA2NDQ0NFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTU4OWYwOTkyNDQ5NDM0MGFhNmU1NTdmYWZhYjM4ZGU0NmY3ZWVjODMxOTc0OWFkMzIyMmMzMWE2ZTNlOWRiMTkmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.eo7fj2nDd5W88Df_wnM734AMFKJRahQi6j-9Z07iQYs)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconstance012%2Fsilly_ninja","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fconstance012%2Fsilly_ninja","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconstance012%2Fsilly_ninja/lists"}