Skip to content

Configuration Reference

cjcarw edited this page Nov 4, 2026 · 17 revisions

⚙️ Configuration Reference

Every setting in <profile>/BS_BaseBuilding/bs_config.json (config version 34).

Important

Booleans are written as 1 / 0. A missing section or key takes its default. A value out of range is clamped in memory and a warning goes to the log; your file is not rewritten. Restart the server after editing — except AdminHammer, which is re-read every 15 seconds.

The server sends the config to the players so their ghost and HUD follow the same rules, except AdminHammer.SteamIds, which never leaves the server.

{
    "Version": 34,
    "Placement": { ... },
    "FreeBuild": { ... },
    "MultiBuild": { ... },
    "Pieces": { ... },
    "Compound": { ... },
    "Raid": { ... },
    "Decay": { ... },
    "Blueprints": { ... },
    "BuildPlan": { ... },
    "BuildHud": { ... },
    "AdminHammer": { ... },
    "Territory": { ... },
    "BSTerritory": { ... },
    "MaterialShelf": { ... },
    "RaidCharges": { ... },
    "EnableDebugLog": 0,
    "DisabledPieces": [],
    "CostOverrides": []
}

🔗 Jump to a section

Top level Placement FreeBuild
MultiBuild Pieces Compound
Raid Decay Blueprints
BuildPlan BuildHud AdminHammer
Territory BSTerritory MaterialShelf
RaidCharges Other files

Keys marked legacy are still read, so older files load, but they do nothing in this version.


Top level

Key Default Description
Version 34 Config version. Don't change it: older files are upgraded on start, and a copy of the old one is kept as bs_config_v<old version>.json.
EnableDebugLog 0 Extra [BS] lines in the server and client logs, including performance measurements.
DisabledPieces [] Pieces that can't be built, by piece id — the middle part of the class name, BSBB_WALL4_T1. Example: ["WATCHTOWER", "FAKEWALL"].
CostOverrides [] Replace the cost of any class: {"ClassName": "BSBB_WALL4_T2", "Materials": [{"ClassName": "MetalPlate", "Amount": 6}]}.

CostOverrides example

"CostOverrides": [
    {
        "ClassName": "BSBB_WALL4_T2",
        "Materials": [
            { "ClassName": "MetalPlate", "Amount": 6 },
            { "ClassName": "Nail", "Amount": 20 }
        ]
    },
    {
        "ClassName": "BSBB_FOUND4_T1",
        "Materials": [
            { "ClassName": "WoodenLog", "Amount": 2 },
            { "ClassName": "WoodenPlank", "Amount": 10 }
        ]
    },
    {
        "ClassName": "BSBB_SIGNS_T1",
        "Materials": []
    }
]
  • ClassName is the tier you upgrade to: BSBB_WALL4_T2 is the cost of armoring a wall, BSBB_FOUND4_T1 the cost of turning a foundation frame into logs. It must match exactly. All class names: Piece Reference.
  • The list replaces that step's whole recipe. Any item class works, vanilla or from another mod.
  • "Materials": [] makes the step free (the sign above).
  • Nails and wire are still left out while they are in Pieces.FreeMaterials.
  • It also changes the repairs of that tier (bastion pieces keep their fixed repair cost), the dismantle refund, undo and debris. It wins over Pieces.ConcreteRecipe.
  • Players see the new costs in the game: the server sends them.

Placement

Key Default Description
AimDistance 6.0 How far (m) the aim looks for a place for a new piece.
ReachDistance 5.0 Max distance (m) from the player to a piece's box to build on it, upgrade, repair, dismantle or rotate it.
PlaceHoldSeconds 0.7 How long the player holds the click to place a piece.
SnapSearchRadius 5.0 Radius (m) around the aimed point searched for pieces to snap to.
SnapCameraDistance 6.0 Snap places farther than this (m) from the camera are ignored.
SnapMaxScore 2.8 How loose a snap match may be (distance + angle); lower is stricter.
FoundationMinHeight -0.5 Lowest a foundation may sit over the ground (negative: it may sink into a slope).
FoundationMaxHeight 2.5 Highest a foundation may sit over the ground.
FoundationMaxLegLength 1.2 How far foundation legs may reach down to the ground.
MaxBuildHeight 25.0 No piece above this height (m) over the terrain — at sea, over the water or the deck of a ship below.
AllowFreePlacement 1 Legacy.
MaxHeightAdjust 3.0 How far (m) a piece may be raised or lowered from where it lands (not with FreeBuild.OpenMode).
HeightStep 0.05 Height step (m) when raising or lowering a piece with the wheel.
EnableAutoAlign 1 A free foundation near one of your own foundations takes its heading and 4 m grid.
AutoAlignDistance 9.0 Auto-align works within this distance (m) of your foundation.
AutoAlignTolerance 0.5 Snaps to the neighbour's grid node within this distance (m).
LockReleaseDistance 20.0 Legacy.
PlaceCooldown 0.3 Minimum time (s) between two placements of the same player.
WorldCollision 1 Pieces collide with map objects (houses, walls, fences). 0: only with other pieces, vehicles and containers. With FreeBuild.OpenMode on, map objects never block anyway.
WorldOverlap 0.5 How far (m) a piece may push into a map object before it counts as a collision.

