messages.yml

plugins/StarAuction/messages.yml 是星月市集所有的提示文字：聊天栏消息、跨服通知、寄到星月邮箱的邮件、输入提示、菜单里的名称、记录格式、帮助列表、云界面画面文字。改完执行 /sa reload 生效。

写法

prefix: '<gradient:#9BB8FF:#E7C6FF>✦ 星月市集</gradient> <dark_gray>» '
bought: '<green>已购买 <white>{item} ×{amount}</white><green>，花费 {cost}'

• 颜色：&a 这种颜色代码、&#RRGGBB 十六进制颜色、MiniMessage 标签（<gradient:#a:#b>…</gradient>、<click:…>、<hover:…>、<#FF8800>）都可以，也可以混着写。
• 前缀：聊天消息前面会自动加上 prefix。
• 关闭某一句：写成 ''（空字符串）就不会发送那一句。默认文件里 news.returned、news.overflow、join-stash、mail-opened 就是关闭的。
• 变量：{item}、{amount} 这种大括号变量会被替换，每一句能用哪些变量见默认文件的写法（下面的表格也有列出常用的）。
• 物品名称会翻译：{item} 是可翻译的物品名称，每个玩家看到自己客户端语言的名字（改过名或带 item_name 的物品显示那个名字）。邮件（mail 段）是例外：邮件会存起来、也可能显示在服务器画出来的云界面画面上，所以 {item} 一律换成物品的中文名。
• 缺少的键：文件里没有的键会自动使用插件内置的默认文字，升级后不会出现「Missing message」；想改那一句时再把键加进来。

文字里有 <、&、# 开头时

YAML 里以这些字符开头的文字要整段加单引号：bought: '<green>已购买…'。文字里本身有单引号时写两个 ''（例如 <click:run_command:''/starauction stash''>）。

键的分组

通用

键	用途
prefix	聊天消息前缀
locked	尚未授权
loading	市集正在载入
error	操作失败（已退回扣除的物品与货币）
busy	上一个操作还在处理
no-permission / players-only	没有权限 / 只有玩家可以使用
disabled-world / creative	这个世界不能交易 / 创造模式不能交易
player-not-found	找不到玩家（{player}）
reloaded	/sa reload 完成
version / version-short	/sa version：管理员看到的详细版本（{version} {edition} {db} {server} {listings}）/ 一般玩家看到的版本

上架

键	用途
no-item / invalid-amount / invalid-price	手上没有物品 / 数量不正确 / 价格不正确
too-many	一笔最多几个（{max}）
not-enough-items	背包里不够（{amount}）
no-currency / currency-no-permission	货币不能用 / 没有那种货币的权限
type-disabled	服务器没有开放这种交易方式
blocked	黑名单物品（{reason}）
cooldown	上架太快
price-too-low / price-too-high	单价低于下限（{min}）/ 高于上限（{max}）
price-too-big	金额超过货币的单笔上限（「金额太大了」）
partial-off	单价低于货币最小单位，改为只能整批购买（{min}）
buyout-too-low / buyout-disabled / reserve-disabled	一口价低于起拍价 / 不能设一口价 / 不能设保留价
limit-sell / limit-auction / limit-buy	达到一口价 / 拍卖 / 收购单上限（{max}）
fee-no-money / order-no-money	手续费不足 / 收购单预付款不足（{cost}）
mixed-items / need-price	上架菜单里放了不同的物品 / 还没设价格
listed-sell / listed-auction / listed-buy	上架成功（{item} {amount} {price} {unit} {time} {id}）

交易

键	用途
gone	商品已经卖完、结束或被下架
changed	价格或出价刚刚变动了，请确认后再试
not-enough-left	剩下的数量不够
own-listing / own-listing-hint	不能买自己的商品 / 点到自己的商品时的提示
no-money	余额不足（{cost} {balance}）
bought / bought-out	购买成功 / 用一口价买下拍卖（{item} {amount} {cost}）
bid-too-low / already-top / bid-placed / anti-snipe	出价太低（{min}）/ 已经是最高出价者 / 出价成功（{bid} {item} {time}）/ 拍卖时间已延长
fill-not-enough / filled	背包里没有足够符合的物品 / 卖给收购单成功（{item} {amount} {money} {buyer}）
broken-item / broken-item-name	物品数据在本服读不出来 / 这种商品在菜单里显示的名称
cancelled / cancel-has-bids / confirm-cancel	下架成功 / 有人出价不能下架 / 再按一次确认下架
confirm-admin-remove / admin-removed / admin-removed-all	强制下架的确认 / 完成 / 下架某位玩家全部商品（{owner} {count}）
not-yours	不是你的商品
repriced / reprice-fee	改价成功（{price}）/ 补交手续费（{fee}）

待寄 / 星月邮箱

键	用途
mail-unavailable	/sa stash 或菜单按钮打开邮箱时，星月邮箱现在不能用（东西还在待寄清单里，恢复后自动寄出）
mail-opened	成功打开星月邮箱时的提示（默认关闭）
overflow	上架失败退回物品时背包放不下，剩下的寄到星月邮箱（{amount}）

