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.

NTM stores all of its primary configuration in a single Forge-style config file located at config/HBM_NTM.cfg inside your Minecraft instance folder. This file is divided into named categories (e.g. 01_general, 528, LESS BULLSHIT MODE) and is created automatically on first launch with every option set to its default value. Options are numerically prefixed so they appear in a predictable order inside tools like the Forge in-game config editor. You can apply changes at runtime — without restarting the game or server — by running /ntmreload as a server operator. Some options (particularly those that affect world generation or mod loading order) require a full restart to take effect.
The config file is located at <instance>/config/HBM_NTM.cfg. Run /ntmreload in-game to hot-reload recipes and most runtime options. World-gen and dimension-registration changes always require a full restart.

Network & Threading

Options in the 01_general category that control how NTM handles server-side packet processing.
FieldValue
Key0.00_crashOnThermos
TypeBoolean
Defaulttrue
When true, NTM will refuse to load on a Thermos server and throw a deliberate crash. Thermos rewrites tile-entity handling in a way that silently breaks a large portion of the mod. Only set this to false if you fully understand the tileentities.yml file and the extent to which Thermos cripples the mod’s functionality.
FieldValue
Key0.01_enablePacketThreading
TypeBoolean
Defaulttrue
Creates a dedicated thread pool for processing NTM packets on the server, which can noticeably reduce main-thread stutter on busy multiplayer servers. Disable if you observe anomalous crashes related to memory or network connections that disappear when this option is off.
FieldValue
Key0.02_packetThreadingCoreCount
TypeInteger
Default1
Number of always-alive core threads in the packet thread pool. The developers recommend keeping this at 1 for most servers.
FieldValue
Key0.03_packetThreadingMaxCount
TypeInteger
Default1
Maximum number of threads the packet pool may scale up to. Must be greater than or equal to 0.02_packetThreadingCoreCount.
FieldValue
Key0.04_packetThreadingErrorBypass
TypeBoolean
Defaultfalse
Forces most packet threading errors to be silently swallowed rather than propagated. Only enable this if a developer directs you to, or if you fully understand the implications of suppressing threading errors.
FieldValue
Key0.05_enableServerRecipeSync
TypeBoolean
Defaultfalse
When true, any machine recipes customised via JSON config files are synced to connecting clients automatically. Required if clients need to display or pre-validate custom recipes. See the JSON Recipes page for details.

Feature Toggles

