Server and CodeLock configuration¶

RaG Hunting Cabin can create two independent JSON files:

File	Created when	Purpose
`$profile:\RaG_Core\Configs\RaG_Hunting_Cabin\RaG_Hunting_Cabin.json`	Hunting Cabin and RaG Core load correctly	Crafting, build materials, refunds, and roof texture.
`$profile:\CodeLock\RaG_Hunting_Cabin_CodeLockConfig.json`	CodeLock conditional integration is active	CodeLock attachment and raiding.

Stop server before editing. Restart after every change.

Main cabin configuration¶

Default version 1 configuration¶

{
  "Version": 1,
  "CanCraftHuntingCabinKit": 1,
  "RuinHammerAfterBuilt": 1,
  "GiveBackMaterialsAfterDismantle": 1,
  "GiveBackKitAfterDismantle": 1,
  "EnableSnowyRoofTexture": 0,
  "NailAmount": 99.0,
  "WoodenPlankAmount": 100.0,
  "WoodenLogAmount": 20.0,
  "StoneAmount": 32.0
}

DayZ's JSON serializer represents these script booleans as 1 and 0.

Settings¶

Setting	Default	Actual effect
`Version`	`1`	Current schema version. Values below `1` are upgraded and saved as `1`.
`CanCraftHuntingCabinKit`	`1`	Enables built-in `10` planks + `50` nails recipe. Does not block already existing, spawned, traded, or scripted kits.
`RuinHammerAfterBuilt`	`1`	Ruins build tool on completion. Despite name, this affects hatchet too. When disabled, action removes `10` tool health.
`GiveBackMaterialsAfterDismantle`	`1`	Creates configured materials in refund box when normal cabin is dismantled. Admin cabins never return materials.
`GiveBackKitAfterDismantle`	`1`	Returns normal kit for normal cabin and admin kit for admin cabin.
`EnableSnowyRoofTexture`	`0`	Applies snowy roof and secondary roof textures when cabin initializes on server.
`NailAmount`	`99.0`	Minimum nails on hologram and nail refund quantity.
`WoodenPlankAmount`	`100.0`	Minimum wooden planks on hologram and plank refund quantity.
`WoodenLogAmount`	`20.0`	Minimum wooden logs on hologram and log refund quantity.
`StoneAmount`	`32.0`	Minimum stones on hologram and stone refund quantity.

Material behavior and validation¶

Current schema does not clamp or validate material values.

Keep values whole and non-negative.
Every hologram still needs all four attachment types, even when a configured amount is 0.
Build deletes complete attached stacks. Excess material is lost.
Refunds use current config amounts, not material quantities originally attached.
Refund code converts float settings to integers.
A refund class is skipped only when its converted amount equals 0.

Changing material amounts affects existing holograms when build condition is next evaluated. Changing refund amounts affects cabins dismantled after restart/config reload; refunds do not remember original construction cost.

Do not use negative or fractional costs

Source accepts them but behavior is bad. Negative minimums make quantity checks trivially pass, while integer conversion can create incorrect or invalid refund quantities.

Crafting versus construction¶

Recipe cost is hard-coded:

10 WoodenPlank + 50 Nail

Material settings control only hologram build requirement and dismantling refund. They do not alter kit recipe.

CodeLock configuration¶

This section applies only when CodeLock Mod integration is active.

Default configuration¶

{
  "RaidTimeInSeconds": 60.0,
  "CanAttach": "true",
  "CanRaid": "false",
  "DeleteLockOnRaid": "false",
  "ToolDamageOnRaid": 100,
  "RaidTools": [
    "Hacksaw"
  ]
}

Unlike main file, this schema has no Version field or upgrade hook.

Settings¶

Setting	Default	Actual effect
`RaidTimeInSeconds`	`60.0`	Intended total raid duration. Code divides this by CodeLock's global increment amount for each repeated progress cycle.
`CanAttach`	`"true"`	Allows CodeLock attachment to cabin door.
`CanRaid`	`"false"`	Enables cabin CodeLock raid action.
`DeleteLockOnRaid`	`"false"`	Deletes lock after successful raid when enabled. When disabled, raid unlocks it without explicit deletion.
`ToolDamageOnRaid`	`100`	Health damage applied to raid tool when lock reaches zero health. It is not applied on every progress repeat.
`RaidTools`	`Hacksaw`	Exact item class names allowed for raid action.

String booleans¶

Three CodeLock toggles are strings, not JSON booleans:

"CanAttach": "true"

Do not write:

"CanAttach": true

Getter lowercases string and enables only exact text true. Use quoted "true" or "false".

Raid timing¶

Cabin code relies on CodeLock global IncrementAmount.

repeat duration = RaidTimeInSeconds / CodeLock IncrementAmount
damage per repeat = lock maximum health / CodeLock IncrementAmount

With uninterrupted action, configured total trends toward RaidTimeInSeconds. Changing CodeLock increment count changes number and size of damage steps.

Keep RaidTimeInSeconds positive and CodeLock increment amount above zero. Hunting Cabin source does not guard division by zero.

Raid tools¶

Tool matching uses exact runtime type:

RaidTools.Find(itemInHands.GetType())

Class spelling and case must match. Derived tools are not automatically accepted unless their runtime class name is listed.

Example:

"RaidTools": [
  "Hacksaw",
  "HandSaw"
]

Adding another mod's tool creates operational dependency for configured server. Ensure class exists wherever required.

Configuration recovery¶

If main file is invalid or missing, RaG Core loads default object and may rewrite defaults. If CodeLock file is invalid, its older direct JsonFileLoader path has no versioning or explicit repair logic.

Recovery:

Stop server.
Back up broken file.
Move broken file out of active profile config directory.
Start once to generate defaults.
Stop server.
Merge wanted values carefully.
Restart and test.