云界面市集

服务器装了 云界面 CloudUI 时，玩家输入 /sa 打开的不再是箱子菜单，而是一组全屏的市集画面：市集、上架物品、我的上架、交易记录四个分页，用左边的一排分页切换。不用另外设置，装好云界面就会自动启用；云界面之后才安装、更新或重载，也会自动接上，不需要重启。

启用条件

条件	说明
安装云界面 CloudUI	连接成功时控制台显示「检测到云界面 CloudUI：市集将使用云界面画面（无法显示的玩家仍使用箱子菜单）」
`config.yml` 的 `menu.cloudui: true`	默认就是 `true`；改成 `false` 再 `/sa reload` 则一律使用箱子菜单
授权已验证	授权还没通过时 `/sa` 本来就不能用

云界面被停用时，控制台显示「云界面 CloudUI 已停用：市集改用箱子菜单」，玩家自动改用箱子菜单。

第一次连接时，星月市集会把画面文件装进云界面的资料夹：

文件	内容
`plugins/CloudUI/screens/starauction/starauction_market.yml`	市集（画面 ID `starauction_market`）
`plugins/CloudUI/screens/starauction/starauction_sell.yml`	上架物品（`starauction_sell`）
`plugins/CloudUI/screens/starauction/starauction_mine.yml`	我的上架（`starauction_mine`）
`plugins/CloudUI/screens/starauction/starauction_history.yml`	交易记录（`starauction_history`）
`plugins/CloudUI/images/market/*.png`	背景、面板、分页、分类、商品卡片、列表行、按钮、背包格、分页箭头、提示框等图片

画布都是 1920 × 1080。已经存在的文件不会被覆盖，你改过的画面在升级后会保留。想恢复默认，删掉对应的文件后重新连接（重启或 /sa reload）即可重新安装。

从 1.0.x 升级

1.0.x 的单一画面 screens/starauction/starauction.yml 与 images/starauction/ 已经不再使用，新的四个画面文件会自动装上。旧文件留着不影响，不需要的话可以删掉。

哪些地方会打开云界面

操作	打开
`/sa`、`/sa open`	云界面的「市集」分页
其他插件调用 `StarAuctionAPI.open(player)`	云界面的「市集」分页
画面左边的「上架物品」「我的上架」「交易记录」	切换到对应的云界面分页（原地切换，不会重新淡入淡出）
画面左边的「‹ 返回主菜单」	打开云界面的 `main` 画面（例如服务器的主菜单）；没有这个画面时直接关闭
`/sa search`、`/sa <关键字>`、`/sa view <玩家>`	云界面「市集」分页，带上搜索关键字 / 只显示那位玩家的商品（1.2.0 起）
`/sa list`、`/sa mine`、`/sa history`	云界面「上架物品」「我的上架」「交易记录」分页（1.2.0 起）
`/sa stash`	星月邮箱
聊天栏的「[点击查看]」「[再出价]」（`/starauction open <编号>`）	云界面「市集」分页并选中那件商品（自己的商品打开「我的上架」）；不能显示云界面时是那件商品的箱子菜单

什么时候改用箱子菜单

以下玩家会自动打开原本的箱子菜单市集，功能完全一样：

云界面判断无法显示画面的玩家：例如拒绝了服务器资源包的玩家、基岩版玩家；
当下打不开云界面画面时（例如云界面要求玩家站在地面上，而玩家正在半空中）。

四个分页共用的部分

区域	说明
左上	标题「星月市集」，下面是默认货币的余额，例如「余额 1,250 金币」
右上小卡片	「我的上架」上架中的数量（星月邮箱从服务器的主选单或 `/sm` 打开，市集画面里不再放邮箱分页与数字）
左边一排分页	市集 / 上架物品 / 我的上架 / 交易记录 / ‹ 返回主菜单；目前所在的分页高亮。没有任何上架权限（`sell`、`auction`、`order` 都没有）时不显示「上架物品」
最下面一行	操作提示，例如「左键选择 · 右键数量 ±10 · Shift / F 退出」

画面开着的时候，别人上架、成交、出价，画面会自动刷新（每人最多每秒两次）。

市集

