内部商店配置
902 字约 3 分钟
内部商店在 plugins/MyCompany/prices.yml 中配置。 文件不存在时会在首次启动时生成,并在服务器启动时读取一次。
文件分为三部分:
prices.yml
multipliers:
company:
normal: 1.2
ore-company: 1.3
mob-company: 1.56
player-share: 0.1
prices:
vanilla:
mob_rotten_flesh:
material: rotten_flesh
price: 2.0
group: mob-companymultipliers
multipliers.company 定义价组。key 是价组 id,值是该价组应用到基础价格上的倍率。
normal是兜底价组。当公司价组与物品价组不一致时会使用它。- 如果区块存在但缺少
normal,插件会使用1.2。 - 整个
multipliers.company区块必须存在。缺失时商店无法初始化。 - 物品的
group在查找前会转为小写,而multipliers.company下的 key 按原样使用。两边都请写小写,确保总能匹配。
一间公司同一时间只使用一个价组。它从 normal 开始,专精方向可以改变它;参见 专精方向。 公司切换专精方向时,价组会重置为 normal。
player-share
player-share 是出售金额中归出售者个人的比例,其余部分归公司。
0.1表示出售者拿 10%,公司拿 90%。- 这是比例,不是百分数:写
0.1,不要写10。 - 缺少该键时使用
0。 - 请保持在
0到1之间;大于1会使公司分成为负。
玩家分成通过 Vault 存入出售者的经济余额,公司分成则加到公司余额。
prices
所有物品都列在 prices.vanilla 下。每个条目有一个 id 和三个字段:
| 字段 | 说明 |
|---|---|
material | 物品的 Bukkit 材料,例如 rotten_flesh 或 diamond。 |
price | 单个物品的基础价格。必须大于 0。 |
group | 物品所属价组。可选,默认 normal。 |
条目 id(上面的 mob_rotten_flesh)只是这个条目的名字。物品按 material 匹配。 只匹配普通物品:带自定义名称、lore、附魔或其他物品 meta 的物品不会被定价,即使它的材料已列出。
物品只按材料匹配,因此两个条目使用同一材料时会共享一个价格。其他插件的自定义物品不在此区块的支持范围内。
计算方式
物品价值 = 价格 × 价组倍率 × 数量
玩家分成 = 物品价值 × player-share
公司分成 = 物品价值 − 玩家分成倍率按物品逐个选择:
| 公司价组 | 物品价组 | 使用的倍率 |
|---|---|---|
normal | normal | normal |
mob-company | mob-company | mob-company |
mob-company | ore-company | normal |
normal | mob-company | normal |
换句话说,只有当公司当前价组与物品价组相同时,物品才会获得它自己的价组倍率。
校验
文件在启动时读取:
- 无效材料会记录日志并跳过该条目。
- 价格为
0或更低时会记录日志并跳过该条目。 - 物品价组在
multipliers.company中不存在时,把该物品放进商店会抛出错误。请始终使用区块中已定义的价组。 - 缺少
multipliers.company区块会导致商店无法加载。 - 修改
prices.yml后需要重启服务器;配置重载不会重新读取该文件。
添加价格
- 在
prices.vanilla下新增一个条目。 - 把
material设为 Bukkit 材料名称。 - 把
price设为公司收购一个物品的价格。 - 把
group设为已有价组,或省略以使用normal。 - 重启服务器,往商店里放一个物品检查显示的结算金额。
如果想给某个专精方向更优惠的价格,使用专精树中的 set_price_group 动作,详见 条件、效果与动作(在新窗口打开)。动作中命名的价组必须存在于 multipliers.company 中。