{"id":15015102,"url":"https://github.com/twelveiterationmods/balm","last_synced_at":"2025-04-12T09:12:45.586Z","repository":{"id":40782557,"uuid":"376244596","full_name":"TwelveIterationMods/Balm","owner":"TwelveIterationMods","description":"Minecraft Library Mod. Abstraction Layer for Multi-Loader Mods.","archived":false,"fork":false,"pushed_at":"2025-04-12T07:54:38.000Z","size":3377,"stargazers_count":29,"open_issues_count":4,"forks_count":23,"subscribers_count":1,"default_branch":"1.21.5","last_synced_at":"2025-04-12T09:12:09.274Z","etag":null,"topics":["fabricmc-mod","forge-mod","minecraft-mod","neoforge-mod"],"latest_commit_sha":null,"homepage":"https://balm.twelveiterations.com","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TwelveIterationMods.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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},"funding":{"github":"BlayTheNinth","patreon":"BlayTheNinth","open_collective":null,"ko_fi":"BlayTheNinth","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2021-06-12T08:57:08.000Z","updated_at":"2025-04-11T06:43:17.000Z","dependencies_parsed_at":"2024-03-18T10:32:22.389Z","dependency_job_id":"ec110f74-ed43-4d73-8620-b45cbd1120f1","html_url":"https://github.com/TwelveIterationMods/Balm","commit_stats":null,"previous_names":[],"tags_count":155,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TwelveIterationMods%2FBalm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TwelveIterationMods%2FBalm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TwelveIterationMods%2FBalm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TwelveIterationMods%2FBalm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TwelveIterationMods","download_url":"https://codeload.github.com/TwelveIterationMods/Balm/tar.gz/refs/heads/1.21.5","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248543847,"owners_count":21121838,"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":["fabricmc-mod","forge-mod","minecraft-mod","neoforge-mod"],"created_at":"2024-09-24T19:46:30.226Z","updated_at":"2025-04-12T09:12:45.580Z","avatar_url":"https://github.com/TwelveIterationMods.png","language":"Java","funding_links":["https://github.com/sponsors/BlayTheNinth","https://patreon.com/BlayTheNinth","https://ko-fi.com/BlayTheNinth"],"categories":[],"sub_categories":[],"readme":"# Balm\n\nMinecraft Library Mod. Abstraction Layer for Multiplatform Mods.\n\nBalm is a library mod for mod developers that simplifies the process of creating multi-loader mods by providing common\ninterfaces and events and removing the need for most mod-loader specific code.\n\nIt is not a magic solution for running Forge and Fabric mods together. As a user, you only need to install this mod if\nyou use a mod that requires it.\n\n## Key Points\n\n- No custom Gradle tooling, official mod loader plugins only\n- Uses Mojang Mappings, supports [Jared's MultiLoader-Template](https://github.com/jaredlll08/MultiLoader-Template)\n- All-inclusive from networking to configs, no third party dependencies\n- Battle-tested across Blay's 20+ mods ranging from content additions to quality of life utilities\n- Supports NeoForge, Fabric and Forge without duplicate code\n- Snapshots builds for pre-releases and release candidates\n- Unified support for Third Party Mods like Curios/Trinkets or Jade/TheOneProbe\n- Available on CurseForge and Modrinth (incl. Third Party Access) \n\n## How to make a mod with Balm\n\nYou can get started [using this template repository](https://github.com/TwelveIterationMods/balm-mod).\nDocumentation is [limited](https://balm.twelveiterations.com/docs/getting-started), but the template gives an overview on how to get started, and you can browse [Blay's other mods'\ncode](https://github.com/TwelveIterationMods) to learn how specific things are done.\n\n#### Downloads\n\n[![Versions](http://cf.way2muchnoise.eu/versions/531761_latest.svg)](https://www.curseforge.com/minecraft/mc-mods/balm)\n[![Downloads](http://cf.way2muchnoise.eu/full_531761_downloads.svg)](https://www.curseforge.com/minecraft/mc-mods/balm)\n\n## Adding Balm to a development environment\n\n### Using CurseMaven\n\nAdd the following to your `build.gradle`:\n\n```groovy\nrepositories {\n    maven { url \"https://www.cursemaven.com\" }\n}\n\ndependencies {\n    // Replace ${balm_file_id} with the id of the file you want to depend on.\n    // You can find it in the URL of the file on CurseForge (e.g. 3914527).\n    // NeoForge: implementation \"curse.maven:balm-531761:${balm_file_id}\"\n    // Fabric (1.21.5+): modImplementation \"curse.maven:balm-531761:${balm_file_id}\"\n    // Fabric (older versions): modImplementation \"curse.maven:balm-fabric-500525:${balm_file_id}\"\n    // Forge: implementation \"curse.maven:balm-531761:${balm_file_id}\"\n}\n```\n\n### Using Twelve Iterations Maven (includes snapshot versions)\n\nAdd the following to your `build.gradle`:\n\n```groovy\nrepositories {\n    maven {\n        url \"https://maven.twelveiterations.com/repository/maven-public/\"\n\n        content {\n            includeGroup \"net.blay09.mods\"\n        }\n    }\n}\n\ndependencies {\n    // Replace ${balm_version} with the version you want to depend on. \n    // You can find the latest version for a given Minecraft version at https://maven.twelveiterations.com/service/rest/repository/browse/maven-public/net/blay09/mods/balm-common/\n    // Common (mojmap): implementation \"net.blay09.mods:balm-common:${balm_version}\"\n    // NeoForge: implementation \"net.blay09.mods:balm-neoforge:${balm_version}\"\n    // Fabric: modImplementation \"net.blay09.mods:balm-fabric:${balm_version}\"\n    // Forge: implementation \"net.blay09.mods:balm-forge:${balm_version}\"\n}\n```\n\n## License\n\nThis project is licensed under the Apache License 2.0, with the following exceptions:\n\n- Forks published outside of GitHub must clearly rename the project as to not create confusion with the original version\n  of Balm.\n- The icon(s) for Balm are Copyright (c) 2025 BlayTheNinth, All Rights Reserved.\n- Binary builds including these icon(s) are Copyright (c) 2025 BlayTheNinth, All Rights Reserved.\n\nAdditionally, it is strongly recommended that forks published outside of GitHub change the mod ID and package names to\navoid conflicts with the original version of Balm.\n\n## Contributing\n\nIf you're interested in contributing to the mod, you can check\nout [issues labelled as \"help wanted\"](https://github.com/TwelveIterationMods/Balm/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22).\n\nWhen it comes to new features, it's best to confer with me first to ensure we share the same vision. You can join us\non [Discord](https://discord.gg/VAfZ2Nau6j) if you'd like to talk. Generally, Balm is designed to be a wrapper around existing mod and mod loader \nAPIs and does not aim to provide its own systems beyond the core functionality (such as configs). Large emphasis is put \non whether a feature is maintainable in the long-term and provides value to the average mod developer.\n\nContributions must be done through pull requests. I will not be able to accept translations, code or other assets\nthrough any other channels.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftwelveiterationmods%2Fbalm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftwelveiterationmods%2Fbalm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftwelveiterationmods%2Fbalm/lists"}