上方：类型、搜索、排序

区域	左键	右键
类型分页	全部 / 一口价 / 拍卖 / 收购	—
搜索框	输入关键字（规则同箱子菜单的搜索）	清除搜索
排序	换下一种排序	恢复默认排序

左边：分类

categories.yml 的前 10 个分类（全部、各分类、其他），显示图示、名称与商品数；目前所在的分类高亮。

中间：商品卡片

每页 12 张卡片（4 × 3），下方有 ‹ › 与页码。每张卡片显示：

内容	说明
物品图示	物品本身；鼠标移上去显示物品名称、说明、附魔与 `#编号`
名称	有附魔的是蓝色、自定义名称的物品是紫色
价格	可以零买的一口价显示「单价 /个」；整批的一口价显示总价；拍卖显示目前价格；收购单显示「单价 /个」
卖家 · 剩余时间
类型标签	一口价（绿）、拍卖（金）、收购（蓝）
数量	「×64」

选中的卡片与自己的商品有不同的外框。左键点卡片选中它，在右边显示。打开画面时自动选中第一件商品。

右边：详情与操作

区域	说明
名称与类型	例如「钻石一口价 · #12」
资讯（最多 9 行）	卖家 / 收购方、数量；一口价的单价、总价、「整组出售」；拍卖的起拍价、目前出价、最高出价者、最低加价到、一口价、「设有保留价」；收购单的单价与「你有 N 个」；剩余时间（不到 10 分钟时变红）；近 N 天均价；自己的商品显示「这是你的商品」
数量	− / + 调整（右键一次 ±10）；可以零买的一口价与收购单才显示
合计	一口价显示「合计 …」；收购单显示「可得 …（税 …）」
主按钮	一口价「购买 N 个」、拍卖「出价 …」（最低出价）、收购单「卖给他 N 个」、自己的商品「下架」
次按钮	拍卖「自订出价」；自己的一口价 / 还没人出价的拍卖「改价」
一口价买下	拍卖设有一口价时显示

买到的物品、拍得的物品、卖给收购单的收入都会寄到星月邮箱，从服务器的主选单或 /sm 打开星月邮箱领取。

二次确认会锁定金额

购买（confirm-purchase: true 时）、出价、一口价买下、下架都要按两次：第一次按下，按钮文字变成「确认支付 …」「确认出价 …」「确认买下 …」「再按一次下架」，4 秒内再按一次才执行。

第一次按下时会记住是哪一件商品、什么价格 / 出价。如果在两次点击之间卖家改了价、或有人先出了价，第二次点击不会执行，而是用新的金额重新等待确认（按钮上显示新的金额），你看清楚再按一次才会成交。卖给收购单只需要按一次。

上架物品

不用先把物品拿在手上：画面左边列出你的背包（上面三排）与快捷栏（下面一排），点一下要卖的物品，右边设置方式、数量、价格与时长，按两次确认就上架。

区域	左键	右键
背包 / 快捷栏的物品	选这件物品（鼠标移上去显示名称与说明）。换成另一种物品时价格会清空；同一种物品换一格时保留	同左键
方式	一口价 / 拍卖 / 收购；服务器关闭的方式与没有权限的方式不显示	—
数量 − / +	±1	±10
全部	数量设成背包里这种物品的总数（不超过这种方式的 `max-amount`；收购单直接设成 `max-amount`）	同左键
价格	一口价与收购单输入单价，拍卖输入起拍价（整批），见下方的输入方式	同左键
一口价 / 保留价	只有拍卖显示，输入 `0` = 不设置	同左键
允许零买	只有一口价显示，开 / 关切换；默认值是 `listing.sell.allow-partial`	同左键
时长	换成下一个可选时长（`config.yml` 里那种方式的 `durations`）	换成上一个
上架按钮	「上架一口价」「发起拍卖」「发布收购单」，按一次变成「再按一次确认」，4 秒内再按一次才上架	同左键

右下会显示上架手续费，以及一口价「全部卖出约可得 …」（扣掉交易税后）、拍卖「成交后扣交易税 N%」、收购单「收购总额 …」。还没选物品或还没设价格时，按钮显示「先选一件物品」「先设置价格」，按了没有作用。

