Files
LonaRPG-Online-Games/ModScripts/_Mods/LonaCraft/docs/RESEARCH_BASE_BUILDING.md
T
2026-10-29 21:59:06 +04:00

39 KiB

R3 Base building research (walls, floors, doors on wilderness world-map tiles)

Board item R3 (owner, 2026-10-06). Research only: nothing in the mod was changed. Options are PROPOSED, one recommendation each; the owner settles them before design.

Path short forms: F/ = LonaRPG/Data/Scripts/Frames/, E/ = LonaRPG/Data/Scripts/Editables/, HCG/ = LonaRPG/Data/HCGframes/, LC/ = ModScripts/_Mods/LonaCraft/Scripts/, CS/ = ModScripts/_Mods/Campsites/Scripts/. Map facts were read from the .rvdata2 files with the scratchpad tools (r3/regmaps.py, r3/tilesets.py, tools/home_evdump.py).

0. Summary

Question Finding PROPOSED
Where is "a base on a wilderness tile"? Entering a tile loads a random map of that region each time (E/34_Functions_ChangeMap.rb:263); field maps are small (522-992 passable tiles, plains are a 25 x 25 square; forests are corridors) Base = the mod's own base map per biome family, entered from the overmap tile and keyed by that tile (option B)
Walls with autotiling Map tiles can be rewritten at runtime (Homes already does it, LC/100_Homes.rb:1187-1204); every wilderness tileset has 32 A3 and 24 A4 wall kinds Walls are TILES: A4 top + face (building look), A3 kind as the cheap "palisade"
Floors Layer-0 swap to an A5 tile, no autotile needed Tiles
Doors Game doors are 2-page events toggled by doorEV_setup (E/29_Functions_417_Interpreter.rb:943-961) Placed door = the same 2-page event, built like a furniture piece
Persistence Furniture records are per map number (LC/90_Furniture.rb:745-768) One record per base in $game_system.lonacraft_data["bases"], tiles as a grid string (596 B for 20 x 20 against 33,403 B as furniture-style records)
Build size 8 build items in 4 phases, about 1,000-1,200 Ruby lines + 11 generated maps

1. World map model

1.1 How a wilderness tile becomes a field map

Step Evidence
OvermapMain is Map002, note isOverMap=true, 170 x 150 tiles, 168 events Map002 note; F/31_Game_Map.rb:285-303 reads isOverMap from the note, makes the player transparent and the map turn-based
Each overmap tile has a region id (layer 3 >> 8); 4,709 of 25,500 tiles have one (ids 1-32), 20,791 are region 0 F/31_Game_Map.rb:880-882; Map002 count
The action key on an overmap tile reserves the region event F/35_Game_Player.rb:604-620 (check_region_event, only when isOverMap) -> F/10_Game_Temp.rb:107-109 -> E/22_GMI_CommonEvents.rb:41-48
Region menu: Cancel / Relax / Observe / Remove tracks / Enter / Kyaaah E/33_Functions_OverMapEvents.rb:27-132
"Enter" calls change_map_enter_region E/33_Functions_OverMapEvents.rb:106, :132
The map is picked AT RANDOM from all maps whose note has region=<id>, on every entry E/34_Functions_ChangeMap.rb:257-269 ($data_region_maps[$game_player.region_id].sample), list built at boot in F/5_DataManager.rb:351-388
Way back: overmap id and LastOverMapX/Y E/34_Functions_ChangeMap.rb:259-260, :271-289
The field map is reloaded from disk at every setup, so nothing on it persists F/31_Game_Map.rb:172
Its events are rolled again on every entry: BIOS spawns resources and wildlife on in-map region ids while ReRollHalfEvents = 1 Map028 event 1 (BIOS); E/34_Functions_ChangeMap.rb:138 sets it, :114 clears it
30 callers of change_map_enter_region (region menu, encounters, out-of-stamina nap on the overmap) grep; Map002 event 9 (NapEvent: sta <= -100 -> change_map_enter_region)

So the same overmap tile does NOT give the same map: PlainField (region 1) picks one of Map016, 026, 028.

1.2 Field map families (wilderness and towns)

Region (overmap name) Field maps Tileset Passable tiles (measured)
1 Plainfield 16, 26, 28 14 RMDLC OUTA 625 each (25 x 25 open square, x 36-60, y 31-55 on Map028)
11 Road 32, 33, 34 14 612 (34)
23 Highway 51, 54, 55 14 625 (51)
12 Rudesind Slope 83 14 -
2 / 27 Shore 27, 147, 149 4 RMDLC ACJbeach 764 (27)
5 Pine Forest 13, 30, 124 10 Exterior417a1 587 (30)
7 Mountain 37 / 184 28 / 45 Mountain,Poor 1,063 (37)
8/25 Swamp, 13/24 Swamp Trail, 15/26 Marsh 19, 163 / 101, 102 / 108, 125 32 Exterior417 swAMP 522 (19)
4 Rain Forest 29, 80, 93 18 Mack-badlandOUTA 525 (29, all in narrow paths)
3 Infested Mountain 39 29 AbomMountain 879
6 Dead Forest 21, 127 39 badlandTerrian 522 (21)
14 Wasteland, 16 Infested Creep, 28 Infected Terrain 107, 112 / 131, 134 / 160, 161 17 Mack-badlandINSA 3,431 (107)
19 Polluted Land 111, 159 40 badlandTown 992 (111)
9 Abandoned House 45 / 47 23 / 13 -
20 Refugee Camp 35 13 Interior-poora -
Towns and ruins: 10 Slums, 17 Blighted Road, 18 Infected City Ruins, 21 Town of Noer, 22 Streets of Noer, 29/30 Fortress Ruins, 31/32 Sybaris 17, 170 / 145, 146 / 150 / 4, 5, 7 / 48, 56, 57 / 191, 192 / 200, 201 42, 40, 23, 34, 15 -

