{"id":46274311,"url":"https://github.com/devvyyxyz/abc-template","last_synced_at":"2026-03-04T04:02:25.771Z","repository":{"id":324665263,"uuid":"1098011578","full_name":"devvyyxyz/abc-template","owner":"devvyyxyz","description":null,"archived":false,"fork":false,"pushed_at":"2025-11-30T02:46:23.000Z","size":110,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-02T07:16:32.876Z","etag":null,"topics":["abc","datapack","minecraft","mod","modrinth"],"latest_commit_sha":null,"homepage":"https://modrinth.com/organization/abcxyz","language":"Shell","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/devvyyxyz.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-17T06:22:18.000Z","updated_at":"2025-11-30T02:46:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/devvyyxyz/abc-template","commit_stats":null,"previous_names":["devvyyxyz/abc-template"],"tags_count":7,"template":true,"template_full_name":null,"purl":"pkg:github/devvyyxyz/abc-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devvyyxyz%2Fabc-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devvyyxyz%2Fabc-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devvyyxyz%2Fabc-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devvyyxyz%2Fabc-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devvyyxyz","download_url":"https://codeload.github.com/devvyyxyz/abc-template/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devvyyxyz%2Fabc-template/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30071670,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T03:25:38.285Z","status":"ssl_error","status_checked_at":"2026-03-04T03:25:05.086Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["abc","datapack","minecraft","mod","modrinth"],"created_at":"2026-03-04T04:02:22.186Z","updated_at":"2026-03-04T04:02:25.766Z","avatar_url":"https://github.com/devvyyxyz.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ABC Template — Datapack \u0026 Resource Pack Template\n\nThis repository is a balanced template for creating Minecraft datapacks and resource packs (Java edition). You can use it as:\n\n- a datapack-only project (logic + functions),\n- a resource-pack-only project (assets like textures/models/sounds), or\n- a combined development workspace (both `data/` and `assets/` present).\n\nTwo short install flows below are split so you can quickly follow the one you need.\n\n## Quick Install — Datapack\n\n1. Download or clone this repository.\n2. Copy the `data/` folder (or the whole repository) to your world's `datapacks` folder:\n   - Location: `.minecraft/saves/[Your World Name]/datapacks/`\n3. In-game run `/reload` or restart the world. Verify `load.mcfunction` ran (use `say`/`tellraw` tests in `load.mcfunction`).\n\n\u003e [!IMPORTANT]\n\u003e Datapacks must live in a world's `datapacks/` folder (not in `resourcepacks/`). If you copy the whole repo, make sure you place it inside the world save `datapacks/` directory.\n\n\u003e [!TIP]\n\u003e Keep `assets/` in the repository during datapack development if you also use resource assets locally; it will not interfere with datapack execution and simplifies testing.\n\n## Quick Install — Resource Pack\n\n1. Download or clone this repository.\n2. Copy the `assets/` folder (or the whole repository) to your Minecraft `resourcepacks` folder:\n   - Location: `~/.minecraft/resourcepacks/` (or `%appdata%/Roaming/.minecraft/resourcepacks/` on Windows)\n3. In Minecraft: Options → Resource Packs → Open Pack Folder (or use the resource pack menu) and enable the pack.\n\n\u003e [!IMPORTANT]\n\u003e Resource packs must be placed in Minecraft's `resourcepacks/` folder (not `datapacks/`). Ensure `pack.mcmeta` has the correct `pack_format` for the target Minecraft version.\n\n\u003e [!TIP]\n\u003e To distribute, create a ZIP containing `assets/` and `pack.mcmeta` (optionally `pack.png`) and share that as the resource pack.\n\n## Quick Install — Combined / Development Workflow\n\nIf you want both datapack logic and resource assets during development, keep both `data/` and `assets/` in the repo. For local testing:\n\n- Copy `data/` into your world's `datapacks/` and copy `assets/` into `~/.minecraft/resourcepacks/`.\n- Alternatively use the helper scripts included to move/backup unwanted directories automatically.\n\n\u003e [!CAUTION]\n\u003e Using the helper scripts will move or delete directories by design. The scripts create timestamped backups by default — review backups after running. Use `DRYRUN=1` when running via the `Makefile` to preview actions.\n\n## What you will need — Datapack (key items)\n\n- `data/\u003cnamespace\u003e/functions/`: your functions and entry points (`load.mcfunction`, `tick.mcfunction`, etc.).\n- `data/minecraft/tags/functions/`: tags (`load.json`, `tick.json`) that call your namespace functions automatically.\n- `pack.mcmeta` (datapack): contains a `pack.pack_format` number appropriate for datapacks. Update this when targeting different Minecraft versions.\n- Namespace: a short identifier (example: `abc`) used as `abc:\u003cfunction_name\u003e` when calling functions.\n\nQuick checklist:\n- Create/adjust `data/\u003cnamespace\u003e/functions/load.mcfunction` for setup commands.\n- Add `data/minecraft/tags/functions/load.json` that references your namespace load function.\n\n\u003e [!NOTE]\n\u003e Datapack `pack_format` values are version-dependent. When in doubt, check the official Minecraft datapack documentation for the correct `pack_format` for your target versions.\n\n## What you will need — Resource Pack (key items)\n\n- `assets/\u003cnamespace\u003e/textures/` (or `assets/minecraft/textures/`) for images and models.\n- `pack.mcmeta` (resource pack): contains `pack.pack_format` for resource packs — this value differs from datapack `pack_format` and is version-dependent.\n- `pack.png` (optional): 128×128 PNG shown in the resource pack selector.\n\nQuick checklist:\n- Place textures under `assets/minecraft/textures/...` or under your namespace folder for namespaced assets.\n- Update `pack.mcmeta` with a resource pack `pack_format` compatible with your target Minecraft versions.\n\n\u003e [!WARNING]\n\u003e Resource pack `pack_format` differs from datapack `pack_format`. Using the wrong `pack_format` may prevent the pack from appearing or working correctly in some Minecraft versions.\n\n## Files \u0026 Paths (summary)\n\n- `pack.mcmeta`: required for both pack types; contains `pack.pack_format` and `description`. Make sure it uses the correct `pack_format` for the pack type (datapack vs resource pack).\n- `data/`: datapack logic (commands, functions, tags).\n- `assets/`: resource pack content (textures, models, sounds).\n- `README.md`, `LICENSE`, `pack.png`: docs, license, and optional icon.\n\n## What's included and what isn't\n\nIncluded in this template:\n\n- `data/` — a minimal datapack namespace (`abc`) with `functions/load`, `tick`, `example` and `tests/` scaffolding.\n- `assets/` — a minimal resource-pack structure and `README.md` with `.gitkeep` in `assets/minecraft/textures/` so the folder is preserved in Git.\n- `Makefile` — convenience targets to run helper scripts safely (includes `DRYRUN` and confirmation behavior).\n- `make-datapack.sh` / `make-resourcepack.sh` — helpers to move or delete directories with backups by default.\n- `.gitignore` — updated with sensible defaults for development and helper-script backups.\n\nNot included (by design):\n\n- Full build tooling (Gradle, Maven, npm) — this template is intentionally lightweight and does not include language-specific build systems.\n- Binary or compiled artifacts — compiled mod JARs or exported zipped releases are not stored here.\n- CI workflows — sample workflow filenames and descriptions are suggested below, but workflow files are not included by default.\n\nIf you want any of the above added (for example a Gradle wrapper or a GitHub Actions workflow), tell me which and I can scaffold it.\n\n## Helper scripts\n\nTwo scripts are included to help convert the repo into the variant you want:\n\n- `make-datapack.sh` — moves or deletes `assets/` so the repo becomes datapack-only.\n- `make-resourcepack.sh` — moves or deletes `data/` so the repo becomes resource-pack-only.\n\nUsage (make executable first):\n```bash\nchmod +x make-datapack.sh make-resourcepack.sh\n./make-datapack.sh       # default: move 'assets' to a timestamped backup\n./make-resourcepack.sh   # default: move 'data'   to a timestamped backup\n./make-datapack.sh --delete       # permanently delete 'assets'\n./make-resourcepack.sh --delete   # permanently delete 'data'\n```\n\n\u003e [!WARNING]\n\u003e The `--delete` option permanently removes files without creating a backup. Only use `--delete` if you are certain you do not need the removed directory.\n\n\u003e [!TIP]\n\u003e Use the Makefile dry-run mode to preview script actions without performing them: `make make-datapack DRYRUN=1` or `make make-resourcepack DRYRUN=1`.\n\n## Recommended edits when starting a project\n\n- For datapacks: set your namespace, update `pack.mcmeta` pack_format, and document functions in `data/\u003cnamespace\u003e/README.md`.\n- For resource packs: add `pack.png`, organize textures under `assets/`, and set the resource pack `pack_format`.\n- Use Git for version control and keep backups when deleting directories.\n\n\u003e [!IMPORTANT]\n\u003e Never commit API tokens, private keys, or other secrets into source. Use your Git hosting provider's encrypted secrets feature (e.g., GitHub Secrets) for CI workflows.\n\n## Want me to do more?\n\n- I can make the helper scripts executable and commit the permission change.\n- I can add a small `data/\u003cnamespace\u003e/README.md` scaffold documenting the included functions.\n- I can add a `Makefile` or simple `package.json` scripts to run the helper scripts consistently.\n\nWhich of the above would you like me to do next? (Pick one or say \"none\")\n\n## Publishing \u0026 CI (Modrinth)\n\nIf you plan to publish releases automatically (for example via GitHub Actions) and upload to Modrinth, add these repository secrets to your repository settings:\n\n- `MODRINTH_API_TOKEN`: a Modrinth API token with project publishing permissions. Create this token in your Modrinth account settings → API tokens.\n- `MODRINTH_PROJECT_ID`: the Modrinth project ID for your mod/resource (can be found in the project's Modrinth page URL or in project settings).\n\nNotes:\n- Store these values as encrypted repository secrets (e.g., GitHub: Settings → Secrets → Actions) rather than committing them into source.\n- Typical CI usage: the action reads these secrets to authenticate to Modrinth and upload a build/artifact.\n- I can add a sample GitHub Actions workflow that builds a ZIP and uploads a release to Modrinth using these secrets — tell me if you want that.\n\n## License\n\nSee `LICENSE` for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevvyyxyz%2Fabc-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevvyyxyz%2Fabc-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevvyyxyz%2Fabc-template/lists"}