{"id":19516081,"url":"https://github.com/jamchamb/ac-mod-template","last_synced_at":"2026-03-19T10:14:37.847Z","repository":{"id":56742845,"uuid":"142799776","full_name":"jamchamb/ac-mod-template","owner":"jamchamb","description":"Template for Animal Crossing ACE injected mods","archived":false,"fork":false,"pushed_at":"2018-07-29T22:31:24.000Z","size":5,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-25T23:43:57.849Z","etag":null,"topics":["animal-crossing","modding-games"],"latest_commit_sha":null,"homepage":null,"language":"Makefile","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/jamchamb.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}},"created_at":"2018-07-29T22:26:41.000Z","updated_at":"2023-06-06T11:15:00.000Z","dependencies_parsed_at":"2022-08-16T01:10:38.471Z","dependency_job_id":null,"html_url":"https://github.com/jamchamb/ac-mod-template","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jamchamb/ac-mod-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamchamb%2Fac-mod-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamchamb%2Fac-mod-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamchamb%2Fac-mod-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamchamb%2Fac-mod-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jamchamb","download_url":"https://codeload.github.com/jamchamb/ac-mod-template/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamchamb%2Fac-mod-template/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266815283,"owners_count":23988564,"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-07-24T02:00:09.469Z","response_time":99,"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":["animal-crossing","modding-games"],"created_at":"2024-11-10T23:44:30.136Z","updated_at":"2026-02-05T09:32:47.242Z","avatar_url":"https://github.com/jamchamb.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Animal Crossing Mod Patch Template\n\nThis is a template for Animal Crossing mod patches written in C.\nSome example mods can be found in the [ac-mods](https://github.com/jamchamb/ac-mods) repo.\n\nThis requires the devkitPro tools to build.\nSee \u003chttps://devkitpro.org/wiki/Getting_Started\u003e for how to install `devkitpro` and `gamecube-dev`.\n\n## Building\n\nWith `gamecube-dev` installed, just run `make`. The output will include a `.patch` file that holds the generated code to patch in.\n\n### Generating the GameCube save file\n\n[`ac-nesrom-gen`](https://github.com/jamchamb/ac-nesrom-save-generator)\ncan automatically create a GCI file for the mod patches by reading the\n`gci_build.yaml` config file. If installed, the GCI file will be generated\nwhen running `make`.\n\nAlternatively, use this command:\n\n```console\n$ ac-nesrom-gen --autoheader 80002000 \"Mod Name\" input.patch output.gci\n```\n\nImport the GCI save file to a memory card and use the generic NES Console\nitem to load the mod.\n\n## Development\n\n### Specifying patch location\n\nSet the start address for the patch in `linker.ld` just before\nthe `.text` section.\n\nNote that `*(.text.__entry);` must always be the first entry in the `.text`\nsection of the linker script.\n\n### Calling Animal Crossing functions\n\nHere are a couple of ways to call a function that already exists in\nAnimal Crossing:\n\n#### Use function pointers\n\nDefine the function like this, using its address as the pointer value:\n\n```c\nvoid (*OSReport)(char*, ...) = (void*) 0x8005A750;\n```\n\n#### Use the linker script\n\nThis uses fewer instructions, resulting in a smaller patch size.\n\n1. Define the function like this:\n\n   ```\n   extern void OSReport(char*, ...);\n   ```\n2. Define its location in `linker.ld`:\n\n   ```\n   SECTIONS\n   {\n           . = 0x80002000;\n           .text . : {\n               ...\n           }\n           ...\n           OSReport = 0x8005A750;\n   }\n   ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjamchamb%2Fac-mod-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjamchamb%2Fac-mod-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjamchamb%2Fac-mod-template/lists"}