跳到主要内容

指令

主指令是 /starauction，平常打 /sa 就好，/ah、/market 也一样。所有子指令都支持 Tab 补全，管理指令只会补全你有权限使用的。

/sa、/ah 被别的插件占用了？

config.yml 的 command-aliases（默认 [sa, ah, market]）里的指令，玩家输入时一律交给星月市集，即使别的插件也注册了同样的指令。 控制台不受这个设定影响；控制台遇到冲突时请写完整的 starauction。见 config.yml。

看懂指令写法​

写法意思
<名称>必填
[文字]选填，可以不写
a|b二选一

价格与金额可以写 1500、1.5k（千）、2w 或 2万（万）、1m（百万）、1亿，也可以带千位逗号 1,500。 时长写 30m、12h、3d、1w，也可以组合 1d12h。

指令一览​

指令作用权限
/sa [编号]打开市集 / 打开某件商品starauction.use
/sa <关键字>直接搜索starauction.use
/sa sell <价格> [数量|all] [时长] [货币]上架手上的物品（一口价）starauction.sell
/sa auction <起拍价> [一口价] [时长] [货币]拍卖手上的物品starauction.auction
/sa order <单价> <数量> [物品ID] [时长] [货币]发布收购单starauction.order
/sa list打开上架菜单starauction.use
/sa search <关键字>搜索starauction.use
/sa mine我的上架starauction.use
/sa stash打开星月邮箱（领取买到的、卖出的东西）starauction.use
/sa history交易记录starauction.use
/sa bid <编号> <金额>拍卖出价starauction.bid
/sa cancel [编号]下架自己的商品starauction.use
/sa view <玩家>看某位玩家的商品starauction.use
/sa help显示帮助无
/sa remove <编号|玩家>强制下架starauction.admin.remove
/sa log [玩家] [页]操作记录starauction.admin.log
/sa trades [页]最新成交starauction.admin.log
/sa reload重载配置starauction.admin.reload
/sa currencyitem <货币ID>把手上的物品设为货币starauction.admin.reload
/sa version版本信息无

所有玩家指令都需要 starauction.use；上架、购买、出价、卖给收购单另外需要对应的权限。全部权限节点见 权限。

还没授权时

还没填授权码、或授权还在验证中时，除了 /sa reload 与 /sa version，所有子指令都只会提示「星月市集尚未授权，市集功能暂时关闭」。见 安装与授权。

玩家指令​

/sa​

打开市集。装了云界面 CloudUI 时打开全屏画面，见 云界面市集。

项目内容
用法/sa、/sa open [编号]（market、市集 也可以）
权限starauction.use（默认所有人）
控制台不行，只能玩家
参数必填说明
[编号]否商品编号（128 或 #128）。写了就直接打开那件商品的购买 / 出价 / 卖给收购单菜单；自己的商品打开「我的上架」。商品已经结束时提示「这件商品已经卖完、结束或被下架了」

聊天栏的「[点击查看]」「[再出价]」执行的就是 /starauction open <编号>。

/sa
/sa open 128

搜索市集，打开「全部」分类的搜索结果。

项目内容
用法/sa search <关键字>（s 也可以），或直接 /sa <关键字>
权限starauction.use
控制台不行，只能玩家
  • 关键字可以是中文物品名、物品 ID、自定义名称、说明里的文字、附魔 ID、玩家名、#编号；多个词用空格分开、要全部符合。规则见 逛市集 · 搜索。
  • /sa search 不写关键字 = 清除搜索。
  • 不是子指令的第一个词都会被当成搜索：/sa 钻石、/sa Steve。
/sa 钻石
/sa search 钻石剑 sharpness
/sa s #128

/sa sell​

把手上的物品以一口价上架。

