Skip to content
Nicholas Kreimeyer edited this page Nov 4, 2026 · 1 revision

The configuration is the file config/openmodularturrets.json. Every key is documented in the file itself with a comment describing it, its range and its default. On a server, the server's values are sent to the clients.

Sections

turrets

General turret behaviour:

Key Default Description
doTurretsNeedAmmo true turrets need ammo to fire
globalCanTargetPlayers / globalCanTargetNeutrals / globalCanTargetMobs true switch a target category off for all bases
turretDamageTrustedPlayers false trusted players take damage when hit by accident
turretTargetSearchTicks 10 ticks between target searches
turretWarnMessage / turretAlarmSound true warn untrusted players entering the warning range
turretWarningDistance 5 warning distance in blocks, added to the turret range
turretSoundVolume 4 volume of firing sounds
turretBreakable false turrets can be broken with a pickaxe (restart needed)
canTurretsConcealWithoutAddon false turrets conceal themselves without the concealer addon
canRocketsHome false rockets steer towards their target
canRocketsDestroyBlocks / canGrenadesDestroyBlocks / canRailgunDestroyBlocks false explosions or slugs destroy blocks
canRocketsHurtEnderDragon false rocket explosions damage the Ender Dragon
dropTurretsOverMaxSimultaneous false turrets over their type's maxSimultaneous drop (otherwise the limit only applies when placing)

Then one section per turret (disposable_turret, machine_gun_turret, …) with its stats, see Turret Heads for the defaults:

Key Description
enabled the turret can be crafted and placed
baseRange range in blocks before range upgrades
baseFireRate ticks between shots (lower is faster)
baseDamage damage per hit before the damage boost addon
powerUsage energy per shot
baseAccuracyDeviation inaccuracy in percent
maxSimultaneous max turrets of this type per base
damageAmp share of the target's health added as damage per damage boost addon
fireRateUpgrade, rangeUpgrade, accuracyUpgrade, efficiencyUpgrade bonus per upgrade, see Upgrades and Addons
recyclerNegateChance, recyclerAddChance recycler addon chances

Turrets added by other mods get the same keys under addon_turrets."<mod id>:<turret>".

bases

One section per tier (tier_1 … tier_5) with baseMaxCharge, baseMaxIo, baseMaxTurrets, baseAmmoStacks, baseBlastResistance and baseHardness (see Turret Bases), plus:

Key Default Description
allowBaseCamo true bases can be camouflaged (restart needed)
baseBreakable false bases can be broken with tools
allowContraptionMovement true Create / Create Aeronautics contraptions may move bases and turrets
unownedBasesActive false bases without an owner fire at everyone instead of staying inert
claimSpreadLimit 1024 how many connected blocks one claim may take over

general

Key Default Description
canOPAccessOwnedBlocks false operators may open every base and are never targeted
fakePlayersCanClaim false machines' fake players may claim unowned blocks
useWhitelistForAmmo true only listed items are disposable ammo
ammoAllowList minecraft:cobblestone,2, #minecraft:planks,1 disposable ammo as item[,damageBonus] or #tag[,damageBonus]
mobBlackList minecraft:armor_stand entities that are never targeted
mobForceList minecraft:creeper entities that always count as hostile
neutralForceList minecraft:cow entities that always count as neutral

See Targeting System for how the lists are applied.

miscellaneous

Key Default Description
solarPanelAddonGen 10 energy per tick of the solar panel addon
redstoneReactorAddonGen 1600 energy per redstone dust of the redstone reactor addon
generatorEnergyPerTick 40 generator output while burning, before upgrades
generatorCapacity 1,000,000 generator energy buffer
generatorMaxOutput 65,536 generator output per tick to all neighbours together

passiveDefense

Per tier: hardness, explosionResistance and fenceDamage of the hardened blocks, walls and fences (no restart needed), see Passive Defense.

expanders

Per tier: stacks, hardness and explosionResistance of the inventory expanders, see Generator and Energy.

Updating

When the defaults change in a new version, config files that still contain the old defaults are updated automatically; values you changed stay as they are.

Clone this wiki locally