{"id":17196874,"url":"https://github.com/vulcandth/pokecrystal16","last_synced_at":"2025-10-12T17:41:12.698Z","repository":{"id":37247930,"uuid":"500681543","full_name":"vulcandth/pokecrystal16","owner":"vulcandth","description":"Pokémon Crystal mod that implements 16-bit IDs for the vanilla game (not relying on other mods' features)","archived":false,"fork":false,"pushed_at":"2025-01-23T03:59:19.000Z","size":48829,"stargazers_count":18,"open_issues_count":2,"forks_count":28,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-13T19:42:42.990Z","etag":null,"topics":["16-bit","gameboy-color","pokemon","rgbds","romhack"],"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/vulcandth.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}},"created_at":"2022-06-07T03:53:41.000Z","updated_at":"2025-01-22T21:35:35.000Z","dependencies_parsed_at":"2023-01-29T20:45:45.803Z","dependency_job_id":"315d5387-c5c8-4ea6-bf4f-f957238d7f21","html_url":"https://github.com/vulcandth/pokecrystal16","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/vulcandth/pokecrystal16","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vulcandth%2Fpokecrystal16","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vulcandth%2Fpokecrystal16/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vulcandth%2Fpokecrystal16/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vulcandth%2Fpokecrystal16/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vulcandth","download_url":"https://codeload.github.com/vulcandth/pokecrystal16/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vulcandth%2Fpokecrystal16/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279012191,"owners_count":26085079,"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-12T02:00:06.719Z","response_time":53,"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":["16-bit","gameboy-color","pokemon","rgbds","romhack"],"created_at":"2024-10-15T01:54:43.902Z","updated_at":"2025-10-12T17:41:12.670Z","avatar_url":"https://github.com/vulcandth.png","language":"Assembly","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 16-bit index expansion for Crystal\n\nThis repository is a modernized and rebased version of [AX6](https://github.com/aaaaaa123456789)'s work found at https://github.com/aaaaaa123456789/pokecrystal16.\nIt includes additional features such as the new `expand-item-ID` branch and the `newbox`/`item-newbox` branches.\n\nThis repository contains a modified Pokémon Crystal game, updated to handle 16-bit indexes. The main goal of this\nproject is to create a reusable system that ROM hacks can use to bring 16-bit indexes into their games.  \nIt is *not* within scope to create a new game, or to add additional features beyond 16-bit indexes.\n\nThe `master` branch of this repository is intended to perform identically to the original Pokémon Crystal, with\nminimal changes to support further development on it. Other branches will implement more features on top of it; the\nintention is that the necessary changes can be readily seen by comparing said branches to `master` (or between each\nother). Therefore, these other branches will never be merged into `master`, even though they will always be directly\ndescended from it (i.e., in Git terminology, a merge would be a fast-forward).\n\nSince this repository is intended to be used as a reference, the commit history is intentionally kept clean to make\nchanges clearly visible. Therefore, modifications (such as bug fixes) will often be merged into whichever commit is\nmore suitable for them, with the remainder of the commit tree rebased on top of the updated commit. **Please do not\nfork this repository to build a new game on top** (unless you intend to contribute to it), as the publicly-visible\nhistory will be repeatedly rewritten, making merges impossible. If you do want to contribute to the repository, let\nme know in advance so I can notify you of history rewrites.\n\nFor update notifications, discussions, bug reports, and feedback, join our Discord server: [Fellowship of the Roms (Public)](https://discord.gg/dvpf6wcqMn). \nOnce there, navigate to the `#reaction-roles` channel and react to pokecrystal16 to gain access to the `#pokecrystal16` channels.\n\nFor further documentation, check out the [wiki].\n\n## Branches\n\nLast PC16 rebase: **2025-01-22**\n\n* `master`: (status: **stable**, last update: **2025-01-22**) Base branch. This branch contains a slightly modified\n  version of Pokémon Crystal, with some quality-of-life improvements intended to make development easier. These\n  improvements have been taken from the documentation in the [main disassembly repository][pokecrystal]. This branch\n  contains no 16-bit features and it is only intended as a reference.\n* `base-components`: (status: **stable**, last update: **2025-01-22**) This branch defines the basic components that\n  will comprise the 16-bit index table system, on top of which the remaining branches will be built. Since it only\n  defines macros (and a handful of WRAM locations to be shared by all index tables), it should build the same ROM as\n  `master`.\n* `expand-mon-ID`: (status: **stable**, last update: **2025-01-22**) This branch implements 16-bit indexes for Pokémon\n  species, thus allowing more than 253 species to be included in a single game.\n* `expand-move-ID`: (status: **stable**, last update: **2025-01-22**) This branch implements 16-bit indexes for moves,\n  on top of the existing 16-bit support for Pokémon species from the previous branch. (Interaction between the\n  branches is kept to a minimum, though.)\n* `newbox`: (status: **experimental**, last update: **2025-01-22**) This branch ports Rangi \u0026 FIQ's \"newbox\" from\n  Polished Crystal. Newbox is a complete overhaul to Bill's PC, and this branch ports the functionality on\n  top of the previous branches.\n* `expand-item-ID`: (status: **very experimental - use at on RISK!**, last update: **2025-01-22**) This branch implements 16-bit\n  indexes for items, on top of the existing 16-bit support for Pokémon moves from the `expand-move-ID` branch.\n* `item-newbox` : (status: **very experimental - use at on RISK!**, last update: **2025-01-22**) This branch is the same\n  as the `newbox` branch, but it builds on top of `expand-item-ID`.\n* `pokecrystal`: (status: **N/A**, last update **2025-01-22**) This branch contains pret's vanilla pokecrystal and\n  should only be used to compare with the previous branches to view pokecrystal16 changes. **DO NOT USE THIS BRANCH!**\n\nTo view the differences between any two branches (or any two commits in the repository), you can use GitHub's [tree\ncomparison][compare] tool.\n\n## FAQs\n\n**Q1:** Will this engine include \\\u003cinsert additional feature here\\\u003e?  \n**A1:** Unless the feature is specifically related to 16-bit indexing (or otherwise extending the range of possible\nindex values), the answer is almost certainly \"no\". This repository's scope is limited to 16-bit indexes. If you\nalready have a ROM hack that includes the features you like and you'd want it to have 16-bit indexes, the right course\nof action would be to port this engine to it. Otherwise, you can use this engine as a base to make your own ROM hack\nwith all the features you want.\n\n**Q2:** Can I use this engine for my own ROM hack?  \n**A2:** Of course; that's what it was made for. I will try make it as easy as possible to port to existing or new ROM\nhacks; instructions to do so will be in the [wiki]. All I can ask you for is that, just like this engine was openly\navailable for you to use, you make your hack's code openly available as well — quoting some of the text in\n[SQLite](https://sqlite.org)'s copyright disclaimer, \"may you share freely, never taking more than you give\".\n\n**Q3:** What's this engine's new limit on indexes?  \n**A3:** The theoretical limit is 65,534, minus a couple of \"special\" indexes used by the game for specific purposes\n(such as the value that indicates that a Pokémon is inside an egg). However, there are several limitations that will\nprobably prevent you from ever reaching that limit. For starters, you can't fit 65,534 of _anything_ inside a ROM\nbank! The index work is done, and I'll try to remove any hurdles that would render that work useless; however, if you\nwant to push the limits of the hardware and add 20,000 new Pokémon, you'll find yourself against a technical challenge\nthat will go beyond indexes.\n\n[compare]: https://github.com/vulcandth/pokecrystal16/compare\n[pokecrystal]: https://github.com/pret/pokecrystal/\n[wiki]: https://github.com/vulcandth/pokecrystal16/wiki\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvulcandth%2Fpokecrystal16","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvulcandth%2Fpokecrystal16","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvulcandth%2Fpokecrystal16/lists"}