跳到主要内容

逛市集

/sa 打开市集主菜单（装了云界面 CloudUI 时是全屏画面，见 云界面市集）。默认是 6 行的箱子菜单：上面 5 行放商品，每页 45 件；最下面一排是功能按钮。

按钮左键右键
分类（书架）打开分类菜单—
类型（漏斗）全部 → 一口价 → 拍卖 → 收购 → 全部回到「全部」
排序（比较器）换下一种排序恢复默认排序
上一页 / 下一页翻页（只有前后还有页时才显示）—
搜索（告示牌）在聊天栏输入关键字清除搜索
上架物品打开上架菜单—
我的上架（你的头）改价、下架、交易记录—
星月邮箱（箱子）打开星月邮箱（买到的、卖出的都寄到这里）；邮箱有附件待领时变成发光的末影箱并显示数量—

市集是即时的：别人上架、成交、出价时，你开着的菜单会自动刷新（每人最多每半秒一次）。分类、类型、排序、搜索条件在你下线前都会保留，下次打开还是一样。

分类​

分类写在 plugins/StarAuction/categories.yml。一件物品可以同时属于好几个分类（附魔的剑同时在「武器」和「附魔」），都不符合的归到「其他」。

categories:
  all:
    name: '<gradient:#9BB8FF:#E7C6FF>✦ 全部</gradient>'
    icon: NETHER_STAR
    slot: 10
  weapons:
    name: '<#FF9B9B>⚔ 武器'
    icon: DIAMOND_SWORD
    slot: 11
    materials: ['*_SWORD', '*_AXE', BOW, CROSSBOW, TRIDENT, MACE, '*ARROW']
  enchanted:
    name: '<#D6A8FF>✧ 附魔'
    icon: ENCHANTED_BOOK
    slot: 14
    enchanted: true
  other:
    name: '<gray>… 其他'
    icon: BUNDLE
    slot: 23
键作用
name显示名称，支持颜色
icon图示材质
slot在分类菜单里的位置；不写就自动排进 menus/categories.yml 的 content-slots
enabledfalse = 暂时停用这个分类
materials物品 ID，支持 * 通配（'*_SWORD'、'RAW_*'）
name-contains名称含有其中一个字（不分大小写）
lore-contains说明含有其中一个字
enchantedtrue = 有附魔（含附魔书）
edibletrue = 可以吃
blocktrue = 方块
customtrue = 其他插件的自定义物品（有 CustomModelData 或插件数据）
  • 条件写几个就要同时符合几个；一个条件都没写的分类不会收任何商品。
  • all（全部）与 other（其他）只能改名称、图示与位置，不能删除。
  • 默认有：全部、武器、防具、工具、附魔、矿物材料、方块、食物、药水、农牧、特殊物品、其他。
  • 商品的分类在上架时决定。改了 categories.yml 后 /sa reload，新上架的商品使用新分类。

分类菜单里每个分类会显示目前有几件商品（按目前的类型与搜索条件计算），目前所在的分类会发光。

排序​

排序说明
最新上架（newest）默认
最早上架（oldest）
单价低 → 高（price-low）一口价与收购单比单价；拍卖比「目前价格 ÷ 数量」
单价高 → 低（price-high）同上
即将结束（ending）
数量多（amount）

默认排序由 config.yml 的 menu.default-sort 决定。

三种方式：

/sa 钻石
/sa search 钻石剑

或在市集左键点 搜索，在聊天栏输入（装了云界面且客户端 1.21.6+ 时是弹出输入框）。关键字最多 40 个字。

搜索会比对：

内容例子
中文物品名钻石、下界合金锭、附魔金苹果
物品 ID（含把下划线换成空格的写法）diamond_sword、diamond sword
自定义名称（改过名的物品）屠龙宝刀
其他插件的物品名称（1.20.5+ 的 item_name 组件，CraftEngine、MMOItems 等常用这种方式命名）那个物品显示的名字
物品说明（lore）绑定、传说
附魔 IDsharpness、mending（附魔书里的附魔也算）
卖家 / 收购方的名字Steve
商品编号#128
  • 不分大小写，颜色会被忽略。
  • 空格分开的多个词要全部符合：钻石 Steve = Steve 卖的钻石类物品。
  • 右键搜索按钮清除；搜索中按钮会变成发光的名牌，显示「搜索「…」」。

