Repository navigation
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": []
}| 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.
| 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": [
{
"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": []
}
]-
ClassNameis the tier you upgrade to:BSBB_WALL4_T2is the cost of armoring a wall,BSBB_FOUND4_T1the 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.
| 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. |
| 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. |
| 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). |
| 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. |
| 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. |
| 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. |
| 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). |
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). |
| 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). |
| 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. |
| 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.
| 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. |
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. |
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. |
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. |
| 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.
🏠 Home · 🔨 Building · 📋 Pieces · 🏴 Territory · ⚙️ Configuration · ❓ FAQ · 💬 Discord
🏗️ BS Base Building · © 2026 cjcarw · Repacking prohibited
🚀 Getting Started
- Home
- Installation
- Building Basics
- Pieces and Tiers
- Upgrade Repair and Dismantle
- Materials and the Materials Rack
⚔️ Systems
📖 Reference & Help