项目内容
用法/sa sell <价格> [数量|all] [时长] [货币]
权限starauction.use + starauction.sell
控制台不行，只能玩家
参数必填说明
<价格>是整批总价（listing.sell.command-price: each 时是单价）
[数量|all]否卖几个；不写 = 手上那一组；all = 背包里全部同样的物品
[时长]否不写用 listing.sell.default-duration（48h）；会被限制在 durations 最短与最长之间
[货币]否货币 ID；不写用默认货币
  • 手上没东西时提示「手上没有物品」；背包里不够时提示「背包里没有 N 个这种物品」。
  • 是否允许零买使用 listing.sell.allow-partial 的默认值；想逐件设定请用上架菜单。
  • 时长与货币的 Tab 补全会列出设定里的时长与所有货币 ID。
/sa sell 1500
/sa sell 1500 128 24h
/sa sell 2w all 72h
/sa sell 300 64 points

详见 一口价。

/sa auction​

拍卖手上那一组物品。

项目内容
用法/sa auction <起拍价> [一口价] [时长] [货币]
权限starauction.use + starauction.auction
控制台不行，只能玩家
参数必填说明
<起拍价>是整批的起拍价
[一口价]否出价达到就立即成交；0 或不写 = 不设。不能低于起拍价
[时长]否不写用 listing.auction.default-duration（12h）
[货币]否货币 ID

保留价只能在上架菜单设定。

/sa auction 100
/sa auction 100 2000 6h
/sa auction 10 6h points

详见 拍卖。

/sa order​

发布收购单，发布时预付 单价 × 数量（+ 手续费）。

项目内容
用法/sa order <单价> <数量> [物品ID] [时长] [货币]
权限starauction.use + starauction.order
控制台不行，只能玩家
参数必填说明
<单价>是每个的收购价
<数量>是要收几个
[物品ID]否要收的物品；不写 = 以手上的物品为样品（不会被拿走）。空手又没写物品 ID 时提示「手上没有物品」
[时长]否不写用 listing.order.default-duration（3d）
[货币]否货币 ID
/sa order 5 128 OAK_LOG
/sa order 2.5 640 WHEAT 7d
/sa order 300 10

详见 收购单。

/sa list​

打开上架菜单：放入物品，选一口价 / 拍卖 / 收购，设定价格、一口价、保留价、零买、收购数量、时长、货币。

项目内容
用法/sa list（create、上架 也可以）
权限starauction.use（确认时再检查对应的上架权限）
控制台不行，只能玩家

上架成功后自动打开「我的上架」。菜单说明见 菜单 · create.yml。

/sa mine​

我的上架：所有上架中的商品，左键改价、右键下架、全部下架、交易记录、星月邮箱。

项目内容
用法/sa mine（my、me 也可以）
权限starauction.use
控制台不行，只能玩家

/sa stash​

打开玩家自己的 StarMail 星月邮箱（装了云界面 CloudUI 时是云界面邮箱）。1.1.0 起市集给玩家的东西——买到的物品、卖出的收入、退回的东西——都寄到这里，见 星月邮箱寄送。

项目内容
用法/sa stash（claim、collect、领取箱 也可以）
权限starauction.use
控制台不行，只能玩家
  • 打开的就是 /sm 的邮箱。打开前会先把还没寄出的东西再寄一次。
  • 星月邮箱现在不能用（例如授权还在验证）时提示「星月邮箱现在不能用……东西都还在待寄清单里，邮箱恢复后会自动寄出」。

/sa history​

交易记录：你最近 135 笔买入与卖出（交易对象、类型、数量、金额、税、实收、时间、商品编号）。

项目内容
用法/sa history
权限starauction.use
控制台不行，只能玩家

/sa bid​

对拍卖直接出价，不用打开菜单。

项目内容
用法/sa bid <编号> <金额>
权限starauction.use + starauction.bid
控制台不行，只能玩家
  • 金额要达到最低出价，否则提示「出价至少要 …」；达到或超过一口价时按一口价立即买下。
  • 用指令出价不需要二次确认，请确认金额再送出。
  • 编号不是进行中的拍卖时提示「这件商品已经卖完、结束或被下架了」。
/sa bid 128 1500
/sa bid #128 2k

/sa cancel​