中文物品名称​

插件内置了常用物品的中文名称（搜索与云界面画面使用）。想补充或修改，在 plugins/StarAuction/item-names.yml 写同样的格式，会覆盖内置的：

SNIFFER_EGG: '嗅探兽蛋'
NETHERITE_INGOT: '合金锭'

改完 /sa reload。搜索用的文字在上架时保存，所以新名称对之后上架的商品生效。 聊天消息与箱子菜单里的物品名称由客户端翻译，每个玩家看到自己客户端语言的名字，不需要写在这里。

商品的样子​

市集里的每件商品就是物品本身（名称、附魔、说明都保留），下面加上价格、卖家、剩余时间等说明，最后一行是操作提示。外观在 menus/market.yml 的 listing-item，见 菜单。

成交均价​

price-reference-days: 7

每件商品显示「近 7 天成交均价 … / 个」：同一种物品（物品数据完全相同）、同一种货币，在最近 N 天内所有成交的「总金额 ÷ 总数量」。 一口价、拍卖、收购单的成交都算。没有成交记录时不显示这一行；数字每 5 分钟更新一次。设成 0 关闭。

点击商品​

点击别人的商品自己的商品
左键打开购买 / 出价 / 卖给收购单菜单改价（拍卖只有没人出价时；收购单不能改价）
右键同左键下架（连按两次确认）
Shift + 左键一口价：confirm-purchase: false 时直接整批买下；否则同左键同左键
Shift + 右键有 starauction.admin.remove 时：强制下架（连按两次确认，物品与出价寄回各自的星月邮箱）；否则同左键同右键
  • 有 starauction.admin.remove 的人会在每件别人的商品下面多看到一行「Shift+右键 强制下架（退回星月邮箱）」。
  • 点到刚刚卖完、结束或被下架的商品，提示「这件商品已经卖完、结束或被下架了」，菜单自动刷新。
  • 连续点击有 menu.click-cooldown-ms（默认 250 毫秒）的间隔，防止连点。

确认购买​

menu:
  confirm-purchase: true
设定购买菜单市集 Shift + 左键
true（默认）「确认购买」要在 4 秒内按两次；第一次按下时记住单价，卖家在两次点击之间改价就不成交，要重新确认同左键（打开购买菜单）
false按一次就买直接整批买下（价格和市集上显示的不一样时不成交）

不论哪一种，成交时数据库都会再核对一次价格与剩余数量，对不上就不成交、已扣的钱马上退回。拍卖出价与一口价买下一律要按两次。

查看某位玩家的商品​

/sa view Steve

打开只显示 Steve 商品的市集（标题「… · Steve 的商品」），分类按钮换成「返回市集」。对方离线也可以，只要他在连同一个数据库的任何子服上线过。

新商品公告与 Webhook​

notify:
  broadcast-new-listing:
    enabled: false
    min-price: 1000

webhook:
  enabled: false
  url: ''
  events: [list, sold]
  • 全服公告：开启后，总价达到 min-price 的新商品会在聊天栏公告「某某 上架了 … ×N（一口价）… [点击查看]」，点一下打开那件商品。只有有 starauction.notify.broadcast 权限（默认所有人）的玩家会收到；公告只在上架的那个子服发出。
  • Webhook：把 Discord（或兼容的）Webhook 网址填进 url，events 里的 list = 新上架 / 新拍卖 / 新收购单，sold = 每一笔成交（一口价购买、拍卖一口价买下、拍卖到期成交、卖给收购单），会发一个带物品、数量、价格、卖家 / 买家的卡片。发送失败只在控制台警告一次。
最后于 更新