Region names: LonaRPG/Text/ENG/OvermapEvents.txt:160-256. Every playable tile of Map028 has a spawn region (3, 4, 7, 9-12) and the ring around it is region 1 (exit trigger, Map028 event 4 set_region_trigger(1) -> change_map_region_map_exit, E/34_Functions_ChangeMap.rb:377-401). Renders: scratchpad/r3/plainfield1_play.png, scratchpad/r3/rainforest1_small.png.

1.3 Sleeping and camping today

Where What runs Evidence
Overmap, "Relax" heal from satiety only, no map change E/33_Functions_OverMapEvents.rb Relax branch; E/100_Game_Player_handle_on_move.rb:135-142
Overmap, nap Map002 event 9 NapEvent: handleNap on the overmap, or forced into a random field map when stamina <= -100 Map002 event 9
Field map, nap Map's NapEvent (Map028 event 32) -> region_map_wildness_nap -> maybe a raid (region_map_wildness_nap_stats, loads HCG/encounter/<race>) -> handleNap HCG/Command_Nap.rb:10, F/31_Game_Map.rb:1299-1308, E/34_Functions_RegionMap.rb:237-246, :1645-1840
Any nap $game_map.setup(map_id) again (tile data reloaded), live events kept only if nappable, spriteset re-created F/Game_InterpreterModifies/Game_Interpreter_Modifies_OM.rb:12-47, F/31_Game_Map.rb:359-372

1.4 What Campsites does (closest prior art)

Point Campsites Evidence
Loaded? No: Banned = 1 UserData/GameMods.ini
Record per camp {id, map_id, x, y, region_id, biome, camp_tag, icon_event, raid_event, expire_segment} in $game_system.campsites_list (the OVERMAP tile) CS/10_Campsites.rb:203-225, :291-303
Biome overmap region id -> name table, towns included (21, 22, 31, 32) CS/10_Campsites.rb:25-58, :129-131
City vs wilderness not checked. can_setup_here? needs isOverMap and a random tag map; OvermapMain's note has no event= tag, so the option never shows on Map002 CS/10_Campsites.rb:149-175, Map002 note isOverMap=true
Inside of a camp one fixed tag map per biome via change_map_enter_tag; the 21 Camp_*.rvdata2 maps and CampEvents.rvdata2 named in mod.cfg are not in the mod folder CS/10_Campsites.rb:240-244, :263-288; Campsites/mod.cfg
Overmap marker an EventLib event re-summoned at every overmap setup CS/10_Campsites.rb:184-193, :305-317
Expiry / raids expires after PERSIST_DAYS x 2 nap segments; raid roll in an alias of process_nap_change CS/10_Campsites.rb:69-71, :235-255, :319-346
Menu replaces the whole overmap_event_EnterMap CS/10_Campsites.rb:348-482

Nothing built inside a camp persists; only the overmap record does. The useful parts are the overmap key (map id + x + y) and the icon re-summon.

1.5 What "base on a wilderness tile" can mean (PROPOSED)

Option How For Against
A. Pin the game's field map Base record keeps the field map number picked on the first visit; a per-base runtime map number points at that game file, so entering that tile always loads it no map authoring; real biome, BIOS weather, gathering space: 25 x 25 on plains, corridors in forests (1.2); BIOS spawns land inside the base unless region filtering (6); StartPoint and the exit ring must stay free; a game update that edits the map moves terrain under the base
B. The mod's own base map per biome family A generated template map per tileset family (about 11), e.g. 40 x 40 open ground of that biome with the exit ring, a BIOS (biome weather) and a NapEvent; one runtime map number per base slot, all pointing at the template file room to build; no clash with game events; own NapEvent = clean raid hook; immune to game map edits 11 maps to generate (one script, as home_build_stonehouse.py); less "the field Lona saw"
C. On the overmap tile itself Write tiles into Map002 none 1 overmap tile = a whole region; overmap is turn-based with the player hidden (F/31_Game_Map.rb:292-296)

Recommendation: B. Key the base by the overmap tile like Campsites (Map002 id, x, y), allow it only on a wilderness region whitelist (PROPOSED: 1-8, 13-16, 19, 24-28; owner to decide roads 11, 23 and Abandoned House 9 / Refugee Camp 20), and enter it with an "Enter base" line in the region menu plus an alias of change_map_enter_region (E/34_Functions_ChangeMap.rb:257-269) that sends Lona to the base when she enters that tile any other way (encounters, out-of-stamina nap). A is the fallback for plains/roads only.

