使用教程 · 手机 App 与 Java 版模组

从安装到每个功能怎么用,都写在这里了。截图全部来自真实运行界面(Android 端)。

下载 App / 模组 下载 Markdown(离线看 / 转发)
① 安装与登录 ② 首页与模块 ③ 指令库 ④ 指令编辑器与附件 ⑤ 生成器 ⑥ AI 助手 ⑦ 快捷查询 ID ⑧ 积分与看广告 ⑨ 聊天室与好友 ⑩ 五子棋 ⑪ 宝贝回家 ⑫ 账号与安全 ⑬ Java 版模组 ⑭ 常见问题

A手机 App 使用方法

① 安装与登录

  1. 下载区 点「Android → 下载 APK」;也可以直接用网页版(免安装)。
  2. 安装时若提示「不允许安装未知应用」,允许一次即可(只在首次安装时需要)。
  3. 打开 App → 注册账号(用户名 + 邮箱 + 密码,邮箱用于找回密码)或直接登录。
  4. 登录后如果提示「版本过低」,点弹窗里的「下载安装」一键升级即可。
建议顺手在「我的 → 设置」里开一次通知权限,审核结果、审核员私信、公告都能收到推送。
另外「输入法模式」和「悬浮窗」是可选功能,需要在系统设置里给一次权限。

② 首页与模块

首页就是总入口:顶部显示积分与签到,中间是公告横幅,下面是各个功能模块。

  • 长按模块可以隐藏/恢复(不喜欢的功能可以收起来)。
  • 底部 6 个页签:首页 / 指令库 / 广场 / 生成器 / AI / 我的。
  • 每个页面底部都有一条「宝贝回家」公益信息,点一下能看详情。
CyanCodex 首页
首页:模块入口 + 更新公告

③ 指令库:浏览、搜索、复制

  • 顶部页签:平台 / 高质 / 低质 / 我的 / 收藏 / 教程 分类浏览。
  • 搜索框输入关键字(如 tnt)即可检索;命中的关键词会高亮。
  • 卡片上直接点复制图标 → 复制指令全文;也可以点进详情复制单行、看效果图与附件。
  • 自己上传的指令在「我的」里,能看审核状态(待审核 / 已通过 / 已驳回+原因),可编辑、可删除。
指令库
指令库列表
搜索指令
搜索「tnt」的结果

④ 指令编辑器(含附件上传)

  1. 首页 →「指令编辑器」,或者指令库右上角的 + 号。
  2. 每行 = 一个命令块:可「整段粘贴」(自动按换行分块)、逐行编辑、快捷插入 @p/~/^ 等参数,还有命令补全提示。
  3. 「打开指令文件」可以直接导入 TXT(每行一个命令块)。
  4. 选中一行后还能设置命令方块属性:方块类型(脉冲/连锁/循环/聊天栏)、连锁模式、红石控制、延迟刻。
  5. 附件:可以添加 txt / json / mcfunction / 图片 / zip / mcpack 等文件(最多 5 个,单个 ≤6MB、合计 ≤8MB);也可以只发附件、指令内容留空——有些作者就是用文件发指令的。
  6. 填标题后点「上传到指令库」提交审核;已上传的点「更新到指令库」可编辑,也能在这里增删附件。
附件里的文字内容同样会被审核(比如文件里写 /op 某某 会被直接驳回),所以不用担心有人用文件绕过审核。
指令编辑器附件区
编辑器的附件区(可只发附件)

⑤ 生成器(不用记语法)

  • T显生成器:计分板 / 标题,输入文字直接出 titleraw 指令。
  • 穷举:批量生成不同数值的指令。
  • 滚动字幕:公告、字幕滚动效果。
  • 音乐生成器:命令方块音乐(note.* 音效)。
  • 生成结果可以一键复制,也能存进「生成历史」下次接着用。
生成器
生成器:T显 / 穷举 / 字幕 / 音乐

⑥ AI 助手

  • 直接描述需求即可,例如「给我一个钻石剑带锋利 5 的指令」「做个倒计时计分板」。
  • 按量计费:基础 5 积分 + 按 Tokens 计费,顶部能看到余额与本次消耗。
  • AI 内置了整套基岩版物品表(7977 条),所以它给的 ID 是准的,不会瞎编;你也可以用「快捷查询 ID」自己核对。
  • 常见问题会命中「社区经验库」直接秒答,不消耗积分;每条回答都能点「有用 / 没用」帮它变准。
