{"id":31618113,"url":"https://github.com/taka-rl/super_mario_py","last_synced_at":"2025-10-06T13:45:56.025Z","repository":{"id":317818447,"uuid":"986244986","full_name":"taka-rl/super_mario_py","owner":"taka-rl","description":"Super Mario style 2D Game (python + pygame)","archived":false,"fork":false,"pushed_at":"2025-10-03T09:07:19.000Z","size":245,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-03T09:20:49.716Z","etag":null,"topics":["game","hobby","hobby-project","mario","object-oriented-programming","oop","oops-in-python","pygame","python","super-mario","super-mario-python"],"latest_commit_sha":null,"homepage":"","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/taka-rl.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-19T10:18:56.000Z","updated_at":"2025-10-03T09:07:22.000Z","dependencies_parsed_at":"2025-10-03T09:21:14.890Z","dependency_job_id":"2c316fa3-df4d-46dc-a776-c559eedd6a08","html_url":"https://github.com/taka-rl/super_mario_py","commit_stats":null,"previous_names":["taka-rl/super_mario_py"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/taka-rl/super_mario_py","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taka-rl%2Fsuper_mario_py","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taka-rl%2Fsuper_mario_py/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taka-rl%2Fsuper_mario_py/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taka-rl%2Fsuper_mario_py/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/taka-rl","download_url":"https://codeload.github.com/taka-rl/super_mario_py/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taka-rl%2Fsuper_mario_py/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278621843,"owners_count":26017253,"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","status":"online","status_checked_at":"2025-10-06T02:00:05.630Z","response_time":65,"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":["game","hobby","hobby-project","mario","object-oriented-programming","oop","oops-in-python","pygame","python","super-mario","super-mario-python"],"created_at":"2025-10-06T13:45:51.625Z","updated_at":"2025-10-06T13:45:56.016Z","avatar_url":"https://github.com/taka-rl.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Super Mario style 2D game\n\n\nhttps://github.com/user-attachments/assets/a9a437cd-e64d-40d6-b692-2929143e825a\n\n\n## Folder structure\n\n\n\n    ├─ img                           # pixel images for the project\n    ├─ src\n    │  └─ game                       # Python package root \n    │     ├─ entities                # All in-game actors (Sprite) \n    │     │  ├─ __init__.py\n    │     │  ├─ entity.py            # Entity class\n    │     │  ├─ mario.py             # Mario class\n    │     │  ├─ mushroom.py          # Mushroom class\n    │     │  ├─ koopa.py             # Koopa class \n    │     │  ├─ goomba.py            # Goomba class\n    │     │  ├─ broken_block.py      # BrokenBlock class\n    │     │  ├─ star.py              # Star class\n    │     │  ├─ fire.py              # Fire class\n    │     │  ├─ coin.py              # Coin class\n    │     │  ├─ static_coin.py       # StaticCoin class\n    │     │  ├─ goal_flag.py         # GoalFlag class\n    │     │  └─ castle_flag.py       # CastleFlag class\n    │     ├─ levels\n    │     │  ├─ __init__.py\n    │     │  ├─ map.py               # Map class\n    │     │  ├─ goal_manager.py      # GoalManager class\n    │     │  └─ world1_1.py          # World 1-1 map data\n    │     ├─ systems                \n    │     │  ├─ __init__.py \n    │     │  ├─ sound.py             # Sound class\n    │     │  ├─ hud.py               # HeadUpDisplay class\n    │     │  └─ number.py            # Number class\n    │     ├─ core\n    │     │  ├─ __init__.py\n    │     │  ├─ state.py             # Status and GoalStatus classes\n    │     │  └─ settings.py          # constants \u0026 tunables\n    │     ├─ main.py                 # Main game loop\n    │     └─ __init__.py\n    ├── .gitignore                             \n    ├── README.md                    # Project documentation\n    └── requirements.txt             # Required dependencies\n\n\n## Environment Description\n### Display \nWidth and Height are 320 and 270, respectively.\nPixel size is 20x20. \n\n### Key inputs\n|Keys|Description|\n| - | - |\n| move | arrows |\n| crouch | down arrow |\n| space | jump |\n| left shift | dash |\n| left shift | fire ball |\n| pause | p |\n\n### Images\nImages are stored in [here](https://github.com/taka-rl/super_mario_py/tree/main/img).  \nImages for this project were drawn by pixels, using the following web pages.  \n\n- ドット絵ツール: https://neutralx0.net/tools/dot3/  \nThis web page is used to make pixel images. You can make any pixel images up to 50x50 sizes.\n\n- ゲームドット絵図鑑: https://pixel-art.tsurezure-brog.com/home/smb/  \nThis web page is a reference to make pixel images for Super Mario characters and objects.\n\n### Maps\nCurrently, World 1-1 is implemented.  \nAdding more worlds is a future plan.\n\nI built this [map creator](https://github.com/taka-rl/map_creator) as a support tool to generate a map data. \n\n## Get started\n1. Clone this project: `git clone https://github.com/taka-rl/super_mario_py.git`\n\n2. Run the following command to install libraries:  \nOn Windows type: `python -m pip install -r requirements.txt`\nOn MacOS type: `pip3 install -r requirements.txt`\n\n3. Run `main.py`\n\n## Future Developments\n- [ ] Introduce Reinforcement learning\n- [ ] Add different stages\n- [ ] Fix bugs and improve this project\n- [ ] Update import methods with Protocols, Registry/Factory\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaka-rl%2Fsuper_mario_py","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftaka-rl%2Fsuper_mario_py","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaka-rl%2Fsuper_mario_py/lists"}