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.

Beyond the general feature flags, NTM splits its more specialised configuration across several focused classes, each writing to a dedicated category inside config/HBM_NTM.cfg. This page covers MachineConfig (RTG/betavoltaic decay), WeaponConfig (CIWS accuracy, dangerous item drops, animation style), BombConfig (per-weapon explosion radii and blast parameters), WorldConfig (ore spawn rates, structure frequencies, meteor settings, and biome IDs), and ServerConfig (a JSON-backed runtime config for server operators). All settings except those marked otherwise can be applied without a full restart using /ntmreload.
Run /ntmreload after editing HBM_NTM.cfg to apply most changes instantly. Changes to ore-generation rates, biome IDs, and world provider registration always require a full Minecraft restart and affect only newly generated chunks.

Machine Config — 09_machines

The machine category currently controls RTG (Radioisotope Thermoelectric Generator) and betavoltaic cell behaviour.
FieldValue
Key9.00_scaleRTGPower
Category09_machines
TypeBoolean
Defaultfalse
When enabled, the power output of RTG and betavoltaic fuel scales down proportionally as the fuel decays. A fully fresh fuel cell produces maximum power; a nearly-depleted one produces very little. When disabled, RTGs produce constant power regardless of their remaining fuel lifetime.
FieldValue
Key9.01_doRTGsDecay
Category09_machines
TypeBoolean
Defaulttrue
Whether RTG and betavoltaic fuel decays at all over time. Set to false for infinite-duration fuel cells — useful in creative or test environments, but removes a key resource management aspect of the late game.

Weapon Config

Weapon-related options are spread across two categories: 07_missile_machines for CIWS behaviour, 10_dangerous_drops for item drop physics, and 18_weapons for animation preferences.
FieldValue
Key7.03_ciwsAccuracy
Category07_missile_machines
TypeInteger
Default50
An additional modifier applied to the CIWS (Close-In Weapon System) interception accuracy. Higher values increase hit probability against incoming projectiles such as missiles. This is a raw modifier, not a percentage — consult the CIWS entity code for how it is applied in the interception formula.
FieldValue
Key10.00_dropCell
Category10_dangerous_drops
TypeBoolean
Defaulttrue
When true, dropping an antimatter cell item on the ground causes it to explode. Set to false to make antimatter cells safe to drop (e.g. for servers that use item-sorting pipes).
FieldValue
Key10.01_dropBHole
Category10_dangerous_drops
TypeBoolean
Defaulttrue
When true, dropping singularity or black hole items spawns the corresponding entity. Disable to prevent accidental singularity creation when managing inventory near storage.
FieldValue
Key10.02_dropStar
Category10_dangerous_drops
TypeBoolean
Defaulttrue
When true, dropping rigged star blaster cells causes them to explode on contact with the ground.
FieldValue
Key10.04_dropCrys
Category10_dangerous_drops
TypeBoolean
Defaulttrue
When true, dropping xen crystals causes them to push or displace nearby blocks on impact.
FieldValue
Key10.05_dropDead
Category10_dangerous_drops
TypeBoolean
Defaulttrue
When true, dropping dead man’s explosives causes them to detonate. Disable if you want to handle these items safely in pipes or sorting systems.
FieldValue
Key18.00_linearAnimations
Category18_weapons
TypeBoolean
Defaultfalse
When true, replaces NTM’s heavily stylised (non-linear, cinematic) weapon animations with more conventional linear animations. Useful for players who find the default animations disorienting or too flashy.

Bomb Config — Explosion Radii & Blast Parameters