物品确认上架后才会离开背包。按下确认时会再检查一次背包里还有没有那么多，不够时提示并把数量调成现有的数量，不会上架。
收购单只用选的物品当样本，不会从背包拿走。
用的是 currencies.default 的默认货币；想用别的货币上架请用指令 /sa sell … <货币> 或箱子上架菜单。
价格、手续费、上限、黑名单等规则和指令上架完全一样，失败时物品留在背包（或退回背包）。
上架成功后自动切换到「我的上架」。过期没卖出的物品、下架的物品、被超过的出价都会寄到星月邮箱。

我的上架

列出你上架中的商品，每页 9 行，下方 ‹ › 翻页；标题旁显示「共 N 件 · 下架的物品会寄到星月邮箱」。每一行显示：

内容	说明
物品与名称	「钻石 ×64」；鼠标移到物品上显示名称与说明
资讯	类型 · `#编号` · 剩余时间
右边	一口价 / 收购单的单价；拍卖还没人出价时显示起拍价，有人出价时显示最高出价、出价次数与最高出价者
「下架」按钮	按一次变成「确认下架」，4 秒内再按一次才下架，剩下的物品 / 预付款寄到星月邮箱。有人出价的拍卖不显示
「改价」按钮	一口价与还没人出价的拍卖才显示，弹出输入框输入新价格（拍卖是新的起拍价）；调高价格时补交手续费差额，规则同改价

交易记录

你最近 200 笔买入与卖出，每页 9 行，标题旁显示「最近 N 笔」。每次打开（或资料超过 10 秒）会重新读取。

内容	说明
物品与名称	成交的物品与数量
资讯	「卖给某某」或「向某某购买」· 类型 · 时间（`MM-dd HH:mm`）
右边	卖出显示绿色的「+ 实收金额」（已扣税）与「税 …」；买入显示红色的「- 花费」与「单价 …」

输入金额与关键字

搜索、自订出价、改价、上架价格需要输入文字时：

云界面支持弹出输入框时（客户端 1.21.6+），直接在画面上弹出输入框；
否则关闭画面，在聊天栏输入（输入 取消 取消），输入完自动回到市集画面（上架物品分页里已经选好的物品与设置会保留）。

箱子菜单里的搜索、出价、改价也会使用同一个弹出输入框；箱子上架菜单因为里面放着玩家的物品，一律使用聊天栏输入。

修改画面文字

画面上的文字可以在 messages.yml 的 cloudui 段修改（文件里没写的使用内置默认值）。默认文件只列了三个，需要时自己加上其他键，改完 /sa reload：

cloudui:
  title: '星月市集'
  empty: '这里还没有商品'
  pick: '选择一件商品查看详情'
  nav_mail: '我的邮箱'
  sell_go: '上架'

共用与市集

键	默认
`title`	星月市集
`balance`	余额 `{balance}`
`nav_market` / `nav_sell` / `nav_mine` / `nav_history` / `nav_main`	市集 / 上架物品 / 我的上架 / 交易记录 / ‹ 返回主菜单（`nav_mail` 仍可用，默认画面不再使用）
`chip_mine` / `chip_mail`	我的上架 / 邮箱待领取（`chip_mail` 默认画面不再使用）
`hint_market`	左键选择 · 右键数量 ±10 · Shift / F 退出
`type-all` / `type-sell` / `type-auction` / `type-buy`	全部 / 一口价 / 拍卖 / 收购
`search` / `search-empty`	搜索：`{keyword}` / 搜索物品、玩家……
`sort`	`{sort}`
`empty` / `pick`	这里还没有商品 / 选择一件商品查看详情
`buy` / `buy-confirm`	购买 `{qty}` 个 / 确认支付 `{cost}`
`bid` / `bid-confirm` / `custom-bid`	出价 `{bid}` / 确认出价 `{bid}` / 自订出价
`buyout` / `buyout-confirm`	一口价 `{buyout}` / 确认买下 `{buyout}`
`fill`	卖给他 `{qty}` 个
`cancel` / `cancel-confirm` / `reprice`	下架 / 再按一次下架 / 改价
`cost` / `income`	合计 `{cost}` / 可得 `{income}`（税 `{tax}`）
`seller` / `buyer` / `amount` / `unit` / `total`	卖家 `{seller}` / 收购方 `{seller}` / 数量 `{amount}` / 单价 `{unit}` / 总价 `{total}`
`start` / `current` / `top` / `min-bid`	起拍 `{start}` / 当前 `{total}`（`{bids}` 次出价）/ 最高出价 `{bidder}` / 最低加价到 `{min_bid}`
`buyout-line` / `reserve`	一口价 `{buyout}` / 设有保留价
`time` / `avg` / `have`	剩余 `{time}` / 近 `{days}` 天均价 `{avg}` / 个 / 你有 `{have}` 个
`partial-no` / `own`	整组出售 / 这是你的商品
`mine` / `stash` / `history` / `sell`	我的上架 `{count}` / 星月邮箱 `{count}` / 交易记录 / 上架物品（变量 `mine_label`、`stash_label` 用，默认画面已改用左边的分页）

