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. - 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
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 |
bs_territory.json |
Territory, BSTerritory, Decay, Healing, Limits, VanillaBuilding |
bs_raid.json |
Schedule, Charges, Explosives, Damage |
bs_admin.json |
AdminHammer, Logging |
The first start of this version splits an old bs_config.json (version 34) and the separate files into the four files, with your values. Copies of the old files go to backups/, and the log says what was done.
| Before | Now |
|---|---|
bs_config.json: Territory, BSTerritory, Decay
|
bs_territory.json |
bs_config.json: Raid
|
bs_raid.json: Damage
|
bs_config.json: RaidCharges
|
bs_raid.json: Explosives
|
RaidCharges.DoorsOnly |
bs_raid.json: DoorsOnly
|
Raid.BlockVehicleExitThroughWalls |
bs_config.json: Pieces.BlockVehicleExitThroughWalls
|
bs_config.json: AdminHammer
|
bs_admin.json: AdminHammer
|
Territory.AllowAdminBypass |
bs_admin.json: AdminHammer.IgnoreTerritory
|
Territory.EnableRaidLog, Territory.EnableRaidNotifications
|
bs_raid.json: RaidLog, RaidNotifications
|
EnableDebugLog |
bs_admin.json: Logging.DebugLog
|
bs_limits.json |
bs_territory.json: Limits and VanillaBuilding
|
bs_limits.json: AdminBypass
|
bs_admin.json: AdminHammer.IgnoreLimits
|
bs_healing.json |
bs_territory.json: Healing
|
bs_log.json |
bs_admin.json: Logging
|
bs_raid.json version 2: RaidableCategories
|
bs_raid.json version 3: Raidable
|
Options that were words are numbers now, and lists of names are a 1 or 0 for each item. Old values are converted:
| Before | Now |
|---|---|
Territory.Provider: "auto", "bs", "vanilla", "expansion", "lbmaster", "none"
|
Territory.System: 0, 1, 2, 3, 4, 7
|
FreeBuild.AutoFree: "nothing", "base", "all"
|
FreeBuild.AutoFreeMode: 0, 1, 2
|
FreeBuild.ControlScheme: "square", "classic"
|
FreeBuild.ArrowKeys: 0, 1
|
Pieces.ConcreteRecipe: "blocks", "classic"
|
Pieces.ConcreteRecipeType: 0, 1
|
BuildPlan.WheelInput: "rmb", "lmb"
|
BuildPlan.WheelButton: 0, 1
|
BSTerritory.MemberActions, AdminActions
|
BSTerritory.MemberCan, AdminCan
|
RaidableCategories |
Raidable |
These keys were removed because they didn't do anything: Placement.AllowFreePlacement, Placement.LockReleaseDistance, FreeBuild.TiltMaxDegrees, Pieces.ReturnKitOnDismantle, Pieces.AllowPlankToLogUpgrade, Compound.WalkwayLadderYaw, BuildPlan.EnableLegacyRadial, BuildPlan.Mode, BuildPlan.PlayerChoice and BuildHud.EnableChalkMarks. bs_raid_schedule.json and bs_fake.json aren't read anymore.
A bs_config.json older than version 34 is copied to backups/ and the server starts with the default values.
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 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.ConcreteRecipeType. - 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 |
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. |
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 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 |
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 |
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. |
ConcreteRecipeType |
0 |
Bastion recipe. 0: concrete blocks and cement bags. 1 (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. |
BlockVehicleExitThroughWalls |
1 |
Nobody can get out of a vehicle through a wall. |
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 |
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. |
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 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 |
0 |
Territory system. 0: auto, the loaded system with the highest priority. 1: the mod's own command cabinet. 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 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 |
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 |
3 |
Don't change it. |
Raidable |
all 1
|
Which kinds of finished pieces can be raided, 1 or 0 for each category. All in 0 means no finished piece can be raided. See Limits and Raid Rules. |
DoorsOnly |
0 |
With 1, the mod's charges can only be planted on pieces that open: doors, gates, hatches, shutters and windows. |
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. |
Note
Three sections are about explosives:
-
Charges: how many charges each piece takes. On by default. -
Explosives: the mod's own charges, like the countdown, defusing and crafting. -
Damage: raid damage multipliers and what a destroyed piece leaves.
While Charges is on, Explosives.HomemadeDamage, Explosives.HeavyDamage and the tier multipliers of Damage aren't used, because the table already sets how many charges each tier takes. The hinge and inner side multipliers still apply.
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. The default table, the keys and examples are in Limits and Raid Rules.
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. |
HomemadeDamage |
750.0 |
Damage of a Homemade Explosive, only when Charges.Enabled is 0. The multipliers of Damage apply. |
HeavyDamage |
1300.0 |
Damage of a Heavy Charge, only when Charges.Enabled is 0. |
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. |
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. |
| Key | Default | Description |
|---|---|---|
HologramMultiplier |
1.0 |
Raid damage multiplier for blueprints. Only without the charge table. |
FrameMultiplier |
1.0 |
Raid damage multiplier for frames. Only without the charge table. |
LogMultiplier |
1.0 |
Raid damage multiplier for the logs tier. Only without the charge table. |
PlankMultiplier |
1.0 |
Raid damage multiplier for plank walls. Only without the charge table. |
MetalMultiplier |
1.0 |
Raid damage multiplier for armored pieces. Only without the charge table. |
ConcreteMultiplier |
1.0 |
Raid damage multiplier for bastion pieces. Only without the charge table. |
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 |
Advanced. 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. 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 |
backups/ |
Copies of old config files, made when they are updated. |
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