The bulk of gameplay-affecting toggles live in keys 1.00 through 1.44 of the 01_general category. These control everything from debug mode to skyboxes, and most can be hot-reloaded.
FieldValue
Key1.00_enableDebugMode
TypeBoolean
Defaultfalse
Enables debug rendering and logging throughout the mod. Produces significant log spam; only useful when diagnosing issues or developing.
FieldValue
Key1.01_enableMyceliumSpread
TypeBoolean
Defaultfalse
Allows NTM’s glowing mycelium variant to spread to adjacent blocks. Disabled by default because uncontrolled spread can be disruptive in survival worlds.
FieldValue
Key1.02_enablePlutoniumNetherOre
TypeBoolean
Defaultfalse
Enables plutonium ore generation in the Nether. The spawn rate is controlled separately by 2.N05_plutoniumSpawnrate in WorldConfig.
FieldValue
Key1.03_enableDungeonSpawn
TypeString (true / false / flag)
Defaultflag
Controls whether NTM structures and dungeons spawn. true forces them on, false forces them off, and flag (the default) defers to the Generate Structures world flag set at world creation.
FieldValue
Key1.04_enableOresInModdedDimensions
TypeBoolean
Defaulttrue
Allows NTM ores to generate in dimensions added by other mods. Disable if a modpack’s dimension has its own ore-generation system and you want to avoid overlap.
FieldValue
Key1.05_enableLandmineSpawn
TypeBoolean
Defaulttrue
Master toggle for landmine world generation. Frequency is controlled by 4.14_landmineSpawn in WorldConfig.
FieldValue
Key1.06_enableRadHotspotSpawn
TypeBoolean
Defaulttrue
Master toggle for radiation hotspot generation. Frequency is controlled by 4.15_radHotspotSpawn in WorldConfig.
FieldValue
Key1.14_enableBomberShortMode
TypeBoolean
Defaultfalse
Causes NTM bomber aircraft to spawn closer to their target. Useful on servers where render distance is limited and planes need to be visible to players before they arrive.
FieldValue
Key1.15_enableVaultSpawn
TypeBoolean
Defaulttrue
Master toggle for locked safe / vault world generation. Frequency is controlled by 4.16_vaultSpawn in WorldConfig.
FieldValue
Key1.17_enableCataclysm
TypeBoolean
Defaultfalse
When enabled, a satellite falls from the sky every time any mob dies anywhere in the world. Intended as a challenge/chaos mode; not recommended for normal survival play.
FieldValue
Key1.18_enableExtendedLogging
TypeBoolean
Defaultfalse
Logs every use of the detonator, every nuclear explosion, every missile launch, and every grenade throw to the server log. Useful for auditing on public servers.
FieldValue
Key1.20_enableGuns
TypeBoolean
Defaulttrue
Allows NTM’s new-system firearms to be fired. Set to false to prevent players from using guns while keeping all other mod content available.
FieldValue
Key1.21_enableVirus
TypeBoolean
Defaultfalse
Allows virus blocks to spread to adjacent blocks. Disabled by default due to the potential for uncontrolled world corruption.
FieldValue
Key1.22_enableCrosshairs
TypeBoolean
Defaulttrue
Shows NTM’s custom HUD crosshairs when holding a gun. Pure client-side cosmetic; disable if you prefer vanilla crosshairs or another mod’s overlay.
FieldValue
Key1.25_enableRenderDistCheck
TypeBoolean
Defaulttrue
Detects and corrects render distances above 16 chunks (which can cause visual and performance issues without OptiFine installed) and automatically lowers them to a safe value.
FieldValue
Key1.28_enableSilentCompStackErrors
TypeBoolean
Defaultfalse
Suppresses log spam caused by unregistered items being used in ComparableStack instances. Enable if your log is flooded with these messages from a third-party addon.
FieldValue
Key1.31_enableSkyboxes
TypeBoolean
Defaulttrue
Enables NTM’s custom skybox rendering. Disable if it conflicts with another mod’s sky effects.
FieldValue
Key1.32_enableImpactWorldProvider
TypeBoolean
Defaulttrue
Registers NTM’s custom world provider that adjusts sky colour and lighting to simulate post-nuclear-impact atmospheric effects.
FieldValue
Key1.33_enableStatReRegistering
TypeBoolean
Defaulttrue
Re-registers item crafting, breaking, and usage statistics for NTM items to work around a Forge bug where modded items fail to appear in the statistics screen.
FieldValue
Key1.34_enableKeybindOverlap
TypeBoolean
Defaulttrue
Handles NTM keybinds that would otherwise be silently ignored because they overlap with another registered keybind.
FieldValue
Key1.35_enableFluidContainerCompat
TypeBoolean
Defaulttrue
Ore-dictionaries NTM fluid containers so they are interchangeable with other mods’ containers in recipes. Also makes TrainCraft’s diesel a valid substitute for NTM diesel canisters.
FieldValue
Key1.36_enableMOTD
TypeBoolean
Defaulttrue
Shows the “Loaded mod!” chat message and any available update notifications when a player joins a world.
FieldValue
Key1.37_enableGuideBook
TypeBoolean
Defaulttrue
Gives new players the NTM guide book the first time they join the world.
FieldValue
Key1.39_enableSoundExtension
TypeBoolean
Defaulttrue
Increases the maximum number of simultaneous sounds beyond Minecraft’s default 28. The channel count is configured by 1.41_normalSoundChannels.
FieldValue
Key1.40_enableMekanismChanges
TypeBoolean
Defaulttrue
Modifies some of Mekanism’s recipes to integrate with NTM’s material progression. Disable if you want unmodified Mekanism recipes.
FieldValue
Key1.41_normalSoundChannels
TypeInteger
Default100
The number of sound channels to allocate when 1.39_enableSoundExtension is enabled. Values below 28 or above 200 can cause buggy sound behaviour and may affect other mods’ audio. The safe range is 28–200.
FieldValue
Key1.42_preferredOutputMod
TypeString List
Default["hbm"]
A list of mod IDs preferred as output sources when machines auto-generate recipes (currently used by the Shredder). NTM’s own mod ID (hbm) is the default.
FieldValue
Key1.43_enableLoadScreenReplacement
TypeBoolean
Defaulttrue
Replaces the vanilla loading screen with NTM’s “tip of the day” screen. May conflict with other mods that also attempt to replace the loading screen.
FieldValue
Key1.44_enableMachineGravity
TypeBoolean
Defaultfalse
Requires large multi-block machines to have a structurally valid foundation. If a machine lacks proper support, it tilts and breaks. This option operates independently from the 528 Mode version of the same mechanic (X528_enable528MachineGravity).

