Skip to content

Configuration Reference

cjcarw edited this page Nov 4, 2026 · 18 revisions

⚙️ Configuration Reference

These are all the settings in <profile>/BS_BaseBuilding/bs_config.json, config version 34.

Important

In this file, booleans are written as 1 and 0. A missing section or key uses its default. A value out of range is corrected in memory and the log shows a warning, but your file isn't rewritten. Restart the server after you edit the file. The only exception is AdminHammer, which is read again every 15 seconds.

The server sends this config to the players, so the ghost and the HUD follow the same rules. The only thing it doesn't send is AdminHammer.SteamIds.

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

🔗 Sections

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 don't do anything in this version.


Top level

Key Default Description
Version 34 Config version. Don't change it. Older files are updated at start, and the old file is kept as bs_config_v<old version>.json.
EnableDebugLog 0 Adds more [BS] lines to the server and client logs, including performance measurements.
DisabledPieces [] Pieces that can't be built. Use the piece id, which is the middle part of the class name: BSBB_WALL4_T1 has the id WALL4. Example: ["WATCHTOWER", "FAKEWALL"].
CostOverrides [] Changes the cost of any class. See the example below.

CostOverrides example

"CostOverrides": [
    {
        "ClassName": "BSBB_WALL4_T2",
        "Materials": [
            {
                "ClassName": "MetalPlate",
                "Amount": 6
            }
        ]
    },
    {
        "ClassName": "BSBB_DOOR1_T2",
        "Materials": [
            {
                "ClassName": "MetalPlate",
                "Amount": 4
            }
        ]
    },
    {
        "ClassName": "BSBB_SIGNS_T1",
        "Materials": []
    }
]
  • ClassName is the tier you upgrade to. BSBB_WALL4_T2 is the cost of making a wall armored, and BSBB_DOOR1_T2 the cost of making a door armored. The name must match exactly. All class names are in Piece Reference.
  • The list replaces the whole recipe of that step. You can use any item class, from vanilla or from another mod.
  • "Materials": [] makes the step free, like the sign in the example.
  • Nails and wire are still left out while they are in Pieces.FreeMaterials.
  • It also changes the repairs of that tier, the dismantle refund, Undo and the materials a destroyed piece drops. Bastion pieces keep their fixed repair cost.
  • It has priority over Pieces.ConcreteRecipe.
  • Players see the new costs in the game, because 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 Maximum distance (m) from the player to a piece 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 where pieces to snap to are searched.
SnapCameraDistance 6.0 Snap places farther than this (m) from the camera are ignored.
SnapMaxScore 2.8 How loose a snap can be, by distance and angle. A lower value is stricter.
FoundationMinHeight -0.5 Lowest height of a foundation over the ground. A negative value lets it sink into a slope.
FoundationMaxHeight 2.5 Highest height of a foundation over the ground.
FoundationMaxLegLength 1.2 How far down the legs of a foundation can reach.
MaxBuildHeight 25.0 Maximum height (m) of a piece over the terrain. At sea it counts from the water or from the deck of a ship.
AllowFreePlacement 1 Legacy.
MaxHeightAdjust 3.0 How far (m) a piece can be raised or lowered from where it lands. Not used with FreeBuild.OpenMode.
HeightStep 0.05 Height step (m) when you raise or lower a piece with the wheel.
EnableAutoAlign 1 A free foundation near one of your foundations takes its direction and its 4 m grid.
AutoAlignDistance 9.0 Auto-align works within this distance (m) of your foundation.
AutoAlignTolerance 0.5 Snaps to the grid of the other foundation within this distance (m).
LockReleaseDistance 20.0 Legacy.
PlaceCooldown 0.3 Minimum time (s) between two placements by the same player.
WorldCollision 1 Pieces collide with map objects like houses, walls and fences. With 0, they only collide with other pieces, vehicles and containers. With FreeBuild.OpenMode on, map objects don't block pieces anyway.
WorldOverlap 0.5 How far (m) a piece can go into a map object before it counts as a collision.

FreeBuild

