Repository navigation
Configuration Reference
The settings are in four files in <profile>/BS_BaseBuilding/, config version 35:
| File | What it has | Read |
|---|---|---|
bs_config.json |
How building works: placement, free building, pieces, compound, blueprint marks, the Build view and the Materials Rack. | At start |
bs_territory.json |
Territory system, the command cabinet, decay, healing, building limits and vanilla building. | Every minute |
bs_raid.json |
Raid hours, what can be raided, how many charges each piece takes, the mod's charges and raid damage. | Every minute |
bs_admin.json |
Admins and logs. | Every 15 seconds |
bs_finishes.json and bs_signs.json are explained in Paint Roller and Signs.
Important
-
1means on and0means off. - Options are numbers too. The description says what each number means, for example
0Set square and1classic. - When a new version adds options, the server adds the missing keys to your files at start, with their default values. Everything you wrote stays as it is: values, order and formatting. A copy of the old file goes to
backups/, and the log lists the keys it added. It also lists keys the mod doesn't know, which are often typos. - 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
bs_config.json. The other three files are read again while the server runs, exceptTerritory.System, which needs a restart. - Keys marked Advanced are fine-tuning. Most servers never change them.
- Distances are in meters and times in seconds, unless the key says something else.
The server sends the building rules to the players, so the ghost and the HUD follow the same rules. The admins' Steam ids are never sent.
| File | Sections |
|---|---|
bs_config.json |
Placement, FreeBuild, MultiBuild, Pieces, Compound, Blueprints, BuildPlan, BuildHud, MaterialShelf, ConcreteMixer |
bs_territory.json |
Territory, BSTerritory, Decay, Healing, Limits, VanillaBuilding |
bs_raid.json |
RaidMode, Schedule, ChargesToDestroy, WeakSpots, ModCharges, Destruction |
bs_admin.json |
AdminHammer, Logging |
How building works. Read at start.
| Key | Default | Description |
|---|---|---|
Version |
35 |
Config version. Don't change it. |
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 upgrading a wall to metal, andBSBB_DOOR1_T2the cost of making a door metal. 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. Concrete pieces keep their fixed repair cost.
- It has priority over
Pieces.ConcreteRecipeType. - Players see the new costs in the game, because the server sends them.
- Every time it starts, the server writes
bs_default_costs.jsonnext tobs_config.json, with the default cost of every piece in this same format. Copy only the entries you want to change. Don't copy all of them: the pieces you list keep their numbers even if a mod update changes them, and the whole list is sent to every player when they connect.
If you change many costs and don't want the server to send them to every player, change them in a small mod instead. The release has an example in extras/BS_BaseBuilding_CostsExample/config.cpp, with every piece and its default cost:
- Keep only the pieces you change and delete the rest.
- Change the numbers in
bsCost[]:"material class", "amount", .... - Pack the folder as a PBO and load it with
-modon the server and on the players, for example inside your server's own mod. Players without it see the default costs.
CostOverrides in bs_config.json has priority over this mod. With Pieces.ConcreteRecipeType 1, change bsClassicCost[] for the concrete pieces instead, and with 2, bsBagsCost[].
| 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 |
Advanced. Radius (m) around the aimed point where pieces to snap to are searched. |
SnapCameraDistance |
6.0 |
Advanced. Snap places farther than this (m) from the camera are ignored. |
SnapMaxScore |
2.8 |
Advanced. 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. |
FoundationMaxWaterDepth |
6.0 |
A foundation can sit on the sea bottom if the water is no deeper than this (m), to start a stack (see Pieces.MaxStackedFoundations). 0: no foundations in the water. Ship decks and piers still work, ponds never do. Up to 20. |
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. |
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 |
Advanced. Snaps to the grid of the other foundation within this distance (m). |
PlaceCooldown |
0.3 |
Advanced. 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 |
Advanced. 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 |
Advanced. How far (m) the base sinks into the terrain, so it never floats. |
ArrowStep |
0.05 |
How far (m) ← / → slide the piece. With ArrowKeys 1, the four arrows. With Shift, 1 cm. |
FineRotateDegrees |
1.0 |
How much (degrees) Ctrl + ← / → turn the piece. |
AutoFreeMode |
1 |
Pieces that are placed free when nothing fits. 0: none. 1: foundations, posts, compound and other ground pieces. 2: every piece. |
ArrowKeys |
0 |
Arrow keys. 0: ↑ opens the Set square panel, ↓ turns snapping on or off, and ← / → slide the piece. 1 (classic): the four arrows move the piece. |
PanelEnabled |
1 |
The Set square 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 |
Advanced. Hand: degrees of turn per mouse unit. |
DragMovePerUnit |
0.002 |
Advanced. Hand: meters along the selected axis per mouse unit. |
FineFactor |
0.2 |
Advanced. Hand: mouse speed while you hold Shift. The magnets are off. |
MagnetDegrees |
3.0 |
Advanced. The direction snaps to a magnet within this many degrees. |
MagnetReleaseDegrees |
6.0 |
Advanced. The magnet lets go beyond this many degrees. |
MagnetMeters |
0.03 |
Advanced. A slide stops flush against the side of another piece within this distance (m). |
MagnetRadius |
9.0 |
Advanced. Radius (m) where magnets and Align to nearest look for your pieces, other bases and buildings. |
AlignCandidates |
3 |
Advanced. How many nearby structures Align to nearest goes through. |
HeadingLockAfterTurn |
1 |
Advanced. After the first turn by hand, the direction stays fixed while you look around. |
FreezeReleaseDistance |
8.0 |
Advanced. A frozen ghost is released when the player walks farther than this (m). |
HandEndMoveDistance |
0.5 |
Advanced. Walking this far (m) while you use the Hand ends it and freezes the ghost. |
HandDeadZone |
6.0 |
Advanced. How far the mouse moves before holding Ctrl becomes the Hand. Ctrl + wheel and Ctrl + arrows still work. |
MuteVoiceZeroingWhileBuilding |
1 |
Advanced. 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 |
Advanced. 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 |
Advanced. After this many refused placements in RejectBurstWindow seconds, the server ignores that player's placements for RejectBurstPause seconds. |
RejectBurstWindow |
5.0 |
Advanced. See RejectBurstCount. |
RejectBurstPause |
3.0 |
Advanced. See RejectBurstCount. |
| 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. 0.5 is 50 %. |
RepairAmount |
0.25 |
Health given back by each repair, as a part of the maximum. 0.25 is 25 %. |
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. |
AllowMetalUpgrade |
1 |
Pieces can be upgraded to metal. With 0, the metal 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 concrete. |
PeepholeAutoCloseSeconds |
30.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 |
Metal pieces can be upgraded to concrete. With 0, the concrete pieces that already exist stay. |
ConcreteUpgradeSeconds |
12.0 |
How long the upgrade to concrete takes. |
DefaultT3DoorStyle |
0 |
The door style offered first when upgrading a metal door. 0: concrete. 1: reinforced. |
ConcreteRecipeType |
0 |
Concrete recipe. 0: concrete blocks only (cement bags go into the concrete mixer). 1 (classic): cement bags, metal sheets and wire, without blocks. 2: concrete blocks and cement bags, as before the mixer. |
MaxStackedFoundations |
4 |
Foundations can be stacked one on top of another every 1.5 m, like in Rust, up to this many in a pile. 0: no stacking. Up to 12. |
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 concrete. |
UndoActionSeconds |
2.0 |
How long Undo takes. |
BlockVehicleExitThroughWalls |
1 |
Nobody can get out of a vehicle through a wall. |
EnableVanillaCodelock |
1 |
Enables BS Base Building's integration with the vanilla digital code lock (DayZ 1.30). Set to 0 to let another mod that modifies this lock, such as LBmaster's code lock mod, handle it instead. Restart the server and reconnect clients after changing it. See Doors and Code Locks. |
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. |
BuildTools |
["Hammer", "Hatchet"] |
Tools that build, upgrade, repair and rotate. Subclasses count too. Only Hammer, Hatchet and Crowbar (and what inherits from them) work: other classes are left out with a warning in the log. The big axes and the sledgehammer don't have the building animation. [] means the default list. Up to 16. |
DismantleTools |
["Crowbar", "Hatchet", "Hammer"] |
Tools that dismantle. Same classes as BuildTools. |
| Key | Default | Description |
|---|---|---|
MaxPostRise |
1.2 |
Advanced. How much higher (m) the next palisade post can be. |
MaxSkirtDepth |
1.5 |
Advanced. How far (m) the ground can drop under a palisade section. |
MaxGroundCover |
0.45 |
Advanced. How much (m) of a palisade section the ground can cover. |
MaxGateGap |
1.48 |
Advanced. 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. |
WalkwayLadderMaxGap |
0.30 |
Advanced. How far (m) the foot of the ladder can be above its support. |
WalkwayLadderMaxBuried |
0.15 |
Advanced. 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. |
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. |
WheelButton |
0 |
How the piece wheel opens. 0: hold the Build wheel key, right mouse by default. 1: hold left mouse. With 1, a short click places and there is no building in series. |
LmbHoldSeconds |
0.3 |
With WheelButton 1, how long to hold left mouse to open the wheel. |
HammerWheel |
1 |
Hold right mouse with a hammer for the hammer wheel. Only with WheelButton 0. |
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. |
InspectDistance |
20.0 |
Maximum distance (m) to see the details of the piece you aim at. |
TeammateGhosts |
1 |
Territory members see where a teammate is placing with the blueprint. Each player can still turn it off in their options. With 0, nobody sees them and nothing is sent. |
HealthBar |
1 |
A health bar when aiming at a built piece. Each player can still turn it off in their options. With 0, nobody gets it, and owners see the health in the piece card. |
HealthBarOutsiders |
1 |
Players who aren't owners or territory members also see the bar, in 4 steps. Owners and members see the exact value. With 0, only owners and members see it. |
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 |
WoodenPlank 200, WoodenLog 50, MetalPlate 120, BSBB_ConcreteBlock 80, BSBB_CementBag 50, Nail 600, MetalWire 20 | Amount per material, as {"ClassName": "WoodenPlank", "Amount": 200}. It can only lower what a rack holds. |
The concrete mixer makes concrete blocks from cement bags and stones. The blocks come out on its pallet.
| Key | Default | Description |
|---|---|---|
Enabled |
1 |
Mixers can be started. With 0, they are only storage. |
BagsPerBatch |
1 |
Cement bags per batch (0 to 4). |
StonesPerBatch |
8 |
Stones per batch (0 to 32). |
WaterLitersPerBatch |
0.0 |
Liters of water per batch. With 0 there is no water tank and no water action. |
BlocksPerBatch |
4 |
Concrete blocks out of each batch (1 to 24). |
EngineSecondsPerBatch |
60.0 |
How long a batch takes, pouring included (20 to 3600 s; the pour is the last 14 s). |
FuelLitersPerBatch |
0.0 |
Liters of gasoline per batch. With 0 there is no fuel tank and no fuel action. |
WaterTankLiters |
20.0 |
Water tank size (1 to 200 L), when water is used. |
FuelTankLiters |
5.0 |
Fuel tank size (1 to 50 L), when fuel is used. |
RequireSparkPlug |
1 |
The engine needs a spark plug. |
RequireBattery |
1 |
The engine needs a charged car or truck battery. It isn't used up. |
LockToTerritory |
1 |
Only players who can build at the mixer can use it and open its slots. |
PublicMixersNeedParts |
0 |
Public mixers also need the spark plug and the battery. |
PublicMixers |
one example, off | Public mixers the server places on start, as {"Enabled": 1, "Position": [x, y, z], "Orientation": [yaw, pitch, roll]}. A y of 0 puts it on the ground. Enabled 0 keeps an entry as an example, not placed; without Enabled it counts as 1. Changes apply after a restart. |
Public mixers. Anyone can use them, even without build rights. Nobody can dismantle or damage them, they don't decay, they don't count for the limits and they aren't saved: what's left inside is lost on restart. Besides PublicMixers, you can place BSBB_MIXER_T1 with the DayZ Editor and export it to an object spawner in cfggameplay.json (objectSpawnersArr): it becomes public too.
A new bs_config.json comes with one entry to copy, turned off: a mixer at Novaya Petrovka (Chernarus).
"PublicMixers": [
{
"Enabled": 0,
"Position": [2974.235596, 210.982101, 12642.432617],
"Orientation": [-90.0, 0.0, 0.0]
}
]On Chernarus, set Enabled to 1 to get that mixer. On any map, add your own entries with the Position and Orientation the DayZ Editor gives you. A file that already had "PublicMixers": [] stays empty.
No mixer on your server: "DisabledPieces": ["MIXER"] takes it out of the build wheel, and Enabled 0 stops the ones already built. Then set Pieces.ConcreteRecipeType to 1 or 2, so concrete pieces don't depend on blocks made in the mixer.
The territory and everything that depends on it. Read again every minute (Territory.System only at start).
| Key | Default | Description |
|---|---|---|
Version |
1 |
Don't change it. |
| Key | Default | Description |
|---|---|---|
System |
1 |
Territory system. 1: the mod's own command cabinet. 0: auto, the loaded system with the highest priority. 2: the vanilla flag, only for upkeep. 3: Expansion territories. 4: LBmaster plotpole flags. 7: no territory. See Territory. |
EnableRangeCage |
1 |
Shows the 3D range of your territory when you hold the Building blueprint or a hammer. |
Only with Territory.System set to 1 (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). |
MemberCan |
all 1 except Invite and Kick
|
What members can do: Build, Upgrade, Repair, Dismantle, Rotate, Codelock, Deposit, Invite and Kick, each 1 or 0. Undo counts as dismantling. |
AdminCan |
all 1
|
What territory admins can do, with the same nine. |
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. |
Example: members can build and repair, but not dismantle, rotate, put on locks, invite or kick.
"MemberCan": {
"Build": 1,
"Upgrade": 1,
"Repair": 1,
"Dismantle": 0,
"Rotate": 0,
"Codelock": 0,
"Deposit": 1,
"Invite": 0,
"Kick": 0
}Pieces outside a maintained territory lose health after some time without activity.
| Key | Default | Description |
|---|---|---|
GraceHours |
72.0 |
Hours without activity on a piece before it starts to decay. |
FramePerHour |
0.02 |
Health lost per hour by frames, as a part of the maximum. 0.02 is 2 % per hour. |
LogPerHour |
0.01 |
Health lost per hour by the logs tier. 0.01 is 1 % per hour. |
PlankPerHour |
0.015 |
Health lost per hour by plank walls. |
MetalPerHour |
0.0067 |
Health lost per hour by metal pieces. About 150 hours from full health to zero. |
ConcretePerHour |
0.0045 |
Health lost per hour by concrete pieces. About 220 hours from full health to zero. |
CheckIntervalMinutes |
30.0 |
Advanced. How often decay is applied. |
PiecesPerCheck |
200 |
Advanced. Pieces processed in each check, to spread the load. |
Damaged pieces in a maintained territory heal by themselves. See Upgrade Repair and Dismantle.
| Key | Default | Description |
|---|---|---|
Enabled |
1 |
Turns healing on or off. |
PercentPerHour |
5.0 |
Health healed per hour, in % of the maximum. 5 is 5 % per hour. |
DelayMinutes |
60.0 |
Minutes without damage before healing starts. |
How many pieces a territory or a player can build. By default there are no limits, except one fake wall or floor per territory, and one per player outside territories. See Limits and Raid Rules.
| Key | Default | Description |
|---|---|---|
Enabled |
1 |
Turns the limits on or off. |
Territory |
FakePanels 1, the rest 0
|
Limits per territory. 0 means no limit. |
OutsideTerritory |
FakePanels 1, the rest 0
|
Limits per player, for the pieces built outside all territories. |
PerPlayer |
all 0
|
Limits per player, for all the pieces each player built anywhere. |
The vanilla kits: fence, watchtower, shelter and territory flag. See Limits and Raid Rules.
| Key | Default | Description |
|---|---|---|
Enabled |
1 |
With 0, players can't place the vanilla kits or build parts on vanilla structures. |
DisabledKits |
[] |
Kits that can't be placed or crafted, for example "FenceKit". |
BlockBuildingParts |
0 |
With 1, players can't build parts on vanilla structures that already exist. |
Raid hours, what can be raided and the explosives. Read again every minute.
| Key | Default | Description |
|---|---|---|
Version |
4 |
Don't change it. |
RaidMode |
0 |
What can be raided. 0 everything, 1 doors only (doors, gates, hatches and fake panels), 2 doors and windows, 3 what Raidable says. See Limits and Raid Rules. |
Raidable |
all 1
|
Only with RaidMode 3: which kinds of finished pieces can be raided, 1 or 0 for each category. All in 0 means no finished piece can be raided. |
RaidLog |
1 |
Writes raids to the territory history, one line per territory per minute. |
RaidNotifications |
1 |
Sends a Base under attack message to online members when a raid starts on their territory. |
Tip
- To raid everywhere, leave
RaidModeat0. - To raid only through doors, set
RaidModeto1. Walls, floors, roofs, windows and the other pieces that don't open can't be blown up, and they can only be dismantled from the inside. - To raid through doors and windows, set
RaidModeto2. - For your own mix, set
RaidModeto3and choose inRaidable. If you changeRaidablewhileRaidModeisn't3, the server log warns you that it isn't used.
Note
Four sections are about explosives:
-
ChargesToDestroy: how many charges each piece takes. A piece without a row uses the default row of its tier. -
WeakSpots: door hinges and the inner side of walls, where a charge counts for more. -
ModCharges: the mod's own charges, like the countdown, defusing and crafting. -
Destruction: what a destroyed piece leaves.
The tiers are named like in the game: Frame, Planks, Metal and Concrete. Planks is tier 1: plank walls and the log tier of floors, doors and the other pieces. Reinforced doors are concrete doors with another look, so they use Concrete.
The raid hours. Off by default, with an example inside: Friday and Saturday from 18:00 to 02:00 and Sunday from 14:00 to 22:00. See Limits and Raid Rules.
| Key | Default | Description |
|---|---|---|
Enabled |
0 |
Turns raid hours on. |
TimeZone |
"server" |
"server" is the clock of the server PC. You can also write an offset like "UTC-3", "UTC+1" or "UTC+5:30". |
OnlyInTerritory |
0 |
With 1, pieces outside all territories can always be raided. |
ProtectFrames |
0 |
With 1, frames and blueprints are protected outside raid hours too. |
Windows |
the example above | The hours, as {"Days": "fri,sat", "From": "18:00", "To": "02:00"}. A window can cross midnight. |
How many charges each piece takes, from the strong side. A 0 means that charge does nothing to the piece, and it can't be planted on it. The default table, the keys and many examples are in Limits and Raid Rules.
A charge on these spots counts for more. You don't have to do the math: the Rules tab of the Build view and the server log show how many charges that makes for each tier, for example raid charges from the inside of a wall (x1.25): Planks 4/2 -> 4/2, Metal 8/4 -> 7/4, Concrete 12/6 -> 10/5.
| Key | Default | Description |
|---|---|---|
PlanksHingeMultiplier |
1.5 |
A charge on the hinge of a planks door counts 1.5 times. |
MetalHingeMultiplier |
1.2 |
The same on the hinge of a metal door. |
ConcreteHingeMultiplier |
1.2 |
The same on the hinge of a concrete or reinforced door. |
InnerSideMultiplier |
1.25 |
A charge on the inner side of a wall or a palisade section counts 1.25 times. |
HingeRadius |
0.35 |
Advanced. A charge this close (m) to a hinge counts as on the hinge. |
With the default table these are the charges (homemade / heavy):
| Tier | Strong side of a wall | Inner side of a wall | Door, strong side | Door hinge |
|---|---|---|---|---|
| Planks | 4 / 2 | 4 / 2 | 2 / 1 | 2 / 1 |
| Metal | 8 / 4 | 7 / 4 | 4 / 2 | 4 / 2 |
| Concrete | 12 / 6 | 10 / 5 | 6 / 3 | 5 / 3 |
The mod's raid charges. See Raiding.
| Key | Default | Description |
|---|---|---|
Enabled |
1 |
The mod's raid charges: crafting, planting and damage. With 0, none of it. |
ArmSeconds |
60.0 |
Countdown of a planted charge (s). |
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. |
ReturnOnDefuse |
1 |
The player who defuses a charge gets it back whole, in the condition it had when it was planted. It goes to their inventory, or drops at their feet if it doesn't fit. With 0, a defused charge is lost. |
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. |
What a destroyed piece leaves.
| Key | Default | Description |
|---|---|---|
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. 0.3 is 30 %. |
DebrisChance |
0.5 |
Chance that a destroyed piece drops anything. 0.5 is half of the time. |
Admins and logs. Read again every 15 seconds.
| Key | Default | Description |
|---|---|---|
Version |
1 |
Don't change it. |
| Key | Default | Description |
|---|---|---|
SteamIds |
[] |
Steam64 ids of your server admins. 17 digits each, up to 64. Used by the admin hammer, IgnoreTerritory, IgnoreLimits and the territory Admin tab. Never sent to players. |
NoWait |
0 |
With the admin hammer, upgrades, repairs, rotations and dismantling finish at once. |
IgnoreTerritory |
0 |
Admins can build, upgrade, repair, dismantle, rotate and put on locks anywhere. Territories and no-build zones don't apply to them. |
IgnoreLimits |
1 |
Admins have no building limits, the vanilla building rules don't apply to them, and they can dismantle from any side when only some pieces can be raided. |
See Admin Hammer.
| Key | Default | Description |
|---|---|---|
DebugLog |
0 |
Adds more [BS] lines to the server and client logs, including performance measurements. |
Doors |
1 |
Logs doors opened and closed, wrong codes, code changes, and locks put on or taken off. |
HQNails |
1 |
Not used in this version. |
ScriptLog |
1 |
Writes these lines to the server's script_*.log. |
CFTools |
1 |
Also sends them to CF Tools. Needs GameLabs. |
| File | Page |
|---|---|
bs_finishes.json, bs_finishes_unlocks.json
|
Paint Roller and Signs |
bs_signs.json |
Paint Roller and Signs |
bs_default_costs.json (written by the server, never read) |
CostOverrides |
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