VinPropane
d6ef4fd811
Followup #5: after locking alpha, walking into beta's ring, stopping and pressing Tab could still return `out_of_range` even when client and server agreed on position (Δ=0). The freshness-kick move-stream POST and the target/select POST race on separate HTTP connections so the select can be validated against a stale stored snap. Extend TargetSelectRequest v1 with an optional positionHint {x,y,z}. Server uses the hint for the radius check and for the echoed targetState.validity; the hint is advisory and does not write to the position store (move-stream stays the sole write path). Client attaches the hint automatically whenever set_freshness_kick(...) is wired, so headless unit tests that skip the wiring fall through to the no-hint behavior. Freshness kick is kept in place to refresh the stored snap for later validity GETs but is no longer load-bearing for denial correctness. Server: 3 new tests (hint accepts when stored is stale, hint-far denies, hint never writes to position store). Client: 1 new test asserting the hint is in the POST body when wired. All 62 server + 96 client tests pass. Plan Decision 8, review follow-up #5, manual QA section 6, and NEO-23 contract notes updated. New bruno request exercises the hint path. |
||
|---|---|---|
| .cursor | ||
| .github/workflows | ||
| .vscode | ||
| bruno/neon-sprawl-server | ||
| client | ||
| content | ||
| docs | ||
| scripts | ||
| server | ||
| .gitignore | ||
| AGENTS.md | ||
| NeonSprawl.sln | ||
| README.md | ||
| docker-compose.yml | ||
| gdlintrc | ||
| neon_sprawl_vision.plan.md | ||
README.md
Neon Sprawl
Neon Sprawl is the working title for a crafting-focused sci-fi / cyberpunk MMORPG with gigs (combat roles) and open non-combat skills (solo-dev scope). Product intent and phase gates: neon_sprawl_vision.plan.md. Design axioms: it must be fun, and it must stay distinctly cyberpunk in theme (see Design axioms in the vision plan).
Tech stack (locked)
| Area | Choice |
|---|---|
| Client | Godot 4.x (GDScript) |
| Game server | C# / .NET 10 (ASP.NET Core), PostgreSQL, Protobuf (JSON OK for earliest spike) |
| Content | JSON/YAML + JSON Schema in CI |
Full rationale and constraints: docs/architecture/tech_stack.md.
Decomposition
Epic-level breakdown: docs/decomposition/README.md.
Git workflow
- Documentation (Markdown under
docs/, README files,neon_sprawl_vision.plan.md): work and commit directly onmain. - Code and implementation (server/client source, Godot project,
content/data, Docker/build/CI config): use a branch, then merge tomainwhen ready. Mixed doc + code changes follow the branch rule.
Repository layout (prototype scaffold)
| Path | Purpose |
|---|---|
NeonSprawl.sln |
.NET solution |
server/NeonSprawl.Server/ |
ASP.NET Core game server |
client/ |
Godot 4.x project (import project.godot) |
content/ |
JSON data + JSON Schema (skills/, schemas/) |
docker-compose.yml |
Local PostgreSQL (docker compose up -d) |
Run the server
cd server/NeonSprawl.Server && dotnet run
Then open http://localhost:5253/health (port from launchSettings.json).
Run Postgres locally
docker compose up -d
Connection (dev): host localhost, port 5432, database neon_sprawl, user neon_sprawl, password neon_sprawl_dev.
Run the client
Open the client/ folder in Godot 4.6 and run the main scene (see client/README.md).