云界面联动

服务器装了 云界面 CloudUI 时，/cs 打开的不再是箱子菜单，而是全屏的商城画面。不用另外设定，装好云界面、重启服务器就会自动启用。

云界面商城：建材商店

画面说明

区域	内容
右上角	前两种可用货币的余额
左边	商店列表（每页 8 个，依 `order` 排序）；下方是出售箱、一键卖出背包、返回主菜单
中间	商品卡片（每页 15 张）：图示、每份数量、名称、买价、回收价或限购 / 库存；特卖中的商品右上角有「-20%」徽章，售罄的显示「已售罄」
右边	选中的商品：买入、回收、每份数量、行情、限购、限售、库存与重置倒数、特卖剩余、背包里有几个；不能购买时显示原因
右下	数量（份数）、合计金额、购买、出售、全部卖出

操作：左键选择商品；右键调整数量 ±10；Shift 或 F 退出。「全部卖出」要按两次确认（4 秒内），避免误卖。

云界面商城：矿物交易所的行情与限售

出售箱与 /sell all 的确认画面仍然是箱子菜单。买卖的规则（价格、限购、背包空间、全有或全无）和箱子菜单完全一样。

启用条件

条件	说明
安装云界面 CloudUI	放进和云商城同一个子服的 `plugins/`；云界面本身需要 1.21.11 与 26.x（目前实测 26.3）的服务端，资源包的发送方式请看云界面自己的说明
`config.yml` 的 `ui`	`auto`（默认）= 装了云界面就用；`cloudui` = 一律用云界面（没装时控制台警告并改用箱子菜单）；`chest` = 一律用箱子菜单。改完 `/cs reload`
这位玩家能显示云界面	由云界面判断：例如拒绝了服务器资源包、基岩版玩家、当下打不开画面时，自动改用箱子菜单

开服时控制台出现下面这行，就代表已经接上：

[CloudShop] 已连接云界面 CloudUI：/cs 打开云界面商城

/cs、/cs <商店>、/cs open <商店> <玩家> 都走同样的判断。

自动安装的文件

第一次连接时，云商城会把画面文件装进云界面的资料夹：

文件	内容
`plugins/CloudUI/screens/cloudshop/cloudshop.yml`	画面布局（元素位置、字体、颜色）
`plugins/CloudUI/images/cloudshop/*.png`	背景、面板、卡片、按钮、徽章等图片

控制台显示「已安装 N 个云界面商城画面文件」代表这次有安装文件。已经存在的文件不会被覆盖，改过的画面在升级后会保留；想恢复默认，删掉对应的文件后重启即可。商店名称、商品名称与说明、货币名称会提供给云界面的字体；/cs reload 后新加的文字也会补上。

修改画面文字

画面上的固定文字可以在 plugins/CloudShop/messages.yml 加一个 cloudui: 段落覆盖，没写的用默认值：

messages.yml
cloudui:
  title: 云商城
  subtitle: 左键选择商品 · 右边调整数量后购买或出售
  buy: 购买 {amount} 个
  sell: 出售 {amount} 个
  sellall: 全部卖出
  sellall-confirm: 再按一次卖出 {amount} 个
  badge-sale: -{percent}%
  shop-sub: 共 {items} 件商品

键	默认
`title` / `subtitle`	云商城 / 左键选择商品 · 右边调整数量后购买或出售
`pick` / `empty`	选择一件商品查看详情 / 这个商店还没有商品
`nav_sellbox` / `nav_sellall` / `nav_main`	出售箱 / 一键卖出背包 / ‹ 返回主菜单
`hint`	左键选择 · 右键数量 ±10 · Shift / F 退出
`buy` / `buy-off` / `sell` / `sellall` / `sellall-confirm`	购买 / 不出售 / 出售 / 全部卖出 / 再按一次卖出（含 `{amount}`）
`cost` / `income`	合计 / 可得（含 `{price}`）
`info-buy` / `info-buy-sale` / `info-sell` / `info-amount`	右侧的买入、特卖买入、回收、每份数量
`info-limit` / `info-sell-limit` / `info-stock` / `info-reset`	限购、限售、库存、重置倒数
`info-trend-up` / `info-trend-down` / `info-sale` / `info-have` / `info-locked`	行情、特卖剩余、背包里有、不能购买的原因
`sub-sell` / `sub-limit` / `sub-stock` / `sub-soldout`	商品卡片的小字
`badge-sale` / `badge-hot`	卡片徽章
`shop-sub` / `shop-sub-rotation` / `shop-sub-sale`	商店标题下方的说明
`free`	价格为 0 时

改完 /cs reload。画面布局（位置、图片）在 plugins/CloudUI/screens/cloudshop/cloudshop.yml，可用的资料键可以用云界面自己的说明查询。

从其他云界面画面打开商店

云商城向云界面注册了一个动作 cloudshop，可以用在任何云界面画面的按钮上：

plugins/CloudUI/screens/<你的画面>.yml
  shop:
    type: button
    # image、hover、x、y、hit 照你原本的按钮
    click:
      left: ['cloudshop: blocks']   # 打开建材商店；只写 'cloudshop:' = 打开商城主画面

改完 /cui reload。也可以用指令动作 command: cs blocks，效果相同。

常见问题

装了云界面，打开的还是箱子菜单？ 依序检查：config.yml 的 ui 是不是 chest、开服时控制台有没有「已连接云界面 CloudUI」、这位玩家有没有载入资源包。没有资源包的玩家一律用箱子菜单。

不想用云界面画面？ 把 config.yml 的 ui 改成 chest，/cs reload。

画面说明​

启用条件​

自动安装的文件​

修改画面文字​

从其他云界面画面打开商店​

常见问题​