Repository navigation
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": []
}| 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.
| 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": [
{
"ClassName": "BSBB_WALL4_T2",
"Materials": [
{
"ClassName": "MetalPlate",
"Amount": 6
}
]
},
{
"ClassName": "BSBB_DOOR1_T2",
"Materials": [
{
"ClassName": "MetalPlate",
"Amount": 4
}
]
},
{
"ClassName": "BSBB_SIGNS_T1",
"Materials": []
}
]-
ClassNameis the tier you upgrade to.BSBB_WALL4_T2is the cost of making a wall armored, andBSBB_DOOR1_T2the 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.
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
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). |
| 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. |
| 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. |
| 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.
| 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. |
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. |
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. |
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. |
| 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.
🏠 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