三分钟跑起无名杀网页版:从启动到自定义武将的完整教程
【免费下载链接】noname项目地址: https://gitcode.com/GitHub_Trending/no/noname
无名杀网页版是一款直接在浏览器里运行的三国杀卡牌游戏:开源(GPL-3.0)、完全免费,不用下载客户端,不锁定任何武将。浏览器就是客户端,克隆代码、启动一个本地服务器,界面就能打开。这篇文章按"先跑起来、再看懂它、最后改它"的顺序展开:从 3 步完成启动,到武将、卡牌、游戏模式都放在哪个目录,再到自定义武将的位置、主题换法,以及面向开发者的技能代码写法和社区贡献路径。
先说清楚:这个项目给你的是什么
不堆形容词,只列玩家最该知道的几件事:
- 内容全免费。数百名武将、完整卡牌、十余种模式全部在仓库里,源码可以直接看,没有任何角色付费解锁。
- 浏览器即客户端。游戏进度存在浏览器本地存储里,换台机器也能接上之前的进度;官方建议用 Chrome 系内核 85 及以上的版本,低版本 Firefox 不推荐。
- 数据全部可读。武将定义、技能逻辑、卡牌效果都是朴素的 JavaScript 文件。能读懂 JS,就能读懂这个游戏的运行方式——这也是后文定制章节的前提。
🚀 让无名杀在浏览器跑起来的最快方法
三步,总耗时控制在三分钟内:
git clone https://gitcode.com/GitHub_Trending/no/noname cd noname node noname-server.jsnoname-server.js启动后默认监听8089端口,浏览器打开http://localhost:8089就是游戏界面,也可以用它带--port参数换端口。如果机器上没有 Node.js,用python3 -m http.server 8000起一个静态服务、把浏览器指到 8000 端口,也够试出核心流程。
想把服务放后台跑或开给局域网,仓库根目录自带 Dockerfile,具体端口和步骤写在 docker/docker.md:docker build加docker run两条命令,网页端走 8734,联机大厅走 8324,端口都可在启动参数里改。
第一次进游戏,选"身份场"、8 人局、空位交给 AI,第一局就打得起来。
🎴 仓库里有什么:武将、卡牌与游戏模式
玩几局之后你会想搞清楚这些内容到底在哪。目录结构很直接,一种玩法对应一个目录:
武将按扩展包分目录管理。character/ 下每个子目录是一个扩展包:standard/是魏蜀吴群的基础武将,sp/放特殊武将,shenhua/、refresh/、yingbian/各自成包,collab/是联动角色。每个包里文件固定:character.js是武将定义(性别、势力、血量、技能列表),skill.js是技能实现,intro.js是人物介绍。想查某个武将的技能细节,打开对应包的skill.js就能看到。
游戏模式。mode/ 下共 12 个模式文件,覆盖身份场、国战双将、1v1 对战、单人剧情、boss 战、斗地主、象棋、五子棋、四子连珠、实时模式等。默认开放哪些模式由game/config.js控制。
卡牌系统。card/ 里除了杀闪桃、锦囊、装备三大类,还有gwent.js、hearth.js、mtg.js这类其他卡牌体系的数据定义,扩展空间比"三国杀本体"更大。
音频资源。audio/ 按用途分目录:background/背景音乐、skill/技能音效(五千多个文件)、voice/语音、die/阵亡台词、effect/界面音效;具体引用方式见 docs/audio-guide.md。
前几局实用建议:身份场里主公开局先观察再出主公技,内奸前期保持低调、等反贼消耗完再考虑收残局;武将搭配上控制和爆发互补,国战模式里同势力双将有额外增益。不用背,打上几局自然形成手感。
🛠️ 进阶定制:加武将、换主题、写技能
自定义武将放哪。在 character/extra/ 下新建 JS 文件,按现有扩展包的结构写上武将姓名、势力、血量和技能列表,技能逻辑放进配套的skill.js,文件放对目录、扩展开关打开,新武将就会出现在选将列表里。
主题、布局与配置中心。界面不必锁死一种样子:layout/ 提供default/、mobile/等多套布局;theme/ 有woodden、music、simple等主题,font/ 备了几款卡牌字体。所有游戏参数集中在 game/config.js 一份文件里——扩展源地址、禁用武将列表、默认模式与主题、音量,改这一个文件就够了。
技能代码怎么写:Async Content。早期写技能靠step 0、step 1字符串标 step 跳转,逻辑稍复杂就很难读。v1.10.6 起项目引入了Async Content写法:技能的 content 函数就是一个标准async函数,用await串起抽牌、弃牌等步骤,比 Step Content 更贴近原生 JavaScript 语法。docs/async-guide.md 从 async 基础讲起,是写自定义武将前最值得先读的一份文档。
社区贡献。项目以 GPL-3.0 协议开放,玩家可以直接提 bug、做新武将新卡牌、改代码。贡献流程和提交规范见 CONTRIBUTING.md,仓库 README.md 里还写明了 Pull Request 应推送到指定分支,动手前先看一下能少走弯路。
无名杀不设注册、不收钱、不锁武将,装完浏览器它就已经在本地跑起来了。下一轮的"杀"打向谁,由你自己决定。
【免费下载链接】noname项目地址: https://gitcode.com/GitHub_Trending/no/noname
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考