Key Default Description
Enabled 1 Free placement (without snapping) is allowed.
OpenMode 1 A free piece doesn't need support and can go up to Placement.MaxBuildHeight. Map houses, walls, fences and rocks don't block pieces. Foundations still need ground under their legs. With 0, free pieces need support and map objects block them.
MaxRaise 0.5 How far (m) a free piece can be raised over its support. Only with OpenMode off.
MaxBury 1.0 How deep (m) the highest corner of a piece can be under the terrain.
SinkDepth 0.05 How far (m) the base sinks into the terrain, so it never floats.
ArrowStep 0.05 How far (m) ← / → slide the piece. With "classic", the four arrows. With Shift, 1 cm.
FineRotateDegrees 1.0 How much (degrees) Ctrl + ← / → turn the piece.
AutoFree "base" Pieces that are placed free when nothing fits. "base": foundations, posts, compound and other ground pieces. "all": every piece. "nothing": none.
ControlScheme "square" Arrow keys. "square": ↑ opens the Escuadra panel, ↓ turns snapping on or off, and ← / → slide the piece. "classic": the four arrows move the piece.
PanelEnabled 1 The Escuadra panel and its button on the wheel.
HandEnabled 1 The Hand: hold Ctrl and move the mouse to turn and raise a free piece. Only with keyboard and mouse.
StepDegreesFine 2.5 Turn per wheel notch (degrees) with the Fine step.
StepDegreesNormal 15.0 Turn per wheel notch with the Normal step.
StepDegreesCoarse 45.0 Turn per wheel notch with the Coarse step.
StepMetersFine 0.01 Move per Page Up / Page Down press (m) with the Fine step.
StepMetersNormal 0.05 Move per press with the Normal step.
StepMetersCoarse 0.25 Move per press with the Coarse step.
DefaultStep 1 The step players start with: 0 Fine, 1 Normal, 2 Coarse.
DragYawPerUnit 0.2 Hand: degrees of turn per mouse unit.
DragMovePerUnit 0.002 Hand: meters along the selected axis per mouse unit.
FineFactor 0.2 Hand: mouse speed while you hold Shift. The magnets are off.
MagnetDegrees 3.0 The direction snaps to a magnet within this many degrees.
MagnetReleaseDegrees 6.0 The magnet lets go beyond this many degrees.
MagnetMeters 0.03 A slide stops flush against the side of another piece within this distance (m).
MagnetRadius 9.0 Radius (m) where magnets and Align to nearest look for your pieces, other bases and buildings.
AlignCandidates 3 How many nearby structures Align to nearest goes through.
HeadingLockAfterTurn 1 After the first turn by hand, the direction stays fixed while you look around.
FreezeReleaseDistance 8.0 A frozen ghost is released when the player walks farther than this (m).
HandEndMoveDistance 0.5 Walking this far (m) while you use the Hand ends it and freezes the ghost.
HandDeadZone 6.0 How far the mouse moves before holding Ctrl becomes the Hand. Ctrl + wheel and Ctrl + arrows still work.
MuteVoiceZeroingWhileBuilding 1 While a ghost is shown, the arrows and Page Up / Page Down don't change the voice level or the zeroing.
ReachForGroundPieces 1 Free ground pieces (foundations, compound, fences, towers) also need the 5 m reach.
RequireLineOfSight 1 The server doesn't accept a free piece that the player can't see from the head.
LineOfSightRays 3 Rays (1 to 3) from the head to the piece: the centre and the 2 closest corners. One clear ray is enough.
BlockPlayersInBox 1 A piece can't be placed where a player, a body or an AI is.
RejectBurstCount 6 After this many refused placements in RejectBurstWindow seconds, the server ignores that player's placements for RejectBurstPause seconds.
RejectBurstWindow 5.0 See RejectBurstCount.
RejectBurstPause 3.0 See RejectBurstCount.
TiltMaxDegrees 0.0 Reserved. It does nothing.

MultiBuild