FreeBuild

Key Default Description
Enabled 1 Free placement (no snapping) is allowed.
OpenMode 1 Open free placement: a free piece needs no support and goes up to Placement.MaxBuildHeight, and map objects (houses, walls, fences, rocks) never block a piece. Foundations still need ground under their legs. 0: free pieces need support and map objects block.
MaxRaise 0.5 How far (m) a free piece may be raised over its support (only with OpenMode off).
MaxBury 1.0 How deep (m) its highest corner may end up in the terrain.
SinkDepth 0.05 How far (m) the base sinks into the terrain so it never floats.
ArrowStep 0.05 Slide step (m) of ← / → (of all four arrows with "classic"); Shift: 1 cm.
FineRotateDegrees 1.0 Turn (degrees) of Ctrl + ← / →.
AutoFree "base" Pieces that go free when nothing fits: "base" (foundations, posts, compound and other ground pieces), "all" (every piece) or "nothing".
ControlScheme "square" Arrow keys: "square" (↑ Escuadra panel, ↓ snapping on/off, ← / → slide) or "classic" (the four arrows nudge the piece).
PanelEnabled 1 The Escuadra panel and its pill on the wheel.
HandEnabled 1 The Hand: hold Ctrl and move the mouse to turn and raise a free piece (keyboard and mouse only).
StepDegreesFine 2.5 Turn per wheel notch (degrees), Fine step.
StepDegreesNormal 15.0 Turn per wheel notch, Normal step.
StepDegreesCoarse 45.0 Turn per wheel notch, Coarse step.
StepMetersFine 0.01 Move per Page Up / Page Down press (m), Fine step.
StepMetersNormal 0.05 Move per press, Normal step.
StepMetersCoarse 0.25 Move per press, Coarse step.
DefaultStep 1 Step players start with: 0 Fine, 1 Normal, 2 Coarse.
DragYawPerUnit 0.2 Hand: degrees of turn per mouse unit.
DragMovePerUnit 0.002 Hand: metres along the active axis per mouse unit.
FineFactor 0.2 Hand: mouse speed with Shift held (magnets off).
MagnetDegrees 3.0 Heading magnets catch within this many degrees…
MagnetReleaseDegrees 6.0 …and let go beyond this many.
MagnetMeters 0.03 A slide stops flush against a neighbour's face within this distance (m).
MagnetRadius 9.0 Radius (m) searched for magnets and Align to nearest (your pieces, other bases, buildings).
AlignCandidates 3 How many nearby structures Align to nearest cycles through.
HeadingLockAfterTurn 1 After the first manual turn the heading stays fixed in the world while you look around.
FreezeReleaseDistance 8.0 A frozen ghost lets go when the player walks farther than this (m).
HandEndMoveDistance 0.5 Walking this far (m) while dragging with the Hand ends the drag and freezes the ghost.
HandDeadZone 6.0 Mouse travel before Ctrl turns into a drag (Ctrl + wheel and Ctrl + arrows keep working).
MuteVoiceZeroingWhileBuilding 1 While a ghost is shown, the arrows and Page Up / Page Down don't change voice level or zeroing.
ReachForGroundPieces 1 Free ground pieces (foundations, compound, fences, towers) also need the 5 m reach to their box.
RequireLineOfSight 1 The server refuses a free piece the player can't see from the head.
LineOfSightRays 3 Rays (1–3) from the head to the piece: box centre and the 2 nearest corners. One clear ray is enough.
BlockPlayersInBox 1 Refuse a piece whose box would contain a player, a body or an AI.
RejectBurstCount 6 After this many refused placements within RejectBurstWindow…
RejectBurstWindow 5.0 …seconds…
RejectBurstPause 3.0 …the server ignores that player's placements for this long (s).
TiltMaxDegrees 0.0 Reserved; no effect.

