Compatibility Learn more about Balm Mod.
Forge, Fabric and NeoForge: Choosing a Balm Build

Choose a Balm build for the loader used by your actual Minecraft instance, then check the game version and dependent mod requirements. Forge, Fabric, and NeoForge labels are not interchangeable download suggestions. A library that supports a multi-loader development approach does not convert arbitrary mods from one environment to another. This guide explains how to identify your loader, compare release information, plan a move between environments, and test a coherent file set without confusing shared project names with runtime compatibility.
Identify the environment that actually launches
Open the selected profile's installation settings and record the loader name, loader version, Minecraft version, and game directory. Do not trust a profile name you or another person can edit. If the folder was copied from an earlier setup, its contents may reflect a different environment from the one currently configured. Establish the actual launch configuration before choosing a release. This gives every later file comparison a concrete target instead of a vague idea that the pack is modded.
Separate the loader from the mod collection
The environment that starts the game and the individual files installed into it are related but different parts of the setup. A folder containing a Forge-labelled mod does not prove that the selected profile uses Forge. Likewise, changing the profile to another loader does not automatically replace every incompatible mod in the folder. Check both the launch configuration and the installed releases. Compatibility depends on the combination, not on a single familiar name appearing somewhere in the directory.
Keep multiple instances clearly named
If you maintain Forge, Fabric, and NeoForge setups, give each a distinct profile name and record its directory. Keep downloads for their different environments organised before copying files. Similar game versions can make otherwise separate setups look interchangeable. A short label including the loader and purpose helps prevent mistakes when you return after an update or ask someone else to help. Clear naming is not a substitute for checking settings, but it reduces avoidable confusion.
Read loader-specific release metadata
Use the published file listing for the selected project and inspect the individual release's supported loader and game versions. A project can offer several builds with similar titles while each targets a particular environment. Compare the selected file with the actual profile rather than copying a version from an unrelated guide. The release details should establish support; the fact that a project is broadly described as multi-loader does not establish that every published file runs everywhere.
Check the gameplay mod and Balm separately
The dependent mod must support the environment, and the selected Balm release must satisfy that mod's requirements in the same environment. Checking only the library cannot make an unsupported gameplay mod suitable. Check the desired feature release first, then its required library. If several mods share Balm, compare their version ranges together. This prevents a local fix for one new component from creating a conflicting dependency requirement elsewhere in the pack.
Do not infer compatibility from matching numbers
Two files can share a game version or a similar release number while targeting different loaders. Treat those fields independently. A larger library number does not override a loader mismatch, and a matching loader does not override unsupported game versions. Our Balm version selection guide provides a method for comparing these constraints. Write down the reason a candidate fits each relevant requirement so your final choice can be reproduced and reviewed.
Understand the limits of a multi-loader library
A multi-loader development approach can help a project support several environments through appropriate implementations and builds. For a player, that still means selecting the release intended for the active setup. It does not mean installing a supporting library makes every Forge mod load on Fabric or every Fabric mod load on NeoForge. Keep development architecture separate from runtime file selection. The player installation must follow the published support information for the actual mod releases involved.
Shared features do not imply identical artifacts
Two releases of the same mod can provide similar gameplay while being packaged for different environments. Their names and descriptions may therefore look almost identical. That resemblance is useful for recognising the project, but it is not sufficient for choosing the file. Read the environment fields and requirements for the individual release. Preserve original file names after downloading so the loader-specific identity remains visible during installation, maintenance, and support discussions.
Renaming does not change the intended environment
Changing a file's name or extension does not rewrite its contents or make its requirements disappear. If a candidate belongs to another loader, obtain the documented release for your target environment rather than disguising the label. Similarly, copying a file into a different profile does not establish compatibility. A dependency decision should be supported by the release information and a controlled test, not by whether the loader happens to progress further after an undocumented experiment.
Choose an environment based on the features you need
If you have not committed to a loader, begin with the mods and features you want. Check which game and loader combinations their relevant releases support. Look for a coherent set instead of choosing an environment first and assuming every desired mod can follow. You may decide to keep separate instances for incompatible feature sets. That is often clearer than forcing unrelated downloads into one folder and treating each resulting startup error as an isolated missing-library problem.
Build a feature-to-release inventory
Write each desired feature beside its project, release, supported loader, supported game version, and required dependencies. Mark anything unavailable or uncertain. This inventory exposes conflicts before installation. It also prevents a migration plan from being based on project names alone, since availability can differ among individual releases. Keep the intended use in view: the best configuration for your task is the one that supports the features you can actually obtain and test together.
Avoid universal performance assumptions
Do not choose or reject a loader solely because of an unqualified claim that it always performs better for every pack. Your actual mod set, configuration, hardware, and test scenario matter. If performance is part of the decision, compare representative setups under recorded conditions. Keep that evaluation separate from dependency compatibility. A candidate still needs to satisfy its published requirements even if another environment seems attractive for an unrelated reason.
Plan a loader migration as a new configuration
Create a separate target-loader instance rather than overwriting the original working folder. Record the target game version and loader, then obtain supported releases of the desired mods and their dependencies. Do not transfer the entire old mods directory and assume the library will bridge the difference. Review each component. Retain the original instance and important save backups while you evaluate whether the target configuration can reproduce the features you depend on.
Review world compatibility before moving saves
A different loader setup may use different mod releases or lack components that contributed content to an existing world. Do not make your only save the first migration test. Use a copied world only after the target environment starts successfully, and preserve the original. Record what was tested and any missing features. A successful launch with a new world does not establish that an established modded save can be opened without changes or losses in the target configuration.
Keep configuration transfer selective
Some settings may be relevant to the same project across environments, while others may differ by release or implementation. Follow project instructions rather than copying all configuration indiscriminately. Start from the documented target setup and introduce necessary settings deliberately. Record each transfer so that a later failure can be associated with a specific change. The migration goal is a clear target environment, not a folder containing unexplained remnants from the previous one.
Install the target Balm release
Once the dependent releases are selected, obtain a compatible published Balm JAR for the target loader and game version. Place it in the target instance's mods folder with the game closed. Leave only the intended active release and keep source archives or spare candidates elsewhere. For a concrete installation workflow in one environment, see the Fabric Balm installation guide. Use the corresponding requirements for your chosen loader rather than treating any one workflow's release labels as universal.
Inspect the final directory before launching
Compare the live target folder with the planned inventory. Look for old loader builds, duplicate libraries, source ZIPs, and files copied from unrelated profiles. Confirm that a pack manager has not restored an earlier configuration after your manual changes. The directory should express one intended environment. This final inspection can prevent a startup failure from being attributed to the new loader when the actual cause is a leftover file that was never part of the compatible plan.
Preserve the relationship between installed files and notes
Mark planned releases separately from installed releases until you have checked the actual live directory. A candidate still in downloads has not become part of the target configuration. Record original names and the selected profile. If you test multiple alternatives, keep their results separate. This makes the eventual decision understandable and prevents a successful test of one combination from being accidentally cited as evidence for a different combination that was not actually run.
Verify the target environment in stages
Start the intended target profile and inspect any compatibility message. Confirm the desired mods are recognised, then test representative features in a disposable world. Repeat important interactions after a restart. If multiplayer is part of the plan, test the corresponding server and client pairing separately. Define the scope of each observation instead of claiming full equivalence after a single menu launch. A migration succeeds when the target setup meets your practical requirements, not merely when its folder contains familiar project names.
Compare outcomes with the original setup
Use the original instance as a reference for the features you intended to preserve. Note any differences or unsupported components instead of assuming every variation is a bug. If a feature is unavailable in the target environment, decide whether that limitation is acceptable. Keep the original available until the decision is complete. This approach turns a loader change into a reviewable configuration choice rather than an irreversible replacement made before its consequences were understood.
Example: one desired mod is unavailable on the target loader
Imagine that most of your preferred mods have releases for a new target environment, but one essential feature does not. Adding Balm does not create a missing target-loader release of that feature mod. Your options include retaining the original setup, finding a documented alternative, changing the game version if a supported combination exists, or keeping separate instances for different uses. Evaluate those options against your actual requirements rather than forcing an unsupported file into the target folder.
If you choose an alternative, test its behaviour independently and record differences from the original feature. The goal is an environment you understand and can maintain, not a superficial match in the number of installed files. Wikipedia's Minecraft modding overview offers background on the broader ecosystem, while individual release requirements remain the authority for your practical selection. Keep general context and specific compatibility decisions in their respective roles.
Questions about loader-specific Balm builds
Can the same library file be assumed to support all loaders?
Only rely on the support explicitly documented for the selected release. A shared project identity does not establish universal artifact compatibility. Check the file's details, the active environment, and the dependent requirements together. If the information is unclear, ask a precise question before changing a working pack. A documented answer is more useful than a series of renames or folder moves that do not explain why a file should be suitable.
What is the most useful final record?
Keep the target profile, game and loader versions, installed mod and dependency releases, feature test results, known differences, and location of the original backup. That record supports future updates and makes support reports more precise. It also preserves the central distinction of this guide: loader support is a property to verify for the actual selected releases, not an assumption inherited from a project's name or from another player's working setup.
Keep a loader comparison focused on your actual requirements
When comparing environments, list the features that are essential, useful, and optional for your intended play. Then evaluate the available supported releases against that list. This prevents a loader decision from becoming an abstract argument disconnected from the pack you want to run. An environment that supports your essential features in a coherent tested set can be a better choice for your task than one preferred in a general discussion. Keep the comparison current by recording the individual releases you inspected, since broad project availability does not establish support for every game version.
If no single configuration meets every requirement, describe the trade-off explicitly. You may retain the original setup, adopt a documented alternative feature, or maintain separate instances. Do not disguise the missing capability by adding another dependency whose purpose does not address it. A clear choice is easier to maintain and explain to players who share the pack. Record what the selected environment supports, what remains unavailable, and what was actually tested. This gives future changes a practical reference point and avoids repeatedly reopening the same migration question without remembering why a previous configuration was accepted or rejected.