The 03_nukes and 06_explosions categories let server operators tune every explosion in the mod — from handheld grenades to the Tsar Bomba. All radius values are in blocks.
KeyDeviceDefault Radius
3.00_gadgetRadiusThe Gadget (Trinity-style)150
3.01_boyRadiusLittle Boy120
3.02_manRadiusFat Man175
3.03_mikeRadiusIvy Mike250
3.04_tsarRadiusTsar Bomba500
3.05_prototypeRadiusPrototype device150
3.06_fleijaRadiusF.L.E.I.J.A.50
3.07_missileRadiusNuclear missile100
3.08_mirvRadiusMIRV warhead100
3.09_fatmanRadiusFatman Launcher35
3.10_nukaRadiusNuka grenade25
3.11_aSchrabRadiusDropped anti-schrabidium20
3.12_soliniumRadiusBlue Rinse / solinium150
3.13_n2RadiusN2 mine200
Each value is an integer read directly from the 03_nukes config category. Changing these values affects all future detonations of that device.
FieldValue
Key6.00_limitExplosionLifespan
Category06_explosions
TypeInteger
Default0
How many seconds (based on system time) a procedural explosion can remain loaded in an unloaded chunk before it is automatically terminated. 0 disables this limit. Useful on servers where abandoned explosions in unloaded areas waste memory.
FieldValue
Key6.01_blastSpeed
Category06_explosions
TypeInteger
Default1024
Base propagation speed of MK3 system explosions (old-style and schrabidium detonations), measured in blocks per tick. Higher values cause the blast wave to expand faster but may increase per-tick load during the explosion event.
FieldValue
Key6.02_mk5BlastTime
Category06_explosions
TypeInteger
Default50
Minimum number of milliseconds per game tick allocated for MK5 chunk processing during an active explosion. Higher values give the MK5 explosion system more time per tick, producing a faster-looking blast at the cost of higher CPU usage.
FieldValue
Key6.03_falloutRange
Category06_explosions
TypeInteger
Default100
The radius of the nuclear fallout area, expressed as a percentage of the base explosion radius. 100 means fallout extends as far as the explosion itself. 200 would double the fallout radius relative to the blast radius.
FieldValue
Key6.04_falloutDelay
Category06_explosions
TypeInteger
Default4
Number of ticks to wait between fallout chunk computation steps. Increasing this value spreads fallout processing over more ticks, reducing instantaneous server load at the cost of slower fallout spread.
FieldValue
Key6.05_enableChunkLoading
Category06_explosions
TypeBoolean
Defaulttrue
Allows all procedural explosions to force-load the central chunk and generate new chunks as the blast wave expands. Disabling this prevents explosions from loading unloaded terrain but may cause the blast to stop prematurely at chunk boundaries.
FieldValue
Key6.06_explosionAlgorithm
Category06_explosions
TypeInteger (0, 1, or 2)
Default2
Selects the algorithm used for MK5 explosion processing:
  • 0Legacy: Original explosion algorithm.
  • 1Threaded DDA: Uses a Digital Differential Analyzer on a background thread for faster processing.
  • 2Threaded DDA with damage accumulation (default): Same as mode 1 but also accumulates material resistance along each ray, producing more physically accurate crater shapes.

World Config — Ore Generation