上架物品

键	默认
`sell_pick` / `sell_pick_sub`	选择要上架的物品 / 点一下背包里的物品，右边设置价格
`sell_tip1` / `sell_tip2` / `sell_tip3`	物品确认上架后才会离开背包 / 过期、下架、被超过的出价都会寄到星月邮箱 / 收购单只用选的物品当样本，不会拿走
`sell_none` / `sell_none_sub`	还没有选物品 / 点左边背包里的物品
`sell_have` / `sell_buy_note`	背包里有 `{n}` 个 / 收购：只当样本，不会拿走
`sell_k_type` / `sell_k_qty` / `sell_k_price` / `sell_k_extra` / `sell_k_time`	方式 / 数量 / 价格 / 选项 / 时长
`sell_max`	全部
`sell_unit` / `sell_start` / `sell_unit_v` / `sell_start_v`	设置单价… / 设置起拍价… / 单价 `{v}` / 起拍 `{v}`
`sell_total` / `sell_lot`	合计 `{v}` / 整批起拍
`sell_buyout` / `sell_buyout_v` / `sell_reserve` / `sell_reserve_v`	一口价（可不设）/ 一口价 `{v}` / 保留价（可不设）/ 保留价 `{v}`
`sell_partial_on` / `sell_partial_off`	允许零买：开 / 允许零买：关
`sell_time` / `sell_fee`	时长 `{t}` / 上架手续费 `{v}`
`sell_income` / `sell_auction_tax` / `sell_order_pay`	全部卖出约可得 `{v}` / 成交后扣交易税 `{p}`% / 收购总额 `{v}`
`sell_note`	过期没卖出的物品会寄回星月邮箱
`sell_need_item` / `sell_need_price`	先选一件物品 / 先设置价格
`sell_go` / `sell_go_auction` / `sell_go_order` / `sell_confirm`	上架一口价 / 发起拍卖 / 发布收购单 / 再按一次确认
`hint_sell`	左键选物品 · 右键数量 ±10 · Shift / F 退出

我的上架与交易记录

键	默认
`mine_title` / `mine_sub` / `mine_empty`	我的上架 / 共 `{n}` 件 · 下架的物品会寄到星月邮箱 / 目前没有上架的商品
`mine_left` / `mine_unit` / `mine_start` / `mine_bid` / `mine_bids` / `mine_total`	剩余 `{t}` / 单价 `{v}` / 起拍 `{v}` / 最高出价 `{v}` / `{n}` 次出价 / 总价 `{v}`
`mine_cancel` / `mine_cancel_confirm` / `mine_reprice`	下架 / 确认下架 / 改价
`hint_mine`	下架要按两次 · Shift / F 退出
`history_title` / `history_sub` / `history_empty` / `loading`	交易记录 / 最近 `{n}` 笔 / 还没有交易记录 / 读取中…
`hist_sold` / `hist_bought` / `hist_tax` / `hist_unit`	卖给 `{who}` / 向 `{who}` 购买 / 税 `{v}` / 单价 `{v}`
`hint_history`	Shift / F 退出

