Skip to content
codeOnRunningPublic

About

First-person single-player MOBA boss rush prototype built with Three.js + Rapier

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

星辉试炼 · Art Pass 1.0

第一人称单机 MOBA 的垂直切片。M0 已验证:

第一人称视角下,移动、瞄准、施放技能、攻击移动目标,是否好玩且不晕。

当前进入 Art Pass 1.0:保留 M0 玩法,把灰盒场景升级为“暮色星穹 / 星辉峡谷”的第一版视觉场景。

第一次玩请先看 玩家手册:启动、操作、Boss 攻击、强化与常见问题。
开发排期见 开发日程表;P0-P6 验收见 P0、P1、P2、P3、P4、P5、P6;发布打磨见 P7;美术打磨见 P8;攻击特效见 P9。
在线试玩:https://codeonrunning.github.io/fp-moba/

运行

最省事的方式:双击 启动游戏.cmd。
它会检查 4173 端口是否已有游戏服务;没有就启动 Vite,然后用默认浏览器打开:

  • 本机:http://127.0.0.1:4173/
  • 局域网:http://<本机局域网 IP>:4173/
    例如本机以太网地址是 192.168.0.55,则访问 http://192.168.0.55:4173/。

Vite 已配置为监听 0.0.0.0,同一局域网设备可以直接访问;如果被 Windows 防火墙拦截,需要允许 Node.js / 端口 4173 的专用网络入站访问。

也可以手动运行:

npm install
npm run dev

打开终端里 Vite 输出的地址(通常为 http://localhost:5173/)。

如果端口被占用或受限:

npm run dev -- --port 4173

生产构建:

npm run build
npm run preview

当前可玩内容

  • 第三人称默认(舒适优先) / 第一人称(V 切换)
  • WASD 移动、鼠标视角、Pointer Lock
  • 左键普攻(奥术弹,按住连发)
  • Q 星弧飞弹(按住蓄力,松开放射)
  • F 引力法阵(W 与移动冲突,因此绑定 F)
  • E 折跃(8m 闪现 + 0.24s 无敌帧)
  • R 天穹裂隙(2.5s 引导光束)
  • 被动星辉印记:技能叠层,3 层后普攻引爆
  • Space 跳跃:可躲 Boss 的地面重拳/冲击波,弹幕仍会命中
  • 等级成长:1-20 级,提升伤害、攻速、冷却缩减、生命/法力
  • Boss Rush v0.9.1a:三个 Boss——星蚀守卫(1800)→ 虚空术士(2200)→ 星环巨像(2400)
  • 新增「中路试炼」原型:小兵波次/交战、金币/经验、6 件装备商店、防御塔/水晶、轻量英雄 AI
  • Art Pass 2.0:小兵换用 KayKit 角色模型,玩家法杖/肩甲/光环,敌方更大体型 + 冠饰/大剑/光环 + 更多骨骼动作
  • 攻击特效 Pass:Q/E/飞弹拖尾、W/R 符文、Boss 落点扩散环
  • 难度:简单 / 普通 / 困难;每局随机 Boss 词缀
  • 每次击败 Boss 后 3 选 1 星辉强化(10 个强化池,普通/稀有/史诗)
  • 强化联动、Build 摘要、结算评分、本地最高分
  • 正式 SVG 技能图标、程序化 Boss 音乐、三层音量设置
  • 命中停顿、战斗统计、右上角小地图
  • Q/F/E/R + 跳跃键位重绑定
  • 星蚀守卫:追击、重拳、冲击波、扇形弹幕、阶段 2 星蚀碎片
  • 虚空术士:传送、追踪法球、虚空区域、阶段 2 镜像分身
  • 星环巨像:旋转激光、引力牵引、陨星雨、阶段 2 组合技
  • Boss 登场/阶段转换演出、受击方向提示、低血警告、技能说明面板
  • 生命 / 法力 / 冷却 / 目标血条 / 击杀 / 金币 HUD
  • 伤害数字、命中标记、受击反馈、程序化音效
  • 死亡倒计时与复活
  • FPS / draw call / 三角形数量面板
  • KayKit CC0 模块化场景:石板、拱门、柱廊、火把、旗帜、废墟
  • 星辉峡谷视觉:渐变天空、星环、远山、星门、Bloom、雾
  • KayKit 法师 / 骷髅战士模型与 idle / walk / cast / hit / death 动画
  • 法师贴图运行时换色,统一为深蓝 / 金 / 星青

操作

输入 功能
W/A/S/D 移动
Space 跳跃(躲 Boss 地面伤害)
鼠标 视角
鼠标左键 普攻(按住连发)
Q 星弧飞弹(按住蓄力)
F 引力法阵(按住显示落点,松开释放)
E 折跃
R 天穹裂隙
V 第一 / 第三人称切换
Esc 暂停 / 释放鼠标
点击“继续” 重新锁定鼠标
开始 / 暂停 → 舒适设置 FOV、视角、灵敏度、武器晃动、屏幕震动、画质、隐藏武器

目录

src/
  main.ts                 入口
  style.css               HUD 与界面样式
  game/
    Game.ts               主循环、相机、战斗、HUD 协调
    InputController.ts    键鼠与 Pointer Lock
    PlayerController.ts   Rapier 角色控制器与玩家模型
    Dummy.ts              训练傀儡、AI、血条、复活
    ProjectileSystem.ts   普攻 / Q / 敌方投射物
    Effects.ts            命中粒子与闪光
    AudioSystem.ts        程序化音效
    SettingsStore.ts      舒适设置本地存储
    SettingsPanel.ts      舒适设置面板
    abilities/            F 引力法阵 / R 天穹裂隙视觉
    Hud.ts                DOM HUD
    map.ts                灰盒地图、灯光、静态碰撞
scripts/
  smoke.mjs               启动、截图、Q 命中、视角切换、暂停的冒烟测试
  gameplay.mjs            傀儡死亡/复活、玩家死亡/复活的流程测试

已知限制

  • 这是 Art Pass 1.0 第一版,不是最终美术:角色比例、场景构图、火光/VFX 还会继续调。
  • 目前是 v0.9.1a:Boss Rush 三 Boss 已完成;中路试炼已有小兵/交战、金币/经验、商店、防御塔/水晶原型;Art Pass 2.0 已替换小兵并加入双方角色装饰;攻击特效 Pass 已加入拖尾、符文和冲击环。
  • 角色目前是“CC0 骨架 + 外观换色/换装”的过渡方案,不是全定制建模。
  • 使用程序化占位音效。
  • 仅面向桌面 Chrome / Edge / Firefox 键鼠;移动端未适配。
  • 当前构建包含内联 Rapier WASM,包体偏大;后续可做拆包/压缩。

资产与状态

当前使用 KayKit 的 CC0 场景与角色资产,未使用 LoL / Riot 素材。

下一步(Boss Rush)

  • 中路试炼:防御塔/水晶/1v1 胜负条件
  • 独立敌方英雄 AI、装备栏、完整兵线
  • 30 分钟 soak、Firefox 回归、资源压缩

当前进度见 BOSS-RUSH-STATUS.md。

M0 通过标准:移动不飘、视角不晕、Q 能稳定命中移动目标、死亡/复活流程正常、目标设备 60 FPS。

验收记录见 M0-ACCEPTANCE.md。

About

First-person single-player MOBA boss rush prototype built with Three.js + Rapier

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages