无名杀网页版部署教程:在浏览器里跑起开源三国杀
【免费下载链接】noname项目地址: https://gitcode.com/GitHub_Trending/no/noname
在浏览器地址栏敲入localhost回车,几秒钟后你已经坐在牌桌前、手牌发完。全程没有安装器——这是无名杀(NoName),一个跑在浏览器里的开源三国杀。
一句话说清这个项目
无名杀是基于 Web 技术的开源三国杀客户端,代码、武将数据、卡牌和美术资源全部公开。它内置了数百名武将和身份场、国战等十余种模式,直接拉取本地源码就能玩,也可以把武将、卡牌、音效换成自己的版本。不用安装、不用注册,浏览器就是整个客户端。
如何启动无名杀:三种方式把游戏跑起来
🚀 先拿到源码:
git clone https://gitcode.com/GitHub_Trending/no/noname cd noname1. 拉取源码—— 武将、卡牌、模式数据都在仓库里,浏览器需要从本地目录读取它们,所以这一步是整个部署教程的前提。
2. 三选一启动,命令与场景对照如下:
| 方式 | 启动命令 | 适用场景 | 你会看到什么 |
|---|---|---|---|
| Python 静态服务 | python -m http.server 8000 | 零依赖新手、本地单机 | 浏览器打开主菜单,可以建房打 AI |
| Node.js 服务 | node --experimental-default-type=module noname-server.js --server | 开发者,默认端口 8089 | 同样主菜单,额外提供联机接口 |
| Docker | docker build -t noname .后docker run -d -p 8734:8089 -p 8324:8080 noname | 服务器部署 | 游戏在 8734 端口,联机大厅在 8324 端口 |
3. 打开对应端口(Python 方式是http://localhost:8000)。之所以要通过本地服务器而不是直接双击index.html,是因为游戏会加载数百个 JS 和图片文件,file://直接打开会被浏览器同源策略拦截。
另外注意浏览器要求:Chrome 系内核(Chrome / Edge)且内核版本 ≥ 85,项目明确不推荐低版本 Firefox。满足这一点,网页版三国杀基本不会出现打不开的情况。
能玩哪些游戏模式
🎮 建房时选择的模式来自 mode/ 目录,主要四种如下:
| 模式 | 核心规则一句话 | 适合谁 |
|---|---|---|
| 身份场(identity) | 9 人抽身份,主公/忠臣/反贼/内奸四阵营对抗 | 想玩经典三国杀的 |
| 国战(guozhan) | 每人挑两名同势力武将,四势力混战 | 研究势力配合的 |
| 1v1 单挑(versus) | 双方各持一名武将对战,先输先出局 | 想快速开一把的 |
| BOSS 模式(boss) | 普通武将组队对抗强化 Boss | 想要固定目标的 |
mode/里还有brawl.js、tafang.js、realtime.js等文件,每个文件就是一套独立规则,房间入口会跟着文件走。
自定义武将文件放哪里:你只需要动这几个路径
🛠 想改内容的话,下面这份目录清单就够用了,不需要理解游戏引擎:
character/standard/character.js # 武将数据:名字、势力、体力、技能列表 character/standard/skill.js # 技能触发条件与效果逻辑 card/standard.js # 卡牌定义:名称、类型、效果 mode/identity.js # 模式规则:胜负条件、人数、牌池 audio/background/ # 背景音乐(MP3) audio/skill/ # 技能音效 audio/card/male|female/ # 出牌音效,按性别分目录 image/character/ # 武将立绘图片几条命名约定值得留意:
- 武将按扩展包放在
character/子目录(standard标准版、shenhua神话再临、sp等),每个扩展包内是同一套文件,无名杀自定义武将时按扩展包各改一份。 - 武将 ID、技能 ID、立绘文件名统一用拼音,新增武将沿用这个约定,三处名字必须一一对应。
- 加一张立绘:把 jpg 放进
image/character/,文件名与武将 ID 一致即可被引用。
替换音效前建议先读项目自带的 docs/audio-guide.md,音频目录的结构和调用方式都写在里面。
无名杀部署常见问题
❓音频完全不出声:多数情况是浏览器拦了自动播放。先在页面上点一下任意位置(完成用户交互),再点开始按钮,Chrome 系浏览器就会放行音频。
自定义武将加了不显示:九成是文件与命名没对上——character.js里的武将 ID 必须与技能引用、立绘、语音的 ID 完全一致,文件编码用 UTF-8。打开浏览器控制台看红色报错,基本能直接定位。
手机上画面错位:无名杀主要按桌面视图适配,窄屏下牌桌布局容易溢出,横屏或换桌面浏览器体验更好,这属于已知限制而非部署问题。
页面加载慢:首次打开要加载本地全部资源,之后浏览器缓存生效会明显变快;配置较低的机器可以关掉其他标签页,并确认浏览器开启了硬件加速。
浏览器兼容:官方推荐 Chrome 系内核 ≥ 85,低版本 Firefox 不推荐;出现卡牌错乱、技能失效时先排除内核版本。
参与社区
无名杀由社区维护,贡献大致分四类:
- 代码:修 bug、改模式逻辑(核心在
noname.js、mode/、character/) - 内容:新武将、新卡牌、新模式配置
- 文档:
docs/下的使用与开发文档可补充完善 - 翻译:各扩展目录下的
translate.js负责卡牌与技能文本的本地化
跑起来之后,打开character/目录挑一名武将,试着改一句技能描述——这就是从玩家变成贡献者的最短路径。
【免费下载链接】noname项目地址: https://gitcode.com/GitHub_Trending/no/noname
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考