Expensive Mode

FieldValue
Key1.99_enableExpensiveMode
TypeBoolean
Defaultfalse
Enables “Expensive Mode”, which significantly increases the resource cost of many recipes across the mod. The config description reads simply “It does what the name implies.” Note that Expensive Mode is automatically disabled if the Precision Assembly Recipe set has been modified by a JSON override (PrecAssRecipes.INSTANCE.modified == true), ensuring JSON-customised servers are unaffected. You can check the effective state via the GeneralConfig.trueExp() method.

Mode 528

Mode 528 is an alternate hardcore gameplay configuration that makes the world significantly more hostile and resource-scarce. It changes boiler behaviour, adds hazardous world spawns, restricts certain machines, burns players in the Nether, and alters several recipes. All 528 sub-options require enable528Mode to be true before they take effect; the game forces the remaining sub-flags off if the master toggle is disabled.
528 Mode is explicitly marked CAUTION in the config file. It is not a casual difficulty option. When 528 Mode is active, Less Bullshit Mode (LBSM) is forcibly disabled.
FieldValue
Keyenable528Mode
Category528
TypeBoolean
Defaultfalse
The master switch for all 528 Mode behaviour. Must be true for the sub-options below to have any effect.
FieldValue
KeyX528_forceReasimBoilers
Category528
TypeBoolean
Defaulttrue
Locks the RBMK boiler dial to the ReaSim boiler type, preventing the use of non-ReaSim boiler columns and enforcing the use of dedicated steam inlets and outlets.
FieldValue
KeyX528_enableColtanDeposit
Category528
TypeBoolean
Defaulttrue
Spawns a large coltan deposit at a single random location in the world. Coltan is a critical resource in 528 Mode, and centralising it forces players to explore or contest the deposit.
FieldValue
KeyX528_enableColtanSpawning
Category528
TypeBoolean
Defaultfalse
Enables random coltan ore generation spread across the world (as opposed to the single deposit). This is separate from the deposit option. The vein frequency is set by X528_oreColtanFrequency.
FieldValue
KeyX528_enableBosniaSimulator
Category528
TypeBoolean
Defaulttrue
Causes anti-tank mines to spawn across the world. Pairs with the general landmine system but uses a separate spawn path tuned for 528 Mode’s hostile overworld.
FieldValue
KeyX528_enable528NetherBurn
Category528
TypeBoolean
Defaulttrue
Players take constant fire damage while in the Nether when this is enabled.
FieldValue
KeyX528_enable528PressurizedRecipes
Category528
TypeBoolean
Defaulttrue
Changes certain recipes to require pressurized fluid input rather than standard fluid input.
FieldValue
KeyX528_enable528ExplosiveEnergistics
Category528
TypeBoolean
Defaulttrue
Renders Applied Energistics 2 (AE2) unusable. This is intentional — 528 Mode targets a more manual, logistically demanding experience where ME networks are considered out of scope.
FieldValue
KeyX528_enable528MachineGravity
Category528
TypeBoolean
Defaulttrue
Requires most large machines to have a valid foundation in 528 Mode. Machines without one will tilt and break. Works independently from the standalone 1.44_enableMachineGravity option.
FieldValue
KeyX528_oreColtanFrequency
Category528
TypeInteger
Default2
Expected number of random coltan ore veins per chunk when X528_enableColtanSpawning is active. Does not affect deposit generation.