Per-base runtime map number: $data_mapinfos[<key>] with its own .id and .filename = the template (or, for A, Data/MapNNN.rvdata2), exactly as Homes registers its houses (LC/100_Homes.rb:546-576, setup key fix :580-590); Game_Map#setup only reads $data_mapinfos[map_id].filename (F/31_Game_Map.rb:170-172). Distinct map numbers per base keep the furniture code working unchanged (its records are per map number, LC/90_Furniture.rb:745-751).

2. Walls with autotiling

2.1 Can a mod change tiles at runtime?

Point Evidence
Tile data is @map.data (a Table, 4 layers: 0-2 tiles, 3 = shadow + region) and is freshly loaded at each setup F/31_Game_Map.rb:172, :524-526, :880-882
Writes before the events are built: setup_event_hack runs after load, before setup_region_map and setup_events F/31_Game_Map.rb:193, :199, :205, :223-225
LonaCraft already writes tiles there: lonacraft_apply_tile_overrides and the floor fill of owned rooms LC/100_Homes.rb:1187-1204, :1252-1259, hook :1285-1304
Passability reads the live tiles: check_passage over layered_tiles with the tileset flags F/31_Game_Map.rb:734-756, :773-776
Pathfinding reads the same check_passage F/202_pathfinding.rb:399-410, :465-475
Drawing: update_tilemap assigns $game_map.data to the tilemap every frame F/49_Spriteset_Map.rb:322-328
Engine is stock RGSS3 (System\RGSS301.dll) LonaRPG/Game.ini
A nap re-runs setup and re-creates the spriteset F/Game_InterpreterModifies/Game_Interpreter_Modifies_OM.rb:24, :37-38
The live map (with written tiles) is saved inside $game_map and not reloaded on load unless the game version changed F/5_DataManager.rb:939, :964, :994-1000

UNVERIFIED (no agent runs the game): that an in-place write shows on the next frame. VX Ace's Tilemap is known to redraw from the Table it holds, but the first build item must prove it; the fallback is the nap's own SceneManager.scene.dispose_spriteset; create_spriteset (Game_Interpreter_Modifies_OM.rb:37-38), a short hitch per placed piece. Tiles written in setup_event_hack need no redraw at all.

2.2 Wall and floor sheets in the wilderness tilesets

Tileset Maps (region) A3 sheet A4 sheet A5 sheet A4 used by the maps
14 1, 11, 23, 12 TileA3 TileA4 (stone, wood, timber, plaster, brick, log walls) TileA5_exterior1 none (Map083: 9 kinds)
4 2/27 TileA3 Village&town A4 Cliffs_And_Mines (cliffs and mine walls only) TileA5_exterior1 113-116, 122
10, 28, 45, 32 5, 7, 8/25, 13/24, 15/26 Outside_POOR_A3 Outside_POOR_A4 (stone, brick, wood walls; cliffs 112-127) Outside_POOR_A5 112, 113, 117, 120-125 (cliffs)
18 4 macks_A3 macks_A4 (brick, plank, timber, plaster walls 96-111) macks_A5 none
17, 29, 39 14, 16, 28 / 3 / 6 macks_A3 / TileA3 (39) macks417_badland_A4 (same wall rows as macks_A4) macks_A5 / TileA5_exterior3 (39) 113, 114, 120 (29), 82 (39)
40 19 TileA3Abom macks417_AbomTown_A4 (stone, wood walls 96-111) TileA5_exterior1 none (Map111)
13 20, 9 (Map047) Outside_POOR_A3 Inside_POOR_A4 (indoor walls) Inside_POOR_A5 83, 84, 92

Labelled sheets: scratchpad/r3/a4_field_1.png, a4_field_2.png, a3_field.png, a5_field.png.

Flags (checked on tilesets 4, 10, 14, 17, 18, 28, 29, 32, 39, 40):

Tile group Passable Terrain tag Meaning
A3, all 32 kinds (48-79) X in all 10 4 in all 10 wall pieces block movement, sight (F/Modules/Sensors.rb:161-171) and projectiles (F/33_Game_CharacterBase.rb:225-234) for free
A4 tops, even rows (80-87, 96-103, 112-119) O (walkable) in all 10 4 in most; 0 on a few kinds (e.g. tileset 29 kinds 96-103) tops must be made impassable by the mod (2.4)
A4 faces, odd rows (88-95, 104-111, 120-127) X in all 10 4 in most face blocks for free
A5 O in 14, 4, 17, 18, 29, 39, 40; mixed O / X / directional in 10, 28, 32 floor ids must come from the O cells

No tileset swap and no new sheet is needed: every family has building-wall kinds. Only Shore (4) lacks A4 building walls (its A4 is cliffs), so Shore uses A3 walls. Adding a custom sheet would mean a cloned RPG::Tileset with one tileset_names slot replaced (Cache.tileset prepends Graphics/Tilesets/, F/4_Cache.rb:71-73; the "../../" mod-path trick of LC/90_Furniture.rb:15-23 works the same) and a runtime tileset id that exists before a save loads; not needed for phase 1-3.

2.3 Autotile shape formulas (PROPOSED code, checked against tools/home_render.py:28-42)

Tile id = 2048 + kind * 48 + shape. same[d] = the neighbour in direction d is the same kind (PROPOSED: off-map counts as same, as the editor does).

Wall type, 16 shapes (all A3 kinds, A4 odd rows):

