WAMMinecraft 模组开发工作台

做出真能跑的模组

不用写代码、不用配开发环境。把脑洞讲清楚 —— 方块、物品、工具、生物、贴图模型 —— WAM 直接生成 Fabric / Forge / NeoForge 工程，打包成能丢进 mods 文件夹的 .jar。

三种加载器都能出
生成完直接下 .jar
浏览器里跑，不装环境

本地生成 · 你的想法不会被上传 | 遇到问题就进官方群：WAM 模组频道 | 跳过，以后直接进工作台

WAMMinecraft 模组开发工作台

AI 就绪

WAM · 直接描述脑洞，回车发送 · 支持拖入文本/图片修改已有模组

⚙️ 模组设置

模组信息

模组名 (英文)

Mod ID

只能用小写字母 / 数字 / _ / -，必须以小写字母开头。写错游戏会直接崩在加载界面。

Java 包名

Minecraft 版本

模组加载器

选择要生成代码对应的模组加载器规范。

AI 引擎（真正的大模型）

🔍 AI 建模联网搜索建模时联网搜索 Minecraft 真实外观（推荐）

开启后，AI 会先精确理解物品「是什么」，再对应到最接近的 Minecraft 实物（例：稿子/手稿→书、图纸/信件→纸、药水→药水瓶），然后按它的真实外观生成模型——即使本地外观库里没有这个词也会交给 AI 判断。关闭则只用本地参数化模板。修改后自动生效，无需重启。

🔑 高级：用我自己的 Key（仅本机）

线上访客看不到这一块：访客用的是站点内置 AI，点顶部「🎁 积分」领积分即可。这里的设置只在你本机打开这份页面时生效，用来兜底（云端不可用时还能直连你自己的账号）。

优先用站点内置 AI（积分制）

服务预设

API Key

API Base URL

模型名

🔌 本地中继（提示 Failed to fetch 时用）通过本机中继转发 AI 请求

网页预览环境的内容安全策略（CSP）常常禁止页面直连外部 AI 域名，浏览器只能报 Failed to fetch——不是断网也不是 Key 错。
解决方法：① 点「⬇ 下载中继脚本」→ ② 在本机运行 python automods-ai-relay.py（窗口保持开着）→ ③ 打开上面的开关 → ④ 点「🔍 测试连接」出现 ✅ 即可用。

🎤 语音识别（不经过谷歌）

麦克风录音在你本机完成，只把这段声音发出去转成文字，全程不碰谷歌。硅基流动的 SenseVoice 是完全免费的，中文/粤语识别比 Whisper 还准，10 秒音频约 70ms 出结果，说一句停一下就自动上屏，和谷歌输入法那种体验一致。
选「站点内置语音」则什么都不用填：Key 在云端服务上，页面里没有、请求里也没有，按站点积分扣（跟内置 AI 同一本账，去顶部「🎁 积分」领取）。
开了「🔌 本地中继」时，语音也会走中继转发（预览环境常禁止页面直连外部域名）。

已默认填入免费服务「智谱 GLM」的 Key，打开即用。如何申请 Key？

🛠 后台管理

登录后进入全屏后台：概览 / 在线客户端（可踢下线）/ 公告推送 / 更新日志（保存即同步到所有客户端）/ AI 中继统计 / 修改密码 / 操作日志 / 数据备份 / 云端用户管理。退出请点后台右上角「⏻ 退出后台」。需本机运行 automods-ai-relay.py（v2.2.0）并在上面填好中继地址。

☁️ 云端

云端服务地址

未登录。登录后项目会自动保存到云端，关掉所有页面、换台电脑都能取回来。

编辑后自动保存到云端

只上传「模组配置 + 对话记录」，不会上传你的 API Key。

不登录就不让用（强制登录 / 注册）

线上默认开，本机默认关（自己电脑上不必每次都登录）。云端服务没配好时别开，否则谁都进不来。

🛠 WAM 后台管理

在线 – 人

实时在线人数

–人正在使用 WAM

每 5 秒自动刷新 · 心跳超过 90 秒视为离线

累计心跳

–

历史客户端

–

服务运行时长

–

AI 成功率

–

服务信息

👥 在线客户端

心跳超过 90 秒会自动消失。「踢下线」是立刻把它从名单移除；该客户端下一次心跳（20 秒内）会重新出现，所以它只用来临时清人，不是封禁。

客户端	版本	IP	首次上线	最后心跳	心跳

📢 公告推送

公告有两种样子：一句话（顶部横幅显示一行字）和 富文本（弹出一张带封面、大标题、编号亮点和底部按钮的卡片）。保存后所有打开着的 WAM 客户端 8 秒内生效；清空「公告内容」并保存 = 关闭公告。

公告内容（一句话 · 必填）

样式

🖼 富文本公告（弹出卡片，而不是只有一条横幅）

📧 同时发邮件给注册用户