MultiBuild

Key Default Description
MaxWallRun 8 Walls placed in one run.
MaxBuildSeconds 4.0 Cap on the build time of a whole run or area.
ReachDistance 18.0 Max distance (m) from the player's feet to each piece of a run or area.
MaxAreaSize 3 Cells per side of a floor or foundation area.
AllowFloorAreas 1 Floor areas (from a floor edge or on top of a wall).
AllowFoundationAreas 1 Foundation areas (from a foundation edge).
AllowAreaOnGround 1 The first foundation of an area may start free on the ground.
MaxPalisadeRun 8 Palisade sections placed in one run.
EnablePalisadeEndPost 0 Add an end post at the open end of a palisade run (charged as one more piece).
AllowPalisadeOnGround 1 The first palisade section may start free on the ground (otherwise only from an open end).

Pieces

Key Default Description
MaterialsRadius 2.5 Materials on the ground within this radius (m) of the player count as carried.
DismantleRefund 0.5 Fraction of the cost given back on dismantle.
ReturnKitOnDismantle 0 Legacy.
RepairAmount 0.25 Health (fraction of max) restored per repair.
RepairCostFactor 0.5 Repair cost = tier cost × this × health restored.
UndoSeconds 60.0 After placing or upgrading, the same player can undo within this time for a full refund of that step.
AllowPlankWalls 1 Wall and gable frames can be finished with planks. 0: they stay frames.
AllowPlankToLogUpgrade 1 Legacy: plank walls upgrade to armored.
AllowMetalUpgrade 1 Pieces can be armored (metal sheets). Armored pieces that exist stay when off.
EnableAutoCornerPosts 1 A corner post appears where two finished walls meet.
AllowRotate 1 Built walls can be turned 180° and doors can swap their opening side.
RotateOwnerOnly 1 Only the owner (or a territory member) can rotate — turning a wall moves its weak side.
RotateCooldownSeconds 300.0 A piece can't be rotated, or upgraded to bastion, for this long after taking damage.
PeepholeAutoCloseSeconds 0.0 A door peephole closes by itself after this time (0 = stays open).
EnableBuildEffects 1 Dust, sawdust or sparks and a short sound when a building step finishes.
AllowConcreteUpgrade 1 Armored pieces can be upgraded to bastion. Bastion pieces that exist stay when off.
ConcreteUpgradeSeconds 12.0 How long the upgrade to bastion takes.
DefaultT3DoorStyle 0 Door style offered first when upgrading an armored door: 0 bastion, 1 reinforced.
ConcreteRecipe "blocks" Bastion recipe: "blocks" (concrete blocks + cement bags) or "classic" (cement bags + metal sheets + wire, no blocks).
MaxFloorOverhang 2 A new floor must be at most this many cells, floor to floor, from one held up by a wall, post, stairs, tower or foundation. 0 = no limit. Only checked when placing.
UpgradeSeconds 4.0 How long an upgrade takes (except to bastion).
UndoActionSeconds 2.0 How long an undo takes.
NonRefundableMaterials ["BSBB_CementBag"] Materials never given back on dismantle or in debris (undo still returns them).
FreeMaterials ["Nail", "MetalWire"] Materials no recipe asks for. [] charges them again.

Compound

Key Default Description
MaxPostRise 1.2 How much higher (m) the next palisade post may sit.
MaxSkirtDepth 1.5 How far (m) the ground may drop under a palisade section.
MaxGroundCover 0.45 How much (m) of a palisade section the ground may cover.
MaxGateGap 1.48 How far (m) the ground may drop under a gate.
AntiClimbDistance 5.0 No piece can be placed closer than this (m) to another group's compound.
EnableWalkwayTrims 1 Automatic trims on angled wall-walk joints.
WalkwayLadderYaw 180.0 Extra heading (degrees) of the climbable wall-walk ladder (0 if Climb shows on the wall side).
WalkwayLadderMaxGap 0.30 How far (m) the ladder foot may float over its support.
WalkwayLadderMaxBuried 0.15 How deep (m) the ladder foot may be buried.
BlockLooseGaps 1 A palisade section can't leave a gap over 0.25 m next to the loose end of another chain.