1.1.0 起领取由星月邮箱负责，claimed、claim-dead、inventory-full、stash-full-inventory、claim-no-currency、overflow-money、join-stash 已经不再使用（留在文件里也没关系）；领取时的提示在星月邮箱的 messages.yml。

邮件（mail）

市集寄到 星月邮箱 的每一种邮件，各有一个标题 title 与正文 content（可以写多行）：

mail:
  bought:   {title: '购买成功：{item}', content: ['你在星月市集买下了 {item} ×{amount}。', '商品编号 #{id}，请领取附件。']}
  sold:     {title: '卖出收入：{money}', content: ['{player} 买下了你的 {item} ×{amount}。', '扣税后的收入 {money} 在附件里。']}

键	什么时候寄	附件
mail.bought	买到一口价商品	物品
mail.won	拍得物品（含一口价买下）	物品
mail.sold	你的东西卖出（一口价、拍卖、卖给收购单）	扣税后的收入
mail.filled	收购单收到货	物品
mail.outbid	出价被超过	冻结的出价
mail.bidback	拍卖结束或被取消，没有成交	冻结的出价
mail.expired	商品到期	剩下的物品 / 没用完的预付款
mail.returned	自己下架	同上
mail.removed	被管理员下架	同上
mail.refund	退款	货币
mail.overflow	背包放不下的物品	物品
mail.broken	物品在当时的子服读不出来，原样寄回	物品
mail.other	其他（找不到对应的键时也用它）	—

变量：{item} 物品名称（中文名）、{amount} 数量、{money} 金额、{player} 交易对象（买家 / 卖家）、{id} 商品编号。 没有的变量会变成空白，例如退款邮件没有 {item}。文字在寄出时套用，已经寄出的邮件不会因为改了文件而改变。 寄件人名称在 config.yml 的 mail.sender，见 config.yml。

跨服通知（news）

在任何子服发生的事都会通知到玩家所在的子服，每件事只通知一次；离线期间发生的在上线时通知。

键	什么时候	变量
news.sold	你的东西卖出了	{player} 买家、{item}、{amount}、{money} 收入
news.outbid	你的出价被超过（可点击「再出价」）	{item}、{money}、{id}
news.bidback	拍卖结束或取消没有成交，出价退回	{item}、{money}
news.won	拍得物品（已寄到星月邮箱，可点击「领取」）	{item}、{amount}
news.filled	收购单收到货（已寄到星月邮箱）	{item}、{amount}、{player} 卖家
news.expired	商品到期，剩下的寄回星月邮箱	{item}
news.removed	被管理员下架，东西寄回星月邮箱	{item}
news.returned	下架退回（默认关闭）	{item}
news.refund	退款	{money}
news.overflow	背包放不下的物品寄到星月邮箱（默认关闭）	{item}、{amount}

公告

键	用途
broadcast-new	新商品全服公告（{player} {item} {amount} {type} {price} {id}），需在 config.yml 开启

输入提示

点按钮后要求在聊天栏（或云界面弹窗）输入时的提示，都可以用 {cancel} 代表取消用的字：

键	用途
input-title	弹出输入框的标题
input-search	搜索
input-price-total / input-price-each	一口价总价 / 单价
input-start-price / input-new-price	起拍价 / 改价
input-order-price / input-order-amount	收购单价 / 收购数量
input-buyout / input-reserve / input-bid	一口价 / 保留价 / 出价

名称对照

这些不是消息，而是菜单与记录里显示的名称：

键	内容
type.*	商品类型（{type}）：sell 一口价、auction 拍卖、buy 收购
filter-type.*	类型筛选：all、sell、auction、buy
sort.*	排序名称：newest、oldest、price-low、price-high、ending、amount
no-keyword	没有搜索时显示的文字
not-set	上架菜单里还没设定的项目
partial-yes / partial-no	零买 / 整批出售
price-mode.total / price-mode.each	总价 / 单价
reason.*	来源名称：bought、won、returned、expired、removed、filled、sold、outbid、bidback、refund、overflow、broken（旧版领取箱菜单使用；1.1.0 起改为 mail.* 邮件，这一组已经用不到）
action.*	/sa log 的动作名称：list、buy、bid、fill、cancel、remove、end

管理与记录

键	用途
usage.*	指令参数不够时显示的用法：sell、auction、order、bid、view、remove、currencyitem
currency-item-saved	/sa currencyitem 完成（{id}）
log-header / log-line / log-empty	/sa log（log-line 的变量：{time} {player} {action} {id} {detail} {server}）
trades-header / trades-line	/sa trades（{time} {seller} {buyer} {material} {amount} {total} {tax} {id} {server}）

帮助

键	内容
help.*	/sa help 每一行：header 标题，其余每个子指令一行（remove、log、reload 只给有权限的人看）

云界面市集（cloudui）

装了云界面 CloudUI 时，市集画面上的文字可以用 cloudui.<键> 修改。默认文件只列了 title、empty、pick，其他键需要时自己加上。全部键与默认值见 云界面市集。