From 0256dfa81299cd13397e80dde0893e6073d17b7b Mon Sep 17 00:00:00 2001 From: Tom Boullay Date: Fri, 8 May 2026 02:18:00 +0100 Subject: [PATCH] add: show broken part prompt during scan --- docs/user/features.md | 2 +- docs/user/main-feature.md | 5 +-- .../three/gameplay/RepairBrokenPartPrompt.tsx | 36 +++++++++++++++++++ .../three/gameplay/RepairScanSequence.tsx | 12 ++++--- src/data/docs/docsTranslations.ts | 2 +- 5 files changed, 49 insertions(+), 8 deletions(-) create mode 100644 src/components/three/gameplay/RepairBrokenPartPrompt.tsx diff --git a/docs/user/features.md b/docs/user/features.md index 310968d..8175e9d 100644 --- a/docs/user/features.md +++ b/docs/user/features.md @@ -31,7 +31,7 @@ This document lists features that are implemented in the current codebase. - Reusable production `RepairGame` mounted for `bike`, `pylone`, and `ferme` mission states - Repair mission config shared through `src/data/gameplay/repairMissions.ts` -- Repair-game flow supports `waiting -> inspected -> fragmented -> scanning -> repairing -> done -> next mission` with `.webm` prompts, repair case spawn/opening/exit, `E`, two-fists hold input, exploded model transition, per-part scan visuals, persistent red broken-part markers, multiple grabbable replacement choices, correct-part install validation, and mission completion +- Repair-game flow supports `waiting -> inspected -> fragmented -> scanning -> repairing -> done -> next mission` with `.webm` prompts, repair case spawn/opening/exit, `E`, two-fists hold input, exploded model transition, per-part scan visuals, persistent red broken-part markers, centered broken-part UI videos, multiple grabbable replacement choices, correct-part install validation, and mission completion ## Audio diff --git a/docs/user/main-feature.md b/docs/user/main-feature.md index a3e117e..1b967b2 100644 --- a/docs/user/main-feature.md +++ b/docs/user/main-feature.md @@ -15,7 +15,7 @@ The current user flow is: 5. The repair case appears near the mission object and can float when the player approaches it. 6. Press `E` or hold both fists closed for one second to move from `inspected` to `fragmented`. 7. The mission object uses an exploded-model transition, then moves to `scanning`. -8. The scan visual moves across the fragmented model one part at a time and keeps a red marker on any configured broken part once it has been found. +8. The scan visual moves across the fragmented model one part at a time and keeps a red marker plus the `cassé.webm` prompt centered on any configured broken part once it has been found. 9. In `repairing`, the case opens and several grabbable replacement parts appear near the case. 10. Move the correct replacement part close to the install target. 11. Press `E` on the green install target to move to `done` and show the reassembled object. Wrong parts turn the target red and cannot finish the repair. @@ -33,7 +33,7 @@ When the player inspects the object, `RepairGame` writes `inspected` through the In `inspected`, `RepairGame` can also move to `fragmented`. The player can use the interaction key or hold both fists closed for one second. The hand-tracking path is state-based, so it does not depend on being inside a local object interaction radius. -In `fragmented`, the repair object is rendered with `ExplodableModel`, then automatically advances to `scanning`. In `scanning`, the exploded model remains visible, a blue scan visual moves from part to part, and a red halo/wire marker stays attached to configured broken parts after the scanner reaches them. The scan can match a specific `nodeName` when mission data provides one, otherwise it falls back to the first scanned parts as placeholder broken parts. In `repairing`, the case opens, several grabbable replacement parts appear, and the install target only validates the configured correct part for the active mission. In `done`, the repaired object remains visible with a completion target that plays the case exit animation before advancing the global mission progression. +In `fragmented`, the repair object is rendered with `ExplodableModel`, then automatically advances to `scanning`. In `scanning`, the exploded model remains visible, a blue scan visual moves from part to part, and a red halo/wire marker plus the configured broken UI video stay attached to configured broken parts after the scanner reaches them. The scan can match a specific `nodeName` when mission data provides one, otherwise it falls back to the first scanned parts as placeholder broken parts. In `repairing`, the case opens, several grabbable replacement parts appear, and the install target only validates the configured correct part for the active mission. In `done`, the repaired object remains visible with a completion target that plays the case exit animation before advancing the global mission progression. ## Key Files @@ -41,6 +41,7 @@ In `fragmented`, the repair object is rendered with `ExplodableModel`, then auto - `src/components/three/gameplay/RepairCompletionStep.tsx` renders the final repaired object, completion target, case exit animation, and mission UI prompt. - `src/components/three/gameplay/RepairGame.tsx` composes the reusable production repair flow. - `src/components/three/gameplay/RepairBrokenPartHighlight.tsx` renders the red halo and wire marker around detected broken parts during scanning. +- `src/components/three/gameplay/RepairBrokenPartPrompt.tsx` centers the configured broken UI video on detected broken parts during scanning. - `src/components/three/gameplay/RepairInspectionObject.tsx` handles the `waiting` inspection interaction. - `src/components/three/gameplay/RepairMissionCase.tsx` renders the mission repair case after inspection. - `src/components/three/gameplay/RepairRepairingStep.tsx` renders grabbable replacement choices, correct-part placement validation, and the install trigger in `repairing`. diff --git a/src/components/three/gameplay/RepairBrokenPartPrompt.tsx b/src/components/three/gameplay/RepairBrokenPartPrompt.tsx new file mode 100644 index 0000000..e738820 --- /dev/null +++ b/src/components/three/gameplay/RepairBrokenPartPrompt.tsx @@ -0,0 +1,36 @@ +import { useRef } from "react"; +import { useFrame } from "@react-three/fiber"; +import * as THREE from "three"; +import { RepairPromptVideo } from "@/components/three/gameplay/RepairPromptVideo"; + +interface RepairBrokenPartPromptProps { + src: string; + target: THREE.Object3D; +} + +const _box = new THREE.Box3(); +const _sphere = new THREE.Sphere(); +const _localPosition = new THREE.Vector3(); + +export function RepairBrokenPartPrompt({ + src, + target, +}: RepairBrokenPartPromptProps): React.JSX.Element { + const groupRef = useRef(null); + + useFrame(() => { + const group = groupRef.current; + if (!group) return; + + _box.setFromObject(target).getBoundingSphere(_sphere); + _localPosition.copy(_sphere.center); + group.parent?.worldToLocal(_localPosition); + group.position.copy(_localPosition); + }); + + return ( + + + + ); +} diff --git a/src/components/three/gameplay/RepairScanSequence.tsx b/src/components/three/gameplay/RepairScanSequence.tsx index d17d896..c555883 100644 --- a/src/components/three/gameplay/RepairScanSequence.tsx +++ b/src/components/three/gameplay/RepairScanSequence.tsx @@ -1,6 +1,7 @@ import { useEffect, useState } from "react"; import * as THREE from "three"; import { RepairBrokenPartHighlight } from "@/components/three/gameplay/RepairBrokenPartHighlight"; +import { RepairBrokenPartPrompt } from "@/components/three/gameplay/RepairBrokenPartPrompt"; import { ExplodableModel } from "@/components/three/models/ExplodableModel"; import { RepairScanVisual } from "@/components/three/gameplay/RepairScanVisual"; import { REPAIR_SCAN_PART_SECONDS } from "@/data/gameplay/repairGameConfig"; @@ -60,10 +61,13 @@ export function RepairScanSequence({ if (!part) return null; return ( - + + + + ); })} diff --git a/src/data/docs/docsTranslations.ts b/src/data/docs/docsTranslations.ts index 3d3a52d..55c9b39 100644 --- a/src/data/docs/docsTranslations.ts +++ b/src/data/docs/docsTranslations.ts @@ -442,7 +442,7 @@ Ce document liste les fonctionnalités présentes dans le code actuel. - \`RepairGame\` de production réutilisable monté pour les états de mission \`bike\`, \`pylone\` et \`ferme\` - Configuration de mission partagée via \`src/data/gameplay/repairMissions.ts\` -- Flow repair-game avec \`waiting -> inspected -> fragmented -> scanning -> repairing -> done -> next mission\`, prompts \`.webm\`, apparition/ouverture/sortie de la mallette, touche \`E\`, hold deux poings, transition de modèle explosé, scan visuel par pièce, marqueur rouge persistant sur les pièces cassées, plusieurs choix de pièces grabbables, validation de la bonne pièce et complétion de mission +- Flow repair-game avec \`waiting -> inspected -> fragmented -> scanning -> repairing -> done -> next mission\`, prompts \`.webm\`, apparition/ouverture/sortie de la mallette, touche \`E\`, hold deux poings, transition de modèle explosé, scan visuel par pièce, marqueur rouge persistant et vidéo UI centrée sur les pièces cassées, plusieurs choix de pièces grabbables, validation de la bonne pièce et complétion de mission ## Audio