Key Default Description
MaxWallRun 8 Walls placed in one row.
MaxBuildSeconds 4.0 Maximum build time of a whole row or area.
ReachDistance 18.0 Maximum distance (m) from the player to each piece of a row or area.
MaxAreaSize 3 Cells per side of a floor or foundation area.
AllowFloorAreas 1 Floor areas, from the edge of a floor or the top of a wall.
AllowFoundationAreas 1 Foundation areas, from the edge of a foundation.
AllowAreaOnGround 1 The first foundation of an area can start free on the ground.
MaxPalisadeRun 8 Palisade sections placed in one row.
EnablePalisadeEndPost 0 Adds an end post at the open end of a palisade row. It is paid as one more piece.
AllowPalisadeOnGround 1 The first palisade section can start free on the ground. With 0, 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 Part of the cost given back when a piece is dismantled.
ReturnKitOnDismantle 0 Legacy.
RepairAmount 0.25 Health (part of the maximum) given back by each repair.
RepairCostFactor 0.5 The repair cost is the tier cost, times this value, times the health given back.
UndoSeconds 60.0 After placing or upgrading, the same player can undo it within this time and get back everything paid for that step.
AllowPlankWalls 1 Wall and gable frames can be upgraded with planks. With 0, they stay frames.
AllowPlankToLogUpgrade 1 Legacy. Plank walls upgrade to armored.
AllowMetalUpgrade 1 Pieces can be upgraded to armored. With 0, the armored pieces that already exist stay.
EnableAutoCornerPosts 1 A corner post appears where two finished walls meet.
AllowRotate 1 Built walls can be turned 180°, and doors can change the side they open to.
RotateOwnerOnly 1 Only the owner, or a territory member, can rotate. Turning a wall moves its weak side.
RotateCooldownSeconds 300.0 For this long after taking damage, a piece can't be rotated or upgraded to bastion.
PeepholeAutoCloseSeconds 0.0 A door peephole closes by itself after this time. With 0, it 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. With 0, the bastion pieces that already exist stay.
ConcreteUpgradeSeconds 12.0 How long the upgrade to bastion takes.
DefaultT3DoorStyle 0 The door style offered first when upgrading an armored door. 0: bastion. 1: reinforced.
ConcreteRecipe "blocks" Bastion recipe. "blocks": concrete blocks and cement bags. "classic": cement bags, metal sheets and wire, without blocks.
MaxFloorOverhang 2 A new floor can be at most this many cells away from a floor that rests on a wall, post, stairs, tower or foundation. 0 means no limit. Only checked when you place a floor.
UpgradeSeconds 4.0 How long an upgrade takes, except the upgrade to bastion.
UndoActionSeconds 2.0 How long Undo takes.
NonRefundableMaterials ["BSBB_CementBag"] Materials that are never given back when you dismantle, and never dropped by destroyed pieces. Undo still gives them back.
FreeMaterials ["Nail", "MetalWire"] Materials that no recipe asks for. Use [] to charge them again.

Compound

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

Raid

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

Decay

Key Default Description
GraceHours 72.0 Hours without activity before decay starts, outside a maintained territory.
FramePerHour 0.02 Health lost per hour by frames, as a part of the maximum.
LogPerHour 0.01 Health lost per hour by the logs tier.
PlankPerHour 0.015 Health lost per hour by plank walls.
MetalPerHour 0.0067 Health lost per hour by armored pieces. About 150 hours from full health to zero.
ConcretePerHour 0.0045 Health lost per hour by bastion pieces. About 220 hours from full health to zero.
CheckIntervalMinutes 30.0 How often decay is applied.
PiecesPerCheck 200 Pieces processed in each check, to spread the load.

Blueprints

These are the blueprint marks (the Mark button on the wheel).

Key Default Description
MaxPerGroup 10 Marks per group. Outside a territory, per player. 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. It is ignored if the territory 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 shows when there is no territory.
MaxPieces 1200 Maximum number of 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. "lmb": hold left mouse. With "lmb", 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 the hammer wheel.
HammerWheelHitLockSeconds 3.0 The hammer wheel doesn't open for this long after you are hit.
HammerWheelEnemyRadius 5.0 The hammer wheel doesn't open if another player with raised hands is this close (m). 0 turns this off.
HammerWheelRunsAction 1 Letting go on a hammer wheel option starts it. With 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 Hides the vanilla status icons while a build tool is in hand. The quickbar stays.
HideGpsMinimap 1 Hides the LBmaster GPS minimap while a build tool is in hand.
EnableChalkMarks 1 Legacy.
InspectDistance 20.0 Maximum distance (m) to see the details of the piece you aim at.

