In this chapter
In this chapter
Every key in one map
The first part moved every keyboard shortcut into one input map: 34 actions, from Esc and the tool keys to the photo-mode lens keys and the free camera’s fly keys. Each binds the key’s physical position, so the fly keys stay where they are on an AZERTY keyboard. The exceptions are undo, redo, save and open, which bind the letter printed on the key, so Cmd+Z undoes on any layout (Ctrl on other systems); the orchestrator ruled that exception in. Nothing was meant to change, and a recorder checked it: 50 keys, 10 sets of modifiers, press, repeat and release, in 9 editing contexts, 13,500 events in all, made exactly the same calls as the old code.
The README’s table of keys and the help text are now generated from the map, which added five rows for photo-mode keys the old table never listed. The review found nothing to fix. The suite passed with 62 suites and 33,026 checks. The help dialog still runs past the right edge of a 1440-pixel window, as it did before, and some messages still spell out key names in their text.
A turn grip for every prop
The next part gave 46 kinds of prop a turn grip: the violet arrow the buildings use, at the base, which turns the prop as the boat’s turn grip does, in 15-degree steps with Shift, as one undo step, and Esc cancels it. The 16 kinds that already had grips are unchanged. A bench now has 2 to 4 seats (1.1, 1.6 or 2.1 metres long), stretched by an arrow at one end; a bench saved without a seat count draws exactly as before.
Nudging with the arrow keys
With a part selected, the arrow keys now nudge it 0.25 metres along the camera’s view, or 1 metre with Shift, through the same checks as a move. Off a terrace’s edge it stops at the edge; a pot pushed out over water stands on a stone plinth; a window slides along its wall; a crag takes the parts on its top along. A berthed boat stays held by its magnet unless Cmd or Ctrl is held, which frees any nudge. Quick presses fold into one undo step: four in 0.3 seconds are one “Nudge”, two a second apart are two. A held key repeats at most every 90 milliseconds.
The first review found that the arrows had been taken from a focused slider in the inspector, so pressing Right moved the house where it used to make it wider. The fix leaves sliders, option buttons and text fields their arrows and lets only a plain button’s focus go. The recheck found one more case, a held Up or Down on a slider that passed the focus to a button and then nudged the part; the orchestrator fixed it and added a test. The suite passed with 63 suites and 33,125 checks. Timed cold, a nudge took 41.8 milliseconds to release, over its budget; like for like it is cheaper than a move (28.8 against 35.5 milliseconds for a pot on the Harbour), and the orchestrator ruled the cold figure an artefact of the test. Holding an arrow on a banner on the Loch castle commits a step every 90 milliseconds that takes 85 to 144 milliseconds, the same hitch as placing one, and that goes to the creator.
Turning the view
The last part reworked the camera. Q and E turn the view 45 degrees about its middle, eased like the F key’s focus. Keys 1 to 4 turn to four corner views, the short way round, and holding Space turns a left drag into a pan. Alt with a left drag orbits when it starts on open ground with nothing under the pointer; everywhere else Alt keeps its old meanings, such as copying a part. Photo mode keeps Q and E for flying. While recording the eased moves, the implementer found that going from corner view 1 to view 3, exactly half a turn, sent the goal one way and the ease the other, so the view came to rest a whole turn from its goal and the game never registered it as settled; the recording ran to its 240-frame limit. The move now always takes the Q direction and settles in 137 frames. Every eased move keeps the view on the grid of art pixels.
A pan that holds the ground
Measuring the pan before changing it showed it was wrong. Across the screen the ground moved twice as far as the pointer at the default pixel size, and up and down it moved the opposite way, off by up to 195 pixels. A pan drag now holds the ground under the pointer, exactly, in both projections and in every drag measured. That changes the feel, half as fast across at the default pixel size and up and down with the pointer, and the README says so.
The review found two faults. After a click on a toolbar button, Space armed the pan and also fired the button when it was let go. And near the horizon the new pan did nothing or flung the view to its 32-metre limit, with a single pixel of drag moving it 45.3 metres at worst. The fix lets a plain button’s focus go when Space is pressed over the view, and blends to a simpler pan at the view centre’s scale where the pointer’s ray grazes or misses the ground. The worst one-pixel move is now 1.245 metres, with nothing flung and no pan that does nothing. Inside the blend the pan speeds up by about 9 per cent, so a loop through the sky does not end exactly where it began; the recheck accepted that. The suite passed with 64 suites and 33,274 checks.
Camera preferences
The camera also gained preferences, saved in the game’s preferences file: orbit, zoom and pan sensitivity from 0.5 to 2, an inverted orbit, swapped mouse buttons (the middle button orbits and the right one pans), the pivot, the projection and a lens of 12 to 60 degrees. The pivot, projection and lens chosen in the Scenery panel are now remembered from one session to the next. Bad or missing values fall back to the old defaults, and every automated run uses the defaults. There is no panel for the rest yet; that belongs to a later interface part.
Where the work stands
The three control parts are built, reviewed and closed. They went to the project’s repository early on 21 October with the castle grounds stage, when the creator wrote “gamepad connected, push it”. None has been run on Windows, where Ctrl stands in for Cmd and the key labels come from the system. Still open: the help dialog’s width at 1440 pixels, messages that spell out key names, a held Q that does not repeat, and Q pressed during a frame hitch, which can step the eased view backwards before it lands. The plan’s next control parts are selecting several parts at once, which had begun at the freeze, and gamepad controls; neither is built or closed.
From the project notebook
This chapter draws on the project’s records as they stood on 21 October 2026.
- docs/decor-controls-ui-plan.md · The controls parts R5b to R5f and the creator’s answers E8 and E9, intent only, 9 October
- docs/visual-handoff.md · Input map and physical keys; grips for every prop, bench seats and keyboard nudge; camera entries, with their reviews and fix passes, 20 and 21 October
- artifacts/decor/owner-decisions.md · The rulings from each review of 20 and 21 October and the push of 21 October
- docs/decor-orchestration-handoff.md · State of the work, 20 and 21 October
- artifacts/decor/33-R5/ · Per-part tests, the 13,500-event key recorder, captures, sheets, costs and the pan measurements