Raid

Key Default Description
HologramMultiplier 1.0 Raid damage multiplier on blueprints.
FrameMultiplier 1.0 … on frames.
LogMultiplier 1.0 … on the logs tier.
PlankMultiplier 1.0 … on plank walls.
MetalMultiplier 1.0 … on armored pieces.
ConcreteMultiplier 1.0 … on bastion pieces.
HingeMultiplier 1.5 Extra damage of a charge on a door hinge.
MetalHingeMultiplier 1.2 Same on an armored door (the hinge hides behind the plate).
ConcreteHingeMultiplier 1.2 Same on a bastion door.
SoftSideMultiplier 1.25 Extra damage of a charge on the weak inner side of a wall.
HingeRadius 0.35 A charge this close (m) to a hinge counts as on the hinge.
RuinSeconds 0.0 A destroyed piece stays as a ruin this long before it disappears.
EnableCollapseEffects 1 Dust, splinters or sparks and a sound when a piece is destroyed.
DebrisFraction 0.3 Fraction of the cost dropped as materials when a piece is destroyed.
DebrisChance 0.5 Chance that a destroyed piece drops anything.
BlockVehicleExitThroughWalls 1 Nobody gets out of a vehicle through a wall.

Decay

Key Default Description
GraceHours 72.0 Hours without a refresh before decay starts (outside a maintained territory).
FramePerHour 0.02 Health lost per hour (fraction of max) by frames.
LogPerHour 0.01 … by the logs tier.
PlankPerHour 0.015 … by plank walls.
MetalPerHour 0.0067 … by armored pieces (about 150 h from full to nothing).
ConcretePerHour 0.0045 … by bastion pieces (about 220 h).
CheckIntervalMinutes 30.0 How often decay is applied.
PiecesPerCheck 200 Pieces processed per check (spreads the load).

Blueprints

Blueprint marks (the Mark pill).

Key Default Description
MaxPerGroup 10 Marks per group (per player outside a territory). 0 turns marks off.
LifetimeHours 72.0 Real hours a mark lasts until someone builds it.
RequireTerritory 0 Marks only inside a territory you belong to (ignored when the system has no territories).
ViewDistance 60.0 Marks are drawn up to this distance (m).

BuildPlan

Key Default Description
Radius 60.0 Radius (m) around the player that the Build view covers when there is no territory.
MaxPieces 1200 Max pieces the Build view lists.
EnableLegacyRadial 0 Legacy.
Mode "blueprint" Legacy.
PlayerChoice 1 Legacy.
WheelInput "rmb" How the piece wheel opens: "rmb" (hold the Build wheel key, right mouse by default) or "lmb" (hold left mouse; a short click places, and there is no building in series).
LmbHoldSeconds 0.3 With "lmb": how long to hold left mouse to open the wheel.
HammerWheel 1 Hold right mouse with a hammer for the hammer wheel (only with "rmb").
HammerWheelHoldSeconds 0.25 How long to hold right mouse to open it.
HammerWheelHitLockSeconds 3.0 The hammer wheel doesn't open for this long after taking a hit.
HammerWheelEnemyRadius 5.0 The hammer wheel doesn't open with another player with raised hands this close (m). 0 = off.
HammerWheelRunsAction 1 Releasing on a hammer wheel option starts it (0: it only selects it).
FirstUseHints 1 The key help panel on the right while building (each player can turn it off in the Build view).

BuildHud

Key Default Description
HideVanillaHud 1 Hide the vanilla status icons while a build tool is in hand (the quickbar stays).
HideGpsMinimap 1 Hide the LBmaster GPS minimap while a build tool is in hand.
EnableChalkMarks 1 Legacy.
InspectDistance 20.0 Max distance (m) to see the details of the aimed piece.

AdminHammer

Key Default Description
SteamIds [] Steam64 ids (17 digits, up to 64) of your server admins. Used by the admin hammer, Territory.AllowAdminBypass and the territory Admin tab. Never sent to players. Re-read every 15 seconds.
NoWait 0 Admin hammer: upgrades, repairs, turns and dismantling finish at once.

See Admin Hammer.

Territory

