Difficulty levels and per-base danger (board R10) - research and design
Status: research done 2026-10-07; DECIDED and built 2026-10-07 (see the next section), pending the owner's run.
Paths: G/ = LonaRPG/Data/, E/ = G/Scripts/Editables/, F/ = G/Scripts/Frames/, M/ = LonaCraft_dev/LonaCraft/Scripts/,
CD/ = LonaRPG/ModScripts/_Mods/CustomDifficulty/. Line numbers from B.0.10.8.26 and the dev copy as read today.
Simulations: scratch Python, 40,000 runs each, the RESEARCH_RAIDS 2.2 model (it reproduces that table: 10 23 30 33 33 33 %).
Decided 2026-10-07 (owner) and built in the dev copy
Owner's words: "Make three modes, and make them align with the game's difficulty modes. We don't need that many
different modes." Then, the same day: "Let's keep it from following the game mode, to give users customizability.
It'll just be in a config file with everything else."
| Choice |
As built |
| C1 levels |
three, named like the game's modes: Hard (default, today's numbers = the Normal column), Hell (= Harsh), Doom (= Brutal); no Easy. The Hell / Doom live-raid trim against the game's own HELL +25 was dropped once the level stopped following the game's mode |
| C2 setting |
Config/Bases.json "difficulty": "level" plus the tables "hard", "hell", "doom" (25 knobs each, _add added, _mult multiplied) and "base_danger" {lower, higher}; strict merge (negative _add allowed) and the defaults file as the other sections. No System-page row, no in-game setting |
| C3 game mode |
independent: the level is never read from Setup_Hardcore or CustomDifficulty. Read once at config load (Raids.resolve_level); console LonaCraft difficulty: Hell (Config/Bases.json); an unknown name falls back to hard with a console line. README says the game's HELL / DOOM add danger of their own on top |
| C4 per-base Danger |
as proposed: "Danger (Normal)" beside "Rename base" on the world-map tile menu and the Deep Sewer ladders, steps Normal -> Higher -> Lower, popup; refused while a live raid runs on that base; rec["danger"] -1 / 0 / 1, missing = Normal; Lower -4, x0.67, -1 extra, -10 sewer points; Higher +4, x1.5, +1, +10 |
| C5 |
nothing new |
| C6 costs |
mercenary contract ceil(days x price x merc_price_mult), maid hire fee + maid_fee_add; maid pay, crafting, rents, house prices fixed |
| C7 mid-game |
the level changes only with a restart; a live raid fixes its give-up time when it begins; paid days and a hired maid keep their terms |
| C8 |
config section + defaults, rec["danger"], 4 self-test rows (every level has every knob; defaults hard pinned to 0 / 1.0; the level names a table; Danger text keys in 5 languages), README "Difficulty", CHANGELOG, header comments of 120 / 130 / 140 / 150 / 160 / 170 |
Simulated live raid chance (40,000 runs, WD 30, survival 5, base value 30, naps 1..6 from W = 0, scratchpad
r10b/sim_levels.py): Hard 10 23 30 32 33 34 %, Hell 15 32 39 40 42 42 %, Doom 21 40 47 50 52 52 %. First nap after
arriving at night (W = world-map step x1.2), game mode HARD: Hard 78, Hell 81, Doom 84 %; game HELL / DOOM: 92, 94, 96 %.
1. Inventory: every danger and cost knob today
"File" = a player can change it without editing Ruby. "Lvl" = the section 4 id that the PROPOSED level scales, "-" = untouched.
BJ = Config/Bases.json section (defaults in M/120_Raids.rb DEFAULTS :110-182), RJ = Config/Recipes.json, const = Ruby constant.
| # |
System |
Knob |
Today |
Lives in |
File |
Lvl |
| 1 |
Live raid |
enabled |
true |
BJ raids |
yes |
- |
| 2 |
Live raid |
danger_per_value (bonus to the game's roll per base value) |
0.1 |
BJ raids |
yes |
L2 |
| 3 |
Live raid |
danger_cap |
10 |
BJ raids |
yes |
L2 |
| 4 |
Live raid |
base value = walls + 2 x doors + 3 x furniture |
formula |
const M/120_Raids.rb:503-509 |
no |
- |
| 5 |
Live raid |
night_only |
true |
BJ raids |
yes |
- |
| 6 |
Live raid |
grace_frames (warning before they move) |
480; forest, sewer 300 |
BJ raids + scenarios |
yes |
L5 |
| 7 |
Live raid |
dog_extra_frames |
300 |
BJ raids |
yes |
- |
| 8 |
Live raid |
give_up_frames (siege without a breach) |
10800 (3 min) |
BJ raids |
yes |
L6 |
| 9 |
Live raid |
retreat_frames |
1200 |
BJ raids |
yes |
- |
| 10 |
Live raid |
swing_frames / swing_rand |
60 / 30 |
BJ raids |
yes |
- |
| 11 |
Live raid |
spawn_min_distance |
8 tiles |
BJ raids |
yes |
- |
| 12 |
Live raid |
door_bias |
0.5; road 0.7, house 0.8 |
BJ raids + scenarios |
yes |
- |
| 13 |
Live raid |
extra_raider_per_value |
30 |
BJ raids |
yes |
L3 |
| 14 |
Live raid |
extra_raiders_max |
4 |
BJ raids |
yes |
L3 |
| 15 |
Live raid |
max_raiders |
12 |
BJ raids |
yes |
L3 |
| 16 |
Live raid |
min_breach_atk |
3 |
BJ raids |
yes |
- |
| 17 |
Live raid |
refuse_nap |
true |
BJ raids |
yes |
- |
| 18 |
Live raid |
breach factor per race |
Orkind 1.5, Goblin 1, Human 1, Fishkind 1, Undead 0.75, Abom 1.25 |
BJ raids.breach |
yes |
L4 on top |
| 19 |
Live raid |
scenarios (8) x group weights |
field .. sewer |
BJ raids.scenarios |
yes |
- |
| 20 |
Live raid |
EXTRA_UNIT (unit added per extra raider) |
12 groups |
const M/120_Raids.rb:92-99 |
no |
- |
| 21 |
Live raid |
game nap roll: W += clamp(rand10 + WD/2 - 2 x surv, 10, 50); raid if W >= rand100 + surv |
game |
E/34_Functions_RegionMap.rb:237-246 |
no |
L1 adds |
| 22 |
Live raid |
group size by WorldDifficulty band 0-25 / 25-50 / 50-75 / 75+ |
game |
E/34_Functions_RegionMap.rb:361-1115 |
no |
- |
| 23 |
Pieces |
W palisade hp / armour |
600 / 3 |
BJ pieces |
yes |
- |
| 24 |
Pieces |
S stone wall |
1200 / 8 |
BJ pieces |
yes |
- |
| 25 |
Pieces |
D door |
300 / 3 |
BJ pieces |
yes |
- |
| 26 |
Pieces |
SD door in stone walls |
600 / 6 |
BJ pieces |
yes |
- |
| 27 |
Repair |
item / hp / frames / blocked_after_hit_frames |
Plank / 150 / 120 / 180 |
BJ repair |
yes |
- |
| 28 |
Repair |
REPAIR_STONE |
Stone Block / +300 |
const M/110_Bases.rb:2990 |
no |
- |
| 29 |
Away raid |
enabled |
true |
BJ away |
yes |
- |
| 30 |
Away raid |
chance a night |
10 % |
BJ away |
yes |
A1 |
| 31 |
Away raid |
value_bonus_per / value_bonus_cap |
10 / 10 |
BJ away |
yes |
A1 (whole chance) |
| 32 |
Away raid |
scenario_mult |
road, house, sewer 1.5 |
BJ away |
yes |
- |
| 33 |
Away raid |
grace_days after founding |
1 |
BJ away |
yes |
A2 |
| 34 |
Away raid |
cooldown_days after a raid |
2 |
BJ away |
yes |
A2 |
| 35 |
Away raid |
catchup_days |
14 |
BJ away |
yes |
- |
| 36 |
Away raid |
swings / per_extra_breacher / breacher_cap |
24 / 0.15 / 2.0 |
BJ away |
yes |
A3 |
| 37 |
Away raid |
spread |
0.25 |
BJ away |
yes |
- |
| 38 |
Away raid |
difficulty_scale (x WorldDifficulty on budget and party power) |
0.01 |
BJ away |
yes |
- |
| 39 |
Away raid |
loot_fraction |
0.5 |
BJ away |
yes |
A6 |
| 40 |
Away raid |
carry_per_looter |
1500 |
BJ away |
yes |
- |
| 41 |
Away raid |
smash / smash_station |
0.25 / 0.10 |
BJ away |
yes |
A4 |
| 42 |
Away raid |
smash_cap (the owner's hard cap) |
3 |
BJ away |
yes |
A5 |
| 43 |
Away raid |
reports_kept |
5 |
BJ away |
yes |
- |
| 44 |
Away raid |
looters |
Human, Moot, Goblin, Orkind, Fishkind |
BJ away |
yes |
- |
| 45 |
Away raid |
AWAY_UNITS (party per group, 0-25 band) |
12 groups |
const M/140_AwayRaids.rb:93-106 |
no |
- |
| 46 |
Mercs |
enabled / coin |
true / ItemCoin2 (Large Copper, price 2000) |
BJ mercs |
yes |
- |
| 47 |
Mercs |
price_per_day |
1 LC |
BJ mercs |
yes |
C1 |
| 48 |
Mercs |
day_choices |
1 / 3 / 7 / 14 |
BJ mercs |
yes |
- |
| 49 |
Mercs |
squad_power |
220 |
BJ mercs |
yes |
- (A3 scales the raiders) |
| 50 |
Mercs |
deter (x away chance where posted) |
0.5 |
BJ mercs |
yes |
- |
| 51 |
Mercs |
down_days |
1 |
BJ mercs |
yes |
- |
| 52 |
Mercs |
squad stats: captain atk 25 / health 400, 2 x atk 20 / 300 |
|
NPC/LonaCraftMerc*.json |
JSON, not a config |
- |
| 53 |
Maid |
enabled / coin |
true / ItemCoin1 (Copper, price 200) |
BJ maid |
yes |
- |
| 54 |
Maid |
hire_fee |
5 Copper |
BJ maid |
yes |
C2 |
| 55 |
Maid |
pay a day |
1 Copper |
BJ maid |
yes |
- (cannot be split) |
| 56 |
Maid |
grace_days unpaid |
3 |
BJ maid |
yes |
- |
| 57 |
Maid |
catchup_days |
14 |
BJ maid |
yes |
- |
| 58 |
Maid |
dishes_per_day / pantry_cap / cook_skill / need_fire |
2 / 6 / 10 / true |
BJ maid |
yes |
- |
| 59 |
Maid |
wander / flee_radius |
3 / 6 |
BJ maid |
yes |
- |
| 60 |
Maid |
away_kill |
0.5 |
BJ maid |
yes |
M1 |
| 61 |
Maid |
health / atk |
150 / 1 |
NPC/LonaCraftMaid.json |
JSON, not a config |
- |
| 62 |
Rest |
enabled |
true |
BJ rest |
yes |
- |
| 63 |
Rest |
ground_sta_mult / ground_sta_cap_pct / ground_health_mult |
0.6 / 80 / 0.5 |
BJ rest |
yes |
- |
| 64 |
Rest |
ground_mood / ground_dirt |
10 / 15 |
BJ rest |
yes |
- |
| 65 |
Rest |
ground_sick_chance |
10 % |
BJ rest |
yes |
R2 |
| 66 |
Rest |
ground_danger (W added, kept) |
10 |
BJ rest |
yes |
R1 |
| 67 |
Rest |
bed_mood |
10 |
BJ rest |
yes |
- |
| 68 |
Rest |
bed_roll_mult (that roll only) |
0.75 |
BJ rest |
yes |
R3 |
| 69 |
Rest |
meal_sat + 4 switches |
30 |
BJ rest |
yes |
- |
| 70 |
Sewer |
NAP_CHANCE_DAY / NAP_CHANCE_NIGHT |
35 / 60 % |
const M/130_Sewer.rb:108-109 |
no |
S1 |
| 71 |
Sewer |
raid groups |
CommonMobs 50, AbomBreedlingRaid 30, SewerRats 30, UndeadWalking 10 |
BJ raids.scenarios.sewer |
yes |
- |
| 72 |
Sewer |
rat raid size 4 + 2 x (WD / 30), cap 10 |
|
const M/130_Sewer.rb:493-494 |
no |
- |
| 73 |
Sewer |
VERMIN Rattus / Roach / Giant Mice |
4-6 / 4-6 / 3-5 |
const M/130_Sewer.rb:121 |
no |
S2 |
| 74 |
Sewer |
HOBO_COUNT / GOBLIN_COUNT |
2-4 / 2-4 |
const M/130_Sewer.rb:123-125 |
no |
S2 |
| 75 |
Sewer |
ENTRANCES_OPEN (parked 2026-10-06) |
false |
const M/130_Sewer.rb:100 |
no |
- |
| 76 |
Crafting |
hand-crafting cost multiplier |
1.25 |
RJ stations.hand.cost (const M/55_Recipes.rb:87) |
yes |
- |
| 77 |
Crafting |
other stations cost |
1.0 (1-10) |
RJ stations |
yes |
- |
| 78 |
Crafting |
recipe inputs / skill / max_tier; bow_rope |
per recipe; 1 |
RJ recipes, rules |
yes |
- |
| 79 |
Homes |
Old Shack / Stone House price |
5 / 15 Gold |
const M/100_Homes.rb:164, :313 |
no |
- |
| 80 |
Homes |
inn rooms a week |
Noer 2, Pirate's Bane 3, Doom Fortress 2, Fish Town 4, Coastal Fortress 1 LC; South FL 8 Copper |
const M/100_Homes.rb:184-298 |
no |
- |
| 81 |
Building |
BUILD_ENEMY_RADIUS / EDGE_GAP |
8 / 2 |
const M/110_Bases.rb:110, :1075 |
no |
- |
| Where it lives |
Rows |
| Config/Bases.json |
62 |
| Config/Recipes.json |
3 |
| Ruby constant or formula |
12 |
| Game code |
2 |
| NPC JSON |
2 |
| Total |
81 (26 scaled by the proposed level) |
Finding: the dev copy's Config/Bases_defaults.json is stale (no "SD", "away", "mercs", "rest", "maid"); the game rewrites
it at the next start because its text changed (M/120_Raids.rb:446-458). Not a bug; the release build must ship a fresh one.
2. The game's own difficulty signals, and CustomDifficulty
| Signal |
Values |
What it does near bases |
Evidence |
$story_stats["Setup_Hardcore"] |
0 HARD, 1 HELL, 2 DOOM (labels menu:system/DiffHard/DiffHell/DiffDoom) |
each world-map step sets W = rand100 + WD/2 + 25 x (HC >= 1), x0.8 day / x1.2 night, and W is kept on entering the field map: HELL adds about +30 to the first nap roll on a base at night. Captured: WD -13 (HELL+) instead of -22. Rot in the bag and boxes 65533/65535 (mod chests never rot); +12 satiety a nap; no leaving a map under threat (the sewer follows it, M/130_Sewer.rb:578); DOOM: no manual save |
E/100_Game_Player_handle_on_move.rb:163-168, E/33_Functions_OverMapEvents.rb:19-24, E/34_Functions_RegionMap.rb:1839, E/97_Game_Actor_Stats&State&Nap.rb:128-135, :183, F/111_Scene_Save.rb:25 |
Setup_HardcoreAmt |
date the mode was set |
achievements only |
F/RVscript/495_ACH_CORE.rb:200 |
WorldDifficulty (WD) |
0-100, float |
+0.35 every nap (cap 100), -22 / -13 when captured; picks the band (count and kind) of every nap group; the mod already uses it: away budget and party power x (1 + WD x 0.01), sewer rats 4 + 2 x (WD / 30); shop prices; HUD number |
E/97:118, E/34:369-1081, M/140_AwayRaids.rb:274-286, M/130_Sewer.rb:493 |
WildDangerous (W) |
accumulator |
the nap roll (row 21); set to 0 on leaving a region map; the mod adds the base bonus, ground +10, bed x0.75 |
E/34_Functions_ChangeMap.rb:278, M/120_Raids.rb:515-525, M/160_Rest.rb:202-216 |
| actor survival |
0 to about 20 |
-2 x survival on the nap increment, +survival on the threshold |
E/34:239-240 |
Note on the model: RESEARCH_RAIDS 2.2 starts W at 0. In play W starts at the last world-map step's value (mean about
50 + WD/2, x1.2 at night, +25 on HELL), so the first nap after arriving is riskier than the tables; later naps match.
The level steps below add to W, so they keep their size either way.
CustomDifficulty (the owner runs it; LonaCraft may detect it, never depend on it)
| Key in CD/mod.cfg |
Effect |
Owner's value |
| MANUAL_SAVE_ENABLED, SAVE_DESTROYED_ON_LOAD, SAVE_LOST_ON_DEATH |
DOOM save rules on / off |
default |
| FOOD_SPOILAGE_ENABLED |
rot on naps (swaps Setup_Hardcore around process_nap_change) |
default |
| LEAVE_COMBAT_MAP_ALLOWED |
leaving a threatened map |
default |
| REST_HP_RECOVERY, RELAX_SKILL_ENABLED |
rest HP, the Relax option |
default |
| EXTRA_SAT_DRAIN |
extra satiety a nap (HELL 12) |
default |
| WORLD_DIFFICULTY_INCREASE / _REDUCTION |
WD a nap (0.35) / on capture (22 / 13) |
default |
| FETISH_HARDCORE_ENABLED |
addictions |
true |
| OVERMAP_DANGER_BONUS |
rand(n) on StepOvermapDangerous (HELL 20); does NOT touch the +25 W of overmap_gen_WildDangerous |
default |
| DDR_TIMER, DDR_MIN_GRIDS, INTIMATE_EXTRA_DAMAGE |
minigame, health drain |
default |
| EFFECTIVE_HARDCORE_LEVEL |
the answer of CustomDifficulty.hardcore_level (never writes Setup_Hardcore) |
default |
With the owner's file every base-relevant number is vanilla. Readable at run time (CD/Scripts/0_Config.rb, 10_CustomDifficulty.rb:440-456):
defined?(::CustomDifficulty), CustomDifficulty.hardcore_level / hell_or_higher? / doom_mode?, world_difficulty_increase,
overmap_danger_bonus, CustomDifficulty::CONFIG (raw strings). Trap: CD sets Setup_Hardcore to 0 or 1 for the length of
process_nap_change (10_CustomDifficulty.rb:122-140), and M/160_Rest.rb aliases the same method, so a mode read inside the
nap math can see the swapped value: read the game's mode outside process_nap_change.
| Readable by LonaCraft |
How |
| Setup_Hardcore, WorldDifficulty, WildDangerous, survival |
$story_stats[...], $game_player.actor.survival, any time |
| CustomDifficulty's level |
defined?(::CustomDifficulty) && ::CustomDifficulty.respond_to?(:hardcore_level) |
| Not useful |
Setup_HardcoreAmt, DDR, fetish keys |
3. Design (PROPOSED)
New: one level for the whole save (C1-C3) and a Danger step per base (C4). Both are factors or additions at the existing
read sites; Normal is exactly today's numbers. One helper, LonaCraft::Raids.diff(knob) / diff_for(rec, knob), reads the
level table; every system calls it where it reads its config today.
C1 Global level
| Option |
For |
Against |
| a. 3 levels (Easy / Normal / Hard) |
short |
no room above "hard" for a veteran |
| b. 4 levels Easy / Normal / Harsh / Brutal (PROPOSED) |
one step down, two up; fits 4 columns at x 356-608 on the System page |
"Harsh", not "Hard": the game's own lowest mode is labelled HARD |
| c. one free multiplier (0.5-2.0) |
finest control |
one number cannot move chance, size and costs sensibly together |
Touches (section 4): live roll add, base-value bonus, extra raiders, wall and door damage, warning time, give-up time; away chance,
grace and cooldown days, swing budget and party power, smash chances and cap, loot share; Deep Sewer nap chance and
population; mercenary price, maid hire fee, maid away-raid death; ground danger, ground sickness, bed roll cut.
Never touches: crafting, recipes, station costs (hand 1.25), tiers, skill, piece HP and armour, repair, race breach factors,
scenario group lists, night_only, refuse_nap, squad power, maid cooking and pay, rest recovery, meal, bath, homes and rents.
Recommendation: b, with the four level tables editable in Config/Bases.json.
C2 Where it is set
| Option |
For |
Against |
| a. Config/Bases.json only |
no UI work |
restart to change; one level for every save |
b. System page only, saved in $game_system.lonacraft_data["difficulty"] |
per save, no file edit |
no default for new saves, no table tuning |
c. both (PROPOSED): Bases.json "difficulty": {"level": "normal", "levels": {...}} is the default; the System page row below "Destroy all bases" sets the save's own level, which then wins |
per save, a file default, tables tunable |
two places to explain (README) |
System row: "LonaCraft difficulty" + 4 columns like the game's hardcore row (F/194_menu_08_0_System.rb:186-189). Row 10 sits at
y 335 on a 640x360 screen (BASE_LINE 125 + 21 x 10): it fits by a few pixels; the owner's screenshot decides, fallback = the
level on row 9 and "Destroy all bases" as that row's last column. Bases.json rather than LonaCraft.json: the level is
gameplay, and Bases.json already has the strict merge, the defaults file and the README section.
Recommendation: c.
C3 Relation to the game's mode and to CustomDifficulty
| Option |
For |
Against |
| a. independent (PROPOSED) |
predictable; HELL already raises base raids through W (+25 on entry) and slower WD recovery, so nothing is counted twice |
a HELL player picks Harsh by hand |
b. follow by default: HARD / HELL / DOOM -> Normal / Harsh / Brutal until the player picks (CD's hardcore_level when loaded) |
one choice for the player |
counts HELL's W bonus twice; CD's swap trap |
| c. add on top: +1 step on HELL, +2 on DOOM |
|
as b, and Brutal + 2 has nowhere to go |
Recommendation: a; the console line at start and the self-test log name the game's mode and whether CustomDifficulty is loaded (information only).
C4 Per-base Danger
| Step |
Live roll add |
Away chance |
Extra raiders max |
Sewer nap chance |
| Lower |
-4 |
x0.67 |
-1 |
-10 points |
| Normal |
0 |
x1 |
0 |
0 |
| Higher |
+4 |
x1.5 |
+1 |
+10 points |
Stacks with the level (additions add, factors multiply; chances floored at 0, raiders capped by max_raiders).
Simulated live raid chance on naps 1..6 at WD 30, survival 5, base value 30, Normal level: Lower 6 15 22 26 27 26 %, Normal
10 23 30 33 33 33 %, Higher 14 30 37 38 41 40 %. Extremes: Easy + Lower 1 4 8 11 13 14 %; Brutal + Higher 25 47 54 57 60 59 %.
| Question |
Options |
Recommendation |
| Entry point |
world-map tile menu line "Danger: Normal" beside "Rename base" (the same Homes.extend_menu path, M/110_Bases.rb:3386-3410); the Deep Sewer ladders beside their Rename (M/130_Sewer.rb:615) |
both; picking cycles Lower -> Normal -> Higher; refused during a live raid on that base |
| Pay back for Higher |
a. pure choice: more raiders already mean more drops and kills (PROPOSED); b. +25 % coin drops from live raiders; c. mercenaries x0.75 at that base |
a |
| Deep Sewer (parked) |
takes part through the ladder menu (code only, untestable until the entrances open) / left out |
takes part |
| Owned houses, inn rooms |
never raided (R13 decision 4) |
no Danger line |
| Save |
rec["danger"] -1 / 0 / 1, missing = 0 (old saves unchanged) |
as listed |
C5 Scaling over time
| Option |
For |
Against |
| a. nothing new (PROPOSED) |
two growth axes exist: WorldDifficulty (+0.35 a nap up to 100: bigger nap groups, away budget and power up to x2, sewer rats 4 -> 10) and base value (live bonus up to 10, extras up to 4, away bonus up to 10) |
|
| b. days since founding: away chance +1 point per 7 days, cap +10 |
old bases feel hunted |
a third axis to balance; punishes keeping a base |
| c. stored wealth: chest value adds to the chance, cap +10 |
"raiders come for loot" |
a chest walk every night per base |
Recommendation: a.
C6 Costs
| Option |
For |
Against |
| a. every cost fixed |
simplest |
"costs" are in the owner's R10 line |
| b. mercenary contracts and the maid's hire fee scale (PROPOSED); maid pay, crafting, rents, house prices fixed |
the hired help is the base's defence cost |
a 1-day contract cannot go below 1 LC |
| c. b + the hand-crafting multiplier and rents |
|
crafting is outside the owner's line ("raids, away raids, spawns, costs" of the base systems) |
Contract price = ceil(days x price_per_day x level factor): 1 / 3 / 7 / 14 days cost Easy 1/3/6/11, Normal 1/3/7/14, Harsh
2/4/9/18, Brutal 2/5/11/21 LC. Maid fee = ceil(5 x factor). Recommendation: b.
C7 A change in mid-game
| Thing |
PROPOSED |
| Live raid running |
the System row and the Danger line buzz while Raids.busy?; the raid keeps the numbers it began with |
| Raid armed by a nap roll, not spawned yet |
uses the level at spawn |
| Away raid |
worked out at once on the date hook, never "in progress"; the next roll uses the new level; catch-up nights after a long sleep use the level at catch-up time |
| Hired squad |
days paid stay, no refund, no surcharge; extensions at the new price |
| Maid |
a hired maid keeps her terms; a new hire pays the new fee |
| Piece HP |
unchanged: the level scales damage, not HP, so the records' HP tables never need rescaling |
| Reports |
unchanged |
Options: a. change any time except during a live raid (PROPOSED); b. lock the level once the first base is founded; c. one
change per N days. Recommendation: a.
C8 Self-test and release
| Item |
PROPOSED |
| Config |
Bases.json section "difficulty": "level" (easy, normal, harsh, brutal) and "levels": {name: {knob: value}}; strict merge like the other sections (an unknown key or a bad value is skipped with a console line) |
| Defaults file |
Bases_defaults.json gains the section; the header comment lists the knobs |
| Save |
lonacraft_data["difficulty"] (string; missing = the file's level), rec["danger"] (integer) |
| Self-test rows |
(1) each level has every knob, numbers in range; (2) the "normal" table equals today's numbers (Normal = no change, pinned); (3) the text keys exist in all 5 languages; (4) the Menu_System row index and the 4 column positions fit 640 x 360 |
| Text |
Text/{CHT,ENG,KOR,RUS,UKR}/Bases.txt: menu/difficulty, 4 level names, Danger/opt, 3 step names, the refused line (about 10 keys each; level names short, 6-7 letters, for the 60-px columns) |
| README |
new "Difficulty" section after "Raids", one line in "Config files"; CHANGELOG entry; next release |
4. Multiplier table (the current values are Normal)
| Id |
Knob |
Easy |
Normal (today) |
Harsh |
Brutal |
| L1 |
live: added to W on a base nap |
-4 |
0 |
+4 |
+8 |
| L2 |
live: base-value bonus factor / cap |
x0.5 / 5 |
x1 (0.1 a value point) / 10 |
x1.5 / 15 |
x2 / 20 |
| L3 |
live: extra raider per value / extras max / max_raiders |
45 / 2 / 10 |
30 / 4 / 12 |
25 / 5 / 14 |
20 / 6 / 16 |
| L4 |
live: wall and door damage a swing |
x0.75 |
x1 |
x1.25 |
x1.5 |
| L5 |
live: warning time |
x1.25 (600) |
x1 (480; forest, sewer 300) |
x0.85 (408) |
x0.7 (336) |
| L6 |
live: give-up time |
x0.67 (7200) |
x1 (10800) |
x1.33 (14400) |
x1.67 (18000) |
| A1 |
away: chance a night |
x0.5 |
x1 (10 + min(10, value / 10)) |
x1.5 |
x2 |
| A2 |
away: grace days / cooldown days |
2 / 3 |
1 / 2 |
1 / 2 |
1 / 1 |
| A3 |
away: swing budget and party power against mercenaries |
x0.75 |
x1 |
x1.25 |
x1.5 |
| A4 |
away: smash / smash_station |
0.15 / 0.05 |
0.25 / 0.10 |
0.30 / 0.12 |
0.40 / 0.15 |
| A5 |
away: smash_cap |
2 |
3 |
4 |
5 |
| A6 |
away: loot_fraction |
0.30 |
0.50 |
0.60 |
0.75 |
| S1 |
Deep Sewer nap chance day / night |
25 / 45 |
35 / 60 |
40 / 70 |
50 / 80 |
| S2 |
Deep Sewer population (vermin, hobos, goblins) |
x0.75 |
x1 |
x1.25 |
x1.5 |
| C1 |
mercenary contract price |
x0.75 |
x1 (1 LC a day) |
x1.25 |
x1.5 |
| C2 |
maid hire fee |
4 |
5 Copper |
7 |
8 |
| M1 |
maid away_kill |
0.25 |
0.50 |
0.60 |
0.75 |
| R1 |
rest: ground_danger |
5 |
10 |
15 |
20 |
| R2 |
rest: ground_sick_chance |
5 % |
10 % |
15 % |
20 % |
| R3 |
rest: bed_roll_mult |
0.60 |
0.75 |
0.85 |
0.90 |
What the levels do (simulated, or worked out from the decided numbers; away figures at WD 0):
| Effect |
Easy |
Normal |
Harsh |
Brutal |
| Live raid chance naps 1..6, base value 0 (WD 30, survival 5) |
3 10 15 19 21 21 % |
7 17 24 28 28 28 % |
11 24 32 34 34 35 % |
15 31 39 41 42 42 % |
| same, value 30 |
4 12 18 22 23 23 % |
10 23 30 32 33 34 % |
15 31 39 40 43 42 % |
21 41 47 51 51 52 % |
| same, value 100+ |
8 19 26 30 29 29 % |
17 35 41 44 46 46 % |
26 48 56 58 61 61 % |
35 61 68 74 77 77 % |
| Bandit spear swings to break door / palisade / stone (live, one breacher, about 1.25 s a swing) |
24 / 47 / 134 |
18 / 36 / 100 |
15 / 29 / 80 |
12 / 24 / 67 |
| Away raids a week, value 30 (chance a night) |
0.37 (6.5 %) |
0.70 (13 %) |
0.95 (19.5 %) |
1.43 (26 %) |
| Away raids a week, value 100+ |
0.56 (10 %) |
1.01 (20 %) |
1.31 (30 %) |
2.00 (40 %) |
| Orkind away raid breaks the door (budget 35 +-25 % against 34 swings) |
0 % |
56 % |
95 % |
100 % |
| BanditMobs away raid breaks door + palisade (budget 38 +-25 % against 18 + 36) |
0 % |
0 % |
23 % |
61 % |
| The squad beats BanditMobs (power 132 x A3 against 220) |
100 % |
100 % |
96 % |
73 % |
| Pieces smashed at most a raid |
2 |
3 |
4 |
5 |
5. Build estimate
| File |
Change |
Lines |
| M/120_Raids.rb |
DEFAULTS "difficulty", merge_difficulty, the diff / diff_for helper, level source (save, then file), L1-L6 at before_roll, reserve_extras, swing_damage, start_grace, update |
+150 |
| M/140_AwayRaids.rb |
A1-A6 at roll?, budget, raid!, simulate, loot_box; the per-base step |
+30 |
| M/130_Sewer.rb |
S1, S2, the Danger line on the ladder menu |
+30 |
| M/150_Mercs.rb |
C1 contract price (ceil) |
+10 |
| M/170_Maid.rb |
C2 fee, M1 away_kill |
+10 |
| M/160_Rest.rb |
R1-R3 |
+10 |
| M/110_Bases.rb |
System row (4 columns, buzzer during a raid), world-map "Danger" line, rec["danger"] |
+120 |
| M/98_SelfTest.rb |
4 rows |
+60 |
| Text/*/Bases.txt (5 languages) |
about 10 keys each |
+50 |
| README.md, CHANGELOG.md |
Difficulty section, Config files line |
+50 |
| Total |
10 files (5 of them text) |
about 520 |
Risk: low to medium. Every change is a factor at an existing read site and the self-test pins Normal to today's numbers.
Highest risks: the System row at y 335 on 640x360 (screenshot), the choice index of the world-map tile menu with two added
lines, and the CustomDifficulty swap if the mode were read inside process_nap_change (this design never does).
In-game checklist sketch (the owner's run):
| # |
Step |
Expect |
| 1 |
New save, open System |
row "LonaCraft difficulty", Normal lit, inside the screen |
| 2 |
Pick Brutal, save, load |
Brutal kept; console "LonaCraft Raids: difficulty brutal (save)" |
| 3 |
Bases.json "difficulty": {"level": "easy"}, a new save |
Easy lit |
| 4 |
Brutal, nap on a base |
console shows W +8 and the bonus x2 |
| 5 |
Debug raid (Numpad .) at Brutal |
a bandit spear breaks a door in about 12 swings; more raiders than at Normal |
| 6 |
The System row during that raid |
buzzer, no change |
| 7 |
World-map tile of a base |
"Danger: Normal" beside Rename; cycles Lower / Normal / Higher |
| 8 |
Higher + Brutal, debug away raid (Numpad . off a base) |
report: up to 5 smashed, a larger loot share |
| 9 |
Hire the mercenaries at Harsh |
7 days = 9 LC |
| 10 |
Hire the maid at Easy |
fee 4 Copper |
| 11 |
Ground nap at Brutal |
console: ground danger +20 |
| 12 |
Back to Normal |
every number as before R10 (spot-check one raid and one away report) |