一个能在浏览器里跑起来的免费开源三国杀：无名杀本地部署与扩展指南

【免费下载链接】noname项目地址: https://gitcode.com/GitHub_Trending/no/noname

无名杀（noname）是一个开源三国杀项目：网页版三国杀，全部用 JavaScript 写，不用装客户端，浏览器打开就能开局。代码走 GPL-3.0 协议，任何人都可以查看、修改、再分发。身份场、国战、单人剧情、对战等玩法各自独立成文件，想加武将、改牌、换皮肤都有明确的位置。适合两类人：只想在电脑上白嫖一局三国杀的玩家，以及想动手改规则、塞自己武将的开发者。

🚀浏览器版本要求：官方建议用 Chrome 系内核且版本不低于 85 的浏览器，低版本内核渲染容易出问题，这点先记下来。

🚀 三步在本地跑起无名杀

• 用 git clone 把代码拉到本机，进 noname 目录。
• 执行node noname-server.js启动服务器，浏览器访问http://localhost:8089进入游戏界面。
• 选身份场，设好玩家数量和 AI 难度，开始一局。

git clone https://link.gitcode.com/i/d7daecb7370cd7fb85e022e3704ecb9d cd noname node noname-server.js

另外两种启动方式

• Docker：cd docker && chmod +x start.sh && ./start.sh，适合不想在系统里装 Node 依赖的环境。
• 临时静态服务：python3 -m http.server 8000，访问 8000 端口能玩，但不适合多人联机。

进度存在哪里

对局状态存在浏览器 localStorage 里，刷新页面不丢进度；换设备或清缓存之前，记得先备份。

📦 武将与卡牌文件装在哪里

character/ 和 card/ 的组织方式

武将定义集中在 character/ 下 20 多个扩展包目录里：standard/是基础武将，extra/是额外扩展武将，sp/放特殊武将，shenhua/放神话武将，其余目录对应各类扩展包。

卡牌定义在 card/，十来个 js 文件按扩展包分，比如standard.js放标准牌，guozhan.js、mtg.js放国战牌、万智联动牌。

基本牌是杀、闪、桃；锦囊牌有顺手牵羊、无中生有、南蛮入侵；装备牌分武器、防具、坐骑三类。

自定义武将该放哪个目录

自己写武将就放 character/extra/，写完在游戏设置里启用对应扩展才会生效。文件名、字段格式要和现有武将文件对齐，这是自定义武将不显示时最常见的两个原因。

界面怎么改

layout/下的 CSS 文件控制主题颜色、布局、卡牌排列；font/放了 8 个 woff2 字体文件，换字体直接替换文件；背景图在image/background/下，替换同名 jpg 即可换背景。

🧭 联机、备份与排错

局域网联机怎么做

同一局域网内，其他玩家用浏览器访问主机 IP 即可加入，主机保持服务器运行即可。

常见问题自查顺序

进度备份：localStorage 里用浏览器开发者工具导出即可。 遇到 bug 或想提建议：先看 docs/ 下的文档，再走 Issue 反馈。 自定义武将不显示：先查文件路径对不对，再查游戏设置里扩展启用没有。 浏览器要求：Chrome 系内核、版本不低于 85。

想参与维护从哪里入手

项目遵循 GPL-3.0，改完可以提 PR。入口是仓库里的 CONTRIBUTING.md，修 bug、加玩法、写武将、补文档都行，Issue 区直接提需求。

先本地跑一局熟悉规则，再往character/extra/塞第一个自定义武将，基本就是上手这个项目的主要路径。

【免费下载链接】noname项目地址: https://gitcode.com/GitHub_Trending/no/noname