Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

docs(star-neighbors): add cooperative planet prototype and art directions

yhhb60f1d2d1acd
diff --git a/games/star-neighbors/README.md b/games/star-neighbors/README.md
new file mode 100644
index 000000000..75073511e
--- /dev/null
+++ b/games/star-neighbors/README.md
@@ -0,0 +1,39 @@
+# 星邻计划 / Star Neighbors
+
+项目暂名。多人合作、社交优先的未来卡通星球建造游戏:每个人拥有自己的星球,在持续扩展的共享宇宙里拜访朋友、寻找新家、共同建设。
+
+**当前阶段:策划与美术方向讨论。尚无本项目可运行的游戏、服务器或经过验证的承载人数。**
+
+3D 星球、角色、建筑与环境承载主要游玩体验;2D 星图、界面、物品图标和社交反馈同步设计。原型拟使用 Estella,具体客户端及服务端能力需按验收项逐步验证。
+
+## 策划文件
+
+| 文件 | 内容 |
+| --- | --- |
+| [原型策划案](docs/01-prototype-design.md) | 游戏定位、已确认设定、世界结构、合作循环与原型范围 |
+| [细节玩法草案](docs/02-gameplay.md) | 社交、探索、随机星球、建造、资源、轻风险与首小时流程 |
+| [美术方向讨论稿](docs/03-art-direction.md) | 三种独立风格图、场景/角色/建筑/2D UI 的比较标准 |
+| [联机与持久化设计](docs/04-network-and-persistence.md) | 分区、共享状态、权限、跨区转移、离线结算与容量边界 |
+| [原型里程碑与验收](docs/05-milestones.md) | 交付顺序、验收案例、观察指标和未验证事项 |
+| [决策记录](docs/06-decisions.md) | 已确认、建议采用、等待看图选择的事项 |
+
+## 当前共识
+
+- 多人合作是基础;每位玩家有自己的星球,星球能够被朋友访问和共同建设。
+- 宇宙持续扩展,按星区、星球和地表区块组织;不以固定小队人数作为全宇宙合作人数上限。
+- 社交为主,有一定风险,反馈以正向或中性为主,尽量减少惩罚。
+- 星球尺度随机;玩家可以探索并寻找更大的星球。概率、大小范围和占有规则尚未定稿。
+- 美术须分别查看三种方向的图片后选择,目前没有锁定最终风格。
+
+## 目录
+
+```text
+star-neighbors/
+ README.md
+ docs/ 策划、玩法、美术、联机与验收
+ art/
+ concepts/ 风格候选图,尚非运行时资产
+ prompts/ 三张候选图的完整制作描述
+```
+
+文档中的数值是用于讨论和验证的初始参数;验收目标不代表功能已经实现。项目暂名不代表正式游戏名称。后续代码、场景和引擎工程文件将在对应原型阶段建立。
diff --git a/games/star-neighbors/art/concepts/a-warm-toy-sci-fi.png b/games/star-neighbors/art/concepts/a-warm-toy-sci-fi.png
new file mode 100644
index 000000000..f19f878e7
Binary files /dev/null and b/games/star-neighbors/art/concepts/a-warm-toy-sci-fi.png differ
diff --git a/games/star-neighbors/art/concepts/b-painted-storybook-sci-fi.png b/games/star-neighbors/art/concepts/b-painted-storybook-sci-fi.png
new file mode 100644
index 000000000..e8a5ecad9
Binary files /dev/null and b/games/star-neighbors/art/concepts/b-painted-storybook-sci-fi.png differ
diff --git a/games/star-neighbors/art/concepts/c-cartoon-industrial-sci-fi.png b/games/star-neighbors/art/concepts/c-cartoon-industrial-sci-fi.png
new file mode 100644
index 000000000..9aa7546ca
Binary files /dev/null and b/games/star-neighbors/art/concepts/c-cartoon-industrial-sci-fi.png differ
diff --git a/games/star-neighbors/art/prompts/a-warm-toy-sci-fi.txt b/games/star-neighbors/art/prompts/a-warm-toy-sci-fi.txt
new file mode 100644
index 000000000..70a75206a
--- /dev/null
+++ b/games/star-neighbors/art/prompts/a-warm-toy-sci-fi.txt
@@ -0,0 +1,10 @@
+INITIAL DESCRIPTION
+
+Use case: stylized-concept.
+Asset type: standalone full-frame game art-direction concept for a cooperative social science-fiction planet-building game. This is concept art for discussion, not an implemented screenshot.
+Create one beautiful landscape 16:9 scene at a believable third-person gameplay viewpoint, slightly elevated, with readable foreground characters and usable terrain. Exact shared scene for comparing styles: a compact friendly homestead clearing on a lush alien planet, a rounded modular habitat with a window and small greenhouse on the left, a circular portal on the right, a small solar panel, a raised garden, a cargo crate, and a floating round repair robot. Three friendly adult space settlers in practical suits with visible faces cooperate: one welcomes a visitor stepping through the portal, one tends a planter. Approximately 4.5-head stylized adult proportions, expressive but not infantile. Broad traversable paths and clear construction footprints. Show a slight curved planetary horizon and two distant planets of clearly different sizes in the sky. Peaceful social atmosphere, discovery and gentle adventure, no combat. Habitat is warm ivory, tools and functional accents orange and teal, living vegetation green. Afternoon light, no heavy cinematic fog or obscuring blur. Integrate plausible game-ready shapes; detailed enough for evaluating materials, silhouettes, ground treatment and architecture. No HUD, no text, no labels, no watermarks, no brands. Keep all objects inside the image with comfortable framing. Do not make a collage or a comparison grid.
+Direction A — warm toy-like science fiction. Render as polished stylized 3D with soft physically plausible lighting, rounded chunky silhouettes, clean bevels, matte painted polymer and restrained satin metal, simple broad color blocks and very limited surface noise. Touchable premium construction-toy feeling with convincing scale and joints, not LEGO and not plastic photographic toys. Trees have clustered sculpted canopies; rocks have soft clear planes. Soft shadows and readable warm ivory/orange/teal palette. Cheerful outdoor afternoon, inviting and uncluttered. No black toon outlines, no pixel art, no photorealism.
+
+FINAL TARGETED STYLE ADJUSTMENT
+
+undefined
diff --git a/games/star-neighbors/art/prompts/b-painted-storybook-sci-fi.txt b/games/star-neighbors/art/prompts/b-painted-storybook-sci-fi.txt
new file mode 100644
index 000000000..e95374731
--- /dev/null
+++ b/games/star-neighbors/art/prompts/b-painted-storybook-sci-fi.txt
@@ -0,0 +1,4 @@
+Use case: stylized-concept.
+Asset type: standalone full-frame game art-direction concept for a cooperative social science-fiction planet-building game. This is concept art for discussion, not an implemented screenshot.
+Create one beautiful landscape 16:9 scene at a believable third-person gameplay viewpoint, slightly elevated, with readable foreground characters and usable terrain. Exact shared scene for comparing styles: a compact friendly homestead clearing on a lush alien planet, a rounded modular habitat with a window and small greenhouse on the left, a circular portal on the right, a small solar panel, a raised garden, a cargo crate, and a floating round repair robot. Three friendly adult space settlers in practical suits with visible faces cooperate: one welcomes a visitor stepping through the portal, one tends a planter. Approximately 4.5-head stylized adult proportions, expressive but not infantile. Broad traversable paths and clear construction footprints. Show a slight curved planetary horizon and two distant planets of clearly different sizes in the sky. Peaceful social atmosphere, discovery and gentle adventure, no combat. Habitat is warm ivory, tools and functional accents orange and teal, living vegetation green. Afternoon light, no heavy cinematic fog or obscuring blur. Integrate plausible game-ready shapes; detailed enough for evaluating materials, silhouettes, ground treatment and architecture. No HUD, no text, no labels, no watermarks, no brands. Keep all objects inside the image with comfortable framing. Do not make a collage or a comparison grid.
+Direction B — fresh storybook science fiction. Render the identical cooperative homestead scenario as a playable-looking stylized 3D world with hand-painted gouache-like albedo, softly illustrated texture accents, organic flowing vegetation and painterly skies. Subtle warm/cool brush variation, simplified light/shadow shapes and expressive contours, refined illustrative charm. Keep built structures recognizably functional science fiction and their footprints clear. Soft light, nuanced greens, ivory, muted coral-orange and teal. Characters remain readable stylized adults, no flat poster composition, no ornate fantasy castle, no photorealism.
diff --git a/games/star-neighbors/art/prompts/c-cartoon-industrial-sci-fi.txt b/games/star-neighbors/art/prompts/c-cartoon-industrial-sci-fi.txt
new file mode 100644
index 000000000..73fb2a62d
--- /dev/null
+++ b/games/star-neighbors/art/prompts/c-cartoon-industrial-sci-fi.txt
@@ -0,0 +1,4 @@
+Use case: stylized-concept.
+Asset type: standalone full-frame game art-direction concept for a cooperative social science-fiction planet-building game. This is concept art for discussion, not an implemented screenshot.
+Create one beautiful landscape 16:9 scene at a believable third-person gameplay viewpoint, slightly elevated, with readable foreground characters and usable terrain. Exact shared scene for comparing styles: a compact friendly homestead clearing on a lush alien planet, a rounded modular habitat with a window and small greenhouse on the left, a circular portal on the right, a small solar panel, a raised garden, a cargo crate, and a floating round repair robot. Three friendly adult space settlers in practical suits with visible faces cooperate: one welcomes a visitor stepping through the portal, one tends a planter. Approximately 4.5-head stylized adult proportions, expressive but not infantile. Broad traversable paths and clear construction footprints. Show a slight curved planetary horizon and two distant planets of clearly different sizes in the sky. Peaceful social atmosphere, discovery and gentle adventure, no combat. Habitat is warm ivory, tools and functional accents orange and teal, living vegetation green. Afternoon light, no heavy cinematic fog or obscuring blur. Integrate plausible game-ready shapes; detailed enough for evaluating materials, silhouettes, ground treatment and architecture. No HUD, no text, no labels, no watermarks, no brands. Keep all objects inside the image with comfortable framing. Do not make a collage or a comparison grid.
+Direction C — robust cartoon industrial science fiction. Render the identical cooperative homestead scenario with stylized 3D game rendering, more angular chamfers, visible modular frames, functional hinges, restrained cables, metal panels and clear support structures. Richer mechanical construction detail and grounded utility, but keep generous proportions, friendly adult faces, bright plants and optimistic afternoon light. Ivory painted panels, dark blue-grey structural metal, orange safety accents and teal status lights. Small controlled wear at tool-contact edges only. Bold clear silhouettes and strong readable planes. Not gritty, not militaristic, no guns, no cyberpunk night, no photorealism.
diff --git a/games/star-neighbors/docs/01-prototype-design.md b/games/star-neighbors/docs/01-prototype-design.md
new file mode 100644
index 000000000..cc6a7e80f
--- /dev/null
+++ b/games/star-neighbors/docs/01-prototype-design.md
@@ -0,0 +1,104 @@
+# 星邻计划:多人星球原型策划案
+
+日期:2026-10-22。状态:设计草案;方向已确认,细节参数与美术待定。
+
+## 1. 游戏定位
+
+每个人在未来宇宙中拥有一颗自己的星球。玩家经营家园、发现大小不同的新星球、邀请朋友到访,并通过共同工程把个人家园连接为一片有生活气息的星际社区。
+
+核心感受:**我的家值得回来,朋友的世界值得拜访,下一颗星球值得期待。**
+
+主要体验为社交、建造、探索和轻度环境冒险。3D 场景、角色与空间操作,和 2D 星图、建造 UI、物品及社交反馈共同组成体验。PC 键鼠第三人称是原型建议方案,尚未锁定正式发行平台;Web、小游戏及其他设备需要独立性能和操作验收。
+
+## 2. 已确认的方向
+
+| 主题 | 共识 |
+| --- | --- |
+| 多人 | 从原型开始支持多人合作与持久化,不以房主在线作为世界存在条件 |
+| 家园 | 每个人有自己的星球,可授权朋友访问和共建 |
+| 宇宙 | 持续扩展,采用分区结构;全宇宙合作不局限于固定小队 |
+| 情绪 | 社交优先,正向/中性反馈为主,保留适度风险,尽量少负反馈 |
+| 星球 | 尺度随机,可以出门探索寻找更大的星球 |
+| 美术 | 分别查看温暖玩具科幻、清新绘本科幻、硬朗卡通工业三张图,再决定 |
+
+“无限”是世界生成与扩展方向。实际存储、服务预算和局部实时人数都有边界,必须实测;不承诺无限人同时在同一地点互动。
+
+## 3. 三条设计原则
+
+1. **关系带来内容。** 拜访、礼物、共同建设和异步协作本身有价值,进度无需强迫玩家固定时间组队。
+2. **探索提供选择。** 大星球提供空间,小星球提供紧凑的生活与独特风景;基础生存和基础制作在所有起始星球都可完成。
+3. **失败保留成果。** 风险产生短期变化和有趣故事;默认规则保护家园、物品与长期建设投入。
+
+## 4. 世界结构
+
+| 层级 | 体验 | 持久内容 |
+| --- | --- | --- |
+| 宇宙 | 星图、好友、共同项目 | 身份、地址、所有权、发现与全局项目 |
+| 星区 | 邻里、公共空间站和活动 | 公共工程、区域发现和访问入口 |
+| 星球 | 家园或探索目的地 | 尺度、种子、环境、建筑、生态与授权 |
+| 地表区块 | 实际行走、采集和建造区域 | 地形变化、放置物与资源状态 |
+
+好友可以优先安排在相邻星区,也可以直接访问已知地址。个人星球与公共探索星球的权属在星图上明确显示。星图中的轨道预览是全景表达,不应被当成全表面可运行、球面重力已实现的证据。
+
+## 5. 核心循环
+
+### 个人日常
+
+回家查看变化 → 选择今天想做的事 → 采集/种植/建造/探索 → 获得材料、外观或发现 → 改善家园 → 邀请朋友看成果。
+
+### 社交合作
+
+看到朋友的邀请或项目 → 方便地到访 → 承担一个可独立完成的小任务 → 一起看见建设变化 → 保留共同成果和纪念。
+
+### 宇宙探索
+
+发现信号 → 预览未知星球的信息 → 独自或一起探索 → 了解尺度、风景与特产 → 标记、分享或认领 → 根据喜好安排新家。
+
+三条循环互相提供动机。探索可以为朋友带回种子,建筑可以成为集合地点,公共工程可以开启新的探索入口。
+
+## 6. 多人合作的三种形式
+
+| 形式 | 原型例子 | 要求 |
+| --- | --- | --- |
+| 同时合作 | 两人搭建温室,一人装设备,一人种植物 | 同步状态、明确权限、操作冲突反馈 |
+| 分头协作 | 不同星球提供空间站所需材料 | 持久项目进度、贡献一次生效 |
+| 异步接力 | 主人下线后,朋友完成被授权的花园 | 无房主依赖、权限可撤回、建设记录 |
+
+伙伴定位采用可随时改变的兴趣分工,如园艺、建筑、发现和运输,不设强制职业门槛。基础制作不因缺少某一职业而锁死。
+
+## 7. 星球尺度与认领
+
+星球尺寸随机是正式方向;实际分布、最小/最大规模和稀有度需要结合生成、性能与体验实验确定。
+
+原型以小、中、大三个尺度档验证发现与选择,抽样权重暂按 40% / 40% / 20% 进行实验,**仅为待验证参数**。大小影响可建设空间、地貌分布和旅行距离,不直接赋予所有资源更高产率。
+
+每颗初始星球保证安全落点、基础材料和早期拜访入口。玩家可以免费探索其他候选星球;大星球的发现不依赖付费刷新。相同宇宙地址始终对应同一颗星球,归属由服务器统一确认。
+
+原型建议允许一颗主星和一颗额外认领星,以验证“找到更大星球并逐步搬家”。切换主星不删除旧家,好友仍能找到原地址。正式占有名额、闲置政策和扩展规则待定。
+
+## 8. 正向反馈与风险
+
+优先反馈:朋友到访、共同建成的设施、环境变美、新植物、新外观、新地点、便捷功能和纪念记录。
+
+风险来自可识别的环境变化和自愿参与的远征。例如磁雾让路线不易辨认,同时出现发光植物;玩家可返回、等待,或和朋友继续寻找。活动失败返回安全点,保留携带物、已发现信息和已完成贡献。
+
+默认原型不设饥饿死亡、死亡掉落、经验倒扣、装备永久损坏、离线拆家或强制每日任务。食物用于可选增益和社交分享;离线生产受到原料与仓储限制,满仓后停止且不损坏。
+
+## 9. 第一版范围
+
+建议原型内容预算:一个共享星区、每位测试玩家的初始星球、三个尺度档的候选星球、一座公共空间站、一个温和天气事件、两种基础地表配色、一个角色基础体和一个维修机器人外形。
+
+功能优先:身份与星球绑定、访问、授权共建、资源转移、星球发现/认领、公共项目、重连/重启后状态保留。美术优先:一个可对照的完整样区,加对应 2D 星图、建筑菜单和物品反馈。
+
+宇宙战争、复杂战斗职业、玩家掠夺、完整交通经济、连续宇宙飞行和全地形自由挖掘不进入这次原型。球面地表与平面分区的衔接先做专项实验,再确定实际探索尺度。
+
+## 10. 第一轮成功标准
+
+- 新玩家目标在 10 分钟内理解星球归属,并能拜访另一位玩家;时间是观察目标。
+- 两人能完成一次共同建造,并能说清楚自己贡献了什么。
+- 主人离线时,获授权的朋友仍可进入并继续工作。
+- 玩家能发现不同尺度星球,认领新地点且保留旧家。
+- 失败/返程/重连不会丢失物品或已确认的建设成果。
+- 访谈能回答“我为什么想去朋友那里”和“我下一次想做什么”。
+
+完整验收、实施次序及证据要求见 [里程碑](05-milestones.md)。未通过的项目不得标记为已完成。
diff --git a/games/star-neighbors/docs/02-gameplay.md b/games/star-neighbors/docs/02-gameplay.md
new file mode 100644
index 000000000..35888662f
--- /dev/null
+++ b/games/star-neighbors/docs/02-gameplay.md
@@ -0,0 +1,112 @@
+# 细节玩法草案
+
+日期:2026-10-22。下列规则是供原型讨论和验证的建议;已确认方向以 [决策记录](06-decisions.md) 为准。
+
+## 1. 体验优先级
+
+社交与自我表达 → 建造与共同成果 → 探索新星球 → 轻度资源规划 → 可选择的环境挑战。
+
+角色没有必须不断补充的饥饿/口渴倒计时。暂停游玩、晚到或退出活动都不造成进度倒退。任务列表允许忽略和更换,不用连续签到维持收益。
+
+## 2. 首小时流程目标
+
+| 时间 | 内容 | 获得的反馈 |
+| --- | --- | --- |
+| 0—5 分钟 | 抵达随机尺度的初始星球,选择称呼和基地配色 | 一块可立即使用的家园与起始材料 |
+| 5—10 分钟 | 安放第一件设施,激活访客门,选择拜访或继续独玩 | 可以与朋友见面;无强制组队步骤 |
+| 10—20 分钟 | 两人放置建筑、交换种子、完成一个花园 | 可见的共同成果和一条纪念记录 |
+| 20—35 分钟 | 查看探索信号,访问候选星球 | 发现不同尺度、景色与材料 |
+| 35—45 分钟 | 可选择认领新星球,标记主星或保留以后使用 | 新空间与搬迁选择,旧家仍存在 |
+| 45—60 分钟 | 向公共空间站贡献材料,参与一个建设阶段 | 空间站外观改变、解锁便捷访问功能 |
+
+朋友不在线时,个人建设、探索和公共项目贡献均可继续。时间范围是新手测试目标,不强制计时通关。
+
+## 3. 操作与建造
+
+原型建议键鼠第三人称:WASD 移动,鼠标控制视角,E 交互,B 打开建造,R 旋转预览,左键确认,Esc 取消。操作需可重新绑定;手柄和触屏方案另行验证。
+
+地板、墙体、屋顶等结构采用 1 米基础网格,设备采用标准接口;小装饰允许自由摆放。格长与角色尺寸均待实际样区测试。支持半透明预览、清晰占地、吸附切换和不依赖红绿颜色的有效/无效提示。
+
+放置前显示缺少的材料;扣料与建成由服务器作为一次操作确认。材料可从背包和获授权的附近建造仓领取。被其他玩家同时占用的位置只允许一次成功放置;失败者不扣料。
+
+整件搬移保持设备身份和库存。原型普通部件拆除返还全部建造材料;含物品设备必须先完成清空或整件搬移。移动影响其他玩家正在操作的设施时,给出明确状态反馈。
+
+首轮建议部件:地板、直墙、窗墙、门框、屋顶、坡道、平台、栏杆;设施:访客门、工作台、建造仓、种植箱、太阳能设备、生态装置。家具首先提供座椅、桌子、路灯和花盆,以验证聚会场景。
+
+## 4. 采集、生产与物资
+
+初始资源建议控制在四类:回收金属、植物纤维、能量晶体、种子。三类建材均能在起始区域获得;特产体现外观、用途分支或效率,基础进度不依赖罕见星球。
+
+| 参数 | 初始建议值 | 设计目的 |
+| --- | --- | --- |
+| 起始包 | 金属 30、纤维 20、晶体 10、种子 6 | 允许立即建造和送礼 |
+| 基础采集 | 每次约 2 秒、获得 3 单位 | 短循环、少重复点击;支持按住采集 |
+| 地板 / 直墙 | 每件金属 2 | 早期容易改造空间 |
+| 种植箱 | 金属 4 + 纤维 4 | 首次合作目标容易达成 |
+| 建造仓 | 金属 6 + 纤维 2 | 让资源共享有清晰入口 |
+| 工作台 | 金属 6 + 晶体 2 | 简化初期制造 |
+| 访客门 | 初始赠送,激活免费 | 尽早见到朋友 |
+| 基础植物成熟 | 在线或离线累计 10 分钟 | 回家有小变化,错过不会枯萎 |
+
+这些数值没有经过平衡测试。原型必须先检查初始包能覆盖引导要求,以及无朋友帮助时是否能继续发展。
+
+基础资源在公共采集点按规则补充;玩家花园和仓库需授权才能取用。生成与刷新不能清除建筑占地,也不能在玩家脚下突然出现。初期运输采用赠送、共享仓和项目交付;价格市场与跨服货币暂不进入原型。
+
+## 5. 星球发现与搬家
+
+1. 星图提供可选择的探索信号;玩家看见大致距离、已知环境和发现者信息。
+2. 抵达后扫描,揭示尺度档和可辨识的地貌;未知状态清楚标注。
+3. 可分享地址、收藏风景或请求认领。认领需服务器原子确认,避免两人同时成为唯一所有者。
+4. 原型建议保留两颗持有星:一颗主星、一颗副星;该名额是验证参数。
+5. 切换主星只改变默认返回地址,不删除旧家,也不取消原地址中的授权。
+6. 建筑可以按设施逐步搬运;物品搬运使用持久的迁移清单,失败可恢复且不复制。
+
+大小是探索惊喜的一部分。小星球可拥有漂亮地貌、紧凑动线或特色植物;大星球的额外面积不自动提高所有收益。起始随机结果不得导致缺少基础资源或无法访问朋友。
+
+大星球增加地表区块数量而非一次加载全部表面。具体物理尺寸要在移动速度、载具需求和服务器成本实验后锁定。
+
+## 6. 社交行为
+
+- **拜访:** 星图选择好友或公开目的地,显示访问状态;到访提示可关闭。
+- **共同建设:** 所有者授权指定区域、指定仓库与操作类型;一次性访客许可可过期。
+- **赠送:** 接收者确认后完成转移;取消、背包满或断线时物品仍有明确归属。
+- **表达:** 招手、指向、坐下、赞赏与合影动作优先。文字、图标、音效共同提示,避免只依赖语音沟通。
+- **接力:** 建造请求说明需要的物资和区域,朋友完成后留下一条简短记录。
+- **边界:** 可关闭访问、屏蔽来访者或退出合作;更改权限立即作用于后续操作。
+
+原型不以贡献排名奖励竞争,不把在线时长和付出量绑定到社交地位。共同工程显示阶段与参与记录,允许隐藏公开姓名。
+
+## 7. 公共空间站原型事件
+
+建议第一个工程为“星区会客站”:完成后获得一个共同集合地点和方便访问朋友的星门目录。
+
+三个阶段依次开放:骨架(金属 60)、供能(晶体 30)、花园(纤维 40 + 种子 12)。每阶段有明显外观变化。数量是小规模测试参数,支持后续配置;不因玩家缺席而退度。
+
+贡献可以发生在不同星球的交付端。交付时检查当前剩余需求,只接收需要的数量;并发操作后多余物资保留在原库存。提交必须有唯一操作编号,超时重试不能重复扣除或重复记功。
+
+工程完成后永久开放本星区会客功能,参与者得到纪念外观。晚加入的玩家仍可使用公共设施,并通过后续维护/装饰任务获得同类纪念,避免错过活动即永久失去核心奖励。
+
+## 8. 轻风险的具体规则
+
+原型建议采用一次“磁雾花季”:天气逐渐改变天空和植物发光状态,远处出现稀有花种。参与完全自愿。
+
+| 情况 | 反馈 | 默认结果 |
+| --- | --- | --- |
+| 玩家不参加 | 正常建造和聊天 | 无惩罚 |
+| 找到花种 | 新植物、外观与共同记录 | 正向奖励 |
+| 迷路或选择退出 | 立即使用返程信标 | 回到安全点,保留物品和发现 |
+| 被环境干扰 | 暂时降低设备效率,指示恢复条件 | 可等待或更换路线,无永久损坏 |
+| 队友帮助 | 标记道路、协助开启观察设施 | 更方便完成目标,表达合作 |
+| 活动结束未完成 | 可保存进度或下次再尝试 | 不扣经验、不损坏家园 |
+
+首版不实现战斗、死亡或掉落系统。若未来增加生物威胁,应先验证回避/安抚/协助能否提供足够玩法,再决定伤害机制。
+
+## 9. 离线反馈
+
+离线期间植物成熟后保持可收获状态;机器只在输入和仓储允许的范围内结算。停电或满仓不会消耗维护费,也不会损坏设施。重新上线时显示最多三条有意义变化,如“朋友完成了门廊”“新植物成熟”“空间站花园开放”。
+
+社交消息与建设记录保留来源、时间和地点。系统避免把每次采集变成通知。玩家可选择静默,世界变化本身仍可观察。
+
+## 10. 下一轮需要决定
+
+先看三张美术图选主方向;随后确认人物比例、地表风格与建筑复杂度。玩法优先讨论“第一次拜访要一起做什么”“发现大星球后如何搬家”“公共会客站如何让人愿意停留”。资源精确数值、稀有度、星球持有数量和正式人数目标等待原型验证。
diff --git a/games/star-neighbors/docs/03-art-direction.md b/games/star-neighbors/docs/03-art-direction.md
new file mode 100644
index 000000000..f672abe71
--- /dev/null
+++ b/games/star-neighbors/docs/03-art-direction.md
@@ -0,0 +1,91 @@
+# 美术方向讨论稿
+
+日期:2026-10-22。状态:三种候选均未确认。用户希望每个方向各有一张独立图片,看图后再选择。
+
+## 1. 比较方式
+
+三张图采用相同的场景描述:外星草地上的小型家园、居住舱与温室、访客门、太阳能设备、种植箱、货箱、圆形维修机器人,以及正在到访/欢迎/种植的三名成年拓荒者。镜头为略微俯视的第三人称场景,天空包含大小不同的远处星球。
+
+每张图保持相同的主要物件与活动,重点比较轮廓、材质、地表与工业细节。图像是风格概念稿,不是已实现的游戏截图;独立绘制的画面在布局和角色细节上可能存在差异。最终只能通过相同资产的引擎样区确认实时效果与成本。
+
+## 2. 三个独立候选
+
+### A:温暖玩具科幻
+
+[查看独立图片](../art/concepts/a-warm-toy-sci-fi.png)
+
+![A:温暖玩具科幻](../art/concepts/a-warm-toy-sci-fi.png)
+
+圆润厚实的轮廓、清晰大色块、哑光涂层、少量金属结构。角色和设备有可触摸的体积感,树木以块状树冠组织,岩石保留简洁的面。
+
+适合传达:安全的家园、容易接近的科技、朋友来访的轻松氛围。
+
+重点验证:是否过于幼态;设备用途能否看清;大量重复模块是否单调;地形与建筑能否区分材质。
+
+### B:清新绘本科幻
+
+[查看独立图片](../art/concepts/b-painted-storybook-sci-fi.png)
+
+![B:清新绘本科幻](../art/concepts/b-painted-storybook-sci-fi.png)
+
+保留 3D 体积,采用手绘色彩变化、柔和明暗、自然的植物轮廓与插画感天空。科技设施仍然有明确结构和占地。
+
+适合传达:值得探索的自然、星球之间的景色差异、园艺和环境变化。
+
+重点验证:纹理在远景是否变脏;模块拼接的笔触是否连续;动态光照下是否仍统一;2D 图标能否与场景保持清楚的视觉层次。
+
+### C:硬朗卡通工业
+
+[查看独立图片](../art/concepts/c-cartoon-industrial-sci-fi.png)
+
+![C:硬朗卡通工业](../art/concepts/c-cartoon-industrial-sci-fi.png)
+
+更明确的倒角、支架、面板、连接件和可读机械结构。维持明亮环境与友好角色,以受控的机械细节表达开拓感。
+
+适合传达:建设的功能感、模块组合、合作施工与设备升级。
+
+重点验证:细节是否妨碍采集物辨认;远景是否碎;玩家能否一眼分辨可交互接口;模型制作工作量是否可控。
+
+## 3. 三个方向共用的视觉目标
+
+- 主情绪为温暖、可亲近和好奇;危险通过局部事件表现。
+- 角色、可采集物、道路和放置空间首先可辨认,氛围效果不能淹没操作信息。
+- 每位玩家可选基地配色;颜色变化不改变功能。功能状态还需图标、动作或文字。
+- 天空和轨道视角表达星球大小差异;地面保持容易判断距离与行走方向的参照。
+- 3D 环境与 2D UI 同步验收:星图、建造菜单、好友状态、物品图标、权限提示不延后到美术定稿后补做。
+
+## 4. 待定的角色与环境参数
+
+| 项目 | 初始建议 | 尚需验证 |
+| --- | --- | --- |
+| 人物 | 约 4.5 头身的成年拓荒者,面部可见、手套和背包略夸张 | 看图后确认是否调整为更自然比例 |
+| 服装 | 基础工作服 + 可换色外层 + 可辨认工具 | 动作范围、背包遮挡与多人识别 |
+| 建筑 | 统一连接尺寸,屋体、窗、门、温室组合 | 网格吸附、内外尺度与装饰自由度 |
+| 植物 | 形状与成熟变化清楚,少量发光种类 | 夜间辨识与大量种植的性能 |
+| 地表 | 大块材质分区,草/土/岩石边界自然 | 跨区块连续、坡面和建筑接地 |
+| 光照 | 昼夜保留温度差,夜晚仍可辨认路径 | 低配置画面、阴影成本与灯光数量 |
+| 配色 | 奶白、橙、青绿为比较基准,正式配色待选择 | 三种风格在同等色彩下的表现 |
+
+## 5. 2D UI 与交互反馈
+
+星图分清“我的家”“好友家”“公共目的地”“未知信号”,用图形和标签共同表达;星球规模未知时不伪装为精确数据。访问按钮显示权限、在线状态及目的地是否可进入。
+
+建造菜单优先显示缩略图、占地、材料和功能。放置预览用轮廓和符号区分有效/无效状态,并明确失败原因。多人施工显示位置已被占用,而不是无提示撤销玩家操作。
+
+社交信息采用小幅动画、表情和短提示;完成共同工程时允许大家停留合影。控制弹窗频率,不把画面变成不断滚动的奖励列表。
+
+## 6. 风格选择的评审方式
+
+先选择最想长期居住的场景,再比较建筑可读性和角色亲近感。一个方向作为主体,其余方向仅吸收明确元素,避免同时混用不同材质语言。
+
+看图后的下一步是一个完整样区:基础角色、机器人、居住舱、访客门、种植箱、树、岩石、地面,以及对应 2D 建造卡片/物品图标/好友到访提示。先确认同屏效果,再扩展资产数量。
+
+完成标准:同场景日/夜可读;角色动作尺度合理;建筑能在网格中拼接;UI 不遮挡放置位置;局部多人和目标设备性能通过相应检查。概念图好看不能替代这些验收。
+
+## 7. 候选图完整描述
+
+- [A 图完整描述](../art/prompts/a-warm-toy-sci-fi.txt)
+- [B 图完整描述](../art/prompts/b-painted-storybook-sci-fi.txt)
+- [C 图完整描述](../art/prompts/c-cartoon-industrial-sci-fi.txt)
+
+最终风格确认后更新 [决策记录](06-decisions.md),保留未选方向作为讨论历史,不将其混入正式资产。
diff --git a/games/star-neighbors/docs/04-network-and-persistence.md b/games/star-neighbors/docs/04-network-and-persistence.md
new file mode 100644
index 000000000..6141c66ac
--- /dev/null
+++ b/games/star-neighbors/docs/04-network-and-persistence.md
@@ -0,0 +1,97 @@
+# 联机与持久化设计
+
+日期:2026-10-22。状态:拟议架构,尚未实现或完成承载验证。本文描述游戏需要满足的行为,不代表 Estella 已提供完整的账号、世界服务或分布式运行平台。
+
+## 1. 目标与边界
+
+共享身份、唯一星球地址、可持久化的家园、跨星球协作、主人离线后可访问,以及按活跃区域扩展服务。
+
+全宇宙的参与者不受固定小队人数限制;每个实时区域仍有 CPU、带宽、存储及延迟预算。总容量随部署资源变化,局部容量必须压测。测试人数只是证据,不是“无限人数”证明。
+
+## 2. 三种不同的分区
+
+| 概念 | 作用 | 不能据此推断 |
+| --- | --- | --- |
+| 客户端地图区块 | 控制几何、纹理和实体加载/释放 | 已经实现服务器水平扩展 |
+| 服务端模拟区域 | 为活跃实体分配权威模拟与同步 | 同一热点可以无限扩容 |
+| 数据分区 | 按星球/区块组织保存与查询 | 每个区块都需要一个独立进程 |
+
+原型可先用一个专用服务进程承载多个逻辑区域,验证接口和一致性后再扩为多工作进程。区域身份和全局实体身份从第一版分离,客户端不依赖具体服务器地址作为世界身份。
+
+## 3. 服务职责建议
+
+```text
+游戏客户端
+ ├─ 会话与访问入口:身份、连接、目的地路由
+ ├─ 星图目录:地址、发现、归属、访问规则
+ ├─ 区域模拟:移动、交互、建造、环境事件
+ └─ 持久状态:库存、建筑、项目贡献、转移记录
+```
+
+初期可以在同一服务内实现这些职责,通过清晰数据边界避免过早拆成大量微服务。每个实体在任何时刻只有一个权威写入者;多个客户端同时发请求时,服务器确定结果与顺序。
+
+## 4. 需要保存的数据
+
+| 对象 | 至少包含 |
+| --- | --- |
+| 玩家 | playerId、外观、背包版本、当前位置、主星地址、授权关系 |
+| 星球 | planetId、生成种子、生成器版本、尺度档、环境参数、归属版本 |
+| 区块 | 坐标/球面面标识、基础生成信息、修改版本、建筑与资源变化 |
+| 建筑 | entityId、部件类型、位置/朝向、所有权、库存引用、状态版本 |
+| 操作 | operationId、发起者、状态、结果;用于安全重试 |
+| 跨区转移 | transferId、来源、目的地、物品/实体清单、确认状态 |
+| 公共工程 | projectId、阶段、材料余额、贡献操作与完成状态 |
+
+基础地貌采用种子与生成器版本重建,保存玩家修改。已发现星球更新生成器时不得静默改变地貌或吞掉建筑;需要明确迁移策略或保留旧版本支持。持久存储仍随玩家改造和探索量增长,不能按“仅存一个种子”估算整体成本。
+
+## 5. 跨区与跨星球转移
+
+原型优先通过星门切换场景,过程显示明确状态。物理上无缝穿越两个模拟区不是首版完成标准。
+
+转移先确认目的地容量和权限,再建立持久转移记录并暂时锁定迁移物品;目标接收成功后,来源完成退出。失败或超时按记录恢复到确定的一侧,重复请求返回同一结果。物品不能在两边都可使用,也不能两边都消失。
+
+源与目标同时崩溃、玩家重连、确认消息丢失、重复请求都是必须覆盖的验收场景。具体存储事务方案在实现阶段确定,不能仅靠客户端请求顺序保证一致性。
+
+## 6. 同步与负载
+
+按距离、可见区域和交互关系订阅动态对象;星图、远处工程进度和离线通知使用低频状态更新。客户端移动可做预测与插值,物品、归属、贡献和建筑位置以服务端确认结果为准。
+
+草木装饰、远景灯光、部分粒子可客户端表现;可采物、碰撞、交互设施和库存有权威状态。建筑数量、活跃机器和同步实体数应与玩家人数一起记录,避免只用空场景容量宣传性能。
+
+## 7. 无人区域与离线结算
+
+无人区域释放高频模拟,保留最后结算时间、输入原料、生产状态和仓储容量。恢复时计算受资源与容量约束的产量;满仓后停止,不产生物资无限累积。
+
+结算依据服务端时间,客户端时间变化不产生收益。多次唤醒或重试不得重复结算。朋友进入会唤醒被授权的星球,不要求主人上线。
+
+## 8. 权限与合作
+
+权限按“星球/区域/设施 × 操作”表达:访问、放置、移动、拆除、取出、存入和管理可分别授权。角色只是权限集合的快捷方式,服务端每次执行关键操作时检查当前权限。
+
+撤销权限后,尚未确认的新操作应被拒绝;已确认成果仍保留。库存和公共项目的变更保留可追踪记录。断线不自动把协作者提升为所有者。
+
+## 9. 热点接待
+
+热门工程可分为多个实际施工区域,进度统一汇总;独立探索活动可使用明确标识的独立场景。私人家园保持唯一建设状态,不通过创建多份可独立修改的同名星球接待超量玩家。
+
+实时区域满载时显示等待/改去相邻会客地点的选择,并尽量保持同行者一起进入。相邻分区不能解决所有人聚集在同一个交互点的计算瓶颈。人数限制、机器数限制和容量提示必须依据实测制定。
+
+## 10. 第一轮工程验收
+
+- 两名玩家同时访问同一建筑,看到相同位置、状态和库存。
+- 同一材料被同时请求用于建造与赠送时,只允许合法的一次消费。
+- 重复提交项目贡献不重复扣除物品、不重复增加进度。
+- 跨星球过程中断线,重连后人和物品归属唯一。
+- 无人区域结算不重复、满仓不超产、资源不足不负数。
+- 主人离线,协作者可以按授权访问和建造;撤权后关键操作被拒绝。
+- 重启服务后归属、建筑、发现与项目状态恢复。
+- 种子与生成器版本重现既有基础地貌,保存的修改正确覆盖。
+
+容量报告必须注明硬件、网络、版本、区域数量、活跃玩家、每区实体/建筑/机器、延迟分位数、带宽、内存和故障率。具体阈值在技术样区确定后记录。
+
+## 11. 参考资料
+
+- [Epic:Networking Overview](https://dev.epicgames.com/documentation/unreal-engine/networking-overview-for-unreal-engine):专用服务器与网络相关性概念的参考,不代表本项目必须选择该引擎。
+- [EVE Online:Fleet Fight Notification Tool](https://www.eveonline.com/fr/news/view/fleet-fight-notification-tool):玩家集中在单个区域时产生服务器压力的实例。
+
+以上资料用于解释设计取舍,不作为本项目功能已实现或性能达标的证据。
diff --git a/games/star-neighbors/docs/05-milestones.md b/games/star-neighbors/docs/05-milestones.md
new file mode 100644
index 000000000..925a709f8
--- /dev/null
+++ b/games/star-neighbors/docs/05-milestones.md
@@ -0,0 +1,68 @@
+# 原型里程碑与验收
+
+日期:2026-10-22。当前只有策划和美术方向候选;以下游戏功能均未验收。按依赖推进,不预设发布日期。
+
+## 1. 交付次序
+
+| 阶段 | 交付内容 | 通过条件 |
+| --- | --- | --- |
+| M0:方向确定 | 三张独立风格图、玩法草案、决策记录 | 用户选定主风格;关键规则明确标为确认或待测 |
+| M1:空间与操作样区 | 可行走的 3D 地表、角色、基础建筑预览;2D 建造菜单与星图雏形 | 网格、尺度、碰撞、镜头、地表区块加载可验证;形成球面方案结论 |
+| M2:两颗家园互访 | 两个独立玩家、两颗持久星球、传送与授权共建 | 主人退出后访客仍可合法访问;重连和重启保留状态 |
+| M3:探索与新家 | 三个尺度档、发现信息、认领与主星切换 | 起始资源有保障;认领不冲突;切换主星保留旧家 |
+| M4:共同工程与轻事件 | 会客站材料交付、阶段变化、磁雾花季与安全返程 | 分地/异步参与有效;重试不重复消费;退出保留成果 |
+| M5:体验与承载 | 小规模真实玩家观察、模拟负载、目标设备与 CI 验收 | 有可复现报告;负载和设备范围明确;主要体验问题被处理 |
+
+M1 的空间实验与 M2 的服务端状态设计可在接口约定后交错推进;不应先实现长篇单机内容再补持久化多人。
+
+## 2. 核心验收案例
+
+| 编号 | 场景 | 应有结果 |
+| --- | --- | --- |
+| AC-01 | 玩家首次进入 | 有唯一身份与初始星球,安全落点和基础资源可达 |
+| AC-02 | 两位朋友互访 | 地址一致,看到同一份建筑和生态状态 |
+| AC-03 | 同时占用一个放置位置 | 只有一次建造成功,失败方不扣料 |
+| AC-04 | 主人离线,协作者继续建造 | 合法工作成功,成果能被之后上线的主人看到 |
+| AC-05 | 建造/取物权限被撤销 | 新请求按最新权限拒绝,已确认成果不被无故撤回 |
+| AC-06 | 传送时断线并重连 | 玩家位置可恢复,库存不丢失不复制 |
+| AC-07 | 两人同时认领同一星球 | 归属唯一,另一方获得可理解结果 |
+| AC-08 | 认领大星球并切换主星 | 新地址生效,旧家及其建筑保留 |
+| AC-09 | 离线生产、满仓、重复唤醒 | 正确结算一次,容量与输入约束有效 |
+| AC-10 | 重复/并发交付项目材料 | 消费及进度只生效一次,超出需求部分留在原库存 |
+| AC-11 | 忽略或中途退出环境事件 | 不丢物品、经验或家园,无强制后续任务 |
+| AC-12 | 服务重启 | 星球尺度/种子/归属、建筑、物品和项目状态恢复 |
+| AC-13 | 跨地表区块行走与建造 | 无裂缝、重复交互或双重实体所有权 |
+| AC-14 | 区域达到测试容量 | 明确等待/替代目的地提示,无静默吞请求 |
+
+## 3. 体验观察
+
+首轮建议邀请少量玩家分组观察,人数仅用于试验;每轮记录设备、网络、版本与任务。测量第一次放置、第一次见到朋友、第一次共同成果和第一次发现新星球的时间,以及求助次数。
+
+重点访谈:玩家是否有明确归属感;是否愿意主动拜访;帮朋友是否像额外负担;随机拿到小星球是否觉得吃亏;返程是否让人安心;游戏结束时是否自然产生下次想做的事。
+
+这些观察只用于发现问题,小样本不能推断长期留存率。社交质量不能仅用在线时长或资源产量评价。
+
+## 4. 负载与故障试验
+
+先验证少量真实连接,再增加模拟玩家和区域数。分别测试分散访问、集中会客、密集建设、机器生产、频繁传送和断线重试。
+
+每次报告环境、活跃区域、实体/建筑/机器数量、状态更新频率、帧/模拟耗时、P50/P95/P99 延迟、带宽、内存、错误率和保存延迟。单机单进程结果不推导为跨机水平扩展证据。
+
+增加机器/分区后,要重新验证权威归属、跨区一致性和存储热点。容量目标在样区测量后决定,未验证前不对外承诺固定最大人数。
+
+## 5. 验证约束
+
+遵循仓库要求:本地只使用真正无界面的浏览器或 CLI 检查,不启动编辑器、Electron 窗口或其他可见应用进行验证。编辑器验收放在 CI;Web、小游戏和真实设备分别记录证据。
+
+此次策划交付只检查文件、链接、图片存在性、编码和 Git 差异;不运行与文档无关的引擎全量测试。风格候选的视觉审阅不等于引擎渲染验收。
+
+2026-10-22 文档交付检查:7 份 Markdown 与 3 份完整图像描述通过 UTF-8 和文本格式检查;21 个本地文件引用全部有效;3 张独立 PNG 可解码并已进行视觉审阅。A 图为简化轮廓与材质后的候选,B/C 保留各自绘本与工业方向。尚未开展游戏功能、编辑器、设备或承载验收。
+
+## 6. 暂未解决的问题
+
+- 球面地表的移动/重力/分块与大型星球尺度如何共同实现。
+- 随机尺度分布、正式持有数量、扩展政策和长期存储成本。
+- 最终美术风格、角色比例、资产规格及目标硬件。
+- 一处会客区域的实际人数、建筑与机器预算。
+- 正式账号、部署地区、跨地区延迟与运营方案。
+- 生态变化的复杂度,以及如何避免生产和资源收集变成社交负担。
diff --git a/games/star-neighbors/docs/06-decisions.md b/games/star-neighbors/docs/06-decisions.md
new file mode 100644
index 000000000..2601cccc5
--- /dev/null
+++ b/games/star-neighbors/docs/06-decisions.md
@@ -0,0 +1,45 @@
+# 决策记录
+
+日期:2026-10-22。本文件区分用户已确认方向、设计建议和待验证参数,防止草案被误认为实现结果。
+
+## 已确认
+
+| ID | 决策 | 依据 |
+| --- | --- | --- |
+| D-001 | 未来卡通题材,包含建造、探索与一定生存风险 | 初始游戏构想与后续方向确认 |
+| D-002 | 多人合作、每个人拥有自己的星球、宇宙分区并持续扩展 | 用户提出无限宇宙与个人星球 |
+| D-003 | 建立独立项目文件夹并整理原型策划案,开始美术与细节玩法讨论 | 本轮交付要求 |
+| D-004 | 社交为主,正向/中性反馈优先,尽可能少负反馈 | 本轮用户回答;取代早先中等生存压力的建议 |
+| D-005 | 星球尺度随机,玩家可以探索寻找更大星球 | 本轮用户回答;不锁定所有人为同一种小星球 |
+| D-006 | 三种美术风格各出一张独立图片,再由用户选择 | 本轮用户回答;不使用三图拼板代替 |
+
+## 当前设计建议,尚未全部确认
+
+| ID | 建议 | 需要确认或验证 |
+| --- | --- | --- |
+| P-001 | 项目暂名“星邻计划 / Star Neighbors” | 正式名称 |
+| P-002 | PC 键鼠、第三人称 3D 场景与配套 2D UI | 平台、镜头、操作与目标硬件 |
+| P-003 | 默认无饥饿死亡、死亡掉落、离线家园损坏;食物提供可选增益 | 是否符合期望的轻风险体验 |
+| P-004 | 初始星球免费激活访客门,尽早见到朋友 | 新手节奏与邀请流程 |
+| P-005 | 原型一颗主星 + 一颗副星,搬家保留旧家 | 持有规则和存储成本 |
+| P-006 | 公共工程为星区会客站 | 第一轮最有吸引力的合作目标 |
+| P-007 | 环境事件“磁雾花季”,可随时安全返程 | 风险、趣味与反馈的平衡 |
+| P-008 | 原型采用专用服务承载多个逻辑区域,逐步验证扩展 | 实际服务架构与容量 |
+
+## 待看图决定
+
+| 方向 | 当前状态 | 图片 |
+| --- | --- | --- |
+| A:温暖玩具科幻 | 待用户选择 | [A 图](../art/concepts/a-warm-toy-sci-fi.png) |
+| B:清新绘本科幻 | 待用户选择 | [B 图](../art/concepts/b-painted-storybook-sci-fi.png) |
+| C:硬朗卡通工业 | 待用户选择 | [C 图](../art/concepts/c-cartoon-industrial-sci-fi.png) |
+
+确认风格后依次讨论人物比例、建筑结构、地表材质、2D UI 和昼夜照明。用户可以指出某张图的具体元素,不必只在风格名称中选择。
+
+## 待测参数
+
+尺度抽样权重、地表区块大小、可建设范围、采集产量、建筑配方、生产时间、公共工程需求、同区实时人数和服务器预算均未定稿。文档中的示例数字不构成上线承诺。
+
+## 变更原则
+
+已确认方向发生变化时记录日期、变化内容及影响文件。设计提案通过讨论或试验后才转为确认。功能完成状态只根据实际验收证据更新;概念图、策划文件或已提交代码都不单独证明游戏功能完成。