{"id":20819390,"url":"https://github.com/paradigmmc/mc-modpack-kit","last_synced_at":"2025-07-10T07:34:48.771Z","repository":{"id":187933747,"uuid":"677654265","full_name":"ParadigmMC/mc-modpack-kit","owner":"ParadigmMC","description":"A template designed to streamline the release process of Minecraft modpacks.","archived":false,"fork":false,"pushed_at":"2024-05-20T19:14:00.000Z","size":164,"stargazers_count":34,"open_issues_count":11,"forks_count":25,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-31T11:21:20.358Z","etag":null,"topics":["curseforge","minecraft","modrinth","modrinth-modpack","packwiz"],"latest_commit_sha":null,"homepage":"","language":"Nix","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ParadigmMC.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}},"created_at":"2023-08-12T07:21:25.000Z","updated_at":"2025-03-01T22:25:08.000Z","dependencies_parsed_at":"2023-10-04T23:27:41.384Z","dependency_job_id":"449fea3c-aa87-46b5-9333-34a2b6f47fab","html_url":"https://github.com/ParadigmMC/mc-modpack-kit","commit_stats":null,"previous_names":["jh-devv/mc-modpack-kit","paradigmmc/mc-modpack-kit"],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ParadigmMC%2Fmc-modpack-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ParadigmMC%2Fmc-modpack-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ParadigmMC%2Fmc-modpack-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ParadigmMC%2Fmc-modpack-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ParadigmMC","download_url":"https://codeload.github.com/ParadigmMC/mc-modpack-kit/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252903030,"owners_count":21822359,"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","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":["curseforge","minecraft","modrinth","modrinth-modpack","packwiz"],"created_at":"2024-11-17T22:06:20.680Z","updated_at":"2025-05-07T15:22:50.798Z","avatar_url":"https://github.com/ParadigmMC.png","language":"Nix","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/jh-devv/mc-modpack-kit/assets/122896463/003f8682-7e4f-4797-bdc8-2610a5d505de\" alt=\"Logo\"\u003e\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003eStreamline the Minecraft Modpack Release Process with GitHub Actions!\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/badges/shields/generate\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/use%20this-template-blue?logo=github\u0026style=for-the-badge\" alt=\"Use this template\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/GitHub%20Actions-2088FF?logo=githubactions\u0026logoColor=fff\u0026style=for-the-badge\" alt=\"GitHub Actions Badge\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Minecraft-62B47A?logo=minecraft\u0026logoColor=fff\u0026style=for-the-badge\" alt=\"Minecraft Badge\"\u003e\n\u003c/p\u003e\n\n---\n\n**mc-modpack-kit** is a GitHub Actions workflow template designed to simplify the release process of Minecraft modpacks using a structured monorepo approach. It automates essential tasks such as versioning, modpack building, and publishing on platforms like Modrinth and CurseForge. \n\nIt also includes an `nix flake` for you fellow nix enjoyers! The actions also use it!\n\n### Key Features\n\n1. **Monorepo Structure**\n\n   Embrace the power of organization with a monorepo-style architecture. Each subdirectory represents a different modpack version or loader type, streamlining your management of multiple modpack variations within a single repository.\n\n   Example subdirectories:\n   - `fabric/`: Fabric loader version.\n   - `forge/`: Forge loader version.\n\n   You can create more just by initializing packwiz in the said directory of your choosing.\n\n2. **Automated Releases**\n\n   Experience effortless version control with Release Please, which generates changelogs and handles version releases automatically, in sync with your pull requests. Maintain clarity with Conventional Commit Messages.\n\n   Examples:\n    - `feat(modpack/\u003cmod\u003e): \u003cdescription\u003e` for adding new features, configurations or content.\n    - `chore(modpack/\u003cmod\u003e): \u003cdescription\u003e` for routine maintenance tasks or cleanups.\n    - `update(modpack/\u003cmod\u003e): update \u003cmod\u003e` for updating mods to newer versions.\n    - `mod(modpack/\u003cmod\u003e): add \u003cmod\u003e` for introducing new mods to the modpack.\n       \n4. **Mod Updates**\n\n   Update your mods effortlessly by utilizing the `update.yml` workflow located in `.github/workflows/update.yml`. This action efficiently updates all mods across all subdirectories.\n\n### Getting Started\n\n1. **Fork the Repository**\n\n   Start by forking this repository to your GitHub account.\n\n2. **Set Up Secrets and Permissions**\n\n   - Navigate to \"Settings\" -\u003e \"Secrets\" and add the following secrets:\n     - `MODRINTH_TOKEN`, `MODRINTH_ID` for Modrinth authentication.\n     - `CURSEFORGE_TOKEN`, `CURSEFORGE_ID` for CurseForge authentication.\n   - Enable \"Allow GitHub Actions to create and approve pull requests\" under \"Settings\" -\u003e \"Actions\" -\u003e \"General\" -\u003e \"Workflow permissions\".\n\n3. **Initialize Your Modpack**\n\n   - Generate a `pack.toml` file using `packwiz` (installation instructions [here](https://packwiz.infra.link/installation/)) within a modpack folder.\n   - Begin by running `packwiz init`, preferably within the `main` directory.\n  \n4. **Set a release channel**\n   - By default this template uses the `beta (0.1.0)` channel, you can switch it to `release (1.0.0)` when you are ready!\n   - This can be done via executing `.github/workflows/bump-version-release.yml`!\n\n5. **You are good to go!**\n   - You can now merge the release PR that release please has made, sit back and enjoy a cup of coffee! ☕ ^-^\n\n### Troubleshooting and Support\n\nIf you encounter any issues or need assistance, consult the [Issues](https://github.com/jh-devv/mc-modpack-kit/issues) page or reach out via my GitHub profile.\n\n### License\n\nThis project is licensed under the [CC0 1.0 Universal License](LICENSE).\n\n### Acknowledgments\n\n- This project makes effective use of GitHub Actions and various tools to automate the modpack release process.\n- A heartfelt ❤️ thank you to [Rafii](https://github.com/Rafii2198) for helping with this!\n- Special thanks to the GitHub community for their contributions and support.\n\n---\n\nContributions, feedback, and improvements are warmly welcomed! Let's propel this project forward together! 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparadigmmc%2Fmc-modpack-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fparadigmmc%2Fmc-modpack-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparadigmmc%2Fmc-modpack-kit/lists"}