feat: add the map
This commit is contained in:
+3
-2
@@ -31,6 +31,7 @@ Scene objects are **never** singleton classes. Managers are **never** React comp
|
||||
- Scene components live in `src/world/` and `src/components/3d/`
|
||||
- UI overlays live in `src/components/ui/`
|
||||
- Managers live in `src/stateManager/`
|
||||
- Debug tooling lives in `src/debug/`
|
||||
- Hooks live in `src/hooks/`
|
||||
- Static data lives in `src/data/`
|
||||
- Shaders live in `src/shaders/`
|
||||
@@ -54,9 +55,9 @@ import { useGameState } from "@/hooks/useGameState";
|
||||
### Debug
|
||||
|
||||
- Debug panel activates with `?debug` in URL
|
||||
- All debug logic goes through `Debug.getInstance()` from `src/utils/Debug.ts`
|
||||
- All debug logic goes through `Debug.getInstance()` from `src/debug/Debug.ts`
|
||||
- Never scatter `if (isDev)` blocks across files
|
||||
- `r3f-perf` is lazy-loaded only in debug mode via `src/components/3d/DebugPerf.tsx`
|
||||
- `r3f-perf` is lazy-loaded only in debug mode via `src/debug/DebugPerf.tsx`
|
||||
|
||||
## Managers (4 max)
|
||||
|
||||
|
||||
@@ -11,7 +11,7 @@ http://localhost:5173?debug
|
||||
## Debug singleton
|
||||
|
||||
```ts
|
||||
// src/utils/Debug.ts
|
||||
// src/debug/Debug.ts
|
||||
import GUI from "lil-gui";
|
||||
|
||||
export class Debug {
|
||||
@@ -56,14 +56,15 @@ if (debug.active) {
|
||||
r3f-perf is loaded only in debug mode to avoid dependency issues in production:
|
||||
|
||||
```tsx
|
||||
// src/components/3d/DebugPerf.tsx
|
||||
// src/debug/DebugPerf.tsx
|
||||
import { Suspense, lazy } from "react";
|
||||
import { Debug } from "@/debug/Debug";
|
||||
|
||||
const Perf = lazy(() => import("r3f-perf").then((m) => ({ default: m.Perf })));
|
||||
|
||||
export function DebugPerf() {
|
||||
const debug = new URLSearchParams(window.location.search).has("debug");
|
||||
if (!debug) return null;
|
||||
const debug = Debug.getInstance();
|
||||
if (!debug.active) return null;
|
||||
|
||||
return (
|
||||
<Suspense fallback={null}>
|
||||
|
||||
@@ -49,8 +49,9 @@ la-fabrik/
|
||||
│
|
||||
└── src/
|
||||
├── world/ # Single persistent 3D world
|
||||
│ ├── World.tsx # Main scene composition
|
||||
│ ├── Map.tsx # Base map, always mounted
|
||||
│ ├── Lighting.tsx # Ambient, directional, point lights
|
||||
│ ├── Lighting.tsx # Ambient, directional, point lights
|
||||
│ ├── Environment.tsx # HDRI, fog, sky
|
||||
│ ├── PostFX.tsx # Bloom, SSAO, chromatic aberration
|
||||
│ ├── zones/ # Spatial zones — LOD per zone
|
||||
@@ -97,12 +98,18 @@ la-fabrik/
|
||||
│ ├── vertex.glsl
|
||||
│ └── fragment.glsl
|
||||
│
|
||||
├── utils/
|
||||
│ ├── Debug.ts # lil-gui panel
|
||||
│ ├── EventEmitter.ts # Simple pub/sub for manager-to-manager events
|
||||
│ └── Dispose.ts # traverse() + dispose() helper
|
||||
├── debug/ # Dev-only tools and scene inspection
|
||||
│ ├── Debug.ts # Global lil-gui manager
|
||||
│ ├── DebugPerf.tsx # r3f-perf overlay mounted in Canvas
|
||||
│ └── scene/
|
||||
│ ├── DebugHelpers.tsx # Grid + axes helpers shown in debug mode
|
||||
│ └── DebugCameraControls.tsx # Free debug camera for map inspection
|
||||
│
|
||||
├── App.tsx # Canvas + UI superimposed
|
||||
├── utils/
|
||||
│ ├── EventEmitter.ts # Simple pub/sub for manager-to-manager events
|
||||
│ └── Dispose.ts # traverse() + dispose() helper
|
||||
│
|
||||
├── App.tsx # Canvas bootstrap
|
||||
└── main.tsx
|
||||
```
|
||||
|
||||
@@ -116,7 +123,11 @@ npm run dev
|
||||
```
|
||||
|
||||
Open `http://localhost:5173` — standard experience.
|
||||
Open `http://localhost:5173?debug` — debug panel + r3f-perf overlay.
|
||||
Open `http://localhost:5173?debug` — debug panel + r3f-perf overlay + free debug camera.
|
||||
|
||||
## 🧭 Conventions
|
||||
|
||||
Coding conventions and generation rules live in `.agent/skills/best-practices.md`.
|
||||
|
||||
## 📜 License
|
||||
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Architecture Patterns
|
||||
|
||||
Coding conventions are maintained in `.agent/skills/best-practices.md`.
|
||||
|
||||
The project uses **two complementary patterns**:
|
||||
|
||||
- **Singleton service classes** for orchestration and side effects
|
||||
@@ -332,17 +334,23 @@ useEffect(() => {
|
||||
|
||||
---
|
||||
|
||||
## 6. Debug Utility
|
||||
## 6. Debug System
|
||||
|
||||
The debug panel can be activated by appending `?debug` to the URL:
|
||||
|
||||
`http://localhost:5173?debug`
|
||||
|
||||
All debug logic is centralized in `Debug.ts`.
|
||||
All debug logic is centralized in `src/debug/`.
|
||||
Do not scatter debug checks across the codebase.
|
||||
|
||||
- `src/debug/Debug.ts` owns the global lil-gui singleton
|
||||
- `src/debug/DebugPerf.tsx` mounts the perf overlay
|
||||
- `src/debug/scene/*` contains debug-only R3F helpers such as free camera controls and axes/grid helpers
|
||||
|
||||
`world/` stays focused on product scene components, while `debug/` contains developer tooling.
|
||||
|
||||
```ts
|
||||
// utils/Debug.ts
|
||||
// src/debug/Debug.ts
|
||||
import GUI from "lil-gui";
|
||||
|
||||
export class Debug {
|
||||
@@ -379,3 +387,28 @@ if (debug.active) {
|
||||
debug.gui!.add(params, "bloomIntensity", 0, 3).name("Bloom");
|
||||
}
|
||||
```
|
||||
|
||||
Debug-only scene helpers should live outside `world/`:
|
||||
|
||||
```tsx
|
||||
// src/debug/scene/DebugHelpers.tsx
|
||||
import { Debug } from "@/debug/Debug";
|
||||
|
||||
export function DebugHelpers(): React.JSX.Element | null {
|
||||
const debug = Debug.getInstance();
|
||||
|
||||
if (!debug.active) {
|
||||
return null;
|
||||
}
|
||||
|
||||
return (
|
||||
<>
|
||||
<gridHelper
|
||||
args={[180, 36, "#1d4ed8", "#1e293b"]}
|
||||
position={[0, 0.01, 0]}
|
||||
/>
|
||||
<axesHelper args={[10]} />
|
||||
</>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
@@ -1,153 +0,0 @@
|
||||
# Best Practices
|
||||
|
||||
Generate code that is **simple**, **understandable**, **reviewable**, **scalable**, **optimized**, and **modern**. Follow W3C web standards and platform conventions.
|
||||
|
||||
## Naming Conventions
|
||||
|
||||
### Files
|
||||
|
||||
| Type | Convention | Example |
|
||||
| ---------- | --------------------------- | -------------------- |
|
||||
| Components | PascalCase | `WorkshopZone.tsx` |
|
||||
| Hooks | camelCase with `use` prefix | `useGameState.ts` |
|
||||
| Managers | PascalCase | `GameManager.ts` |
|
||||
| Utils | PascalCase | `Dispose.ts` |
|
||||
| Data | PascalCase | `missions.ts` |
|
||||
| Shaders | kebab-case | `hologram.vert.glsl` |
|
||||
|
||||
### Variables & Functions
|
||||
|
||||
| Type | Convention | Example |
|
||||
| ---------------- | -------------------- | ----------------------------------------- |
|
||||
| Variables | camelCase | `activeZone`, `missionStep` |
|
||||
| Functions | camelCase | `startMission()`, `setActiveZone()` |
|
||||
| Constants | UPPER_SNAKE_CASE | `MAX_SPEED`, `DEFAULT_PHASE` |
|
||||
| React components | PascalCase | `function WorkshopZone()` |
|
||||
| React hooks | camelCase with `use` | `useGameState()`, `useFrame()` |
|
||||
| Classes | PascalCase | `class GameManager` |
|
||||
| Interfaces/Types | PascalCase | `type GameSnapshot`, `interface ZoneData` |
|
||||
|
||||
## Code Style
|
||||
|
||||
### Simplicity First
|
||||
|
||||
```ts
|
||||
// Good — clear, direct
|
||||
function getZoneRadius(zone: Zone): number {
|
||||
return zone.radius;
|
||||
}
|
||||
|
||||
// Bad — over-abstracted
|
||||
function getZoneRadius(zone: Zone): number {
|
||||
return zone[ZoneFields.RADIUS] ?? RADIUS_DEFAULTS[zone.type]?.default ?? 50;
|
||||
}
|
||||
```
|
||||
|
||||
### Early Return
|
||||
|
||||
```ts
|
||||
// Good
|
||||
if (!gltf) return null;
|
||||
if (!visible) return null;
|
||||
|
||||
return <primitive object={gltf.scene} />;
|
||||
```
|
||||
|
||||
### Avoid Nested Callbacks
|
||||
|
||||
```ts
|
||||
// Good — flat structure
|
||||
useEffect(() => {
|
||||
const mixer = new THREE.AnimationMixer(model);
|
||||
|
||||
return () => mixer.stopAllAction();
|
||||
}, [model]);
|
||||
```
|
||||
|
||||
## TypeScript Rules
|
||||
|
||||
### Explicit Types for Exports
|
||||
|
||||
```ts
|
||||
export function useGameState(): GameSnapshot { ... }
|
||||
|
||||
export function setPhase(phase: Phase): void { ... }
|
||||
```
|
||||
|
||||
### Never use `any`
|
||||
|
||||
```ts
|
||||
// Good
|
||||
const ref = useRef<THREE.Group>(null);
|
||||
|
||||
// Bad
|
||||
const ref = useRef<any>(null);
|
||||
```
|
||||
|
||||
## Performance
|
||||
|
||||
### useRef for Mutable Values
|
||||
|
||||
```ts
|
||||
// Good — no re-render
|
||||
const position = useRef(new THREE.Vector3());
|
||||
|
||||
// Bad — triggers re-render every frame
|
||||
const [position, setPosition] = useState(new THREE.Vector3());
|
||||
```
|
||||
|
||||
### Memoize Expensive Computations
|
||||
|
||||
```ts
|
||||
const memoizedValue = useMemo(() => computeExpensiveValue(a, b), [a, b]);
|
||||
```
|
||||
|
||||
## Scalability
|
||||
|
||||
### Single Responsibility
|
||||
|
||||
```ts
|
||||
// Good — focused component
|
||||
export function WorkshopZone() {
|
||||
// Only handles workshop zone logic
|
||||
}
|
||||
|
||||
// Bad — does everything
|
||||
export function WorkshopZone() {
|
||||
// Handles zone logic + audio + cinematics + missions
|
||||
}
|
||||
```
|
||||
|
||||
### Constants for Magic Numbers
|
||||
|
||||
```ts
|
||||
const DEFAULT_CAMERA_DISTANCE = 5;
|
||||
const ZONE_DETECTION_RADIUS = 20;
|
||||
```
|
||||
|
||||
## Accessibility (W3C)
|
||||
|
||||
### Semantic HTML
|
||||
|
||||
```tsx
|
||||
// Good
|
||||
<button onClick={handleInteract} aria-label="Interact with bike">
|
||||
<Model />
|
||||
</button>
|
||||
|
||||
// Bad
|
||||
<div onClick={handleInteract}>
|
||||
<Model />
|
||||
</div>
|
||||
```
|
||||
|
||||
## Rules
|
||||
|
||||
1. **Simplicity** — Every line of code must be justified.
|
||||
2. **Readability** — Code is read 10x more than it's written.
|
||||
3. **Reviewability** — PRs should be understandable in < 5 minutes.
|
||||
4. **Scalability** — Architecture should support growth without refactoring.
|
||||
5. **Performance** — Don't optimize prematurely, but don't introduce obvious bottlenecks.
|
||||
6. **Modern** — Use ES2022+ features, TypeScript strict mode, React hooks.
|
||||
7. **W3C** — Follow web standards: semantic HTML, ARIA, keyboard navigation.
|
||||
8. **No Over-Engineering** — Avoid patterns that add complexity without benefit.
|
||||
@@ -0,0 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:73f7be151055fc5e3cd51b6b2f0db717d442c8ce1645dae8400ac5644e8e4d45
|
||||
size 2067524
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:c98eb2de597f5e0fd60e2caff3e1889c761bfdcb9d23488d31700cb850cdd2ea
|
||||
size 2800791
|
||||
oid sha256:86174fe3ea442f7a13b86d40d96d315f1ae57d894daa69537f4266eb08fec513
|
||||
size 2839228
|
||||
|
||||
-184
@@ -1,184 +0,0 @@
|
||||
.counter {
|
||||
font-size: 16px;
|
||||
padding: 5px 10px;
|
||||
border-radius: 5px;
|
||||
color: var(--accent);
|
||||
background: var(--accent-bg);
|
||||
border: 2px solid transparent;
|
||||
transition: border-color 0.3s;
|
||||
margin-bottom: 24px;
|
||||
|
||||
&:hover {
|
||||
border-color: var(--accent-border);
|
||||
}
|
||||
&:focus-visible {
|
||||
outline: 2px solid var(--accent);
|
||||
outline-offset: 2px;
|
||||
}
|
||||
}
|
||||
|
||||
.hero {
|
||||
position: relative;
|
||||
|
||||
.base,
|
||||
.framework,
|
||||
.vite {
|
||||
inset-inline: 0;
|
||||
margin: 0 auto;
|
||||
}
|
||||
|
||||
.base {
|
||||
width: 170px;
|
||||
position: relative;
|
||||
z-index: 0;
|
||||
}
|
||||
|
||||
.framework,
|
||||
.vite {
|
||||
position: absolute;
|
||||
}
|
||||
|
||||
.framework {
|
||||
z-index: 1;
|
||||
top: 34px;
|
||||
height: 28px;
|
||||
transform: perspective(2000px) rotateZ(300deg) rotateX(44deg) rotateY(39deg)
|
||||
scale(1.4);
|
||||
}
|
||||
|
||||
.vite {
|
||||
z-index: 0;
|
||||
top: 107px;
|
||||
height: 26px;
|
||||
width: auto;
|
||||
transform: perspective(2000px) rotateZ(300deg) rotateX(40deg) rotateY(39deg)
|
||||
scale(0.8);
|
||||
}
|
||||
}
|
||||
|
||||
#center {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 25px;
|
||||
place-content: center;
|
||||
place-items: center;
|
||||
flex-grow: 1;
|
||||
|
||||
@media (max-width: 1024px) {
|
||||
padding: 32px 20px 24px;
|
||||
gap: 18px;
|
||||
}
|
||||
}
|
||||
|
||||
#next-steps {
|
||||
display: flex;
|
||||
border-top: 1px solid var(--border);
|
||||
text-align: left;
|
||||
|
||||
& > div {
|
||||
flex: 1 1 0;
|
||||
padding: 32px;
|
||||
@media (max-width: 1024px) {
|
||||
padding: 24px 20px;
|
||||
}
|
||||
}
|
||||
|
||||
.icon {
|
||||
margin-bottom: 16px;
|
||||
width: 22px;
|
||||
height: 22px;
|
||||
}
|
||||
|
||||
@media (max-width: 1024px) {
|
||||
flex-direction: column;
|
||||
text-align: center;
|
||||
}
|
||||
}
|
||||
|
||||
#docs {
|
||||
border-right: 1px solid var(--border);
|
||||
|
||||
@media (max-width: 1024px) {
|
||||
border-right: none;
|
||||
border-bottom: 1px solid var(--border);
|
||||
}
|
||||
}
|
||||
|
||||
#next-steps ul {
|
||||
list-style: none;
|
||||
padding: 0;
|
||||
display: flex;
|
||||
gap: 8px;
|
||||
margin: 32px 0 0;
|
||||
|
||||
.logo {
|
||||
height: 18px;
|
||||
}
|
||||
|
||||
a {
|
||||
color: var(--text-h);
|
||||
font-size: 16px;
|
||||
border-radius: 6px;
|
||||
background: var(--social-bg);
|
||||
display: flex;
|
||||
padding: 6px 12px;
|
||||
align-items: center;
|
||||
gap: 8px;
|
||||
text-decoration: none;
|
||||
transition: box-shadow 0.3s;
|
||||
|
||||
&:hover {
|
||||
box-shadow: var(--shadow);
|
||||
}
|
||||
.button-icon {
|
||||
height: 18px;
|
||||
width: 18px;
|
||||
}
|
||||
}
|
||||
|
||||
@media (max-width: 1024px) {
|
||||
margin-top: 20px;
|
||||
flex-wrap: wrap;
|
||||
justify-content: center;
|
||||
|
||||
li {
|
||||
flex: 1 1 calc(50% - 8px);
|
||||
}
|
||||
|
||||
a {
|
||||
width: 100%;
|
||||
justify-content: center;
|
||||
box-sizing: border-box;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
#spacer {
|
||||
height: 88px;
|
||||
border-top: 1px solid var(--border);
|
||||
@media (max-width: 1024px) {
|
||||
height: 48px;
|
||||
}
|
||||
}
|
||||
|
||||
.ticks {
|
||||
position: relative;
|
||||
width: 100%;
|
||||
|
||||
&::before,
|
||||
&::after {
|
||||
content: "";
|
||||
position: absolute;
|
||||
top: -4.5px;
|
||||
border: 5px solid transparent;
|
||||
}
|
||||
|
||||
&::before {
|
||||
left: 0;
|
||||
border-left-color: var(--border);
|
||||
}
|
||||
&::after {
|
||||
right: 0;
|
||||
border-right-color: var(--border);
|
||||
}
|
||||
}
|
||||
+8
-115
@@ -1,120 +1,13 @@
|
||||
import { useState } from "react";
|
||||
import reactLogo from "./assets/react.svg";
|
||||
import viteLogo from "./assets/vite.svg";
|
||||
import heroImg from "./assets/hero.png";
|
||||
import "./App.css";
|
||||
|
||||
function App() {
|
||||
const [count, setCount] = useState(0);
|
||||
import { Canvas } from "@react-three/fiber";
|
||||
import { DebugPerf } from "@/debug/DebugPerf";
|
||||
import { World } from "@/world/World";
|
||||
|
||||
function App(): React.JSX.Element {
|
||||
return (
|
||||
<>
|
||||
<section id="center">
|
||||
<div className="hero">
|
||||
<img src={heroImg} className="base" width="170" height="179" alt="" />
|
||||
<img src={reactLogo} className="framework" alt="React logo" />
|
||||
<img src={viteLogo} className="vite" alt="Vite logo" />
|
||||
</div>
|
||||
<div>
|
||||
<h1>Get started</h1>
|
||||
<p>
|
||||
Edit <code>src/App.tsx</code> and save to test <code>HMR</code>
|
||||
</p>
|
||||
</div>
|
||||
<button
|
||||
className="counter"
|
||||
onClick={() => setCount((count) => count + 1)}
|
||||
>
|
||||
Count is {count}
|
||||
</button>
|
||||
</section>
|
||||
|
||||
<div className="ticks"></div>
|
||||
|
||||
<section id="next-steps">
|
||||
<div id="docs">
|
||||
<svg className="icon" role="presentation" aria-hidden="true">
|
||||
<use href="/icons.svg#documentation-icon"></use>
|
||||
</svg>
|
||||
<h2>Documentation</h2>
|
||||
<p>Your questions, answered</p>
|
||||
<ul>
|
||||
<li>
|
||||
<a href="https://vite.dev/" target="_blank">
|
||||
<img className="logo" src={viteLogo} alt="" />
|
||||
Explore Vite
|
||||
</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="https://react.dev/" target="_blank">
|
||||
<img className="button-icon" src={reactLogo} alt="" />
|
||||
Learn more
|
||||
</a>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<div id="social">
|
||||
<svg className="icon" role="presentation" aria-hidden="true">
|
||||
<use href="/icons.svg#social-icon"></use>
|
||||
</svg>
|
||||
<h2>Connect with us</h2>
|
||||
<p>Join the Vite community</p>
|
||||
<ul>
|
||||
<li>
|
||||
<a href="https://github.com/vitejs/vite" target="_blank">
|
||||
<svg
|
||||
className="button-icon"
|
||||
role="presentation"
|
||||
aria-hidden="true"
|
||||
>
|
||||
<use href="/icons.svg#github-icon"></use>
|
||||
</svg>
|
||||
GitHub
|
||||
</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="https://chat.vite.dev/" target="_blank">
|
||||
<svg
|
||||
className="button-icon"
|
||||
role="presentation"
|
||||
aria-hidden="true"
|
||||
>
|
||||
<use href="/icons.svg#discord-icon"></use>
|
||||
</svg>
|
||||
Discord
|
||||
</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="https://x.com/vite_js" target="_blank">
|
||||
<svg
|
||||
className="button-icon"
|
||||
role="presentation"
|
||||
aria-hidden="true"
|
||||
>
|
||||
<use href="/icons.svg#x-icon"></use>
|
||||
</svg>
|
||||
X.com
|
||||
</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="https://bsky.app/profile/vite.dev" target="_blank">
|
||||
<svg
|
||||
className="button-icon"
|
||||
role="presentation"
|
||||
aria-hidden="true"
|
||||
>
|
||||
<use href="/icons.svg#bluesky-icon"></use>
|
||||
</svg>
|
||||
Bluesky
|
||||
</a>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<div className="ticks"></div>
|
||||
<section id="spacer"></section>
|
||||
</>
|
||||
<Canvas camera={{ position: [85, 60, 85], fov: 42 }} shadows>
|
||||
<World />
|
||||
<DebugPerf />
|
||||
</Canvas>
|
||||
);
|
||||
}
|
||||
|
||||
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 44 KiB |
@@ -1 +0,0 @@
|
||||
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="35.93" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 228"><path fill="#00D8FF" d="M210.483 73.824a171.49 171.49 0 0 0-8.24-2.597c.465-1.9.893-3.777 1.273-5.621c6.238-30.281 2.16-54.676-11.769-62.708c-13.355-7.7-35.196.329-57.254 19.526a171.23 171.23 0 0 0-6.375 5.848a155.866 155.866 0 0 0-4.241-3.917C100.759 3.829 77.587-4.822 63.673 3.233C50.33 10.957 46.379 33.89 51.995 62.588a170.974 170.974 0 0 0 1.892 8.48c-3.28.932-6.445 1.924-9.474 2.98C17.309 83.498 0 98.307 0 113.668c0 15.865 18.582 31.778 46.812 41.427a145.52 145.52 0 0 0 6.921 2.165a167.467 167.467 0 0 0-2.01 9.138c-5.354 28.2-1.173 50.591 12.134 58.266c13.744 7.926 36.812-.22 59.273-19.855a145.567 145.567 0 0 0 5.342-4.923a168.064 168.064 0 0 0 6.92 6.314c21.758 18.722 43.246 26.282 56.54 18.586c13.731-7.949 18.194-32.003 12.4-61.268a145.016 145.016 0 0 0-1.535-6.842c1.62-.48 3.21-.974 4.76-1.488c29.348-9.723 48.443-25.443 48.443-41.52c0-15.417-17.868-30.326-45.517-39.844Zm-6.365 70.984c-1.4.463-2.836.91-4.3 1.345c-3.24-10.257-7.612-21.163-12.963-32.432c5.106-11 9.31-21.767 12.459-31.957c2.619.758 5.16 1.557 7.61 2.4c23.69 8.156 38.14 20.213 38.14 29.504c0 9.896-15.606 22.743-40.946 31.14Zm-10.514 20.834c2.562 12.94 2.927 24.64 1.23 33.787c-1.524 8.219-4.59 13.698-8.382 15.893c-8.067 4.67-25.32-1.4-43.927-17.412a156.726 156.726 0 0 1-6.437-5.87c7.214-7.889 14.423-17.06 21.459-27.246c12.376-1.098 24.068-2.894 34.671-5.345a134.17 134.17 0 0 1 1.386 6.193ZM87.276 214.515c-7.882 2.783-14.16 2.863-17.955.675c-8.075-4.657-11.432-22.636-6.853-46.752a156.923 156.923 0 0 1 1.869-8.499c10.486 2.32 22.093 3.988 34.498 4.994c7.084 9.967 14.501 19.128 21.976 27.15a134.668 134.668 0 0 1-4.877 4.492c-9.933 8.682-19.886 14.842-28.658 17.94ZM50.35 144.747c-12.483-4.267-22.792-9.812-29.858-15.863c-6.35-5.437-9.555-10.836-9.555-15.216c0-9.322 13.897-21.212 37.076-29.293c2.813-.98 5.757-1.905 8.812-2.773c3.204 10.42 7.406 21.315 12.477 32.332c-5.137 11.18-9.399 22.249-12.634 32.792a134.718 134.718 0 0 1-6.318-1.979Zm12.378-84.26c-4.811-24.587-1.616-43.134 6.425-47.789c8.564-4.958 27.502 2.111 47.463 19.835a144.318 144.318 0 0 1 3.841 3.545c-7.438 7.987-14.787 17.08-21.808 26.988c-12.04 1.116-23.565 2.908-34.161 5.309a160.342 160.342 0 0 1-1.76-7.887Zm110.427 27.268a347.8 347.8 0 0 0-7.785-12.803c8.168 1.033 15.994 2.404 23.343 4.08c-2.206 7.072-4.956 14.465-8.193 22.045a381.151 381.151 0 0 0-7.365-13.322Zm-45.032-43.861c5.044 5.465 10.096 11.566 15.065 18.186a322.04 322.04 0 0 0-30.257-.006c4.974-6.559 10.069-12.652 15.192-18.18ZM82.802 87.83a323.167 323.167 0 0 0-7.227 13.238c-3.184-7.553-5.909-14.98-8.134-22.152c7.304-1.634 15.093-2.97 23.209-3.984a321.524 321.524 0 0 0-7.848 12.897Zm8.081 65.352c-8.385-.936-16.291-2.203-23.593-3.793c2.26-7.3 5.045-14.885 8.298-22.6a321.187 321.187 0 0 0 7.257 13.246c2.594 4.48 5.28 8.868 8.038 13.147Zm37.542 31.03c-5.184-5.592-10.354-11.779-15.403-18.433c4.902.192 9.899.29 14.978.29c5.218 0 10.376-.117 15.453-.343c-4.985 6.774-10.018 12.97-15.028 18.486Zm52.198-57.817c3.422 7.8 6.306 15.345 8.596 22.52c-7.422 1.694-15.436 3.058-23.88 4.071a382.417 382.417 0 0 0 7.859-13.026a347.403 347.403 0 0 0 7.425-13.565Zm-16.898 8.101a358.557 358.557 0 0 1-12.281 19.815a329.4 329.4 0 0 1-23.444.823c-7.967 0-15.716-.248-23.178-.732a310.202 310.202 0 0 1-12.513-19.846h.001a307.41 307.41 0 0 1-10.923-20.627a310.278 310.278 0 0 1 10.89-20.637l-.001.001a307.318 307.318 0 0 1 12.413-19.761c7.613-.576 15.42-.876 23.31-.876H128c7.926 0 15.743.303 23.354.883a329.357 329.357 0 0 1 12.335 19.695a358.489 358.489 0 0 1 11.036 20.54a329.472 329.472 0 0 1-11 20.722Zm22.56-122.124c8.572 4.944 11.906 24.881 6.52 51.026c-.344 1.668-.73 3.367-1.15 5.09c-10.622-2.452-22.155-4.275-34.23-5.408c-7.034-10.017-14.323-19.124-21.64-27.008a160.789 160.789 0 0 1 5.888-5.4c18.9-16.447 36.564-22.941 44.612-18.3ZM128 90.808c12.625 0 22.86 10.235 22.86 22.86s-10.235 22.86-22.86 22.86s-22.86-10.235-22.86-22.86s10.235-22.86 22.86-22.86Z"></path></svg>
|
||||
|
Before Width: | Height: | Size: 4.0 KiB |
File diff suppressed because one or more lines are too long
|
Before Width: | Height: | Size: 8.5 KiB |
@@ -0,0 +1,48 @@
|
||||
import GUI from "lil-gui";
|
||||
|
||||
export class Debug {
|
||||
private static instance: Debug | null = null;
|
||||
|
||||
public readonly active: boolean;
|
||||
private readonly gui: GUI | null;
|
||||
private readonly folders = new Map<string, GUI>();
|
||||
|
||||
static getInstance(): Debug {
|
||||
if (!Debug.instance) {
|
||||
Debug.instance = new Debug();
|
||||
}
|
||||
return Debug.instance;
|
||||
}
|
||||
|
||||
private constructor() {
|
||||
this.active = new URLSearchParams(window.location.search).has("debug");
|
||||
if (this.active) {
|
||||
this.gui = new GUI({ title: "La-Fabrik Debug" });
|
||||
} else {
|
||||
this.gui = null;
|
||||
}
|
||||
}
|
||||
|
||||
createFolder(name: string): GUI | null {
|
||||
if (!this.gui) {
|
||||
return null;
|
||||
}
|
||||
|
||||
const existingFolder = this.folders.get(name);
|
||||
|
||||
if (existingFolder) {
|
||||
return existingFolder;
|
||||
}
|
||||
|
||||
const folder = this.gui.addFolder(name);
|
||||
this.folders.set(name, folder);
|
||||
|
||||
return folder;
|
||||
}
|
||||
|
||||
destroy(): void {
|
||||
this.folders.clear();
|
||||
this.gui?.destroy();
|
||||
Debug.instance = null;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,18 @@
|
||||
import { Suspense, lazy } from "react";
|
||||
import { Debug } from "@/debug/Debug";
|
||||
|
||||
const Perf = lazy(() => import("r3f-perf").then((m) => ({ default: m.Perf })));
|
||||
|
||||
export function DebugPerf(): React.JSX.Element | null {
|
||||
const debug = Debug.getInstance();
|
||||
|
||||
if (!debug.active) {
|
||||
return null;
|
||||
}
|
||||
|
||||
return (
|
||||
<Suspense fallback={null}>
|
||||
<Perf position="bottom-right" />
|
||||
</Suspense>
|
||||
);
|
||||
}
|
||||
@@ -0,0 +1,68 @@
|
||||
import { useEffect, useRef } from "react";
|
||||
import { OrbitControls } from "@react-three/drei";
|
||||
import type { OrbitControls as OrbitControlsImpl } from "three-stdlib";
|
||||
import { Debug } from "@/debug/Debug";
|
||||
|
||||
export function DebugCameraControls(): React.JSX.Element {
|
||||
const controls = useRef<OrbitControlsImpl | null>(null);
|
||||
|
||||
useEffect(() => {
|
||||
const debug = Debug.getInstance();
|
||||
|
||||
if (!debug.active || !controls.current) {
|
||||
return undefined;
|
||||
}
|
||||
|
||||
const folder = debug.createFolder("Camera");
|
||||
|
||||
if (!folder) {
|
||||
return undefined;
|
||||
}
|
||||
|
||||
const target = controls.current.target;
|
||||
const cameraState = {
|
||||
targetX: target.x,
|
||||
targetY: target.y,
|
||||
targetZ: target.z,
|
||||
};
|
||||
|
||||
const syncTarget = (): void => {
|
||||
if (!controls.current) {
|
||||
return;
|
||||
}
|
||||
|
||||
controls.current.target.set(
|
||||
cameraState.targetX,
|
||||
cameraState.targetY,
|
||||
cameraState.targetZ,
|
||||
);
|
||||
controls.current.update();
|
||||
};
|
||||
|
||||
folder
|
||||
.add(cameraState, "targetX", -100, 100, 0.1)
|
||||
.name("Target X")
|
||||
.onChange(syncTarget);
|
||||
folder
|
||||
.add(cameraState, "targetY", -20, 50, 0.1)
|
||||
.name("Target Y")
|
||||
.onChange(syncTarget);
|
||||
folder
|
||||
.add(cameraState, "targetZ", -100, 100, 0.1)
|
||||
.name("Target Z")
|
||||
.onChange(syncTarget);
|
||||
|
||||
return undefined;
|
||||
}, []);
|
||||
|
||||
return (
|
||||
<OrbitControls
|
||||
ref={controls}
|
||||
enableDamping
|
||||
dampingFactor={0.08}
|
||||
minDistance={20}
|
||||
maxDistance={220}
|
||||
target={[0, 12, 0]}
|
||||
/>
|
||||
);
|
||||
}
|
||||
@@ -0,0 +1,19 @@
|
||||
import { Debug } from "@/debug/Debug";
|
||||
|
||||
export function DebugHelpers(): React.JSX.Element | null {
|
||||
const debug = Debug.getInstance();
|
||||
|
||||
if (!debug.active) {
|
||||
return null;
|
||||
}
|
||||
|
||||
return (
|
||||
<>
|
||||
<gridHelper
|
||||
args={[180, 36, "#1d4ed8", "#1e293b"]}
|
||||
position={[0, 0.01, 0]}
|
||||
/>
|
||||
<axesHelper args={[10]} />
|
||||
</>
|
||||
);
|
||||
}
|
||||
+15
-99
@@ -1,111 +1,27 @@
|
||||
:root {
|
||||
--text: #6b6375;
|
||||
--text-h: #08060d;
|
||||
--bg: #fff;
|
||||
--border: #e5e4e7;
|
||||
--code-bg: #f4f3ec;
|
||||
--accent: #aa3bff;
|
||||
--accent-bg: rgba(170, 59, 255, 0.1);
|
||||
--accent-border: rgba(170, 59, 255, 0.5);
|
||||
--social-bg: rgba(244, 243, 236, 0.5);
|
||||
--shadow:
|
||||
rgba(0, 0, 0, 0.1) 0 10px 15px -3px, rgba(0, 0, 0, 0.05) 0 4px 6px -2px;
|
||||
|
||||
--sans: system-ui, "Segoe UI", Roboto, sans-serif;
|
||||
--heading: system-ui, "Segoe UI", Roboto, sans-serif;
|
||||
--mono: ui-monospace, Consolas, monospace;
|
||||
|
||||
font: 18px/145% var(--sans);
|
||||
letter-spacing: 0.18px;
|
||||
color-scheme: light dark;
|
||||
color: var(--text);
|
||||
background: var(--bg);
|
||||
font-synthesis: none;
|
||||
text-rendering: optimizeLegibility;
|
||||
-webkit-font-smoothing: antialiased;
|
||||
-moz-osx-font-smoothing: grayscale;
|
||||
|
||||
@media (max-width: 1024px) {
|
||||
font-size: 16px;
|
||||
}
|
||||
}
|
||||
|
||||
@media (prefers-color-scheme: dark) {
|
||||
:root {
|
||||
--text: #9ca3af;
|
||||
--text-h: #f3f4f6;
|
||||
--bg: #16171d;
|
||||
--border: #2e303a;
|
||||
--code-bg: #1f2028;
|
||||
--accent: #c084fc;
|
||||
--accent-bg: rgba(192, 132, 252, 0.15);
|
||||
--accent-border: rgba(192, 132, 252, 0.5);
|
||||
--social-bg: rgba(47, 48, 58, 0.5);
|
||||
--shadow:
|
||||
rgba(0, 0, 0, 0.4) 0 10px 15px -3px, rgba(0, 0, 0, 0.25) 0 4px 6px -2px;
|
||||
}
|
||||
|
||||
#social .button-icon {
|
||||
filter: invert(1) brightness(2);
|
||||
}
|
||||
color-scheme: dark;
|
||||
font-family: Inter;
|
||||
}
|
||||
|
||||
html,
|
||||
body,
|
||||
#root {
|
||||
width: 1126px;
|
||||
max-width: 100%;
|
||||
margin: 0 auto;
|
||||
text-align: center;
|
||||
border-inline: 1px solid var(--border);
|
||||
min-height: 100svh;
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
box-sizing: border-box;
|
||||
margin: 0;
|
||||
width: 100vw;
|
||||
height: 100vh;
|
||||
}
|
||||
|
||||
body {
|
||||
margin: 0;
|
||||
overflow: hidden;
|
||||
}
|
||||
|
||||
h1,
|
||||
h2 {
|
||||
font-family: var(--heading);
|
||||
font-weight: 500;
|
||||
color: var(--text-h);
|
||||
button,
|
||||
input,
|
||||
textarea,
|
||||
select {
|
||||
font: inherit;
|
||||
}
|
||||
|
||||
h1 {
|
||||
font-size: 56px;
|
||||
letter-spacing: -1.68px;
|
||||
margin: 32px 0;
|
||||
@media (max-width: 1024px) {
|
||||
font-size: 36px;
|
||||
margin: 20px 0;
|
||||
}
|
||||
}
|
||||
h2 {
|
||||
font-size: 24px;
|
||||
line-height: 118%;
|
||||
letter-spacing: -0.24px;
|
||||
margin: 0 0 8px;
|
||||
@media (max-width: 1024px) {
|
||||
font-size: 20px;
|
||||
}
|
||||
}
|
||||
p {
|
||||
margin: 0;
|
||||
}
|
||||
|
||||
code,
|
||||
.counter {
|
||||
font-family: var(--mono);
|
||||
display: inline-flex;
|
||||
border-radius: 4px;
|
||||
color: var(--text-h);
|
||||
}
|
||||
|
||||
code {
|
||||
font-size: 15px;
|
||||
line-height: 135%;
|
||||
padding: 4px 8px;
|
||||
background: var(--code-bg);
|
||||
canvas {
|
||||
display: block;
|
||||
}
|
||||
|
||||
+1
-1
@@ -1,7 +1,7 @@
|
||||
import { StrictMode } from "react";
|
||||
import { createRoot } from "react-dom/client";
|
||||
import "./index.css";
|
||||
import App from "./App.tsx";
|
||||
import "./index.css";
|
||||
|
||||
createRoot(document.getElementById("root")!).render(
|
||||
<StrictMode>
|
||||
|
||||
@@ -1 +0,0 @@
|
||||
// src/utils/Debug.ts
|
||||
@@ -1,11 +0,0 @@
|
||||
import { Suspense, lazy } from "react";
|
||||
const Perf = lazy(() => import("r3f-perf").then((m) => ({ default: m.Perf })));
|
||||
export function DebugPerf() {
|
||||
const debug = new URLSearchParams(window.location.search).has("debug");
|
||||
if (!debug) return null;
|
||||
return (
|
||||
<Suspense fallback={null}>
|
||||
<Perf position="top-left" />
|
||||
</Suspense>
|
||||
);
|
||||
}
|
||||
@@ -1 +1,3 @@
|
||||
// src/world/Environment.tsx
|
||||
export function Environment(): React.JSX.Element {
|
||||
return <color attach="background" args={["#0b1018"]} />;
|
||||
}
|
||||
|
||||
+12
-1
@@ -1 +1,12 @@
|
||||
// src/world/Lighting.tsx
|
||||
export function Lighting(): React.JSX.Element {
|
||||
return (
|
||||
<>
|
||||
<directionalLight
|
||||
position={[60, 80, 30]}
|
||||
intensity={2.8}
|
||||
color="#fff7ed"
|
||||
castShadow
|
||||
/>
|
||||
</>
|
||||
);
|
||||
}
|
||||
|
||||
+101
-1
@@ -1 +1,101 @@
|
||||
// src/world/Map.tsx
|
||||
// # route path src/world/Map.tsx
|
||||
import { useEffect, useLayoutEffect, useMemo, useRef } from "react";
|
||||
import { useFrame } from "@react-three/fiber";
|
||||
import { useGLTF } from "@react-three/drei";
|
||||
import * as THREE from "three";
|
||||
import { Debug } from "@/debug/Debug";
|
||||
|
||||
const MODEL_PATH = "/models/map/blocking/model.glb";
|
||||
|
||||
type MapDebugState = {
|
||||
positionX: number;
|
||||
positionY: number;
|
||||
positionZ: number;
|
||||
rotationY: number;
|
||||
scale: number;
|
||||
};
|
||||
|
||||
const DEFAULT_DEBUG_STATE: MapDebugState = {
|
||||
positionX: 0,
|
||||
positionY: 0,
|
||||
positionZ: 0,
|
||||
rotationY: 0,
|
||||
scale: 1,
|
||||
};
|
||||
|
||||
function centerModel(model: THREE.Object3D): number {
|
||||
model.updateMatrixWorld(true);
|
||||
|
||||
const bounds = new THREE.Box3().setFromObject(model);
|
||||
const center = bounds.getCenter(new THREE.Vector3());
|
||||
const size = bounds.getSize(new THREE.Vector3());
|
||||
|
||||
model.position.set(-center.x, -bounds.min.y, -center.z);
|
||||
|
||||
return size.length() > 0 && size.length() < 10 ? 5 : 1;
|
||||
}
|
||||
|
||||
export function Map(): React.JSX.Element {
|
||||
const root = useRef<THREE.Group>(null);
|
||||
const debugState = useRef<MapDebugState>({ ...DEFAULT_DEBUG_STATE });
|
||||
const { scene } = useGLTF(MODEL_PATH);
|
||||
const model = useMemo(() => scene.clone(true), [scene]);
|
||||
|
||||
useLayoutEffect(() => {
|
||||
debugState.current.scale = centerModel(model);
|
||||
}, [model]);
|
||||
|
||||
useEffect(() => {
|
||||
const debug = Debug.getInstance();
|
||||
|
||||
if (!debug.active) {
|
||||
return undefined;
|
||||
}
|
||||
|
||||
const folder = debug.createFolder("Map");
|
||||
|
||||
if (!folder) {
|
||||
return undefined;
|
||||
}
|
||||
|
||||
folder
|
||||
.add(debugState.current, "positionX", -100, 100, 0.1)
|
||||
.name("Position X");
|
||||
folder
|
||||
.add(debugState.current, "positionY", -20, 50, 0.1)
|
||||
.name("Position Y");
|
||||
folder
|
||||
.add(debugState.current, "positionZ", -100, 100, 0.1)
|
||||
.name("Position Z");
|
||||
folder
|
||||
.add(debugState.current, "rotationY", -Math.PI, Math.PI, 0.01)
|
||||
.name("Rotation Y");
|
||||
folder.add(debugState.current, "scale", 0.1, 10, 0.01).name("Scale");
|
||||
|
||||
return undefined;
|
||||
}, []);
|
||||
|
||||
useFrame(() => {
|
||||
const currentRoot = root.current;
|
||||
|
||||
if (!currentRoot) {
|
||||
return;
|
||||
}
|
||||
|
||||
currentRoot.position.set(
|
||||
debugState.current.positionX,
|
||||
debugState.current.positionY,
|
||||
debugState.current.positionZ,
|
||||
);
|
||||
currentRoot.rotation.y = debugState.current.rotationY;
|
||||
currentRoot.scale.setScalar(debugState.current.scale);
|
||||
});
|
||||
|
||||
return (
|
||||
<group ref={root}>
|
||||
<primitive object={model} />
|
||||
</group>
|
||||
);
|
||||
}
|
||||
|
||||
useGLTF.preload(MODEL_PATH);
|
||||
|
||||
@@ -0,0 +1,20 @@
|
||||
import { Suspense } from "react";
|
||||
import { DebugCameraControls } from "@/debug/scene/DebugCameraControls";
|
||||
import { DebugHelpers } from "@/debug/scene/DebugHelpers";
|
||||
import { Environment } from "@/world/Environment";
|
||||
import { Lighting } from "@/world/Lighting";
|
||||
import { Map } from "@/world/Map";
|
||||
|
||||
export function World(): React.JSX.Element {
|
||||
return (
|
||||
<>
|
||||
<Environment />
|
||||
<Lighting />
|
||||
<DebugHelpers />
|
||||
<DebugCameraControls />
|
||||
<Suspense fallback={null}>
|
||||
<Map />
|
||||
</Suspense>
|
||||
</>
|
||||
);
|
||||
}
|
||||
@@ -6,9 +6,14 @@
|
||||
"module": "esnext",
|
||||
"types": ["vite/client"],
|
||||
"skipLibCheck": true,
|
||||
"ignoreDeprecations": "6.0",
|
||||
|
||||
/* Bundler mode */
|
||||
"moduleResolution": "bundler",
|
||||
"baseUrl": ".",
|
||||
"paths": {
|
||||
"@/*": ["./src/*"]
|
||||
},
|
||||
"allowImportingTsExtensions": true,
|
||||
"verbatimModuleSyntax": true,
|
||||
"moduleDetection": "force",
|
||||
|
||||
@@ -1,7 +1,13 @@
|
||||
import { defineConfig } from "vite";
|
||||
import react from "@vitejs/plugin-react";
|
||||
import path from "node:path";
|
||||
|
||||
// https://vite.dev/config/
|
||||
export default defineConfig({
|
||||
plugins: [react()],
|
||||
resolve: {
|
||||
alias: {
|
||||
"@": path.resolve(__dirname, "./src"),
|
||||
},
|
||||
},
|
||||
});
|
||||
|
||||
Reference in New Issue
Block a user