[kafasam]

A walk-around first-person view, as a row in the Insert menu's Controls tab (option 47, first_person in hookshot_options.ini; HOS_FIRST_PERSON=1 for one run).

It is a constrained free camera rather than a camera patch: the shipped free camera's hook in the shared view-matrix routine (f_804e48c0, patch_view) already replaces the gameplay view's matrix after the game stores it, and the game's own frustum culling reads the replacement back the same frame. This adds hos_first_person(c, view) beside it, which takes the frame's eye->target direction (so yaw, pitch, mouse and lock-on easing all keep working — no angle-convention math, no feedback loop into the camera FSM) and moves the eye to the player actor's origin + HOS_FP_UP (1.5 m, adult; a child's eyes are nearer 1) + a small forward offset (HOS_FP_FORWARD, 0.15 m). The camera pointer comes from the f_80644c80 hook that mouse_native.c already publishes; liveness is the camera hook setting a flag the view hook consumes, plus the event-playing test, so cutscenes, shops and the game's own aim camera take the view back untouched.

Known limits, v1 (documented in the readme too):

• the view inherits the game camera's angles, including its rest tilt down; the eye is not checked against walls
• a recentering (Z tap) or a targeting/climb/swim state holds the view briefly, then steps out to third person until the state passes — safe, visible
• the option id is 47 (46 went to the prompts row while this was in the works)

Two sliders are planned as a follow-up commit on this branch (eye height and forward offset, live in the menu) along with a smoother handover when the game's own first-person aiming takes the view.

Tested on an RX 6700 XT (RDNA2), Windows: walking, running, right-stick and native-mouse look, lock-on steering, cutscene fallback. Single commit on current main; no other PR's changes carried.

[Joey-Magnus]

Since the workflows haven't run, I merged this into current main and ran tests/run_all.py: 429 passed and 1 failed. The failure is tests/test_lift_cache.py, which fails on main here too. test_first_person_anchor/options/view and test_mouse_native pass. The row is off by default and the hook stands down for other cameras, events and the free camera, so players who don't turn it on aren't at risk.

What blocks it:

• The title "first person: …" fails the Conventional Commit title check. Something like feat(camera): first-person view at Link's eyes would pass, and CI then needs maintainer approval to run.
• Option ids: you moved to 54 with 52/53 for the sliders, but open PRs already claim them. #2604 takes HOS_OPT_SPRINT = 52, #2669 takes 52 onward, and #2530 takes HOS_OPT_KEYBOARD = 54. Whoever lands second has to renumber, so it's worth agreeing on numbers now.
• This changes what's on screen, so it needs a screenshot or short clip in the description (CONTRIBUTING).
• The description still says option 47 and calls the sliders a follow-up, and host/hos_first_person.c:91 still says "option 47". Please bring both up to date.