积分不够时:每日签到、看公益广告都能拿积分(见第 ⑧ 节)。
AI 助手
AI 助手对话

⑦ 快捷查询 ID

  1. 入口:首页「快捷查询ID」、我的、每日签到页,以及指令编辑器右上角的搜索图标。
  2. 输入中文(钻石剑、锋利、铜粒…)或英文 ID(copper_nugget)→ 直接出结果。
  3. 点结果里的 ID 即可复制;上方可以按分类筛选(物品 / 方块 / 实体 / 附魔 / 药水效果 / 配方…)。

一共 7977 条基岩版参考数据,找不到的可以换个说法,或者直接用 AI 问。

快捷查询 ID
输入 diamond_sword → 钻石剑

⑧ 积分:签到 / 看广告 / 转账

  • 每日签到:基础 +20,连续签到每天额外 +5(封顶 +50),断签重新累计。
  • 看广告得积分:完整看完一条央视公益广告 +50 积分,每天最多 20 次。必须看完才能领,看一半不给。
  • 积分转账:转给好友,手续费 20%。
  • 积分明细:每一笔增加/消耗都有记录。

页面:我的 → 每日签到 / 看广告得积分 / 积分明细 / 积分转账。

看广告得积分
看广告得积分(每天 20 次)

⑨ 聊天室、好友与广场

  • 聊天室:首页「聊天室」进入,实时交流指令;长按别人的消息可以举报,被别人举报的会被 AI + 人工处理。
  • 好友:加好友、私聊;消息里有违规内容同样可举报。
  • 广场:看最新的指令与评论动态;指令详情里能评论、点赞、收藏。
  • 聊天室里点别人头像可以进他的主页,看他上传的指令。
聊天室
聊天室(长按消息可举报)

⑩ 五子棋(内置小游戏)

  • 四种玩法:人机对战(简单 / 普通 / 困难 / 老叟戏顽童 / 顽童宗师)、匹配对手房间大厅(按房间号加入、踢人、观战)、AI 观战(两个 AI 自动对弈,可调速、可分别设置黑白强度)。
  • 高难度 AI 会「边下边嘲讽」,还会发动【神之一手】抢走你的必赢棋。
  • 计分板和标题相关的玩法都能在「生成器」里做成指令。
五子棋
五子棋(人机 / 匹配 / 房间 / 观战)

⑪ 宝贝回家(公益)

  • 每个页面底部都有一条公益信息条,轮播走失儿童的寻亲信息,点「查看」进入列表。
  • 点开某一条可以看:姓名 / 性别 / 走失时间地点 / 体貌特征 / 官方联系方式,另外可以一键分享拨打 110
  • 数据来自「宝贝回家」寻子网,仅用于公益传播;权威信息以警方发布为准
如果你看到疑似走失、被拐儿童,请第一时间拨 110,不要自行处置,也不要在网上发布未经核实的信息。
宝贝回家
宝贝回家公益页

⑫ 个人中心与账号安全

  • 「我的」页面可以改头像、昵称、性别,查看积分与 AI 解锁状态。
  • 修改密码后,其它设备上的旧登录会立即失效;退出登录会同时注销服务器上的令牌。
  • 可以绑定/更换邮箱,开启两步验证(开启前需要先输入当前密码)。
  • 还有:站内信、意见申诉(有问题、有建议都能提,我们会看)。
个人中心
我的:积分、设置、安全

BJava 版(Fabric 模组)使用方法

① 先选对包

你的游戏版本下载哪个额外要求
1.20.1 – 1.21.81.20.1–1.21.8 通用包(一个包覆盖中间所有版本)Fabric Loader + Fabric API(对应版本)
26.2(最新版)26.2 包需要 Java 25;Fabric API 26.2 版

下载地址就在官网下载区(Java 版 · 模组 / Java 版 · 26.2)。

为什么是两个包:Minecraft 从 26.1 起官方取消了代码混淆,Fabric 也随之换了映射体系,所以 26.x 与 1.21.x 及以前不可能合成同一个 jar——这是平台限制,不是我们偷懒。