AdminHammer

Key Default Description
SteamIds [] Steam64 ids of your server admins. 17 digits each, up to 64. Used by the admin hammer, Territory.AllowAdminBypass and the territory Admin tab. Never sent to players. Read again every 15 seconds.
NoWait 0 With the admin hammer, upgrades, repairs, rotations 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 can build, upgrade, repair, dismantle, rotate and put on locks anywhere. Territories and no-build zones don't apply to them.
EnableRaidLog 1 Writes raids to the territory history, one line per territory per minute. With 0 there is no raid alert either.
EnableRaidNotifications 1 Sends a Base under attack message to online members when a raid starts on their territory.
EnableRangeCage 1 Shows the 3D range of your territory when you hold the Building blueprint or a hammer.

BSTerritory

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

Key Default Description
LevelRadius [20, 30, 40] Radius (m) at cabinet level 1, 2 and 3. From 5 to 500, and each value can't be lower than the one before.
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 other players can't build. It also keeps other cabinets away.
MinHQDistance 100.0 Minimum distance (m) between two cabinets. Holograms count.
MaxTerritoriesPerPlayer 1 Cabinets one player can own, holograms included. 0 means no limit.
MaxMembers 10 Members per territory, including the owner.
AllowBuildOutsideTerritory 1 Anyone can build outside all territories. With 0, only inside your own territory (placing cabinets is still allowed).
MemberActions ["Build", "Upgrade", "Repair", "Dismantle", "Rotate", "Codelock", "Deposit"] What members can do. The names are Build, Upgrade, Repair, Dismantle, Rotate, Codelock, Deposit, Invite and Kick. [] means this default.
AdminActions All nine What territory admins can do, with the same names. [] means 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. [] means this default.
UpkeepBasePerDay [10, 20, 30] Points per day that the cabinet itself costs at level 1, 2 and 3. The pieces inside add their own cost.
UpkeepMaxDays 14.0 Days of cost that can be paid in advance.
ResetLifetimeInRadius 1 While the territory is maintained, vanilla tents, barrels and other items in the radius don't despawn.
InviteDistance 10.0 Maximum 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 uses the materials on nearby racks. With 0, racks are only storage.
Radius 20.0 Maximum distance (m) from the player to a rack whose materials count. 0 turns it off, and the maximum is 60.
TakeFromShelfFirst 1 Racks pay first, then the inventory and the ground. With 0: inventory, racks, ground.
RequireBuildPermission 1 A rack only pays where the player can build.
LockToTerritory 0 Only players who can build at the rack can put materials in or take them out.
RaidDropPercent 50 % of each material that drops when a rack is destroyed. The rest is lost. The command cabinet's storage uses it too.
Capacity The rack's capacity Amount 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. With 0, none of it.
HomemadeDamage 750.0 Damage of a Homemade Explosive, before the hinge, side and tier multipliers in 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 wood, 3 armored, 4 bastion.
DoorsOnly 0 Charges can only be planted on doors, gates, hatches, shutters and windows.
Radius 0.0 Also damages other BS pieces this close (m) to the charge. 0 means only the piece it is attached to.
DefuseSeconds 8.0 How long it takes to defuse a charge (s).
DefuseTools ["Pliers"] Items that can defuse a planted charge.
Gunpowder 5 Portions of gunpowder to prime a Charge Casing, and again to overpack it. From 1 to 10.
CraftSeconds 10.0 Crafting time of each step. The Heavy Charge takes 1.5 times longer.

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_limits.json, bs_raid_schedule.json Limits and Raid Hours

Tip

Something isn't working? See FAQ and Troubleshooting.

Clone this wiki locally