权限组与费用
上架数量上限、交易税、上架手续费都按 权限组 设定,写在 config.yml 的 groups:
groups:
default:
priority: 0
permission: ''
max-listings: 10
max-auctions: 3
max-orders: 5
tax-percent: {sell: 5, auction: 5, order: 5}
listing-fee: {flat: 0, percent: 0}
vip:
priority: 10
permission: starauction.group.vip
max-listings: 25
max-auctions: 6
max-orders: 10
tax-percent: {sell: 2, auction: 2, order: 2}
listing-fee: {flat: 0, percent: 0}
玩家属于哪一组
玩家属于「priority 最高、而且拥有 permission 的那一组」。permission 留空 = 所有人都符合,所以 default 组一般设 priority: 0、permission: '' 当作保底。
例如上面的设定:有 starauction.group.vip 的玩家属于 vip,其他人属于 default。要加更高的组,就再加一段、priority 写更大的数字:
svip:
priority: 20
permission: starauction.group.svip
max-listings: 50
max-auctions: 10
max-orders: 20
tax-percent: {sell: 0, auction: 1, order: 1}
listing-fee: {flat: 0, percent: 0}
lp group vip permission set starauction.group.vip true
lp group svip permission set starauction.group.svip true
组名可以随便取(会显示在「我的上架」与变量 %starauction_group%)。万一没有任何一组符合(例如每一组都写了权限),玩家会被当成 priority 最低的那一组。
键
| 键 | 默认 | 作用 |
|---|---|---|
priority | 0 | 优先顺序,数字大的先比对 |
permission | 空 | 有这个权限才属于这一组;空 = 所有人 |
max-listings | 10 | 同时上架的一口价数量上限 |
max-auctions | 3 | 同时进行的拍卖数量上限 |
max-orders | 5 | 同时发布的收购单数量上限 |
tax-percent.sell / auction / order | 5 | 成交时从收款方扣的税(%,0 ~ 100) |
listing-fee.flat | 0 | 上架手续费:固定金额 |
listing-fee.percent | 0 | 上架手续费:价格的百分比 |
上架数量上限
- 三种类型分开计算,跨服时算的是所有子服合计(从数据库数)。
- 达到上限时提示「你最多只能同时上架 10 件一口价商品」(拍卖、收购单各有自己的提示)。
- 卖掉、到期、下架的商品不再占名额。
starauction.limit.数量
想单独提高某个玩家或某个组的一口价上限,不用多建一个权限组,给权限就好:
lp user Steve permission set starauction.limit.50 true
玩家的一口价上限 = 「所在组的 max-listings」与「所有 starauction.limit.<数量> 权限里最大的数字」中较大的那个。这个权限只影响一口价,不影响拍卖与收购单。
有 starauction.bypass.limit 的玩家完全不受上架数量限制。
交易税
成交时从收钱的一方扣税,剩下的才寄到他的星月邮箱:
| 类型 | 谁收钱(被扣税) | 用的税率 |
|---|---|---|
| 一口价 | 卖家 | 卖家上架时的 tax-percent.sell |
| 拍卖 | 卖家 | 卖家上架时的 tax-percent.auction |
| 收购单 | 把物品卖给收购单的玩家 | 发布收购单的人发布时的 tax-percent.order |
- 税率在上架那一刻就固定在商品上,之后改权限组、改设定都不影响已经上架的商品。
- 上架的人有
starauction.bypass.tax时,那件商品的税率是 0。 - 买家付的就是标价,不额外收税。
- 税款直接从市集里消失(回收货币),不会给任何人。
上架手续费
手续费 = flat + 价格 × percent%
| 类型 | 「价格」指 |
|---|---|
| 一口价 | 整批总价(单价 × 数量) |
| 拍卖 | 起拍价 |
| 收购单 | 单价 × 数量(与预付款一起扣) |
- 上架时用那件商品的货币扣除,按货币四舍五入;付不起时提示「上架手续费不足,需要 …」,不会上架,物品退回。
- 上架菜单的 费用 按钮会先显示要付多少手续费与成交时的税率。
- 有
starauction.bypass.fee的玩家免手续费。
改价时补差额
调高价格时,按新价格重新计算手续费,比当初付的多就补交差额(提示「价格调高,已补交手续费 …」);调低价格不退。 这样卖家没办法先用低价上架省手续费、再改成高价。
手续费什么时候退
| 情况 | 退不退 |
|---|---|
| 卖家自己下架 | 默认不退;listing.refund-fee-on-cancel: true 时退 |
| 管理员强制下架 | 一律退还 |
| 到期 | 不退 |
| 成交 | 不退 |
| 上架失败(例如数据库错误) | 退还 |
查看自己的组
「我的上架」菜单的书本会显示:一口价 / 拍卖 / 收购单上限、所在权限组、一口价交易税。也可以用变量 %starauction_group%、%starauction_tax%、%starauction_limit%、%starauction_limit_auction%、%starauction_limit_order%,见 变量。
免除权限
| 权限 | 作用 |
|---|---|
starauction.bypass.tax | 上架的商品成交时不扣交易税 |
starauction.bypass.fee | 上架免手续费(改价也不补差额) |
starauction.bypass.limit | 不受上架数量上限 |
全部权限见 权限。