{"id":33003964,"url":"https://github.com/AntonioND/ucity","last_synced_at":"2025-11-18T09:01:43.953Z","repository":{"id":78603516,"uuid":"55847756","full_name":"AntonioND/ucity","owner":"AntonioND","description":"The open-source city building game for Game Boy Color.","archived":false,"fork":false,"pushed_at":"2025-08-08T22:21:18.000Z","size":2150,"stargazers_count":462,"open_issues_count":1,"forks_count":16,"subscribers_count":26,"default_branch":"master","last_synced_at":"2025-10-28T08:43:17.239Z","etag":null,"topics":["assembly","assembly-language","city-builder","city-simulation","game","gameboy"],"latest_commit_sha":null,"homepage":"","language":"Assembly","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/AntonioND.png","metadata":{"files":{"readme":"readme.rst","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}},"created_at":"2016-04-09T14:10:47.000Z","updated_at":"2025-10-26T22:30:19.000Z","dependencies_parsed_at":"2023-03-12T04:49:19.462Z","dependency_job_id":"61669b41-e7c1-444c-842f-8f4ef3b9f356","html_url":"https://github.com/AntonioND/ucity","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/AntonioND/ucity","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntonioND%2Fucity","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntonioND%2Fucity/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntonioND%2Fucity/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntonioND%2Fucity/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AntonioND","download_url":"https://codeload.github.com/AntonioND/ucity/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntonioND%2Fucity/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":285035891,"owners_count":27103933,"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-11-18T02:00:05.759Z","response_time":61,"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":["assembly","assembly-language","city-builder","city-simulation","game","gameboy"],"created_at":"2025-11-13T15:00:34.724Z","updated_at":"2025-11-18T09:01:43.944Z","avatar_url":"https://github.com/AntonioND.png","language":"Assembly","readme":"=========\nµCity 1.3\n=========\n\nIntroduction\n============\n\nThis is µCity (also spelled 'uCity', pronounced 'micro-city'), the open-source\ncity-building game for Game Boy Color.\n\n.. image:: screenshot.png\n\nVideo: https://www.youtube.com/watch?v=2rir-TVx020\n\nThis game is completely free. Just download the ROM, install a Game Boy Color\nemulator, and play! The last release of the game should be here:\n\nhttps://github.com/AntonioND/ucity/releases\n\nYou can also play on real hardware. Even though the game has been developed\nusing mainly emulators, it has been verified to work on hardware. The game\ndetects how much available space there is and adjust the maximum number of saved\ncities accordingly.\n\nThere are two available ROMs. ``ucity.gbc`` is the preferred ROM that you should\nuse. It can save up to 16 cities depending on the memory available in your\nemulator or flashcart. If your emulator fails to load this ROM because of an\nunknown RAM size or your flashcart fails to save data, try ``ucity_compat.gbc``.\nThis ROM will only be able to save up to 4 cities, but it is more likely to work\nin all cases.\n\nNote: A direct port of this game to the monochrome Game Boy isn't possible. This\ngame uses most of the extra RAM that was added to the Game Boy Color, which\nisn't available in a regular Game Boy. While the Game Boy Color has 32 KiB of\nWRAM, the Game Boy only has 8 KB, and this game currently uses 30 KB more or\nless. Only a really limited version of this game with a much smaller map and\nmuch fewer features would fit in a Game Boy.\n\nManual\n======\n\nIf needed, there is a short manual with instructions for the player\n`here \u003cmanual.rst\u003e`_.\n\nDocumentation\n=============\n\nAn open-source project is a lot worse without documentation! That's why the code\nhas a lot of comments and why there is a highly detailed documentation\n`here \u003cdocs/index.rst\u003e`_. And also because assembly code without comments can't\nbe understood even by the developer who wrote it originally. :)\n\nCompiling\n=========\n\nThis game needs a really recent version of ``RGBDS`` to correctly assemble the\ncode. It is the only real dependency. This toolchain can be found here:\n\nhttps://github.com/gbdev/rgbds/\n\nFollow the instructions in that link to install it in your system.\n\nOnce the ``RGBDS`` binaries are installed in your system, assembling the game is\nas simple as typing :code:`make` in a terminal.\n\nIf the binaries aren't installed in any system path, the variable ``RGBDS`` of\nthe Makefile has to point at the path where they are located:\n\n:code:`make RGBDS=path/to/binaries/`\n\nThis should work on Linux, MinGW, Cygwin, etc. To remove all files that are\ngenerated during the assembly process, type :code:`make clean`.\n\nTools\n=====\n\n- Open ModPlug Tracker\n\n  This is just a program to edit tracker style music. It has been used to\n  compose the music used by GBT Player.\n\n    https://openmpt.org/\n\n  GBT Player is my music player library. It is included in the code, and it can\n  be found here if you want to use it for your projects:\n\n    https://github.com/AntonioND/gbt-player\n\n- GBTD (Game Boy Tile Designer) and GBMB (Game Boy Map Builder)\n\n  Graphics edition tools (for Windows, but they run on Wine).\n\n  Note that both of them can be found in this repository in the ``tools`` folder\n  in case the following links are broken:\n\n    http://www.devrs.com/gb/hmgd/gbmb.html\n\n    http://www.devrs.com/gb/hmgd/gbtd.html\n\nCredits\n=======\n\nGame made by AntonioND/SkyLyrac (Antonio Niño Díaz)\n\nEmail:\n\n    antonio_nd@outlook.com\n\nWeb:\n\n    https://github.com/AntonioND\n\n    www.skylyrac.net\n\nThanks to:\n\n- beware: For the emulator BGB (http://bgb.bircd.org/), extremely useful tool\n  used to develop this game.\n\n- Pan of Anthrox, Marat Fayzullin, Pascal Felber, Paul Robson, Martin Korth\n  (nocash) and kOOPa for the pandocs.\n\n- Otaku No Zoku (Justin Lloyd) for the Gameboy Crib Sheet.\n\n- Everyone that has contributed to develop ``RGBDS`` over the years, specially\n  Carsten Sorensen, Justin Lloyd, Vegard Nossum and Anthony J. Bentley.\n\nLicense\n=======\n\nThis game is licensed under the GPLv3+ license. You should have received the\nsource code of this game along with the ROM file. If not, the source code is\nfreely available at the following address:\n\n    https://github.com/AntonioND/ucity\n\nNot all source code files are licensed under the GPL v3+, though, only the ones\nwith the GPL header are. There other source files are licensed under different\nterms (for example, GBT Player is licensed under the 2-clause BSD license).\n\nThe media files (graphics and music) are licensed under a Creative Commons\nlicense (CC BY-SA 4.0).\n","funding_links":[],"categories":["Homebrews","自制啤酒"],"sub_categories":["ASM","空对地导弹"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAntonioND%2Fucity","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAntonioND%2Fucity","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAntonioND%2Fucity/lists"}