Key Default Description
Provider "auto" Territory system: "auto", "bs", "vanilla", "expansion", "lbmaster" or "none". See Territory.
AllowAdminBypass 0 Admins in AdminHammer.SteamIds build, upgrade, repair, dismantle, rotate and fit locks anywhere, ignoring territories and no-build zones.
EnableRaidLog 1 Write raids to the territory history, one line per territory per minute. With 0 there is no raid alert either.
EnableRaidNotifications 1 Base under attack message to online members when a raid starts on their territory.
EnableRangeCage 1 Draw the 3D range of your own territory with the Building blueprint or a hammer in hand.

BSTerritory

Only with Territory.Provider = "bs" (the command cabinet).

Key Default Description
LevelRadius [20, 30, 40] Radius (m) at cabinet level 1, 2 and 3 (5 to 500, never decreasing).
HeightUp 40.0 Height (m) above the cabinet that belongs to the territory.
HeightDown 15.0 Depth (m) below the cabinet.
ForeignRing 25.0 Ring (m) around a territory where outsiders can't build; it also keeps other cabinets away.
MinHQDistance 100.0 Minimum distance (m) between two cabinets, holograms included.
MaxTerritoriesPerPlayer 1 Cabinets one player may own, holograms included (0 = no limit).
MaxMembers 10 Members per territory, owner included.
AllowBuildOutsideTerritory 1 Anyone may build outside every territory. 0: only inside your own (cabinets excepted).
MemberActions ["Build", "Upgrade", "Repair", "Dismantle", "Rotate", "Codelock", "Deposit"] What members may do. Names: Build, Upgrade, Repair, Dismantle, Rotate, Codelock, Deposit, Invite, Kick. [] = this default.
AdminActions all nine What territory admins may do (same names). [] = all of them.
UpkeepItems Nail 1, WoodenPlank 4, MetalPlate 8 Items that pay upkeep, as {"ClassName": "Nail", "Points": 1}. Child classes count too; up to 32 entries. [] = this default.
UpkeepBasePerDay [10, 20, 30] Points per day the cabinet itself costs at level 1, 2 and 3. The pieces inside add their own.
UpkeepMaxDays 14.0 Days of cost that can be paid in advance.
ResetLifetimeInRadius 1 While maintained, vanilla tents, barrels and other items in the radius don't despawn.
InviteDistance 10.0 Max distance (m) to invite a player.
RaidLogLines 40 Raid history lines kept per territory.

MaterialShelf

The Materials Rack. See Materials and the Materials Rack.

Key Default Description
Enabled 1 Building pays with the materials on nearby racks. 0: racks are plain storage.
Radius 20.0 Max distance (m) from the player to a rack whose materials count (0 = off, up to 60).
TakeFromShelfFirst 1 Racks pay first, then the inventory and the ground. 0: inventory, racks, ground.
RequireBuildPermission 1 A rack only pays where the player may build.
LockToTerritory 0 Only players who may build at the rack can put materials in or take them out.
RaidDropPercent 50 % of each material that falls to the ground when a rack is destroyed (the rest is lost). The command cabinet's storage uses it too.
Capacity the rack's capacity Per material, as {"ClassName": "WoodenPlank", "Amount": 200}. It can only lower what a rack holds.

RaidCharges

See Raiding.

Key Default Description
Enabled 1 The mod's raid charges: crafting, planting and damage. 0: none of it.
HomemadeDamage 750.0 Damage of a Homemade Explosive, before the hinge, side and tier multipliers of Raid.
HeavyDamage 1300.0 Damage of a Heavy Charge.
ArmSeconds 60.0 Countdown of a planted charge (s).
MaxTier 4 Highest tier a charge works on: 1 frame, 2 logs or planks, 3 armored, 4 bastion.
DoorsOnly 0 Charges only go on doors, gates, hatches, shutters and windows.
Radius 0.0 Also hits other BS pieces this close (m) to the charge. 0 = only the piece it is stuck to.
DefuseSeconds 8.0 How long defusing takes (s).
DefuseTools ["Pliers"] Items that defuse a planted charge.
Gunpowder 5 Gunpowder portions to prime a Charge Casing, and again to overpack it (1 to 10).
CraftSeconds 10.0 Crafting time of each step of the charge chain; the Heavy Charge takes 1.5 times that.

Other files

File Page
bs_finishes.json · bs_finishes_unlocks.json Paint Roller and Signs
bs_signs.json Paint Roller and Signs
bs_healing.json Upgrade Repair and Dismantle
bs_fake.json — Limit 1, Per "territory" or "player" Pieces and Tiers

Tip

Something not working? See FAQ and Troubleshooting.

Clone this wiki locally