下架自己的商品，剩下的物品 / 预付款寄到星月邮箱。

项目内容
用法/sa cancel [编号]
权限starauction.use
控制台不行，只能玩家
  • 不写编号 = 打开「我的上架」。编号的 Tab 补全列出你上架中的商品。
  • 不是自己的商品时提示「这不是你的商品」。
  • 已经有人出价的拍卖默认不能下架；到期的商品不能下架。规则见 一口价 · 下架。
  • 用指令下架不需要二次确认。

/sa view​

打开只显示某位玩家商品的市集。

项目内容
用法/sa view <玩家>
权限starauction.use
控制台不行，只能玩家

对方离线也可以，只要他在连同一个数据库的任何子服上线过；找不到时提示「找不到玩家 …（对方需要在连同一数据库的子服上线过）」。

/sa help​

列出指令。所有人都看到玩家指令；remove、log、reload 三行只有有对应权限的人才看到。

管理指令​

/sa remove​

强制下架：物品寄回卖家的星月邮箱、拍卖的最高出价退回出价者、收购单没用完的预付款退回发布者（都是寄到星月邮箱），上架手续费一律退还。卖家收到「你的 … 被管理员下架，已寄到星月邮箱 [领取]」。

项目内容
用法/sa remove <编号|玩家>
权限starauction.admin.remove
控制台可以
参数说明
编号下架这一件（128 或 #128）
玩家下架这位玩家所有上架中的商品（例如封禁的玩家），提示「正在下架 … 的 N 件商品…」。玩家离线也可以
  • 不受「已有人出价不能下架」的限制。
  • 在市集里也可以对别人的商品 Shift + 右键（连按两次确认）。
/sa remove 128
/sa remove Steve

/sa log​

操作记录：上架、购买、出价、供货、下架、强制下架、结束。

项目内容
用法/sa log [玩家] [页]
权限starauction.admin.log
控制台可以
  • 不写玩家 = 全服的操作记录。每页 10 条，最新的在前。
  • 每行：时间 玩家 动作 #商品编号 内容 子服。
  • 保留 cleanup.log-days（默认 90）天。
/sa log
/sa log Steve
/sa log Steve 2

/sa trades​

全服最新成交。

项目内容
用法/sa trades [页]
权限starauction.admin.log
控制台可以

每行：时间 卖家 → 买家 物品 ×数量 金额 税 #商品编号 子服。每页 10 条。保留 cleanup.trade-days（默认 365）天。

/sa reload​

重新载入设定。

项目内容
用法/sa reload
权限starauction.admin.reload
控制台可以
  • 重新载入 config.yml、messages.yml、categories.yml、item-names.yml、menus/*.yml 与货币，更新 command-aliases，按 menu.cloudui 接上或断开云界面。
  • 缺少的 messages.yml、categories.yml、菜单文件会重新生成默认的。
  • 所有人打开中的星月市集菜单会被关闭；上架菜单里的物品退回背包；正在聊天栏输入的会被取消。
  • 数据库（database）与跨服（sync）设定需要重启服务器才会生效。

/sa currencyitem​

把手上的物品（完整物品数据，自定义物品也可以）设为物品货币，写入 config.yml 并自动重载。

项目内容
用法/sa currencyitem <货币ID>
权限starauction.admin.reload
控制台不行，只能玩家

货币 ID 只能用小写字母、数字、_、-。详见 货币 · 物品货币。

/sa currencyitem coin

/sa version​

显示版本；有 starauction.admin.reload 的人（或控制台）另外看到版本类型、数据库、子服 ID 与上架中的商品数。

项目内容
用法/sa version
权限无（详细信息需要 starauction.admin.reload）
控制台可以
✦ 星月市集 » StarAuction 1.0.0 · 简体授权版 · 数据库 MySQL · 子服 lobby · 上架中 128 件

一般玩家只看到 StarAuction 1.0.0。跨服时用它检查每个子服是不是都连上了 MySQL、子服 ID 有没有设对。

最后于 更新