Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/hbmmods/hbm-s-nuclear-tech-git/llms.txt

Use this file to discover all available pages before exploring further.

Installing HBM’s Nuclear Tech Mod follows the same pattern as any other Minecraft Forge mod: install the correct version of Forge for 1.7.10, drop the NTM JAR into your mods folder, and launch. However, because NTM is a large and actively developed mod, there are a few important prerequisites and compatibility considerations to be aware of before you start. This page covers installation from pre-compiled releases, using NTM as a Gradle dependency in your own mod project, and building the very latest version from source.

​
Prerequisites

Before installing NTM, make sure you have the following:

Minecraft 1.7.10

NTM targets Minecraft 1.7.10 exclusively. It will not load on any other Minecraft version.

Minecraft Forge

Install Forge 1.7.10-10.13.4.1614-1.7.10 (the exact version NTM is built against). Download from files.minecraftforge.net.

JDK 8 (for building)

Only needed if you are building from source. Download from adoptium.net.

​
Install from Modrinth or CurseForge

The simplest way to install NTM is to grab a pre-compiled release from one of the official distribution platforms.
1

Install Minecraft Forge 1.7.10

Download the Forge 1.7.10-10.13.4.1614-1.7.10 installer from files.minecraftforge.net and run it. Select Install client (or Install server for a dedicated server), then click OK.
2

Download NTM

Visit modrinth.com/mod/ntm or curseforge.com/minecraft/mc-mods/hbms-nuclear-tech-mod and download the latest release JAR. You can also download JARs directly from the Assets section of any GitHub Release — grab the HBM-NTM-<version>.jar file, not the source code archives.
3

Place the JAR in your mods folder

Copy the downloaded HBM-NTM-<version>.jar into your Minecraft mods directory:
  • Windows: %APPDATA%\.minecraft\mods\
  • macOS: ~/Library/Application Support/minecraft/mods/
  • Linux: ~/.minecraft/mods/
Create the mods folder if it doesn’t already exist.
4

Launch Minecraft with the Forge profile

Open the Minecraft Launcher, select the Forge 1.7.10 profile, and click Play. NTM will load alongside any other mods in your mods folder.
Always review the changelogs when updating NTM. The mod evolves rapidly and updates may change recipes, progression paths, or world generation. Loading an existing world with a significantly newer version of NTM without reading the changelog can result in unexpected behavior.

​
Compatibility Notices

Thermos is not supported. NTM will intentionally crash on servers running Thermos (or its forks, such as Crucible) due to a Thermos “performance” feature that causes tile entity ticking to slow down when no player is nearby. This breaks machines in ways that are nearly impossible to diagnose without knowing the cause. The crash log will contain a plain-English explanation at the top. Use a standard Forge server instead.
Optifine causes known issues. Optifine’s optimizations are known to break several NTM features:
  • Blocks with connected textures may become invisible (try toggling triangulation or multicore chunk rendering).
  • Entity “optimization” can break chunkloading for missiles, causing them to freeze mid-air.
  • Guns will break shader rendering when held (install Shader Fixer to address this).
Consider using alternative performance mods. A community-maintained list of Optifine alternatives for 1.7.10 can be found here.

​
Using NTM as a Gradle Dependency

If you are writing your own Forge mod and want to depend on NTM (for example, to access its API for custom machines or integration), you can pull it from the NTM Maven repository instead of bundling the JAR manually. Add the following to your mod project’s build.gradle: 
repositories {
    maven {
        name "NTM Releases"
        url "https://maven.ntmr.dev/releases"
    }
}

dependencies {
    def ntmBuildNumber = "5687" // Change to the build number of the release you wish to use

    implementation "com.hbm:HBM-NTM:1.0.27_X${ntmBuildNumber}:dev"
    compileOnly "com.hbm:HBM-NTM:1.0.27_X${ntmBuildNumber}:src"
}
Replace ntmBuildNumber with the specific build number of the NTM release you are targeting. Build numbers are listed on each GitHub release page. The :dev artifact provides the deobfuscated runtime JAR, and :src provides the sources for IDE navigation.

​
Building from Source

If you want to use the absolute latest code between releases, you can compile NTM yourself from the GitHub repository. The instructions below assume Windows; Linux users should be able to follow along using equivalent shell commands.
1

Install JDK 8

Download and install JDK 8 from adoptium.net. Make sure java -version reports a 1.8.x version in your terminal.
2

Install Git

If you don’t have Git installed, download and install it from git-scm.com/downloads. Open Git Bash from the Start menu for the following steps.
3

Clone the repository

Navigate to the directory where you want the source code and clone the repository:
cd $HOME/Downloads
git clone https://github.com/HbmMods/Hbm-s-Nuclear-Tech-GIT.git
cd Hbm-s-Nuclear-Tech-GIT
4

Build the mod

Run the Gradle build task. ForgeGradle will automatically download Minecraft, deobfuscation mappings, and all dependencies on the first run — this may take several minutes:
./gradlew build
5

Locate the compiled JAR

After a successful build, the compiled mod file will be at:
build/libs/HBM-NTM-<version>.jar
Copy this JAR into your Minecraft mods folder as you would any other mod. Do not use the -sources.jar or -dev.jar files — only the plain HBM-NTM-<version>.jar is the installable mod file.
If you want to modify NTM’s source code and work in an IDE, additional setup steps are required (setting up a Forge decompilation workspace and generating Eclipse or IntelliJ project files). See the Contributing section of the README for the full IDE setup guide.

Build docs developers (and LLMs) love

Get started for freeTalk to us