☰
无名杀:免费开源的网页版三国杀启动指南与武将自定义路径
2026/10/21 3:35:41 网站建设 项目流程

无名杀:免费开源的网页版三国杀启动指南与武将自定义路径

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

无名杀(noname)是一款免费、开源的网页版三国杀卡牌游戏:浏览器打开即玩,内置约 2500 个武将条目与 2342 张立绘,无需安装客户端。本文按顺序讲清四件事:怎么把游戏跑起来、它能做什么、怎么加入自己的武将、新手容易踩的坑。

三分钟跑起来

整个流程只有三步:拿到代码、起服务、验证。先克隆仓库到本地:

git clone https://gitcode.com/GitHub_Trending/no/noname cd noname

项目自带 Node 服务器脚本,用一行命令同时启动游戏服务和联机大厅(见 docker/start.sh):

node noname-server.js --server

如果你的机器上装了 Node 但嫌手动起服务麻烦,也可以直接跑纯静态方案——在项目根目录执行python -m http.server 8000,然后打开http://localhost:8000即可进入选将界面。看到角色头像铺满屏幕、模式列表可点,就说明启动成功了。有 Docker 环境的读者可参考 docker/docker.md,游戏界面与联机大厅分别映射到 8734 和 8324 端口。

一个能翻遍的武将库

🎴 character/ 目录下有 30 多个子目录,按势力与版本分组(standard、sp、sb、huicui、xianding 等)。去掉重名版本后约有 2500 个武将条目,每个武将就是一行 JS 数据:性别、势力、体力上限、技能列表。你能用它做什么:从魏蜀吴群到跨界联动角色,几乎随手可挑;好在哪:数据是纯文本结构,新增或调整武将不需要碰渲染代码,客户端即改即生效。

12 种玩法装在一个客户端里

mode/ 下有 12 个模式文件:identity(身份场)、guozhan(国战)、single(单人剧情)、boss、brawl、versus,还有 chess(象棋)、doudizhu(斗地主)、connect 这类非三国休闲玩法。你能用它做什么:同一个入口切换竞技与休闲,联机对战和单机自娱都能覆盖;好在哪:每个模式是独立的 JS 文件,模式之间互不干扰,新增一个玩法只需在 mode/ 下加一个文件。

三国之外,还有 16 套卡牌数据

card/ 目录包含 16 个牌组数据文件,除了三国杀标准的基本牌、锦囊与装备,还收录了 mtg(万智牌)、hearth(炉石)、gwent(巫师)等跨游戏卡牌。你能用它做什么:在同一套引擎里换一副牌池,体验不同世界观的对局;好在哪:卡牌数据与武将数据完全分离,扩充牌组不会碰坏角色逻辑。卡牌原画存放在 image/card/,例如这套 mtg 卡图:

主题、布局与字体都可以换

视觉资源集中在三处:theme/ 提供 music、simple、style、woodden 四套主题,layout/ 有 21 个布局样式文件,font/ 内置 8 种中文字体(行楷、小篆、黄草等)。你能用它做什么:换背景、换配色、换字体,把界面调成自己喜欢的样子;好在哪:全是 CSS 与字体文件,改主题不用动任何 JS。

自定义武将:写一行数据,加一段技能

想给自己喜欢的角色写个武将,入口就是 character/。新建一个 js 文件,仿照现有格式声明势力、体力与技能名即可被客户端识别。技能逻辑分两种写法:

  • Async Content(推荐):content写成async函数,用await串联摸牌、选牌等步骤,代码接近原生 JavaScript。入门教程见 docs/async-guide.md。
  • Step Content:用"step 0"标记分步执行的老写法,存量代码里仍大量存在。

想让武将开口说话,参考 docs/audio-guide.md:技能语音默认放在 audio/skill/,目录里现有 5637 条技能音频、1289 条阵亡语音,音频字段只需填技能名就能自动匹配文件。

避坑指南

  • 浏览器内核。推荐 Chrome 系内核 ≥85 的浏览器,低版本 Firefox 不被支持,页面异常时先核对这一点(见 README.md)。
  • 进度存哪了。游戏状态写入浏览器 localStorage,刷新页面不会丢局;但清除站点数据等于重开,跨设备也不互通。
  • 提交流程。Pull Request 必须推送到 PR-Branch 分支,规范细节见 CONTRIBUTING.md。
  • 联机端口。Docker 方式下 8734 是游戏界面、8324 是联机大厅,防火墙放行后才能让朋友连进来。

参与维护

无名杀遵循 GPL-3.0 协议,仓库对社区完全开放。贡献路径有四条:给本体提交功能改进、向 character/ 目录添加新武将扩展、按 audio-guide 补充技能语音、测试并反馈模式或技能的问题。改动前先读 docs/ 里的两篇开发指南,PR 走 PR-Branch 分支即可。

以上是主仓库的主要入口;动手改功能前,建议先翻 game/ 与 noname/ 里的核心源码,更新版本时留意 changelog,再决定要不要跟进新写法。

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询