勾选后保存公告，会额外把这封公告发到云端所有注册用户的邮箱（需已登录 ☁️ 云端后台，且发信邮箱已配好）。邮件是一个人一封单独投递的，收件人里不会出现别人的地址；发送后台进行，进度显示在下面。

保存时同时群发邮件通知所有注册用户

📜 更新日志

版本号 / 日期 / 条目（一行一条）。点「保存」后所有打开着的客户端立即同步。

🤖 AI 中继统计

总请求

–

成功 / 失败

–

成功率

–

平均耗时

–

最近请求（最多 60 条）

时间	上游	状态	耗时	大小

🔑 修改密码

一周（滚动 7 天）最多改 2 次，改完旧密码立即失效。

旧密码

新密码（至少 6 位）

确认新密码

🧾 后台操作日志

自动记录登录、改密、保存日志、推送公告、踢下线、导入导出等，最多保留 300 条。

时间	操作	详情	来源

☁️ 连接云端后台

连上你的云端服务（NAS / 服务器）后，就能管理所有注册用户。云端后台账号默认 WAM，初始密码是你部署时填的 WAM_ADMIN_PASS；没填的话服务首次启动会随机生成一个，写进数据目录的 ADMIN_PASSWORD.txt（启动窗口里也会打印一次，之后不再出现）。连上后请立刻改掉。

云端服务地址

云端后台密码

🎁 站点内置 AI（给访客免费用）

开启后，页面设置里的「🤖 AI 来源」选 🎁 站点内置 AI 就能直接生成， 用户不需要填任何 Key。Key 只保存在这台云端服务上，任何接口都不会把它返回给浏览器（这个页面里也只显示掩码）。成本用积分控制：每人每天可领固定积分，每次调用按模型「单价」扣分。

启用站点内置 AI（关掉后访客只能用自己填的 Key）

接口地址（OpenAI 兼容）

API Key

还没有读取

每人每天可领积分

每月最多领取次数

每次调用基础积分（实际扣除 = 基础积分 × 模型单价）

🧩 可选模型（用户在页面上看到的就是这一列）

「单价」就是扣积分的倍数：单价 ×2 的模型，一次消耗是 ×1 的两倍 —— 用来把贵模型和便宜模型分开摆，让用户自己权衡。只勾「启用」的模型会出现在页面里。

🎤 站点内置语音（访客点开麦克风就用）

开启并填好 Key 之后，页面设置里的「🎤 语音识别」选 站点内置语音，访客不用申请任何 Key，点 🎤 直接说话。录音、静音断句、WAV 编码都在访客本机完成，只有那段声音送到这里代转文字（全程不经过谷歌）。
成本走同一本积分账：识别一次扣「每次积分」这么多，上游出错原样退回。

启用站点内置语音

用哪一套语音服务

语音接口地址

语音 API Key

模型

每次识别扣积分（0 = 免费）

第三方：推荐先用 智谱 GLM-ASR —— 地址填 https://open.bigmodel.cn/api/paas/v4、模型填 glm-asr-2512，就用站点现在这把智谱 Key，国内直连、有免费额度（实测 20 秒音频约 0.5 秒出结果）。注意它单段最长 30 秒（页面会自动断句，正常说话碰不到）。
想要中文更准或单段更长：换硅基流动的 FunAudioLLM/SenseVoiceSmall（免费，需单独申请 Key）。

自建（WhisperLiveKit 跑在自家 NAS 上）：地址填网关的公网地址（形如 https://asr.你的域名），Key 填网关签出来的 JWT 令牌（一长串 eyJhbGciOi...，不是 sk- 开头的厂商 Key）。模型随便填个名字即可，实际用哪个模型是 NAS 上容器启动时定的。
网关自带 JWT 鉴权 + 每天次数 / 音频分钟 / 并发 / 单段时长四道闸，令牌被偷也能随时吊销。部署和签令牌见 nas-asr/README.md。

📈 内置 AI 用量

今日调用

–

今日消耗积分

–

累计调用

–

累计消耗 / 失败

–

已记账身份

–

消耗最多的身份（u: = 注册用户，g: = 未登录访客）

🚀 快速上手（3 步）

在底部输入框用大白话描述脑洞，例如「做一把会发光的苍穹之剑」，然后回车或点 ➤。
WAM 会把需求拆成几个设计方向，你点选想要的加进「想法池」，点「确认」后它开始生成完整模组。
生成完成后，在结果卡片上点「⬇ 下载 .jar」（或顶部同名按钮），把文件拖进游戏的 mods 文件夹即可。

没有想法也不怕：欢迎语里自带几个示例词条，点一下就能直接套用。

📦 下载 Java 版模组（.jar）

Java 版模组打包成单个 .jar 文件，拖进游戏 mods 文件夹就能玩。

点顶部「⬇ 下载 .jar」，或在生成结果卡片上点「⬇ 下载 .jar」。
把下载的 {modid}.jar 放进 .minecraft/mods 文件夹。
启动游戏，进创造模式的物品栏搜索你的模组名即可看到物品 / 方块。