All ore spawn rates are in the 02_ores category. Overworld rates are veins-per-chunk; bedrock ore rates are spawn weights (higher = more common relative to other bedrock ores); nether rates are veins-per-chunk in the Nether.
KeyDescriptionDefault
2.D00_overworldOresMaster switch for overworld ore generationtrue
2.D01_netherOresMaster switch for Nether ore generationtrue
2.D02_endOresMaster switch for End ore generationtrue
These do not affect special structures like oil bubbles or trixite crystals.
KeyOreDefault (veins/chunk)
2.00_uraniumSpawnrateUranium7
2.01_titaniumSpawnrateTitanium8
2.02_sulfurSpawnrateSulfur5
2.03_aluminiumSpawnrateAluminium7
2.04_copperSpawnrateCopper12
2.05_fluoriteSpawnrateFluorite6
2.06_niterSpawnrateNiter6
2.07_tungstenSpawnrateTungsten10
2.08_leadSpawnrateLead6
2.09_berylliumSpawnrateBeryllium6
2.10_thoriumSpawnrateThorium7
2.11_ligniteSpawnrateLignite2
2.12_asbestosSpawnRateAsbestos2
2.13_lithiumSpawnRateSchist lithium6
2.14_rareEarthSpawnRateRare earth6
2.16_gasShaleSpawnRateOil shale5
2.17_gasBubbleSpawnRateGas bubble (1-in-N chunks)12
2.18_cinnebarSpawnRateCinnebar1
2.18_cobaltSpawnRateCobalt2
2.19_explosiveBubbleSpawnRateExplosive gas bubble (1-in-N chunks, 0 = off)0
2.20_alexandriteSpawnRateAlexandrite (1-in-N chunks)100
2.21_oilSpawnRateOil bubble (1-in-N chunks)100
2.22_bedrockOilSpawnRateBedrock oil node (1-in-N chunks)200
2.23_meteoriteSpawnRateFallen meteorite (1-in-N chunks)200
KeyOreDefault Weight
2.NB_newBedrockOresMaster toggle for new bedrock orestrue
2.B00_bedrockIronWeightIron100
2.B01_bedrockCopperWeightCopper200
2.B02_bedrockBoraxWeightBorax50
2.B03_bedrockAsbestosWeightAsbestos50
2.B04_bedrockNiobiumWeightNiobium50
2.B05_bedrockTitaniumWeightTitanium100
2.B06_bedrockTungstenWeightTungsten100
2.B07_bedrockGoldWeightGold50
2.B08_bedrockUraniumWeightUranium35
2.B09_bedrockThoriumWeightThorium50
2.B10_bedrockCoalWeightCoal200
2.B11_bedrockNiterWeightNiter50
2.B12_bedrockFluoriteWeightFluorite50
2.B13_bedrockRedstoneWeightRedstone50
2.B14_bedrockChlorocalciteWeightChlorocalcite35
2.B15_bedrockNeodymiumWeightNeodymium50
2.B16_bedrockRareEarthWeightRare earth50
2.B17_bedrockBauxiteWeightBauxite100
2.B18_bedrockEmeraldWeightEmerald50
2.BN00_bedrockGlowstoneWeightGlowstone (Nether)100
2.BN01_bedrockPhosphorusWeightPhosphorus (Nether)50
2.BN01_bedrockQuartzWeightQuartz (Nether)100
KeyDescriptionDefault
2.C00_ironClusterSpawnIron cluster veins/chunk4
2.C01_titaniumClusterSpawnTitanium cluster veins/chunk2
2.C02_aluminiumClusterSpawnAluminium cluster veins/chunk3
2.C03_copperClusterSpawnCopper cluster veins/chunk4
2.L00_enableHematiteToggle hematite depositstrue
2.L01_enableMalachiteToggle malachite depositstrue
2.L02_enableBauxiteToggle bauxite depositstrue
2.L02_limestoneSpawnLimestone veins/chunk1
2.C00_enableSulfurCaveToggle sulfur cavestrue
2.C01_enableAsbestosCaveToggle asbestos cavestrue
KeyOreDefault (veins/chunk)
2.N00_uraniumSpawnrateNether uranium8
2.N01_tungstenSpawnrateNether tungsten10
2.N02_sulfurSpawnrateNether sulfur26
2.N03_phosphorusSpawnrateNether phosphorus24
2.N04_coalSpawnrateNether coal8
2.N05_plutoniumSpawnrateNether plutonium (if enabled)8
2.N06_cobaltSpawnrateNether cobalt2
2.E00_tikiteSpawnrateEnd trixite8

World Config — Structure & Event Frequencies

