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.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
art: add cyberpunk survival modular ship concept kit
yhhb1e223d75b9b
diff --git a/docs/assets/space-exploration/cyber-survival-kit-v3/01-module-atlas.png b/docs/assets/space-exploration/cyber-survival-kit-v3/01-module-atlas.pngnew file mode 100644index 000000000..f497cf161Binary files /dev/null and b/docs/assets/space-exploration/cyber-survival-kit-v3/01-module-atlas.png differdiff --git a/docs/assets/space-exploration/cyber-survival-kit-v3/02-assembly-comparison.png b/docs/assets/space-exploration/cyber-survival-kit-v3/02-assembly-comparison.pngnew file mode 100644index 000000000..0d7f8c6ebBinary files /dev/null and b/docs/assets/space-exploration/cyber-survival-kit-v3/02-assembly-comparison.png differdiff --git a/docs/assets/space-exploration/cyber-survival-kit-v3/03-gameplay-atmosphere.png b/docs/assets/space-exploration/cyber-survival-kit-v3/03-gameplay-atmosphere.pngnew file mode 100644index 000000000..42b5133b6Binary files /dev/null and b/docs/assets/space-exploration/cyber-survival-kit-v3/03-gameplay-atmosphere.png differdiff --git a/docs/assets/space-exploration/cyber-survival-kit-v3/README.md b/docs/assets/space-exploration/cyber-survival-kit-v3/README.mdnew file mode 100644index 000000000..29cb6236c--- /dev/null+++ b/docs/assets/space-exploration/cyber-survival-kit-v3/README.md@@ -0,0 +1,53 @@+# 赛博太空生存模块参考包 v3++用于太空探索建造手游的 3D 模块造型,以及 2D 建造界面与氛围设计。以本轮三组用户提示词为依据,统一为深枪灰硬表面、青色灯带、磨损工业面板和黄黑方形接口。++## 交付内容++| 文件 | 用途 |+| --- | --- |+| [01-module-atlas.png](01-module-atlas.png) | 12 类模块的正面、侧面、顶面概念参考;浅灰背景 |+| [02-assembly-comparison.png](02-assembly-comparison.png) | 侦察舰、货船、战斗空间站的并列拼装示例 |+| [03-gameplay-atmosphere.png](03-gameplay-atmosphere.png) | 废弃站附近的建造场景,含全息网格与待放置模块 |+| [prompts.json](prompts.json) | 用户原始要求、完整生成与修改提示词、参考图映射 |+| [manifest.json](manifest.json) | 实际像素尺寸、文件散列与验证状态 |++原图使用工具实际返回的分辨率保存,没有插值放大为 8K。准确尺寸见 manifest.json。氛围图是美术目标,不是运行中的引擎截图。++## 共同造型规则++- 深枪灰为大面积底色;青色表现动力与反应堆,橙红表现武器,暖白表现驾驶与生活区。+- 方形连接面使用黄黑框,保留清楚的模块接缝和未占用接口。+- 船体、货舱和设备以大形体为主,面板磨损作为表面细节,避免用密集小零件堆叠轮廓。+- 玩家共用模块和接口规则;细长主干、宽货舱架、分支平台和不对称布置由玩家选择。+- 6 / 20 / 50+ 是拼装示例的规模设计目标,尚无对应的装配清单或逐件计数验证,不能作为已验证的模型数量使用。++## 模块目录++COCKPIT、HULL 2x2、HULL 2x4、CORRIDOR、CARGO BAY、ENGINE L、ENGINE S、THRUSTER、TURRET、REACTOR、SOLAR PANEL、DOCKING PORT。++同型号部件应复用同一份网格;引擎喷口形状与结构连接面的方形标准分别处理。生活舱、货舱及方形接口是否允许人员通行,需要单独标记。++## 尺寸与内部空间++本轮将 2x2 / 2x4 解释为网格格数:在 2m 吸附网格下,规划占地分别为 4m × 4m 和 4m × 8m。该解释用于后续白模的尺寸约定,不代表已从图片测得一致的尺寸。++2m 网格约束放置步长,不等于每个舱室仅高 2m,也不等于人员通道的净空。高度、通道净宽净高、地板与顶部设备空间、门框、墙体厚度仍须在白模中确定,再统一到所有模块。++图集中部分视图带轻微俯视或透视;视角之间的装饰面板、开口与接口数量也不是经过同一 3D 网格投影验证的。应先锁定一份尺寸正确的基础舱段,再从统一网格输出生产用正交参考。++外壳、内部通道、门、连接框和封口盖应分别管理。内部空间由规则化白模建立,不能依靠整船图片重建来自动推断。发动机、反应堆等设备可以是封闭模块,不要求每个接口都连通人员通道。++## 后续建模入口++1. 先建立基础舱段和一个通道件的尺寸白模,确定接口中心、朝向、原点及人员净空。+2. 按单件准备无遮挡、无标签的独立参考;不要把整张图集或三艘不同船当成一个物体输入 Tripo。+3. 在 Tripo 使用用户指定的“智能网格”,先验证一个外壳模块;当前包尚未进行这一新风格的建模。+4. 校准输出网格的真实单位、接合平面、壁厚及开口,再制作其他兼容模块。拼装检查应包括转角、纵向串联、并排货舱和不对称布局。+5. 检查拓扑、法线、UV、碰撞、材质、遮挡与细节层级,最终画质和性能以实际目标手机验收。++先前另一风格的试件不属于本包,也不应混入本包的同一物体多视角输入。++## 本轮验收范围++已检查三张图片的主题、主要配色、模块标签与构图,并验证文件可解码。当前成果为概念参考;未完成精确正交校准、3D 接口配合、内部空间、拓扑、碰撞或设备性能验收。diff --git a/docs/assets/space-exploration/cyber-survival-kit-v3/manifest.json b/docs/assets/space-exploration/cyber-survival-kit-v3/manifest.jsonnew file mode 100644index 000000000..86d3c514e--- /dev/null+++ b/docs/assets/space-exploration/cyber-survival-kit-v3/manifest.json@@ -0,0 +1,65 @@+{+ "version": 3,+ "title": "Cyberpunk space survival modular kit",+ "status": "concept-reference",+ "grid": {+ "snap_meters": 2,+ "hull_2x2_footprint_meters": [+ 4,+ 4+ ],+ "hull_2x4_footprint_meters": [+ 4,+ 8+ ],+ "dimensions_status": "proposed-not-geometry-verified"+ },+ "module_categories": [+ "cockpit",+ "hull_2x2",+ "hull_2x4",+ "corridor",+ "cargo_bay",+ "engine_large",+ "engine_small",+ "thruster",+ "turret",+ "reactor",+ "solar_panel",+ "docking_port"+ ],+ "images": [+ {+ "file": "01-module-atlas.png",+ "width": 1536,+ "height": 1024,+ "bytes": 2077205,+ "sha256": "16bdb7d1d421a86435f4c69ac0f997013a217df92399d3f86a6ae3c775f09b81"+ },+ {+ "file": "02-assembly-comparison.png",+ "width": 1774,+ "height": 887,+ "bytes": 2055677,+ "sha256": "d67d364dcf5bb38081df1eef0f4e40adf464ed8ae05e5cacda079d9305f63e7a"+ },+ {+ "file": "03-gameplay-atmosphere.png",+ "width": 1672,+ "height": 941,+ "bytes": 1845160,+ "sha256": "7145b5977f5d8a95275719fcff223f87df62cde4264dea1679c6554669676e5e"+ }+ ],+ "verification": {+ "image_decode": "passed",+ "visual_review": "passed-concept-scope",+ "native_resolution_preserved": true,+ "native_8k": false,+ "strict_orthographic_projection": false,+ "module_count_verified": false,+ "three_d_interface_fit_verified": false,+ "interior_clearance_verified": false,+ "mobile_engine_acceptance": false+ }+}diff --git a/docs/assets/space-exploration/cyber-survival-kit-v3/prompts.json b/docs/assets/space-exploration/cyber-survival-kit-v3/prompts.jsonnew file mode 100644index 000000000..008c113c4--- /dev/null+++ b/docs/assets/space-exploration/cyber-survival-kit-v3/prompts.json@@ -0,0 +1,44 @@+{+ "version": 3,+ "title": "Cyberpunk space survival modular kit",+ "user_briefs": {+ "kit": "Modular spaceship kit sheet, orthographic views (front, side, top), clean light-grey background, parts laid out on a grid like a game asset sheet.\nStyle: future cyberpunk space survival, hard-surface sci-fi, dark gunmetal hull with neon cyan accent lights, worn industrial panels, bold readable silhouettes.\nModules: cockpit, 2x2 hull block, 2x4 hull block, corridor, cargo bay, engine (large/small), thruster, turret, reactor core, solar panel, docking port.\nEach module has standardized square connection ports on its faces, marked with glowing yellow-black edge frames, all modules snap on a 2m grid.\nColor coding: reactor=cyan, weapons=orange-red, living=warm white.\nMobile game asset style, low-poly friendly, simple large shapes, no tiny greebles, labeled parts, concept art, high detail, 8k",+ "assembly": "Three spaceships assembled from the same modular kit: small scout (6 modules), medium cargo hauler (20 modules), large battle station (50+ modules). Visible module seams and connection ports so the assembly logic is clear. Same art style as the kit sheet, side-by-side comparison, dark space background, orthographic 3/4 view.",+ "atmosphere": "In-game screenshot concept, mobile sci-fi survival builder, player-built modular ship floating near a derelict station, 3/4 top-down camera, neon cyan and magenta lighting, visible build grid hologram, UI-friendly composition with empty space at screen edges, cinematic but readable."+ },+ "assets": [+ {+ "id": "kit",+ "file": "01-module-atlas.png",+ "reference_images": [],+ "prompt": "Use case: stylized-concept.\nAsset type: labeled modular spaceship KIT SHEET for a mobile cyberpunk space-survival builder.\nFollow the user's brief closely:\nModular spaceship kit sheet, orthographic views (front, side, top), clean light-grey background, parts laid out on a grid like a game asset sheet.\nStyle: future cyberpunk space survival, hard-surface sci-fi, dark gunmetal hull with neon cyan accent lights, worn industrial panels, bold readable silhouettes.\nModules: cockpit, 2x2 hull block, 2x4 hull block, corridor, cargo bay, engine (large/small), thruster, turret, reactor core, solar panel, docking port.\nEach module has standardized square connection ports on its faces, marked with glowing yellow-black edge frames, all modules snap on a 2m grid.\nColor coding: reactor=cyan, weapons=orange-red, living=warm white.\nMobile game asset style, low-poly friendly, simple large shapes, no tiny greebles, labeled parts, concept art, high detail, 8k\nComposition clarification: one very high-resolution LANDSCAPE reference atlas, a disciplined FOUR-COLUMN by THREE-ROW grid, twelve module cells total. Each cell contains THREE small clean orthographic projections of the SAME component: front, side and top. Keep each component simple enough that its three views remain readable. Do not turn it into twelve whole spaceships. All silhouettes fully visible, clear spacing, no cropping, neutral consistent illumination. Aim for the maximum available native resolution and 8K-level detail in the concept, while retaining large low-poly-friendly shapes.\nThe twelve cells, in reading order, must have exactly these legible labels:\n\"COCKPIT\"; \"HULL 2x2\"; \"HULL 2x4\"; \"CORRIDOR\";\n\"CARGO BAY\"; \"ENGINE L\"; \"ENGINE S\"; \"THRUSTER\";\n\"TURRET\"; \"REACTOR\"; \"SOLAR PANEL\"; \"DOCKING PORT\".\nA small shared legend may contain exactly \"FRONT / SIDE / TOP\" and \"GRID 2m\".\nDesign language: practical angular dark gunmetal modules, large beveled plates and readable panel breaks, restrained edge abrasion and industrial wear, precise inset cyan lights, bright yellow rim pieces interrupted by BLACK hazard stripes around square connection interfaces. Hazard strips must be visible in the light-gray sheet. Warm-white light in cockpit/living/corridor sections, cyan reactor accents, orange-red weapon accents.\nAll modules expose compatible SQUARE attachment faces; do not use circular docking collars as the standard interface. Engine nozzles can be round or faceted but their attachment faces are square. Docking port is a square framed unit. Hull 2x4 has twice the planar length of Hull 2x2 at the SAME width and comparable height. Interpret 2x2 and 2x4 as grid footprints on a 2m snap lattice, not as a guarantee that a person's room is only 2m tall. Personnel clearance and final engineered wall thickness remain a later modeling constraint. The solar panel includes its foldable panel surface and square-root mount as one component.\nKeep the requested industrial cyberpunk finish, not clean white luxury ceramic. Do not introduce extra colors, neon-covered surfaces, tiny greebles, fantasy ornament, logos, an assembled hero ship, a city, a starfield, UI widgets or upgrade arrows. This is a concept asset atlas; labels and geometry clarity take priority over decorative graphics."+ },+ {+ "id": "assembly",+ "file": "02-assembly-comparison.png",+ "reference_images": [+ "01-module-atlas.png"+ ],+ "prompt": "Use case: stylized-concept.\nAsset type: modular spaceship assembly comparison board for a mobile cyberpunk space-survival builder.\nInput image 1: REFERENCE ONLY — the authoritative module kit atlas. Use its module designs, materials, lights and square interface proportions consistently; do not reproduce the atlas grid.\nPrimary request: Three spaceships assembled from the same modular kit: small scout (6 modules), medium cargo hauler (20 modules), large battle station (50+ modules). Visible module seams and connection ports so the assembly logic is clear. Same art style as the kit sheet, side-by-side comparison, dark space background, orthographic 3/4 view.\nComposition: one landscape comparison image, exactly three distinct assembled vessels arranged horizontally from small to large, separated with breathing room. All three use the same orthographic three-quarter camera angle and comparable module scale, so the larger structures really contain more modules instead of merely enlarging the same hull. Every vessel is fully visible. Near-black space with restrained stars, no planet or distracting scenery.\nLeft: compact SMALL SCOUT, a short forward cockpit and slim body with two small rear engines, six main modules clearly bounded by seams. Center: MEDIUM CARGO HAULER, elongated central spine with paired cargo pods attached along the sides and two large rear engines, twenty main modules. Right: LARGE BATTLE STATION, a broad cross-shaped or branched platform assembled from fifty-plus repeated modules, with docks, cargo pods, reactor sections, solar panels and orange-red turret clusters. It must read as a constructed station, not a giant smooth battlecruiser.\nThe purpose is to show player creativity using ONE kit: scout is narrow, hauler has a long spine and wide cargo racks, station has a branching architecture. Reuse recognizable parts from the input atlas at compatible interfaces. Never fuse all parts into a monolithic hull.\nClearly visible physical panel boundaries, attachment joints and unused square ports, with yellow-and-black interface rims. Connected modules meet flush, with no floating disconnected parts or impossible interpenetration. Count targets apply to main assembled blocks, not little armor panels or exhaust details.\nMaterials: dark gunmetal, worn industrial hard-surface panels, controlled cyan light strips, warm-white living/cockpit windows, orange-red weapons. Keep the atlas's bold readable mobile-game silhouettes and large low-poly-friendly forms. Render with polished PBR-like metal and restrained edge wear, no dense tiny greebles. Subtle neutral rim light keeps all module seams readable against dark space.\nTypography: simple and unobtrusive, exactly these three captions beneath the respective craft:\n\"SMALL SCOUT · 6 MODULES\"\n\"CARGO HAULER · 20 MODULES\"\n\"BATTLE STATION · 50+ MODULES\"\nNo other text, no logos, no arrows, no UI, no bright colored background. High-quality concept art; maximum available native resolution."+ },+ {+ "id": "atmosphere",+ "file": "03-gameplay-atmosphere.png",+ "steps": [+ {+ "id": "atmosphere-initial",+ "reference_images": [+ "01-module-atlas.png"+ ],+ "prompt": "Use case: stylized-concept.\nAsset type: in-game screenshot CONCEPT for a mobile cyberpunk sci-fi survival builder, landscape screen.\nInput image 1: REFERENCE ONLY — the authoritative module kit atlas. The player's ship must visibly be assembled from those same dark gunmetal modules, square yellow-black attachment rims, cyan inset light strips and warm-white cockpit windows.\nPrimary request: In-game screenshot concept, mobile sci-fi survival builder, player-built modular ship floating near a derelict station, 3/4 top-down camera, neon cyan and magenta lighting, visible build grid hologram, UI-friendly composition with empty space at screen edges, cinematic but readable.\nComposition: a single cinematic but highly readable landscape game-view image. Orthographic-like three-quarter TOP-DOWN camera showing the upper surfaces and sides, suitable for playing a mobile ship-building game. A compact-to-medium player-built modular ship sits near the central lower-left area and a larger derelict modular station occupies the upper-right middle distance. Both remain inside a central safe content zone; leave generous uncluttered dark space at all screen edges for future touch controls and resource UI. No painted HUD, no text, no logos.\nPlayer ship: recognizably kit-built, with forward cockpit, a central hull spine, exposed seams, several offset cargo/utility modules, a cyan reactor and twin engines. Allow a practical slightly asymmetric builder layout with a spare square port. The ship remains the primary subject, clearly readable at phone size.\nA localized cyan holographic square build grid aligns with the player's ship, on a consistent 2m snap lattice. Add one simple translucent preview hull module beside an empty compatible attachment face to communicate building. Grid is restrained and stops around the ship; it does not cover the entire screen or obscure the hull. The ghost is visibly a placement preview and the assembled ship has real connected geometry.\nDerelict station: damaged modular architecture with readable broken hull sections and docking structures, some faded cyan lighting and magenta environmental spill. A small amount of nearby debris provides abandoned-space mood without visual clutter.\nLighting: neon cyan from functional ship systems, magenta rim/environment light from the derelict station, dark neutral space, controlled bloom. Preserve local contrast on the gunmetal panels, yellow-black square interfaces and warm-white living sections. High-end game art materials and cinematic light, but simple broad shapes and visible construction logic remain paramount.\nAvoid giant white luxury hulls, seamless organic ships, heavy fog, excessive bloom, dense tiny greebles, explosions, many ships, fake UI, giant typography, or photorealistic cockpit interiors. Render as a polished visual target, not a claim of an actual running game. Maximum available native resolution."+ },+ {+ "id": "atmosphere-final",+ "reference_step": "atmosphere-initial",+ "prompt": "Use case: precise-object-edit.\nEdit the referenced gameplay atmosphere concept. Change ONLY camera framing and placement to create better mobile UI safe margins.\nKeep the exact same gunmetal cyberpunk module designs, square yellow-black ports, cyan and magenta light, warm-white cockpit, worn panels, derelict station identity, build grid and translucent module preview. Keep the same three-quarter top-down orthographic-like game camera.\nPull the camera back about 25–30%. Fit BOTH the complete player ship with its entire build grid AND the complete visible derelict station structure inside the central area of the canvas. Move the station down and left enough that no station structure, antenna or light is cut off at the top or right borders.\nLeave a continuous band of calm, uncluttered dark space around ALL FOUR image edges, about 10–12% of the image dimension, suitable for mobile controls and HUD. The station can occupy the upper-right central area and the ship the lower-left central area. The player ship stays the primary subject and retains clear readable individual modules at mobile scale.\nDo not change the asset art style, add new objects, add HUD/text, remove the holographic grid, or redesign the ship. Preserve the wide landscape aspect ratio and polished game concept quality.",+ "purpose": "Increase empty mobile UI margins while preserving the visual design."+ }+ ]+ }+ ]+}