两个前提：
1. 游戏要装 Fabric Loader（不是 Forge）——Java 版模组按 Fabric 规范编译；
2. 游戏版本要与「设置 → Minecraft 版本」里选的一致（默认 1.21.1）。
没装 Fabric？去 fabricmc.net 下载 Fabric 安装器，装到对应版本即可。

下载的 .zip（源码工程包）是给想二次开发的人用的：里面有 automods-build.py，装好 Python 后双击它就能在本地重新编译出 .jar。

🎮 下载网易基岩版模组（.mcaddon）

想要网易《我的世界》基岩版能用，就把「设置 → Minecraft 版本」选成「🎮 网易基岩版」，然后点顶部「🎮 网易版」或结果卡片上的「🎮 下载网易版」，得到 .mcaddon 文件。

把 .mcaddon 传到手机或导入网易版客户端（双击或用「打开方式」选择网易版）。
在世界的「行为包 / 资源包」里启用这个模组。
进入世界后，在创造物品栏里找到生成的物品 / 方块。

关于版本号：选择「网易基岩版」后，下方会出现「网易版版本号」输入框，由你自行填写（如 1.26.40）。留空或填了无效值会显示「无版本」，此时按 1.16.0 兼容模式打包，导入更老版本一般也能用。

🧊 AI 建模 / 🎨 AI 贴图

🧊 AI 建模

点顶部「🧊 AI 建模」，输入要生成的物品名（如「烈焰大剑」），生成对应的 Minecraft 方块模型文件，可挂到模组里。

🎨 AI 贴图

点顶部「🎨 AI 贴图」，描述想要的贴图风格，生成像素风贴图，自动用于模组物品 / 方块。

生成的模型 / 贴图会显示在对话区的结果卡片里，可直接下载或在后续生成模组时复用。

✏️ 修改已有模组

想改已经生成的模组，不用从头再来：

把之前的 content.json、描述文本、或截图 直接拖进输入框，再说明要改什么（如「把剑的伤害改成 20」）。
WAM 会基于已有内容做增量修改，而不是全部重写。

⚙️ 设置项说明

点顶部「⚙️ 设置」打开右侧抽屉，可调整：

设置项	作用
模组名 / Mod ID / 包名	决定生成模组的标识（英文，小写，避免特殊字符）。
Minecraft 版本	Java 版选目标游戏版本；「网易基岩版」切到基岩版产物；「自定义」手动填版本号。
模组加载器	Fabric / Forge / NeoForge，决定生成代码遵循的规范（Java 版）。
AI 引擎	选真正的大模型服务与 Key，用于需求拆解与内容生成。

🔑 申请 API Key

工作台已默认填入免费服务「智谱 GLM」的 Key，通常打开即用。想换服务或自己申请，按下面来：

智谱 GLM（免费）

打开 open.bigmodel.cn，用手机号注册 / 登录。
进入「API Keys」，点「创建 API Key」，复制 sk-xxx。
无需充值，GLM-4-Flash 可免费调用。

硅基流动（免费）

打开 siliconflow.cn，注册后进入「API 密钥」创建 Key。
新用户送一定量 Token，小模型可长期免费。

拿到 Key 后：到「⚙️ 设置」选对应「服务预设」（会自动填好地址和模型名），把 Key 粘进「API Key」框，再发一条消息即生效。

🎤 语音输入（不经过谷歌）

点输入框旁边的 🎤 就能说话。浏览器自带的语音识别在 Chrome 上要走 Google 的服务器，国内基本连不上，所以这里整条链路是自己走的：麦克风 → 本机采样 → 本机静音检测断句 → 编码成 WAV → 交给国产免费模型识别。录音和断句都在你本机完成，只有「这一段声音」被送出去。

打开 siliconflow.cn 注册，在「API 密钥」里创建一个 Key（免费）。
线上站点：什么都不用配，「⚙️ 设置 → 🎤 语音识别」保持「站点内置语音」即可，点 🎤 直接说（按站点积分扣，去顶部「🎁 积分」领）。
本机/想用自己的 Key：选「硅基流动 SenseVoice」，把 Key 粘进「语音 Key」，点「🔍 测试语音接口」出现 ✅ 就能说话了。

说完停约 0.7 秒会自动断句上屏，不用手动点停止。若上面的 AI Key 本来就是硅基流动的，语音 Key 留空会自动复用。

❓ 常见问题

游戏里找不到模组？确认装了 Fabric Loader，且游戏版本与设置一致；再看 mods 文件夹里 .jar 是否放对。
生成失败 / 报错？多半是 API Key 无效或额度不足，去「设置」换一个 Key 或服务再试。
贴图不好看？点顶部「🎨 AI 贴图」重新生成，或拖入自己的图片让 WAM 按图重画。
网易版版本号怎么填？在「设置 → Minecraft 版本」选「网易基岩版」后填写你客户端当前版本，留空则按兼容模式打包。