def wall_shape(same)   # bit set = edge drawn on that side
  (same[:w] ? 0 : 1) | (same[:n] ? 0 : 2) | (same[:e] ? 0 : 4) | (same[:s] ? 0 : 8)
end

Ground / ceiling type, 47 shapes (A2, A4 even rows):

def ground_shape(same)
  n, s, w, e = same[:n], same[:s], same[:w], same[:e]
  c = lambda{|a, b, d| a && b && !same[d] }          # inner corner: both sides same, diagonal not
  case [!w, !n, !e, !s]                                 # edges drawn: west, north, east, south
  when [false, false, false, false]
    (c[n, w, :nw] ? 1 : 0) | (c[n, e, :ne] ? 2 : 0) | (c[s, e, :se] ? 4 : 0) | (c[s, w, :sw] ? 8 : 0)
  when [true,  false, false, false] then 16 + (c[n, e, :ne] ? 1 : 0) + (c[s, e, :se] ? 2 : 0)
  when [false, true,  false, false] then 20 + (c[s, e, :se] ? 1 : 0) + (c[s, w, :sw] ? 2 : 0)
  when [false, false, true,  false] then 24 + (c[s, w, :sw] ? 1 : 0) + (c[n, w, :nw] ? 2 : 0)
  when [false, false, false, true ] then 28 + (c[n, w, :nw] ? 1 : 0) + (c[n, e, :ne] ? 2 : 0)
  when [true,  false, true,  false] then 32
  when [false, true,  false, true ] then 33
  when [true,  true,  false, false] then 34 + (c[s, e, :se] ? 1 : 0)
  when [false, true,  true,  false] then 36 + (c[s, w, :sw] ? 1 : 0)
  when [false, false, true,  true ] then 38 + (c[n, w, :nw] ? 1 : 0)
  when [true,  false, false, true ] then 40 + (c[n, e, :ne] ? 1 : 0)
  when [true,  true,  true,  false] then 42
  when [true,  true,  false, true ] then 43
  when [true,  false, true,  true ] then 44
  when [false, true,  true,  true ] then 45
  else 46
  end
end

Placing or removing one wall tile changes at most its 8 neighbours' shapes (9 tiles for the 47-shape top, 5 for the 16-shape face); recompute those only.

