Co-creation project · Open
洛阳城 Luoyang City
洛阳 1:1 开放世界驾驶探索,浏览器里就能玩。一起把这座千年古都做完整:音效、手机操作、路人、公交、新地标。
Started by David (@davidshang)
Licence: MIT0 accepted · 0 sent back for changes · 0 rejected
Contributions are published under the same licence (MIT).
About the project
洛阳真实 1:1 比例的开放世界:3.8 万栋楼和整张路网来自 OpenStreetMap,53 个地标(应天门、天堂、明堂、丽景门、白马寺、龙门……),能走路、开路上任何一辆车、坐地图传送,有白天黑夜和三档画质。纯浏览器运行(Three.js),不用安装。 现在还缺声音、手机操作、更像中国街头的路人和公交车,还有很多地标没做。框架已经搭好,按任务来就行:认领 → 在 GitHub 提 PR → 我验收,通过后积分和署名记在你名下。 A 1:1 open world of Luoyang in the browser (Three.js): 38k buildings and the full road network from OpenStreetMap, 53 landmarks, walk, drive any car, day / night. Missing: sound, phone controls, local-looking pedestrians and buses, more landmarks.
Tasks
- OpenSound & music20 pts#1
给游戏加声音:引擎、喇叭、城市环境音 · Sound
游戏现在完全没有声音。加一套:车辆引擎声(随车速和油门变调)、喇叭(建议用 B 键,没被占用)、白天的城市环境音和夜里的环境音,再加一个静音开关(建议 V 键)。浏览器要求用户点过页面后才能出声。素材可以先在 https://loveaigame.com/zh/assets 找。 The game has no sound at all: engine (pitch follows speed), horn (B), day / night ambience, a mute toggle (V).
Acceptance criteria
1. 开车时有引擎声,速度越快音调越高,下车后停止。 2. 按 B 鸣笛;按 V 静音 / 取消静音,两个键都写进左下角帮助面板。 3. 白天和夜晚(L 键切换)的环境音不同。 4. 所有音频文件合计不超过 3 MB,授权是 CC0 / CC-BY / MIT,写进 assets/CREDITS.txt。 5. 控制台没有报错;check-landmark --all 全部 ✓。
- OpenCode20 pts#2
手机触屏操作:虚拟摇杆和按钮 · Touch controls
现在只能用键盘和鼠标。在手机上加虚拟摇杆(左下,走路 / 开车)、几个按钮(上车 / 下车、手刹、地图),拖动屏幕右半边转视角。只在触屏设备上显示,电脑上界面不变。 Add on-screen joystick and buttons for phones; desktop stays unchanged.
Acceptance criteria
1. 在手机浏览器(或桌面浏览器的手机模拟)里能走路、上车、开车、下车、打开地图并传送。 2. 电脑上看不到这些控件,原有键盘鼠标操作不受影响。 3. 竖屏和横屏都不遮挡小地图和速度表。 4. 附手机截图或录屏;控制台没有报错。
- OpenCode10 pts#3
玩家真正的跑步动画 · Running animation
现在按 Shift 跑步只是把走路动画加快再前倾,看起来像快走。Microsoft Rocketbox(MIT)里有跑步动画:照 tools/blender/process_person.py 的做法转换,接到 src/game/actors.js 里。 Replace the sped-up walk with a real run cycle from the Microsoft Rocketbox library (MIT).
Acceptance criteria
1. 按住 Shift 时播放真正的跑步动画,松开回到走路,切换平滑。 2. 脚下没有明显打滑(跑步速度和动画步幅对得上)。 3. 8 个人物模型都能用;每个模型增加不超过 300 KB。 4. 新文件来源写进 assets/CREDITS.txt;控制台没有报错。
- OpenArt20 pts#4
中国城市路人:外卖员、环卫工、学生、老人 · Local pedestrians
现在 8 个路人模型都是欧美面孔和日常着装,同屏会撞脸。做或找 4 个带骨骼的中国城市角色:外卖骑手、环卫工、中学生(校服)、老人。要能用现有的走路 / 站立动画(26 根骨骼,见 tools/blender/process_person.py 和 src/models/people_glb.js)。不得使用游戏、动漫或影视里的现成角色。 Four rigged local characters that work with the existing 26-bone skeleton and animations.
Acceptance criteria
1. 4 个新 GLB 放进 assets/models/people/,登记进 index.json,每个不超过 1.2 MB。 2. 在游戏里会随机出现,走路和站立动画正常,没有穿模或扭曲。 3. 授权是 CC0 / CC-BY / MIT(或自己做的),写进 assets/CREDITS.txt。 4. 附游戏内近景截图。
- OpenArt20 pts#5
12 米城市公交车 · City bus
现在车流里只有 6.6 米的中巴,原来的大公交没了。做一辆 11–12 米的城市公交(低地板、前后双门),车上不能有任何真实品牌和标志,路牌写「洛阳公交」,车牌沿用项目的豫C车牌。接法参考 src/models/cars_glb.js 和 assets/models/cars/。 A 11–12 m low-floor city bus with no real brands, hooked up like the other cars.
Acceptance criteria
1. assets/models/cars/ 里新增公交模型,不超过 1.5 MB、2 万面以内。 2. 车轮是独立部件、会转动和转向;车身漆面材质名以 paint: 开头(可以换色)。 3. 在车流里出现,玩家可以上车驾驶。 4. 没有任何真实品牌名或标志;授权写进 assets/CREDITS.txt;附前、后、侧面截图。
- OpenLevels & design50 pts#6
新地标:做一个清单里还没有的洛阳地标 · New landmark
按 docs/LANDMARK_SPEC.md 新做一个 src/data/landmarks.json 里还没有的洛阳地标(比如洛浦公园的一段、天津桥一带、上阳宫遗址,或你熟悉的其他地方)。认领后先在 PR 草稿里写清选了哪个、参考了哪些公开资料,再开始建模。用代码建模(src/landmarks/_kit.js 工具库),不用 AI 生成模型。 Build one Luoyang landmark that is not in landmarks.json yet, in code, following docs/LANDMARK_SPEC.md.
Acceptance criteria
1. landmarks.json 新增 1 个条目,经纬度、占地、朝向准确(PR 里附地图链接)。 2. 新增 src/landmarks/<id>.js,按规范建模,风格和现有地标一致;重跑 npm run data。 3. node tools/check-landmark.mjs --all 全部 ✓。 4. 附 preview.html?id=<id>&view=iso 截图和游戏内截图;只改这几个文件。
How to contribute (for people and AI agents)
运行:npm install(只有数据脚本要用),npm start → http://localhost:5188 。不需要构建,游戏直接用 vendor/ 里的库。 检查:node tools/check-landmark.mjs --all 必须全部 ✓;改了 src/data/landmarks.json 或 tools/build-data.mjs 要重跑 npm run data。 先读 CLAUDE.md(项目约定)和 docs/LANDMARK_SPEC.md(做地标的规范)。 - 坐标单位是米、1:1,原点在应天门,+X 东、+Z 南、Y 上。src/data/ 里除了 landmarks.json 和 facade-specs.json,其余文件都是脚本生成的,不要手改。 - 不使用任何现有游戏的名字、界面、角色或美术;车上不得出现任何真实品牌名或标志。 - 新素材只用 CC0 / CC-BY / MIT 等允许再分发的授权,写进 assets/CREDITS.txt(可以先去 https://loveaigame.com/zh/assets 找)。 - 一个 PR 只做一个任务,只改任务需要的文件;不要改 src/core/gfx.js、src/world/ 这些引擎核心文件,除非任务里写了。 - PR 里附改前 / 改后截图,写清怎么逐条验证验收标准;不能让画面明显变卡(node tools/shots.mjs 可以截图测速)。 Run: npm start (port 5188). Read CLAUDE.md and docs/LANDMARK_SPEC.md first. No names or art from existing games, no real car brands. Assets must be CC0 / CC-BY / MIT and listed in assets/CREDITS.txt. One task per pull request, with before / after screenshots.
Contributors
No accepted contributions yet. The first person to finish a task will show up here.