Less Bullshit Mode (LBSM)

Less Bullshit Mode is an optional set of quality-of-life simplifications designed to reduce grind without breaking core NTM progression. It is aimed at casual players and server operators who want a more accessible experience. LBSM is forcibly disabled whenever 528 Mode is active.
LBSM can alter progression in ways that affect recipe balance. It is generally considered server-friendly, but always inform your players before enabling it.
FieldValue
KeyenableLessBullshitMode
CategoryLESS BULLSHIT MODE
TypeBoolean
Defaultfalse
Master toggle for LBSM. Forcibly set to false when 528 Mode is active.
FieldValue
KeyLBSM_fullSchrab
CategoryLESS BULLSHIT MODE
TypeBoolean
Defaulttrue
Replaces schraranium with full schrabidium ingots in the transmutator output, reducing late-game material grind.
FieldValue
KeyLBSM_shortDecay
CategoryLESS BULLSHIT MODE
TypeBoolean
Defaulttrue
Drastically accelerates nuclear waste disposal drum decay. LBSM decay speed is 60× faster than 528 Mode and 5–12× faster than standard mode.
FieldValue
KeyLBSM_recipeSimpleArmor
CategoryLESS BULLSHIT MODE
TypeBoolean
Defaulttrue
Simplifies armor set recipes (starmetal, schrabidium, etc.) to require fewer intermediate materials.
FieldValue
KeyLBSM_recipeSimpleTool
CategoryLESS BULLSHIT MODE
TypeBoolean
Defaulttrue
Simplifies tool set recipes (starmetal, schrabidium, etc.) in the same way as the armor option.
FieldValue
KeyLBSM_recipeSimpleAlloy
CategoryLESS BULLSHIT MODE
TypeBoolean
Defaulttrue
Adds shortcut blast furnace recipes to make certain alloys cheaper to produce.
FieldValue
KeyLBSM_recipeSimpleChemistry
CategoryLESS BULLSHIT MODE
TypeBoolean
Defaulttrue
Simplifies selected chemical plant recipes to reduce the number of processing steps required.
FieldValue
KeyLBSM_recipeSimpleCentrifuge
CategoryLESS BULLSHIT MODE
TypeBoolean
Defaulttrue
Enhances centrifuge output quantities to make rare materials more accessible.
FieldValue
KeyLBSM_recipeUnlockAnvil
CategoryLESS BULLSHIT MODE
TypeBoolean
Defaulttrue
Makes all anvil recipes available from tier 1, removing the tier gate normally required.
FieldValue
KeyLBSM_recipeSimpleCrafting
CategoryLESS BULLSHIT MODE
TypeBoolean
Defaulttrue
Adds crafting table recipes for items that are otherwise uncraftable or excessively expensive. Also makes scorched uranium washable.
FieldValue
KeyLBSM_recipeSimpleMedicine
CategoryLESS BULLSHIT MODE
TypeBoolean
Defaulttrue
Makes medicine recipes (including those requiring bismuth) significantly more affordable.
FieldValue
KeyLBSM_safeCrates
CategoryLESS BULLSHIT MODE
TypeBoolean
Defaulttrue
Prevents crates from becoming radioactive when stored near radioactive materials.
FieldValue
KeyLBSM_safeMEDrives
CategoryLESS BULLSHIT MODE
TypeBoolean
Defaulttrue
Prevents AE2 ME Drives and Portable Cells from becoming radioactive.
FieldValue
KeyLBSM_schrabOreRate
CategoryLESS BULLSHIT MODE
TypeInteger
Default20
Changes the average amount of uranium ore required to produce one schrabidium ore through nuclear transmutation. Standard mode value is 100; LBSM lowers this to 20 by default, making schrabidium five times more attainable.

Build docs developers (and LLMs) love