All structure frequencies in the 04_dungeons and related categories use a 1-in-N-chunks model: higher values mean rarer spawns. Values that would evaluate to zero or below are automatically replaced with a safe default.
KeyStructureDefault (1 per N chunks)
4.01_antennaSpawnRadio antenna250
4.02_atomSpawnPower plant500
4.04_dungeonSpawnLibrary dungeon64
4.06_satelliteSpawnSatellite dish500
4.10_dudSpawnDud bomb500
4.11_spaceshipSpawnSpaceship crash1000
4.12_barrelSpawnWaste tank5000
4.13_broadcasterSpawnCorrupt broadcaster5000
4.14_landmineSpawnAP landmine64
4.15_radHotspotSpawnRadiation hotspot5000
4.16_vaultSpawnLocked safe2500
4.18_geyserChlorineSpawnPoison geyser3000
4.19_geyserVaporSpawnVapor geyser250
4.21_capsuleSpawnLanding capsule100
4.22_arcticVaultSpawnArctic code vault500
4.23_jungleDungeonSpawnJungle dungeon2000
4.24_pyramidSpawnPyramid4000
KeyDescriptionDefault
5.00_enableMeteorStrikesToggle meteor impact eventstrue
5.01_enableMeteorShowersToggle meteor showers (1% chance per spawned meteor)true
5.02_enableMeteorTailsToggle particle trails on falling meteorstrue
5.03_enableSpecialMeteorsToggle rare special-impact meteorstrue
5.03_meteorStrikeChanceAverage ticks between meteor strikes216000 (≈3 h)
5.04_meteorShowerChanceAverage ticks between meteors during a shower18000 (≈15 min)
5.05_meteorShowerDurationMax shower duration in ticks36000 (≈30 min)
KeyDescriptionDefault
17.B_toggleToggle biome changes caused by nuclear explosionstrue
17.B00_craterBiomeIdBiome ID for crater biome80
17.B01_craterBiomeInnerIdBiome ID for inner crater81
17.B02_craterBiomeOuterIdBiome ID for outer crater rim82
17.R00_craterBiomeRadRAD/s in the crater biome5.0
17.R01_craterBiomeInnerRadRAD/s in the inner crater25.0
17.R02_craterBiomeOuterRadRAD/s in the outer crater rim0.5
17.R03_craterBiomeWaterMultRAD/s multiplier when in water within crater biomes5.0
Biome ID values must not conflict with other mods’ biome IDs. If you change these, do so before creating the world — biome IDs are baked into chunk data and cannot be remapped retroactively.

Server Config — hbmServer.json

Unlike the Forge .cfg file, ServerConfig is backed by a JSON file at config/hbmConfig/hbmServer.json. It is created automatically on first launch and can be edited in-game using the /ntmserver command. Changes are written back to the file immediately and take effect at runtime without a reload command.
FieldValue
KeyDAMAGE_COMPATIBILITY_MODE
TypeBoolean
Defaultfalse
Enables a compatibility shim for damage calculations that helps NTM work alongside mods that use non-standard health or damage systems.
KeyMine TypeDefault Damage
MINE_AP_DAMAGEAnti-personnel mine10.0
MINE_HE_DAMAGEHigh-explosive mine35.0
MINE_SHRAP_DAMAGEShrapnel mine7.5
MINE_NUKE_DAMAGENuke mine100.0
MINE_NAVAL_DAMAGENaval mine60.0
All values are in half-hearts of damage. These can be tuned individually to balance PvP or survival difficulty.
FieldValue
KeyTAINT_TRAILS
TypeBoolean
Defaultfalse
When enabled, tainted entities leave a contamination trail as they move.
KeyDescriptionDefault
CRATE_OPEN_HELDWhether crates can be opened while held in handtrue
CRATE_KEEP_CONTENTSWhether crates retain their contents when brokentrue
FieldValue
KeyITEM_HAZARD_DROP_TICKRATE
TypeInteger
Default2
How frequently (in ticks) hazardous dropped items are evaluated for their environmental effects. Lower values increase responsiveness at the cost of more frequent checks.
FieldValue
KeyENABLE_MKU
TypeBoolean
Defaulttrue
Enables the MKU (a specific weapon system). Disable to prevent players from using it.
FieldValue
KeySTRUCTURE_DEBUG
TypeBoolean
Defaultfalse
Enables debug logging for structure generation. Useful when diagnosing why structures are or aren’t spawning.
FieldValue
KeyAUTOCAL_MAX_CLOCK
TypeInteger
Default20
Maximum clock rate (in ticks) for the auto-calibration system. Controls how frequently automatic calibration routines are allowed to run.

Build docs developers (and LLMs) love