# idle-core **Repository Path**: aowind/idle-core ## Basic Information - **Project Name**: idle-core - **Description**: 拾剑录 · 挂机武侠 Web 游戏(Node + Three.js) - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: https://aigpart.com/play/shijianlu/ - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-29 - **Last Updated**: 2026-10-29 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 拾剑录 · 挂机武侠 Web 游戏 一款中华武侠题材的挂机刷宝网页游戏:选择存档进入江湖,门客自动战斗,装备与铭文层层掉落, 闯关、悬赏、图鉴、山庄与离线收益构成完整的挂机循环。前端 Three.js 正交舞台,后端 Node.js 权威模拟,玩法数据与文案全部由 JSON 配置驱动。 - 游戏内名称:**拾剑录**(副题:剑影尘缘) - 题材:中华武侠 + 剑仙修真 - 形态:浏览器网页游戏(另有 Electron 桌面壳) ## 玩法 | 系统 | 说明 | |---|---| | 挂机战斗 | 30 帧逻辑帧推进,服务端权威结算,WebSocket 10Hz 快照;小队三人协同,全灭判负 | | 掉落与品质 | 按掉落组 × 怪物等级选档、权重抽取,品质染色(凡品 / 良品 / 稀有 / 成套 / 传世) | | 装备与铭文 | 底材 × 词缀组合,成套与传世装备、孔位与符箓真言、随机词缀搭配 | | 门客与门派 | 七门派、236 名门客,属性随等级成长、自动换装、独立武学 | | 武学 | 主动 / 被动 / 普攻,冷却与内力消耗,技能升级与效用分支 | | 江湖舆图 | 203 张关卡分幕布局,前置解锁链、难度准入、失败回退 | | 悬赏任务 | 五类悬赏目标(剿灭 / 精英 / 交付物品 / 缴纳银两 / 交付装备)与势力声望 | | 图鉴 / 成就 | 物品 · 怪物 · 关卡 · 门客武学四类图鉴,成就与进度统计 | | 山庄 | 三层背景、装饰分层、NPC 交互与对话 | | 经济 | 商铺、赌博、合成(丹房)、分解、库房、自动出售 | | 离线收益 | 下线后按 8 小时上限结算 | 界面为十二个页签(行囊 / 装备 / 门客 / 真言 / 商铺 / 任务 / 悬赏 / 图鉴 / 成就 / 合成 / 设置 / 舆图), 全部中英双语,装备详情、筛选规则与自动出售均可配置。 ## 技术栈 | 层 | 选型 | |---|---| | 前端 | Three.js(正交相机、三层视差背景、序列帧精灵与特效)、原生 DOM/CSS 界面 | | 后端 | Node.js + Express + WebSocket(ws),权威战斗模拟与存档 | | 共用 | 纯 JS 战斗公式引擎与属性体系(`shared/`),前后端同一套公式 | | 桌面 | Electron 壳(`electron/`,可选) | | 数据 | JSON 配置表 + 多语言词典 + 命名覆盖层(`data/`、`client/public/data/`) | ## 目录结构 ``` idle-core/ ├── shared/ 前后端共用逻辑(纯 JS,无依赖) │ ├── const.js 属性编号体系、伤害类型、品质、槽位 │ ├── combat.js 战斗公式引擎(伤害 / 命中 / 暴击 / 抗性 / 碾压) │ ├── items.js 物品生成、词缀、掉落抽取、符文之语 │ └── text-zh.js 文案常量 ├── server/src/ 权威模拟服务端 │ ├── index.js HTTP + WebSocket 入口 │ ├── sso.js 平台统一登录(可选接入) │ ├── data/loader.js 配置表装载与索引 │ ├── data/achievements.js 成就定义与进度 │ ├── config/balance.js 数值曲线(怪物成长、经验、掉落) │ └── core/ 战斗引擎、挂机会话、存档与角色 ├── client/ │ ├── index.html │ ├── src/ │ │ ├── main.js 入口:连接服务端、场景切换、NPC 对话 │ │ ├── render/stage.js Three.js 正交舞台、三层背景、精灵与飘字 │ │ ├── game/assets.js 素材索引、动画查询、精灵映射 │ │ ├── game/battleview.js 战斗表现层(站位 / 动作 / 特效) │ │ ├── ui/ HUD、行囊、装备、门客、图鉴、舆图等面板 │ │ ├── audio/ 音频总线与音效池 │ │ └── i18n.js 中英双语 │ └── public/ │ ├── data/ 客户端数据包(动画 / 静态图 / 展示配置 / i18n) │ └── vendor/ Three.js 运行时 ├── data/ │ ├── naming/ 命名词典(门派 / 技能 / 地图 / 装备 / 术语) │ ├── i18n/ 双语词典 │ ├── text/ 整句翻译表 │ └── ui/ 界面数据 ├── electron/ 桌面壳(Electron + 可选 Steamworks) ├── tools/ 美术生成与验收工具(序列帧、图标、立绘、舆图、浏览器探针) ├── docs/ 技术文档 └── package.json ``` ## 本地运行 ```bash npm install npm run dev # 启动服务,默认 http://localhost:5173 ``` 浏览器打开 `http://localhost:5173`,等数据加载页走完,在开始页选择或新建存档即可开始挂机。 > **注意**:本仓库是源码快照,体积较大的美术素材(`client/public/assets/`,序列帧与图集) > 与配置数据包(`data/config/`、`data/i18n/`)未随仓库分发,直接启动会在「载入配置表」阶段报 > ENOENT 退出。补齐方式: > > 1. 把美术素材放到 `client/public/assets/`(保持 `index.json` 索引结构); > 2. 把配置表与语言包放到 `data/config/`、`data/i18n/`(发行包 `dist/` 下的同名目录可直接拷贝); > 也可以放在任意位置,用环境变量 `IDLE_CFG_DIR` / `IDLE_I18N_DIR` 指向自己的数据目录; > 仓库不含运行时数据目录,服务端启动时按 `server/src/data/loader.js` 的规则解析这两个路径。 ## 美术与素材 - 角色 / 怪物 / 特效 / 背景 / 界面:项目内用生成式管线(文生图、图生视频、序列帧后处理)自制, 生成脚本与提示词在 `tools/` 下;产出图不入版本库,可重跑重建。 - 界面图标:几何剪影来自 [game-icons.net](https://game-icons.net/),CC BY 3.0, 本项目重新绘制为「朱砂印」视觉(署名见 [`docs/CREDITS.md`](docs/CREDITS.md))。 - 标题字标:字形来自阿里妈妈东方大楷(免费商用),已栅格化为 PNG 字标,不随仓库分发字体文件。 - 第三方依赖(Three.js、Node.js、Express、ws、Electron)均按其开源许可使用。 ## 文档 | 文档 | 内容 | |---|---| | [`docs/DATA.md`](docs/DATA.md) | 数据字典:配置表结构、属性编号、伤害链路、掉落规则 | | [`docs/BALANCE.md`](docs/BALANCE.md) | 数值与成长曲线 | | [`docs/SKILL-EFFECTS.md`](docs/SKILL-EFFECTS.md) | 武学表现与特效链路 | | [`docs/AUDIO-PLAN.md`](docs/AUDIO-PLAN.md) | 音频规划 | | [`docs/ART-START-SCREEN.md`](docs/ART-START-SCREEN.md) | 开场与开始页美术规格 | | [`docs/ART-TITLE-LOGO.md`](docs/ART-TITLE-LOGO.md) | 标题字标生成说明 | | [`docs/ART-BATTLE-BG.md`](docs/ART-BATTLE-BG.md) | 战斗背景三层管线 | | [`data/naming/README.md`](data/naming/README.md) | 命名词典与覆盖层格式 | | [`docs/CREDITS.md`](docs/CREDITS.md) | 第三方素材署名 | ## 许可 代码与自制美术、文案版权归项目作者所有;第三方组件遵循其各自许可(见 `docs/CREDITS.md`)。 未经授权请勿将本项目整体或素材用于商业发行。