Building look with A4 (as the game's own buildings and the Stone House builder scratchpad/tools/home_build_stonehouse.py): wall tiles W get the TOP kind with ground_shape over W; every tile directly south of a W tile that is not itself W (and not a door) gets the FACE kind with wall_shape over that face set. Mock-up written with exactly these formulas (scratchpad/r3/mockup.py), TileA4 top 97 / face 105 on the left, TileA3 log kind 76 on the right, A5 1609 floor, game door sprite: scratchpad/r3/base_mockup_plainfield.png.

2.4 Walls as tiles vs walls as events

Tiles (PROPOSED) Events with a wall sprite sheet
Look the game's own wall art, same as its buildings; A4 gives top + face, A3 a one-tile strip needs a 16-piece (or 47-piece) sheet drawn per wall style; events draw above tiles, can look pasted on
Autotile correctness the engine draws the shape from the tile id; the mod computes the id (2.3) the mod picks the piece the same way; mistakes are visible the same way
Passability A3 and A4 faces: from the flags. A4 tops: walkable, so an alias of Game_Map#check_passage (F/31_Game_Map.rb:734) returns false for the base's wall tiles from a per-map Hash; that one alias covers walking (:773-776) and pathfinding (F/202_pathfinding.rb:406-409, :465-468). @forced_block_dir (F/31_Game_Map.rb:56, :134, :777-779) is NOT enough: pathfinding skips it and it is a linear Array one non-through event per tile, as furniture blockers (LC/90_Furniture.rb:608-632); pathfinding sees them (F/202_pathfinding.rb:399-404)
Sight / projectiles terrain tag 4 from the flags (2.2) needs ev_terrain_tag 4 per event (F/31_Game_Map.rb:858-877)
Save size, 20 x 20 base (76 walls) in the base record (5) 76 furniture-style records + 76 live events in the saved map
Events on the map 0 76 walls, 400 with floors; the busiest game map has 207 (Map121), PlainField has 6
NPC pathing, fog, lighting as any game wall; KHAS shadows are off (E/50_System_Settings.rb:132) and editor shadows are cleared at setup (E/50_System_Settings.rb:131, F/RVscript/460_KHAS_LightLib.rb:1866-1880) events are characters: NPCs collide, sprites sort by y
Nap / reload rewritten in setup_event_hack at every setup and nap events must stay nappable (F/31_Game_Map.rb:359-366)

Recommendation: tiles. A3 (one kind, no passability work) for the first build; A4 top + face with the check_passage alias as the "building wall".

3. Floors

Layer-0 tile swap (PROPOSED) Event
How layer 0 = an A5 floor id; layers 1-2 cleared on that tile walkable event (LC/90_Furniture.rb:571-573 style, priority below characters)
Autotile A5 has none; grass/dirt A2 neighbours keep their shapes (small seam) unless recomputed with ground_shape none
Passability must pick an O-flag A5 id (2.2) through
Cost 0 events, 1 char per cell in the record 324 events for an 18 x 18 floor
Limit building only where layer 2 is empty (Map028's playable area has 0 layer-2 tiles; forests have trees) same

Recommendation: tile swap. Candidates per family to be picked by the owner from scratchpad/r3/a5_field.png (1609 = wood planks on TileA5_exterior1, used in the mock-up).

4. Doors

4.1 The game's doors (NoerTavern, Map059)

Point Evidence
6 doors named WoodenDoorSide4, sprite !Door4 (cells 32 x 96: 384 x 768 sheet) Map059 events 49, 54, 55, 60, 61, 62
Page 1 = OPEN: through ON, priority "same as characters", action button Map059 event 49 page 1
Page 2 = CLOSED: through OFF, same priority, action button Map059 event 49 page 2
Starts closed: init block init_jump_page(2, tag) (tag 1 side door, 4 front door) F/39_Game_Event.rb:1997-2002
Action key: doorEV_setup(id, page, tag, sound) plays openDoor / closeDoor and forces the other page + terrain tag; refuses to close while a living NPC stands in the doorway E/29_Functions_417_Interpreter.rb:943-961, :1082-1086
Animation: none, a page swap (sprite pattern changes) Map059 pages
Closed tag 4 blocks sight and projectiles F/31_Game_Map.rb:858-877, F/Modules/Sensors.rb:161-171

Render: scratchpad/r3/tavern_doors.png, sheet scratchpad/r3/door4_sheet.png.

4.2 A placed door (PROPOSED)

Point How
Event built at runtime like LC/90_Furniture.rb:542-606, with the two pages above and doorEV_setup(get_character(0).id, ...) in each page (works on summoned events: it only uses $game_map.events[id])
Tile under it a floor tile; the door tile is not in the wall set, so no face is drawn under it (mock-up)
Lona opens with the action key, walks through (page 1 through ON), closes it from either side
NPCs and companions no NPC ever opens a door (only the player's action key starts it, F/35_Game_Player.rb:604-614); a closed door blocks them (collide_with_characters, and pathfinding F/202_pathfinding.rb:399-404). Companions wait outside a closed door, as in towns
State closed at every setup (init block); PROPOSED keep it that way (an open door after a nap is the raid follow-up's question)
Injection added to @map.events in setup_event_hack, as the home doors (LC/100_Homes.rb:1262-1283), so a nap rebuilds it the same way

5. Persistence (PROPOSED)

Where: $game_system.lonacraft_data["bases"] (plain types, no save hook, as furniture LC/90_Furniture.rb:475-509 and homes LC/100_Homes.rb:71-73).

lonacraft_data["bases"] = {
  "next" => 2,
  "list" => [{
    "id" => 1,
    "om" => [2, 88, 61],        # overmap map id, x, y  (the owner's "the tile")
    "region" => 1,              # overmap region at creation
    "family" => "plain",        # template / tile table row
    "slot" => 1,                # runtime map number = BASE_MAP_ID + slot
    "ox" => 5, "oy" => 5, "w" => 40, "h" => 40,
    "rows" => ["....WWWWWW....", ...],   # one char per cell: "." untouched, "W"/"w" wall kinds, "F"/"f" floor kinds
    "doors" => [[12, 9, "Door_Wood"]]
  }]
}
Format, 20 x 20 base (76 walls, 323 floor, 1 door), Ruby Marshal Bytes
furniture-style record per piece ({"uid","map_id","x","y","item_name"}) 33,403
per-base [x, y, kind] list 3,262
per-base grid string (PROPOSED) 596
a current save, for scale (UserData/SavAuto*.rvdata2) 1,132,145-1,284,524

Rebuild: alias setup_event_hack (F/31_Game_Map.rb:193): when the map number is a base slot, write walls (top + face), floors and their shapes into @map.data, fill the wall Hash for check_passage, inject door events; furniture inside the base keeps working through LC/90_Furniture.rb:899-911 because each base has its own map number. Overmap marker: an event re-added at every Map002 setup, as CS/10_Campsites.rb:184-193 / :305-317. This is Campsites' model (overmap tile record + re-summon) with the inside kept as well.

6. Engine limits for this

Limit Fact PROPOSED handling
Random field map per entry E/34_Functions_ChangeMap.rb:263 base map number per slot; alias change_map_enter_region for the base tile
Field maps reloaded each setup F/31_Game_Map.rb:172 rebuild from the record in setup_event_hack
Small field maps 522-992 passable tiles; plains 25 x 25 (1.2) option B (40 x 40 template)
Spawns inside the base BIOS / encounters place events at region_map[id].sample (Map028 event 1; E/34_Functions_RegionMap.rb:361-1100); region_map is built from layer 3 after setup_event_hack (F/31_Game_Map.rb:199, :270-281) B: template paints spawn regions only outside the build area. A: drop base cells from @region_map after setup_region_map, never emptying a region (BIOS does region_map[11].sample[0] and would crash on nil)
NPC pathing tiles: through check_passage (2.4); doors: event collision as 2.4 / 4.2
Enemies through walls no destructible tiles or door-breaking in the game raid follow-up R4 (new AI)
Map events no hard cap (new id = max + 1, LC/90_Furniture.rb:787-799); every event costs update + sprite each frame tiles: only doors and furniture are events
Fog / lighting KHAS fog is a screen overlay (F/RVscript/480_KHAS_Fog.rb:398-420); shadows off (E/50_System_Settings.rb:132) nothing to do
Live redraw UNVERIFIED (2.1) proven in build item B2; fallback spriteset re-create
Nap on the base field NapEvent -> region_map_wildness_nap (1.3) B: template's own NapEvent (raid hook for R4)
Saved live map $game_map incl. written tiles is in the save (F/5_DataManager.rb:939) consistent; nothing extra

7. Build plan (PROPOSED)

Phase Item What Files Lines (rough)
1 minimum B1 Base record and entry wilderness whitelist, "Build a base here" / "Enter base" in the region menu (append, not replace, unlike Campsites), change_map_enter_region alias, slot map numbers, setup key, PlainField template map (generated) new LC/110_Bases.rb, loader.rb, Maps/LonaCraftBase_Plain.rvdata2, Text/*/Bases.txt (6 languages) 220 + map
B2 Wall + floor tiles one A3 wall kind and one A5 floor as items + recipes; placement cursor reusing the furniture ghost loop; tile write + neighbour shapes; live-redraw proof with fallback; rebuild in setup_event_hack 110_Bases.rb, 90_Furniture.rb (route tile kinds, ~30), Item/, Recipes/ (2 + 2 JSON), texts 280
B3 Door 2-page door event with doorEV_setup, record, injection, item + recipe 110_Bases.rb, Item/, Recipes/, texts 110
2 building B4 A4 building walls top + face kinds, check_passage alias, per-family kind table 110_Bases.rb 150
B5 Remove and furniture pick up a wall / floor / door (refund, shapes recomputed), furniture allowed inside a base (Furniture.map_allowed?) 110_Bases.rb, 90_Furniture.rb (~15) 90
3 all biomes B6 Templates for the other 10 families generator script + 10 maps, tile table (A3 / A4 / A5 ids per family) Maps/LonaCraftBase_*.rvdata2, 110_Bases.rb 60 + maps
B7 Overmap marker and limits marker event on Map002, max bases, base list 110_Bases.rb, texts 70
4 follow-up B8 Raids (board R4) base NapEvent rolls a raid, enemies spawn on the exit ring, doors / walls as obstacles; new AI to break doors 110_Bases.rb, template NapEvent owner research first

Raid hooks for R4: the field map NapEvent (Map028 event 32) -> HCG/Command_Nap.rb:10 -> F/31_Game_Map.rb:1305-1308 -> region_map_wildness_nap (E/34_Functions_RegionMap.rb:1645) -> region_map_wildness_nap_stats (:237-246) -> encounter script (:232); Campsites' place for its raid roll: process_nap_change alias (CS/10_Campsites.rb:319-346). With option B the base template carries its own NapEvent, so the raid code is the mod's, not a patch of the game's.

8. Choices for the owner (design phase)

# Choice PROPOSED
1 Base location: A pinned field map / B own template / C overmap B
2 Which overmap regions count as wilderness 1-8, 13-16, 19, 24-28; roads 11 / 23, Abandoned House 9, Refugee Camp 20 open
3 Wall look: A3 palisade, A4 building wall, both both (A3 in phase 1, A4 in phase 2)
4 Template size and buildable area 40 x 40 map, 30 x 30 buildable
5 Max bases 3 (Campsites' default, Campsites/mod.cfg)
6 Costs (materials per wall / floor / door) from existing LonaCraft materials, set in the recipe JSONs
7 Doors after a nap closed

9. Design for the owner's decisions (2026-10-06)

Binding owner decisions: option A, pinned only while buildings stand; a marker on Map002 in phase 1; the game's own resource respawn kept; allowed tiles by rule; A3 palisade first, A4 later; "Destroy all bases" on the System page; raids stay research. B1 is built (9.8); this section is its spec.

9.1 Record schema ($game_system.lonacraft_data["bases"], plain types)

lonacraft_data["bases"] = {
  "next_id" => 3,
  "list" => [{
    "id"      => 2,
    "om"      => [2, 47, 92],          # overmap map number, tile x, y (the owner's "the tile")
    "region"  => 1,                    # overmap region id of that tile
    "field"   => 28,                   # the $data_region_maps entry picked on that visit: a game map
                                       #   number, or a mod map key (RolePlayS adds file-path keys,
                                       #   RolePlayS/Scripts/0_CORE.rb:147-156)
    "key"     => "LonaCraftBase_2",    # $data_mapinfos key of the pinned map
    "map_no"  => 9202,                 # its runtime map number ($game_map.map_id there; furniture keys by it)
    "pieces"  => {"40,38" => "debug"}, # "x,y" => kind; B2/B3 put walls, floors, doors here
    "made"    => 1234                  # $game_date.dateAmt
  }],
  "maps"  => {"LonaCraftBase_2" => [9202, 28]},  # runtime map registry (kept while a save can stand on it)
  "entry" => {"om" => [2, 47, 92], "region" => 1, "event" => 0, "to" => 28, "base" => nil}
}

entry = the last region entry (written on the overmap, cleared at the next overmap setup). A base can only be created on the map named in entry["to"], so the record knows its tile without reading the overmap again.

9.2 Pin and revert

Rule How Evidence
Every way into a field map goes through one function change_map_enter_region is the only reader of $data_region_maps. Callers: region menu Enter, 27 encounter scripts, the pregnancy-pain overmap event, Map002 NapEvent (out of stamina), Map211 E/34_Functions_ChangeMap.rb:257-269; E/33_Functions_OverMapEvents.rb:132; E/40_OverEvent_Check.rb:351; grep of Data/HCGframes/encounter/ and Data/Map*.rvdata2
Pin alias in GIM_ADDON (included in Game_Interpreter, F/40_Game_Interpreter.rb:19). On the overmap, $data_region_maps[region] is set to [pick] for the call and restored after: pick = the base's key when a record holds Lona's tile, else one sample of the list (so the entry knows to) the original's own .sample then returns pick (:263)
Pinned map $data_mapinfos[key] = new MapInfo: .filename = the field map's file, .name = the field map's name, .id = map_no. Game_Map#setup only reads those F/31_Game_Map.rb:169-172; Homes does the same (LC/100_Homes.rb:546-576)
Numbers back to keys Game_Map#setup alias turns a base map_no into its key (a load after a game update calls setup with the number) and registers a missing key from maps F/5_DataManager.rb:994-1000; LC/100_Homes.rb:580-590
After a load DataManager.extract_save_contents alias registers every key in maps (a nap on a pinned map calls setup(map_id_rec) with the key) F/5_DataManager.rb:954-964; F/Game_InterpreterModifies/Game_Interpreter_Modifies_OM.rb:12, :24
Created by the first piece: Bases.on_piece_placed(map, x, y, kind) on the map named in entry["to"], tile and entry passing 9.4
Reverted by Bases.on_piece_removed(map, x, y) taking the last piece, or Bases.destroy_all!: the record goes, the next entry picks a random map again, the marker goes
Map numbers 9200 + id; moved to a free number if another mod took it (furniture records follow) F/5_DataManager.rb:390-405 (extra_map_register takes max + 1)

Resources (decision 3): field maps have no regrow timer. Every entry reloads the map file (F/31_Game_Map.rb:172) and its BIOS rolls resources and wildlife again because change_map_story_stats_fix sets ReRollHalfEvents = 1 (E/34_Functions_ChangeMap.rb:138, called at :264; Map028 event 1 rolls RandomRootVegetables and StaticRockInsect0 on in-map regions 9 and 11, then region_map_wildness_*). Trees and nodes are plain map events without self-switch conditions (Map030). The pin runs the same function on the same file, so this is unchanged. The only difference is the map number (9200 + id), which only separates self switches ([map_id, event_id, key], F/39_Game_Event.rb:1992-1995); field maps use none.

9.3 Marker on Map002

Point How
Where injected into @map.events in setup_event_hack when the map note has isOverMap=true, one per record of that overmap, like the home doors (LC/100_Homes.rb:1262-1283, :1285-1304), so a nap rebuilds it
Sprite !World Map 02 index 4, direction 4, pattern 0, a small fenced camp (scratchpad/r3/worldmap02_sheet.png)
Page below characters, through, action button, command lonacraft_base_marker = $game_temp.reserve_region_event(region). Any event under Lona takes the action key first, so without this the region menu would not open on a base tile (F/35_Game_Player.rb:604-620, :331-345)
Removed not injected once the record is gone; destroy_all! on the overmap also deletes the live events

9.4 Allowed tile rule (Bases.allowed_tile?)

# Rule Evidence
1 the map is a world map (note isOverMap=true) F/31_Game_Map.rb:285-287
2 the tile has a region id > 0 with field maps in $data_region_maps (an enterable tile) F/5_DataManager.rb:381-388, E/34_Functions_ChangeMap.rb:263
3 no map event stands on the tile: every town, cave and quest place is a Map002 event (-point-*, AbanHouse1, DfRefugeeCamp, ...) and takes the action key before the region does Map002 events; F/35_Game_Player.rb:604-614
4 not inside the walls of Noer: three boxes on OvermapMain, x 22-28 y 94-103, x 28-40 y 95-103, x 33-37 y 92-96, read off the wall art (scratchpad/r3/om_noer.png; gates -point-NoerGate (40,99), -point-NoerGate2 (31,95)) Map002 render
5 not a settlement region (deny list): 10 Slums, 12 Rudesind Slope, 18 Infected City Ruins, 20 Refugee Camp, 21 Town of Noer, 22 Streets of Noer, 29/30 Fortress Ruins, 31/32 Sybaris Text/ENG/OvermapEvents.txt:160-256
6 creation only: a plain visit, OverMapEvent_name was 0 when Lona entered. Every world-map event sets it before entering (HCG/encounter/RefugeeCamp.rb:1, E/33_Functions_OverMapEvents.rb:128, :178-201); the game clears it after the BIOS (E/34_Functions_ChangeMap.rb:111), so it is kept in entry["event"]

Dry run over Map002 (scratchpad/r3/allowed_tiles.py, same constants):

Result Tiles
allowed 4,246
refused, settlement region 345
refused, event on the tile 104
refused, inside Noer's walls (regions 23, 7, 11 inside the boxes) 14
region 0, not enterable 20,791
allowed tiles inside the Noer boxes / static events on allowed tiles 0 / 0

Abandoned House (region 9): 83 tiles allowed; the AbanHouse1 / AbanHouse2 points (41,90), (108,90) are event maps and stay refused by rule 3. Renders: scratchpad/r3/om_allowed.png, scratchpad/r3/om_allowed_noer.png (green allowed, red refused by rules 3-5, yellow Noer boxes).

9.5 Destroy all bases (System page)

Point How
Line appended last in Menu_System#create_sprites (F/194_menu_08_0_System.rb:67-90; RolePlayS replaces that method, RolePlayS/Scripts/Frames/194_menu_08_0_System.rb:22-39, and loads first, so the alias sits on top of either), row 9 under Keybinding (BASE_LINE + UNIT_HEIGHT * 9), text "Destroy all bases (N)"
Prompt an overlay like the hardcore prompt (:408-440): title, two lines, Confirm / Cancel keys. update_input and mouse_update_input answer it first (:487-500, :502-506); mouse_force_main_menu_pause is true while it shows (:909-912)
Yes Bases.destroy_all!: every record; the map registry except the map Lona stands on; furniture records on base map numbers (no refund); live markers when on the overmap
No bases the line buzzes

9.6 Option A space and spawn mitigations (B2)

Problem Measure
Small or corridor maps (1.2: 522 passable tiles on Map019 swamp and Map021 dead forest, 525 on Map029 rain forest, all in paths, 587 on Map030) allowed (the rule is about the tile); the map limits what fits
BIOS spawns inside a built area after setup_region_map (F/31_Game_Map.rb:199, :270-281) drop built cells from @region_map[id] unless the list would become empty (Map028's BIOS does region_map[11].sample[0])
StartPoint, exits no piece on the region-1 exit ring (Map028 event 4, set_region_trigger(1)), on -point-StartPoint or its 4 neighbours

9.7 Raids (R4, research only)

On a pinned GAME map the nap event is the game's: Map028 event 32 region_map_wildness_nap (E/34_Functions_RegionMap.rb:1645), reached through HCG/Command_Nap.rb:10 and F/31_Game_Map.rb:1305-1308. Two hooks: (1) alias region_map_wildness_nap / region_map_wildness_nap_stats (:237-246) when Bases.base_at_map? is true; (2) alias Game_Actor#process_nap_change, as Campsites does (CS/10_Campsites.rb:319-346). Different scenarios per tile type (Abandoned House vs field) are wanted later; the record's region and field give the type.

9.8 Phase 1, updated

Item Scope Files State
B1 record, pin / revert, entry note, marker, allowed rule, Destroy-all line + prompt, debug key Numpad / (adds or removes a debug piece), public API Scripts/110_Bases.rb (new), loader.rb, Text/<lang>/Bases.txt (5 language folders), README, BOARD built, owner's run pending
B2 A3 palisade wall + A5 floor tiles; placement through the furniture cursor, calling Bases.on_piece_placed / on_piece_removed; tile rebuild and region-map filter (9.6) 110_Bases.rb, 90_Furniture.rb, items, recipes after the 90_Furniture.rb work
B3 door event (4.2) 110_Bases.rb, items, recipes after B2

API for B2: Bases.record_for_tile(om_map, x, y), Bases.record_for_map(map), Bases.base_at_map?(map), Bases.can_build_here?(map), Bases.on_piece_placed(map, x, y, kind), Bases.on_piece_removed(map, x, y), Bases.allowed_tile?(x, y, om_map = nil), Bases.destroy_all!.

9.9 B2 / B3 as built (2026-10-06)

Point Built
Items Palisade Wall (2 Plank + 1 Rope), Plank Floor (2 Plank), Wooden Door (3 Plank + 1 Rope); hand and Carpentry Bench, Common, new recipe category / craft group "building"; 0_Core.rb ITEMS rows, icons in cells 13-15 of Iconset_LonaCraft.png
Tile table (by sheet name, all 13 tilesets of allowed regions) wall A3 kind: TileA3 68, TileA3Abom 68, Outside_POOR_A3 66, macks_A3 70 (vertical logs); floor A5: TileA5_exterior1 1600, TileA5_exterior3 1600, Outside_POOR_A5 1552, macks_A5 1570, Inside_POOR_A5 1552 (picked to stand apart from the logs). Flags checked: wall impassable in all 13 (terrain tag 4, tag 0 on tileset 13), floor passable in all 13
Wall shape 16-shape from the 4 neighbours (2.3), neighbours repainted; dry run 3x3 ring = 3 10 6 / 5 . 5 / 9 10 12, L = 7 / 5 / 9 10 14
Storage the base record's pieces ("W", "F", "D", "FD", "S" = sideways door); no furniture records
Rebuild setup_event_hack writes the tiles, setup_region_map alias drops built cells from the spawn lists, doors spawned after setup and closed after every nap
Live repaint REDRAW = :table (a fresh Table copy, so the tilemap's next map_data = sees a new object, F/49_Spriteset_Map.rb:322-328); fallback :spriteset. Unverified until the owner's run
Doors the game's two-page door (open through, closed solid, doorEV_setup); the side-door sprite (!Door4 [4]) is a small hatch, so both orientations use the front door [0] (one-line switch DOOR_SIDE)
Taking down action key facing a wall / floor: Take down / Cancel; open door: Close / Take down / Cancel; full refund; the last piece reverts the tile (B1)
Render scratchpad/r3/b2_base_plainfield.png (scratchpad/r3/b2_render.py reads the table from the Ruby file)