画面使用的字体会自动包含这些文字、分类名称、物品中文名与商品名称里的字。

修改画面外观

画面的位置、大小、字体、颜色与图片都在 plugins/CloudUI/screens/starauction/ 的四个文件与 plugins/CloudUI/images/market/，修改方式请参考云界面的说明。四个画面属于同一组（transition.family: starauction），互相切换时外框原地更新、不会淡出淡入；自己改外框时请让四个文件保持一致。

画面里的 {键} 由星月市集即时提供，在云界面编辑器的「变量」分页可以看到市集画面每个键的说明，例如：

键	内容
`lang.<键>`	上面 `cloudui` 段的文字
`balance`	玩家余额（默认货币）
`mine_count` / `mail_count`	右上小卡片：上架中的数量 / 邮箱待领取（`mail_count` 默认画面不再使用，自己做画面时可以用）
`nav_<分页>` / `nav_<分页>_color`	左边分页的状态（目前所在 = `active`，没有权限 = `hidden`）与文字颜色；分页是 `market`、`sell`、`mine`、`history`、`mail`、`main`
`hint`	最下面一行的操作提示
`types.N.state` / `types.N.name`	类型分页；目前所在 = `active`
`cats.N.state` / `name` / `count` / `icon`	左侧分类（最多 10 个）；目前所在 = `active`，没有 = `hidden`
`search_label` / `sort_label`	搜索框与排序按钮的文字
`cards.N.frame`	卡片外观：`active` 选中 / `own` 自己的 / `empty` 空格 / 空 = 一般
`cards.N.icon` / `name` / `namecolor` / `price` / `sub` / `badge` / `badgecolor` / `amount`	卡片内容
`page_text` / `page` / `pages` / `prev` / `next`	分页（「1 / 3」）；没有上一页 / 下一页时 `prev` / `next` = `hidden`
`has_sel` / `no_sel`	右侧是否选中了商品
`sel_icon` / `sel_name` / `sel_namecolor` / `sel_type`	选中商品
`info.N.line` / `info.N.color`	选中商品的资讯（每行）
`qty_state` / `qty` / `minus` / `plus`	数量调整（不能调整时 `hidden`）
`sel_cost`	合计金额 / 可得金额
`action_state` / `action_label`	主按钮：购买 / 出价 / 卖给他 / 下架
`action2_state` / `action2_label`	次按钮：自订出价 / 改价
`action3_state` / `action3_label`	一口价买下
`mine_label` / `stash_label` / `stash_state`	「我的上架」「星月邮箱」按钮文字；邮箱有东西待领时 `stash_state` = `full`（自己做按钮时可以用）

上架物品、我的上架、交易记录分页用到的键：

分页	键
上架物品	`inv.N.` / `hot.N.`（背包 27 格 / 快捷栏 9 格：`icon`、`count`、`frame` 选中 = `active`、`hit` 空格 = `hidden`）、`stype.N.state` / `stype.N.name`（方式）、`draft_icon` / `draft_name` / `draft_namecolor` / `draft_sub` / `draft_cat` / `draft_qty`、`q_minus` / `q_plus`、`price_state` / `price_label` / `price_note`、`extra_state` / `buyout_label` / `reserve_label`、`partial_state` / `partial_label`、`time_label`、`fee_line` / `income_line`、`confirm_state`（`disabled` / `primary` / `confirm`）/ `confirm_label`
我的上架	`my.N.*`（每行：`icon`、`name`、`namecolor`、`info`、`right`、`right2`、`right2color`、`frame`、`hit`、`a_state` / `a_label` 下架按钮、`b_state` / `b_label` 改价按钮）、`mine_sub`、`empty`
交易记录	`tr.N.*`（每行：`icon`、`name`、`info`、`right`、`rightcolor`、`right2`、`frame`）、`history_sub`、`empty`

启用条件​

哪些地方会打开云界面​

什么时候改用箱子菜单​

四个分页共用的部分​

市集​

上方：类型、搜索、排序​

左边：分类​

中间：商品卡片​

右边：详情与操作​

二次确认会锁定金额​

上架物品​

我的上架​

交易记录​

输入金额与关键字​

修改画面文字​

修改画面外观​