BlueGit

timfa questward

Add repository layout, gitignore, and local run scripts.

Co-authored-by: Cursor <cursoragent@cursor.com>

timfa Tim Falken · pushed by timfa

Authored 2026-08-24 · 2 months ago

Hash
4d73d64bf6156acd077899484365350a0671c4fa
Parent
77da18ca
4 files changed +92 −0
.gitignore added +12 −0
@@ -0,0 +1,12 @@
1 node_modules/
2 server/data/
3 *.sqlite
4 *.sqlite-journal
5 *.sqlite-wal
6 *.sqlite-shm
7 .DS_Store
8 Thumbs.db
9 client/frameworkv3/js/framework.js
10 client/public/framework.js
11 .env
12 .env.local
@@ -0,0 +1,12 @@
1node_modules/
2server/data/
3*.sqlite
4*.sqlite-journal
5*.sqlite-wal
6*.sqlite-shm
7.DS_Store
8Thumbs.db
9client/frameworkv3/js/framework.js
10client/public/framework.js
11.env
12.env.local
README.md +27 −0
@@ -0,0 +1,27 @@
1 # Tile MMO
2
3 Authoritative Node.js tile MMO with a FrameworkV3 web client. Architecture lives in `tile_mmo_server_technical_design_v0.6.md`. Implementation status lives in `docs/FEATURES.md`.
4
5 ## Layout
6
7 - `shared/` — protocol constants and tile definitions used by server and client
8 - `server/src/` — Node.js simulation, persistence, editor API, gateway
9 - `client/src/` — game client on top of FrameworkV3
10 - `client/assets/` — 16×16 world sprites
11 - `client/frameworkv3/` — FrameworkV3 git submodule
12
13 ## Run locally
14
15 ```text
16 git submodule update --init --recursive
17 npm install
18 npm run build:client
19 npm test
20 npm start
21 ```
22
23 Open [http://localhost:8080](http://localhost:8080) to play and [http://localhost:8080/editor](http://localhost:8080/editor) for the world editor.
24
25 Until auth.timfalken.com exists, each browser connection is a stub admin (`admin-1`, `admin-2`, …). A fresh world is infinite closed grass: open chunk `0,0` in the editor, save, then **Apply now** before a character can walk.
26
27 The player-driven marketplace is not in this slice. It will be placed in the world editor after those assets exist.
@@ -0,0 +1,27 @@
1# Tile MMO
2
3Authoritative Node.js tile MMO with a FrameworkV3 web client. Architecture lives in `tile_mmo_server_technical_design_v0.6.md`. Implementation status lives in `docs/FEATURES.md`.
4
5## Layout
6
7- `shared/` — protocol constants and tile definitions used by server and client
8- `server/src/` — Node.js simulation, persistence, editor API, gateway
9- `client/src/` — game client on top of FrameworkV3
10- `client/assets/` — 16×16 world sprites
11- `client/frameworkv3/` — FrameworkV3 git submodule
12
13## Run locally
14
15```text
16git submodule update --init --recursive
17npm install
18npm run build:client
19npm test
20npm start
21```
22
23Open [http://localhost:8080](http://localhost:8080) to play and [http://localhost:8080/editor](http://localhost:8080/editor) for the world editor.
24
25Until auth.timfalken.com exists, each browser connection is a stub admin (`admin-1`, `admin-2`, …). A fresh world is infinite closed grass: open chunk `0,0` in the editor, save, then **Apply now** before a character can walk.
26
27The player-driven marketplace is not in this slice. It will be placed in the world editor after those assets exist.
package-lock.json added +37 −0
@@ -0,0 +1,37 @@
1 {
2 "name": "tile-mmo",
3 "lockfileVersion": 3,
4 "requires": true,
5 "packages": {
6 "": {
7 "name": "tile-mmo",
8 "dependencies": {
9 "ws": "^8.18.3"
10 },
11 "engines": {
12 "node": ">=22.13.0"
13 }
14 },
15 "node_modules/ws": {
16 "version": "8.21.3",
17 "resolved": "https://registry.npmjs.org/ws/-/ws-8.21.3.tgz",
18 "integrity": "sha512-201TZ/kPWxoPr/OKWjquZR1SWKXcvxdH+e1xrx89b3YbmzLMFCLfnaG1HFIgWzJOEWZ7MvpK++odZufgYR50Rw==",
19 "license": "MIT",
20 "engines": {
21 "node": ">=10.0.0"
22 },
23 "peerDependencies": {
24 "bufferutil": "^4.0.1",
25 "utf-8-validate": ">=5.0.2"
26 },
27 "peerDependenciesMeta": {
28 "bufferutil": {
29 "optional": true
30 },
31 "utf-8-validate": {
32 "optional": true
33 }
34 }
35 }
36 }
37 }
@@ -0,0 +1,37 @@
1{
2 "name": "tile-mmo",
3 "lockfileVersion": 3,
4 "requires": true,
5 "packages": {
6 "": {
7 "name": "tile-mmo",
8 "dependencies": {
9 "ws": "^8.18.3"
10 },
11 "engines": {
12 "node": ">=22.13.0"
13 }
14 },
15 "node_modules/ws": {
16 "version": "8.21.3",
17 "resolved": "https://registry.npmjs.org/ws/-/ws-8.21.3.tgz",
18 "integrity": "sha512-201TZ/kPWxoPr/OKWjquZR1SWKXcvxdH+e1xrx89b3YbmzLMFCLfnaG1HFIgWzJOEWZ7MvpK++odZufgYR50Rw==",
19 "license": "MIT",
20 "engines": {
21 "node": ">=10.0.0"
22 },
23 "peerDependencies": {
24 "bufferutil": "^4.0.1",
25 "utf-8-validate": ">=5.0.2"
26 },
27 "peerDependenciesMeta": {
28 "bufferutil": {
29 "optional": true
30 },
31 "utf-8-validate": {
32 "optional": true
33 }
34 }
35 }
36 }
37}
package.json added +16 −0
@@ -0,0 +1,16 @@
1 {
2 "name": "tile-mmo",
3 "private": true,
4 "type": "module",
5 "engines": {
6 "node": ">=22.13.0"
7 },
8 "scripts": {
9 "start": "node --experimental-sqlite server/src/index.js",
10 "test": "node --experimental-sqlite --test server/tests/**/*.test.js client/tests/**/*.test.js",
11 "build:client": "node client/scripts/build-framework.mjs"
12 },
13 "dependencies": {
14 "ws": "^8.18.3"
15 }
16 }
@@ -0,0 +1,16 @@
1{
2 "name": "tile-mmo",
3 "private": true,
4 "type": "module",
5 "engines": {
6 "node": ">=22.13.0"
7 },
8 "scripts": {
9 "start": "node --experimental-sqlite server/src/index.js",
10 "test": "node --experimental-sqlite --test server/tests/**/*.test.js client/tests/**/*.test.js",
11 "build:client": "node client/scripts/build-framework.mjs"
12 },
13 "dependencies": {
14 "ws": "^8.18.3"
15 }
16}