② 安装(3 步)

  1. 用官方安装器给对应版本装一次 Fabric Loaderfabricmc.net/use/installer,装完启动一次游戏,会生成 .minecraft/mods 文件夹。
  2. 下载 Fabric API(对应版本)丢进 mods,再下载本模组的 jar 丢进同一个文件夹。
    参考版本:1.20.1 用 0.92.12+1.20.1;1.21.8 用 0.136.1+1.21.8;26.2 用 0.160.0+26.2
  3. 用 Fabric 启动器打开游戏。纯客户端模组,服务器不用装

③ 游戏内怎么用

进游戏后按 K 打开 / 关闭 CyanCodex 界面。顶部页签:

  • 指令库:搜指令、翻页,点行选中,再点「复制」或「执行」。
  • 生成器:T显计分板 / 穷举 / 滚动字幕 / 音乐 / T显 JSON,输出的是 Java 版语法/title @a title {"text":...}/playsound minecraft:block.note_block.harp …),和手机端基岩版语法不同,这点别搞混。
  • AI 助手:和手机上同一个 AI,直接问它要指令。
  • 收藏:存自己喜欢的指令;设置:填接口地址与 API 密钥。
操作说明
K打开 / 关闭界面
点列表行1.20.1~1.21.8 版:选中该行;26.2 版:直接复制
复制复制到剪贴板,切回游戏 Ctrl + V 粘进聊天框
执行以你的身份直接执行该指令(需要 OP 权限
收藏 / 刷新 / ◀ ▶收藏当前行 / 重新拉取 / 翻屏

④ 配置 API 密钥(用生成器和 AI 才需要)

  1. 手机上打开 App →「我的 → 开发者/API」(或在网页版开发者平台)创建一把 API 密钥,默认每天 2000 次。
  2. 回到游戏按 K设置 页签 → 填 接口地址(默认 https://app.blueworkshop.top)和 API 密钥 → 点「保存并测试」。
  3. 底部显示 今日剩余 xxxx / 2000 就说明通了。

配置会写到 .minecraft/config/cyancodex.json(密钥只存在你本机)。

指令库是公开接口,不填密钥也能用;只有生成器和 AI 需要密钥。AI 与生成器共用同一把密钥的每日额度。

⑤ 卸载 / 出问题怎么办

  • 卸载:删掉 mods 里的 jar 即可,游戏本体不受影响(模组不修改游戏文件、不联机注入)。
  • 界面打不开:先确认 Fabric Loader + Fabric API 都装了、版本对得上;再看 .minecraft/logs/latest.log 有没有报错。
  • 提示版本不匹配:1.21.9 ~ 26.1 之间暂时没有包(映射体系刚换),26.2 用 26.2 包,其余用通用包。
  • 生成器/AI 报 401:密钥没填对或额度用完,重新创建一把即可。

C常见问题

App 装不上 / 提示「不允许安装未知应用」

这是安卓的安全限制:允许一次「安装未知应用」权限就行。下载的 APK 请从官网或 App 内更新获取,别用第三方渠道的包。

积分怎么来?

每日签到(+20 起,连签更多)、看公益广告(每次 +50,每天最多 20 次)、活动奖励、好友转账(手续费 20%)。积分用于 AI 按量计费等场景。

上传的指令多久能通过?

工作日有 AI 自动审核,通常几分钟内就有结果;被驳回会写明原因,改完重新提交即可。周末的 AI 自动审核需要开发者邮件授权后才开启。

为什么有的指令要积分才能看?

那是作者设置的「付费指令」:支付对应积分后即可查看。积分直接给作者,平台不收。

Java 版和手机端的指令能通用吗?

语法不同:手机端是基岩版(titleraw / note.harp / 计分板 dummy),Java 版模组输出的是 Java 语法(title / minecraft:block.note_block.*)。两边都会按各自版本生成,复制时注意别混用。

换手机后数据还在吗?

在。账号、积分、上传的指令、聊天记录都在服务器上,登录同一个账号即可;只有「快捷指令」等本机设置需要重新加。

没找到答案?App 里「我的 → 意见申诉」直接提,或加 QQ 群 1065025874。
也可以 下载这份教程的 Markdown 版本 存到本地。