Files
chameleon/README.md
T
2026-06-22 17:11:26 +02:00

54 lines
2.1 KiB
Markdown

# Chameleon
A Unity mesh-painting game inspired by **Meccha Chameleon** — not a 1:1 clone.
You paint your character directly on its 3D mesh to blend into the environment,
and move with an extended traversal kit (run, jump, slope-slide, wall-climb).
> Status: early prototype. Core painting and movement work; the hide-and-seek
> game loop (roles, rounds, scoring, multiplayer) is not built yet.
## Features so far
- **Seamless mesh painting** straight onto the character's 3D mesh (GPU + CPU path,
edge-dilation against seams).
- **Third-person character controller** — camera-relative WASD, jump, gravity,
slope-sliding off too-steep surfaces.
- **Wall-climb + mantle** — climb walls/ceilings (W approach/up, S detach, A/D
sideways) and pull up over top edges instead of dropping.
- **Cinemachine orbit camera** — mouse look, scroll zoom, collision deocclusion.
- **Game mode manager** — extensible state machine, switch with **Tab**:
- *Player Control* — move + mouse look.
- *Paint* — no movement, left-click paints, hold right-click to orbit.
## Controls
| Input | Action |
|---|---|
| WASD | Move (camera-relative) |
| Space | Jump |
| Mouse | Look / orbit camera |
| Mouse wheel | Zoom |
| Left click | Paint (Paint mode) |
| Tab | Switch mode (Player Control ⇄ Paint) |
## Getting started
1. Open the project with **Unity 6000.3.11f1** (Unity 6).
2. Open `Assets/Scenes/SampleScene.unity`.
3. Press **Play**, move with WASD, press **Tab** to switch to Paint mode and paint.
Cinemachine (`com.unity.cinemachine`) and the Input System are resolved
automatically via the package manifest.
## Project layout
- `Assets/Scripts/` — gameplay scripts (`PlayerCharacterController`, `MeshPainter`,
`ThirdPersonOrbitInput`, `GameModeManager`, modes, `FrameRateLimiter`).
- `Assets/Scenes/` — `SampleScene` (the playground).
- `Docs/GAME_DESIGN.md` — design notes and the full feature checklist (German).
## Roadmap
See **[`Docs/GAME_DESIGN.md`](Docs/GAME_DESIGN.md)** for what's done and what's next
(color-picker UI, eyedropper, poses, seeker role, rounds, multiplayer).