VaultEconomy

插件

· 作者 Pritfort

VaultEconomy —— 一款功能强大的经济插件,支持 Vault 集成、自定义货币、占位符、权限管理、灵活配置,并兼容 Spigot、Bukkit、Paper、Folia 和 BungeeCord。

0 本站下载 0 关注 更新于 6 天前

最新 4.1.1-rc13.3 · 26.3 · Bukkit / BungeeCord

一键开服(送7天)

✨ VaultEconomy

经济、服务器管理与自定义玩法——融为一体。

VaultEconomy 3.0.0-rc1 将持久化经济与拍卖行、氏族、传送、管理、自定义物品、配方、酿造、交互式钓鱼、成就和视觉效果结合在一起。

构建生存模式经济,创建 RPG 进度系统,奖励玩家的活动,或通过共享数据库连接多个服务器。

免费功能 • 服务端玩法 • 无需客户端模组 • 无需外部数据库

Fis

? 兼容性

声明的 Minecraft 兼容版本:1.13–26.3。

平台 可用功能
Paper 玩法系统、经济、命令和支持的其他 API
Purpur Bukkit/Paper 玩法实现
Spigot Bukkit 玩法实现
Bukkit / CraftBukkit Bukkit 玩法实现
Folia 具有实体、区域和全局调度适配器的玩法实现
Velocity 网络命令和可选的共享经济
BungeeCord 网络命令和可选的共享经济

Velocity 和 BungeeCord 是代理(Proxy)。 自定义物品、背包、合成、钓鱼和其他世界机制在连接的玩法服务器上运行。

兼容范围由维护者声明。包含的自动 API 报告覆盖了 Spigot 1.13、Spigot 1.21.11 和 Paper 26.2;它们并不认证每一个中间版本或实时的 26.3 部署。

请使用您的服务器软件所需的 Java 版本。诸如新属性、黑暗效果、CustomModelData、虚拟铁砧和熔炉加速等功能取决于可用的服务器 API。


? 主要功能

类别 包含的系统
经济 余额、支付、排行榜、自定义货币、Vault 提供者
交易 拍卖行、税费、过期处理、购买确认、配送队列
氏族 角色、邀请、金库、家园、存储升级、旗帜、外交
旅行 出生点、家园、传送点、传送请求、上次位置、随机传送
社区 私聊、邮件、婚姻、昵称、前缀、战利品包 (Kits)
管理 Moderation、战斗限制、监狱、背包检查、玩家控制
自定义内容 物品、药水、点击动作、合成、酿造、熔炉
钓鱼 时机小游戏、物种、大小变化、稀有度、买家菜单
进度 可配置的成就,附带金钱、物品和命令奖励
视觉效果 粒子图案、音效、标题、充能标枪
存储 11 种可选的文件和数据库后端
语言 英语、俄语及其他翻译文件

该 Bukkit 插件注册了 108 个根命令。其扩展目录包含 391 个命令路径,以及 819 个静态权限定义和额外的特定内容权限。

这些是命令路径和权限,并非声称有 391 个无关的玩法系统。


? 你可以如何使用它?

  • 生存模式: 余额、家园、玩家交易、氏族、钓鱼和成就。
  • RPG: 自定义药水、特殊物品、合成链、进度系统和奖励。
  • 社区服务器: 通信、战利品包、婚姻、管理和共享氏族活动。
  • 活动: 粒子效果、玩家特效、充能标枪、收集品奖励和命令驱动的物品。
  • 网络: 共享余额、服务器切换和代理消息传递。

VaultEconomy 提供可配置的系统。它不会自动生成城市、任务、NPC、领地或资源包。


? 安装

  1. 停止服务器并备份现有的插件和玩家数据。
  2. 移除旧的 VaultEconomy JAR 文件。
  3. 安装 VaultEconomy-3.0.0-rc1.jar。
  4. 保留现有的 plugins/VaultEconomy 目录。
  5. 启动服务器。
  6. 检查 /ve status 和 /vex status。
  7. 配置权限并使用非 OP 账号进行测试。

SQLite 是默认后端,会自动创建。

可选集成

集成 用途
Vault 将兼容的外部插件连接到主经济系统
PlaceholderAPI 暴露余额和其他插件数值
LuckPerms 可选的权限管理
LibsDisguises 真实的生物伪装,及其必需的依赖项

内置的经济命令无需 Vault 即可工作。

如果另一个插件注册了相同的命令,请使用命名空间:

/vaulteconomy:balance
/vaulteconomy:pay Alex 25

英文设置

编辑 config.yml:

language: en

currency:
  symbol: "$"
  singular: coin
  plural: coins

然后运行:

/ve reload
/language reload
/language set en

捆绑的自定义内容名称可能同时包含两种语言。请在 items.yml、fishing.yml 和 achievements.yml 中单独编辑这些名称。


? 经济与自定义货币

主货币

/balance [player]
/pay <player> <amount>
/baltop [currency]

/eco give <player> <amount>
/eco take <player> <amount>
/eco set <player> <amount>

别名包括 /bal、/money 和 /bits。

附加货币

为活动、进度或奖励创建代币:

/point create tokens T
/point list
/point give tokens Alex 50
/point balance tokens Alex
/point pay tokens Alex 5
/baltop tokens

管理操作支持 give、take 和 set。

交易处理

  • 金额使用整数百分之一表示。
  • 命令最多接受两位小数。
  • 无效金额、溢出和自付行为将被拒绝。
  • 转账在报告成功之前提交。
  • 失败的存储操作不会报告为成功的付款。

Vault 暴露主货币。附加货币使用该插件自己的命令和占位符。

未实现 Vault 银行账户。 氏族金库使用内部账户。

?️ 拍卖行

出售主手物品堆:

/ah sell 250

其他命令:

/ah
/ah mine
/ah cancel <listing-id>
/ah claim
/claim
/ahelp

包含的功能

  • 带有卖家和价格的挂牌浏览。
  • 购买确认。
  • 可配置的出售税。
  • 离线卖家支付。
  • 挂牌过期。
  • 通过队列处理退货和购买交付。
  • 用于中断操作的管理员恢复工具。

当背包空间可用时,/claim 会收取下一个队列中的交付物品。

auction:
  tax-percent: 3.0
  lifetime-seconds: 172800

limits:
  auction: 5

172800 秒等于 48 小时。

恢复命令:

/ah recover list
/ah recover <operation-id> restore
/ah recover <operation-id> discard

模糊的物品交付需要管理员在做出恢复操作之前检查记录和资源库。


?️ 氏族与社交功能

氏族拥有四种角色:成员、军官、副官和所有者。

功能包括:

  • 邀请和公开加入。
  • 金库存款和取款。
  • 氏族出生点。
  • 共享存储,容量从 27 格到 54 格。
  • 存储升级。
  • 旗帜和氏族聊天。
  • 晋升、降级和所有权转让。
  • PvP 开关。
  • 联盟和战争关系。
/clan
/clan help
/clan create <name>
/clan invite <player>
/clan accept
/clan join <clan>
/clan deposit <amount>
/clan withdraw <amount>
/clan home
/clan storage
/clan upgrade
clans:
  create-price: "1000.00"
  storage-upgrade-price: "2000.00"
  max-members: 20

权限和氏族角色是分开检查的。命令权限不会自动授予金库管理权。

外交功能不包含领土占领。

婚姻与交流

/marry propose <player>
/marry accept
/marry info
/marry chat <message>
/marry divorce confirm

/msg <player> <message>
/reply <message>
/ignore <player>
/mail read
/mail send <player> <message>

? 传送与日常实用功能

系统 命令
出生点 /spawn, /setspawn
家 /sethome, /home, /delhome, /homes
跳跃点 /setwarp, /warp, /delwarp, /warps
请求 /tpa, /tpahere, /tpaccept, /tpdeny, /tptoggle, /tpcancel
其他旅行 /back, /rtp, /tp, /tphere, /tppos
装备包 /kit, /kits, /createkit, /delkit
信息 /rules, /motd, /list, /ping, /seen, /playtime

传送请求在 60 秒后过期。

teleport:
  delay: 3

limits:
  homes: 2
  near: 100
  auction: 5

rtp:
  radius: 2000

cooldowns:
  spawn: 10
  home: 10
  warp: 10
  back: 10
  tpa: 5
  rtp: 120
  clanhome: 15

传送延迟和冷却时间以秒为单位计算。

装备包保存主背包内容,不包括盔甲和副手物品。访问需要根装备包权限以及 vaulteconomy.kit.<name>。


? 无需 Java 的自定义物品

在 items.yml 中创建可重复使用的定义。

ID 使用小写字母、数字、下划线和连字符,最大长度为 48 个字符。

示例:法杖和药水

将这些定义合并到现有的 items: 部分中:

items:
  wind_wand:
    enabled: true
    public: true
    material: BLAZE_ROD
    name: "&bWind Wand"
    cooldown-seconds: 15

    lore:
      - "&7右键点击获得速度 II。"
      - "&8冷却时间:15 秒"

    actions:
      right_click:
        - "effect SPEED:8:2"
        - "sound ENTITY_EXPERIENCE_ORB_PICKUP"
        - "animation spiral"
        - "message &b风将你向前吹送!"

  frost_potion:
    enabled: true
    public: true
    material: POTION
    name: "&bFrost Potion"
    color: "66CCFF"

    effects:
      - "SLOWNESS:30:2"
      - "RESISTANCE:30:1"

应用并获取:

/customitem reload
/customitem give wind_wand 1
/customitem give frost_potion 1 Alex

物品设置

字段 用途
enabled 启用创建和配置的动作处理
public 控制默认的使用/放置访问权限
material 现有的 Minecraft 材质
name, lore 显示名称和描述
unbreakable 耐久度行为
model 支持的 CustomModelData
color 十六进制 RGB 格式的药水颜色
effects 自定义药水效果
cooldown-seconds 动作激活延迟
actions 点击和玩家目标动作
kind 特殊行为标记,例如 spear
furnace 自定义熔炉属性

CustomModelData 不会生成纹理。需要兼容的资源包来支持自定义模型或外观。

效果语法

TYPE:seconds:level

STRENGTH:45:3 表示 力量 III 持续 45 秒。

药水定义支持 1–86,400 秒的持续时间以及 1–255 的等级,具体取决于服务器可用的效果。

使用命令创建

/customitem create frost_potion POTION
/customitem name frost_potion &bFrost Potion
/customitem effect add frost_potion RESISTANCE:30:1
/customitem color frost_potion 66CCFF
/customitem give frost_potion 1

新定义默认为 public: false。在 YAML 中更改它或授予特定的内容权限。

其他管理命令:

/customitem list
/customitem inspect <id>
/customitem clone <id> <new-id>
/customitem delete <id> confirm
/customitem menu

? 物品动作

触发器

  • right_click — 在空中或方块上右键点击。
  • left_click — 在空中或方块上左键点击。
  • target — 右键点击另一名玩家。

动作

message <text>
effect TYPE:seconds:level
command <player-command>
console <console-command>
jail <cell>:<seconds>
sound <SOUND>
animation <style>

命令动作支持 {player} 和 {target}。编写命令时不要加前导斜杠。

玩家命令使用玩家的权限。控制台命令是管理员定义的动作。

动作使用不会自动消耗物品。

监狱法杖示例

items:
  prison_wand:
    enabled: true
    public: false
    material: BLAZE_ROD
    name: "&5监狱法杖"
    cooldown-seconds: 5

    actions:
      target:
        - "jail default:60"
        - "sound BLOCK_ANVIL_LAND"
/jail set default
/customitem give prison_wand 1

使用它需要以下权限:

vaulteconomy.item.use.prison_wand
vaulteconomy.item.target.prison_wand

身份标识与更新

自定义物品使用 HMAC 签名的 Lore(描述)标记。重命名普通物品不会使其变成有效的自定义物品。

请保留后端存储的签名密钥。

更改定义会影响未来的创建和操作查找。现有的物品名称、Lore 和药水元数据不会在每个玩家的背包中自动重建。


? 合成与配方控制

配方位于 recipes.yml 中。

支持的类型:

shaped (形状)
shapeless (无形状)
furnace (熔炉)

形状合成配方

recipes:
  frost_craft:
    enabled: true
    public: true
    type: shaped
    result: frost_potion
    amount: 1

    shape:
      - " I "
      - "IPI"
      - " I "

    ingredients:
      I: ICE
      P: POTION

空格代表空槽位。

对于精确匹配的已签名自定义材料,请使用 custom:<id>:

ingredients:
  P: "custom:frost_potion"

结果使用不带 custom: 前缀的物品 ID。

仅因为材质匹配,已签名的自定义物品不会作为普通合成材料被接受。

配方编辑器

/recipe create frost_craft shaped frost_potion
/recipe shape frost_craft _I_/IPI/_I_
/recipe ingredient frost_craft I ICE
/recipe ingredient frost_craft P POTION
/recipe enabled frost_craft true

在命令中,/ 用于分隔行,_ 表示空槽位。

新创建的配方默认处于禁用且私有状态。完成定义后启用它,并配置其权限。

屏蔽配方

/recipe block minecraft:diamond_sword
/recipe unblock minecraft:diamond_sword
/recipe blockresult DIAMOND_SWORD
/recipe unblockresult DIAMOND_SWORD
/recipe reload

屏蔽功能使用 Bukkit 配方注册表。由其他插件后续注册的配方可能需要再次重载。

熔炼定义需要普通的材料输入;合成和酿造支持精确的自定义材料。


⚗️ 酿造与自定义熔炉

酿造 — brewing.yml

recipes:
  frost_brew:
    enabled: true
    public: true
    base: POTION
    ingredient: ICE
    result: frost_potion
    ticks: 200
    fuel: true
  1. 将匹配的基药水放入酿造架。
  2. 如需燃料,加入烈焰粉。
  3. 加入原料,或者如果原版界面不接受,则手持该原料。
  4. 潜行右键点击酿造架,或注视它并运行 /brew start。
  5. 在完成之前保持背包不变。

200 tick 在正常游戏刻率下大约为十秒。一份烈焰粉可提供 20 次循环。

/brew create <id> <base> <ingredient> <result-id>
/brew ticks <id> <ticks>
/brew fuel <id> <true|false>
/brew enabled <id> <true|false>

自定义熔炉

将此部分添加到自定义的 FURNACE 物品中:

furnace:
  speed: 2
  fuel-multiplier: 2
  output-multiplier: 1
  • speed: 2 请求一半的正常烹饪时间。
  • fuel-multiplier: 2 使燃料持续时间加倍。
  • output-multiplier 在堆叠限制内改变产出数量。

加速功能需要相关的服务器 API。正常的受支持方块掉落可以保留自定义熔炉的身份;爆炸不能保证物品回收。


? 互动钓鱼

钓鱼会在符合条件的原版捕获后增加一个计时小游戏。

界面包含移动指示器、绿色目标区域以及命中/未命中计数器。在目标区域内右键点击或按下交换手按键(通常为 F)。

默认设置:

game:
  hits: 5
  misses: 3
  period-ticks: 40
  window: 0.28

五次命中可成功钓起鱼。三次未命中或未击中窗口会导致失败。移动超过八个方块距离会终止尝试。

包含物种

  • River Carp(河鲤)。
  • Silver Salmon(银鲑)。
  • Moon Ray(月鳐)。
  • Abyss Puffer(深渊河豚)。
  • Golden Leviathan(金色利维坦)。

自定义物种 — fishing.yml

species:
  crystal_carp:
    enabled: true
    name: "&b水晶鲤鱼"
    material: COD
    rarity: rare
    chance: 5
    price: 20

    weight:
      min: 0.5
      max: 4.0

    length:
      min: 20
      max: 80

    worlds: []
    biomes: []
    rain-only: false

重量以千克为单位测量;长度以厘米为单位测量。

chance 是相对的选择权重,而非独立的百分比。空的生物群系和世界列表意味着不受限制的选择。

玩家命令

/fish menu
/fish price
/fish sell
/fish sellall
/fish list
/fish stats
/fish cancel
/fish animation ripple

买家

买家是一个菜单和命令系统,而不是自动生成的 NPC。

/fish buyer set
/fish buyer require-location true

位置强制要求玩家在保存点六个方块范围内出售。

价格取决于基础价格、大小、稀有度、选择权重以及买家乘数。

每条生成的鱼都有一个签名的序列号。已售出的序列号不能再获得 payout(收益)。

管理员可以使用 /fishspecies 编辑物种,使用 /fish buyer 编辑买家设置,使用 /fish difficulty 调整难度。


✨ 特效与充能长矛

粒子图案

ring, spiral, helix, double_helix, wave,
orbit, fountain, vortex, star, pulse,
figure_eight, rain, comet, crown, ripple
/fx preview spiral
/fx sound ENTITY_EXPERIENCE_ORB_PICKUP
/fx title Welcome|Enjoy_your_stay
/fx styles

长矛

/spear give
/spear style storm
/spear styles

手持自定义长矛,潜行以蓄力,然后在松开潜行键后的三秒内投掷。

样式:

ember
storm
void
tidal
solar

effects.yml 中的设置:

particles: true
sounds: true
points-per-frame: 12

spear:
  charge-ticks: 60
  screen-darkening: true
  max-speed-bonus: 1
  max-damage-bonus: 8

屏幕变暗效果使用可用的药水效果,而非自定义客户端光影。


? 成就

在 achievements.yml 中创建进度:

achievements:
  stone_collector:
    enabled: true
    public: true
    name: "&6Stone Collector"
    icon: STONE
    trigger: block_break
    match: STONE
    goal: 500
    auto-claim: false

    rewards:
      money: 100
      items:
        - "reward_token:2"
      commands: []

触发条件

block_break
block_place
kill
death
craft
join
vanilla_advancement
fish_catch
fish_sell
item_use
brew
spear_throw

当不需要特定匹配项时,请使用 match: "*"。

/achievements
/achievements progress <id>
/achievements rewards <id>
/achievements claim <id>
/achievements claimall

物品奖励会进入 /claim 队列。奖励命令支持 {player} 和 {uuid} 占位符。

金钱、领取状态以及排队中的物品奖励是共同记录的。外部控制台命令无法与其他插件共享事务;中断的奖励可能需要检查。

管理工具:

/achievementedit create <id> <trigger> <goal>
/achievementedit grant <id> <player>
/achievementedit reset <id> <player> confirm
/achievementedit pending <player>

创造模式下的破坏/放置方块不计入统计。之前完成的原版进阶不会自动导入。


?️ 物品编辑与玩家控制

手持物品编辑器

/itemedit name &6Explorer's Sword
/itemedit lore-add &7An expedition reward.
/itemedit enchant sharpness 5
/itemedit unenchant sharpness
/itemedit enchants-clear
/itemedit potion-add SPEED 30 2
/itemedit potion-remove SPEED
/itemedit attribute-add attack_damage 3 ADD_NUMBER
/itemedit repair
/itemedit info

还支持材质、数量、耐久度、物品标志(Item Flags)、CustomModelData、书籍、皮革颜色、药水颜色及玩家头颅。

/itemedit 编辑当前手持物品。/customitem 编辑可重复使用的定义。

移除药水效果会影响自定义药水效果。它并非用于编辑所有原版基础药水属性或其他插件自定义元数据的通用编辑器。

玩家控制

/playerctl glowing true Alex
/playerctl freeze Alex
/playerctl unfreeze Alex
/playerctl effect speed 30 2 Alex
/playerctl cure speed Alex
/playerctl attribute scale 1.5 Alex
/playerctl attribute-reset scale Alex

其他控制功能包括生命值、饥饿值、空气值、飞行、移动、重力、名称、头衔、速度、效果和伪装。

缩放和交互范围等属性需要服务器版本提供支持。

管理与监禁

/kick <player> [reason]
/ban <player> [reason]
/tempban <player> <seconds> [reason]
/mute <player> [reason]
/tempmute <player> <seconds> [reason]

/jail set default
/jail send Alex default 60
/jail info Alex
/jail release Alex

监禁会保留刑期和返回位置。离线期间刑期继续计算。

库存工具

/craft
/anvil
/enderchest [player]
/invsee <player>
/sejf
/repair [all]

查看其他玩家的库存为只读模式。个人保险箱拥有 54 个格子。


? 权限

核心命令使用:

vaulteconomy.<command>

扩展命令需要同时具备根权限和命令路径权限。

例如冻结另一名玩家:

vaulteconomy.playerctl
vaulteconomy.playerctl.freeze
vaulteconomy.playerctl.freeze.others

内容权限

权限 控制内容
vaulteconomy.item.use.<id> 使用自定义物品
vaulteconomy.item.give.<id> 给予该物品
vaulteconomy.item.place.<id> 放置其对应的方块
vaulteconomy.item.target.<id> 针对玩家的操作
vaulteconomy.recipe.craft.<id> 合成配方
vaulteconomy.recipe.brew.<id> 开始自定义酿造
vaulteconomy.achievement.earn.<id> 成就进度
vaulteconomy.achievement.claim.<id> 成就奖励
vaulteconomy.kit.<name> 领取礼包

public: true 会更改适用的内容默认值。但这并不授予编辑、给予或针对操作的权利。

活动权限

vaulteconomy.fish.play
vaulteconomy.spear.use
vaulteconomy.effects.view
vaulteconomy.achievements.earn

有用的额外权限

vaulteconomy.balance.others
vaulteconomy.eco.give
vaulteconomy.eco.take
vaulteconomy.eco.set
vaulteconomy.repair.all
vaulteconomy.gamemode.creative
vaulteconomy.vanish.see
vaulteconomy.combat.bypass
vaulteconomy.cooldown.bypass
vaulteconomy.teleport.instant
vaulteconomy.kit.cooldown.bypass

等级限制

vaulteconomy.limit.homes.10
vaulteconomy.limit.auction.15
vaulteconomy.limit.rtp.5000
vaulteconomy.limit.near.200

正整数权限会增加配置基线,但受限于内置最大值。

LuckPerms 示例

/lp group vip permission set vaulteconomy.fly true
/lp group vip permission set vaulteconomy.limit.homes.10 true
/lp group default permission set vaulteconomy.item.use.wind_wand true
/lp group default permission set vaulteconomy.recipe.craft.frost_craft true

大多数编辑和管理命令默认仅对操作员开放。日常经济、社交、钓鱼和成就命令通常对所有玩家可用,并在适用时进行额外检查。

使用以下命令查看帮助:

/vex help [page]
/vex permissions [filter]

归档文件包含完整的 permissions.json 和 docs/COMMAND_CATALOG.md。帮助和扩展命令路径建议均经过权限过滤。


? 存储

从 11 种后端中选择一种:

类型 后端
YAML YAML 文件
JSON JSON 文件
PROPERTIES Java Properties
XML XML Properties
CSV 键值 CSV
SQLITE 嵌入式 SQLite — 默认
H2 嵌入式 H2
MYSQL MySQL
MARIADB MariaDB
POSTGRESQL PostgreSQL
SQLSERVER Microsoft SQL Server

这些是可选择的替代方案,而非同时运行的副本。

MySQL 示例

storage:
  type: MYSQL
  url: "jdbc:mysql://127.0.0.1:3306/minecraft"
  username: minecraft
  password: "CHANGE_ME"

PostgreSQL 示例

storage:
  type: POSTGRESQL
  url: "jdbc:postgresql://127.0.0.1:5432/minecraft"
  username: minecraft
  password: "CHANGE_ME"

JDBC 驱动已包含在内。远程数据库必须预先存在,并允许插件创建和使用其数据表。

没有专用的 SUPABASE、ORACLE 或 CUSTOM_JDBC 模式。兼容的托管 PostgreSQL 服务使用 POSTGRESQL 及其连接设置。

后端存储插件记录,包括余额、社交数据、拍卖、位置、进度和签名密钥。Minecraft 仍负责管理世界文件和玩家背包文件。

性能模型

存储保存完整的状态快照。SQL 使用共享锁定记录,因此远程延迟和频繁写入可能会影响性能。

不要在服务器进程之间共享文件后端。本插件附带的测试并未确立大型网络吞吐量标准。

备份与审计

/ve backup
/ve audit 25

导出文件存储在插件的 backups 目录中。经济日志保留最新的 2,000 条记录。

后端更改需要停止服务器后进行导出/导入迁移。请保留 storage.binding 和项目签名密钥。说明见 docs/STORAGE_RU.md。


? Velocity 和 BungeeCord

代理设置存储在 proxy.properties 中。

hub=lobby
language=en
economy.enabled=false
storage.type=MYSQL
storage.url=jdbc:mysql://127.0.0.1:3306/minecraft
storage.username=minecraft
storage.password=CHANGE_ME

网络命令

命令 用途
/hub 连接到配置的枢纽节点
/veserver [name] 列出服务器或连接
/veglist 网络玩家列表
/gmsg <player> <message> 网络私聊
/gstaff <message> 网络管理员聊天
/gbalance [player] 共享金钱余额
/gpay <player> <amount> 共享经济支付
/geco give/take/set <player> <amount> 管理员金钱调整
/veproxy 代理模块状态

权限使用:

vaulteconomy.proxy.<command>
vaulteconomy.proxy.server.<server-name>

其他玩家余额和管理员金钱操作需额外权限。

请在代理上授予这些权限。Bukkit 操作员(OP)状态不会自动转移。

共享经济

使用共同的远程 SQL 后端、匹配的玩家 UUID 以及不同的后端标识:

server-id: survival
server-id: skyblock

代理经济默认禁用。配置存储后,设置 economy.enabled=true。

后端聊天静音和忽略设置不自动适用于 /gmsg。


? 语言和占位符

包含 Bukkit 翻译:

lang/en.yml
lang/ru.yml

要添加另一种语言:

  1. 将 en.yml 复制为新的语言代码,例如 de.yml。
  2. 在保留键和 {0} 风格占位符的同时翻译值。
  3. 重新加载并选择它:
/language reload
/language set de

缺失的翻译将回退到英语。一些旧的事件消息使用服务器语言。

内容名称和物品描述属于其定义文件,不为每位查看者单独翻译。

代理翻译使用 UTF-8 .properties 文件。

PlaceholderAPI

%vaulteconomy_balance%
%vaulteconomy_balance_formatted%
%vaulteconomy_points_tokens%
%vaulteconomy_clan%
%vaulteconomy_prefix%
%vaulteconomy_kills%
%vaulteconomy_deaths%
%vaulteconomy_storage%

当安装 PlaceholderAPI 时,扩展会自动注册。


⚙️ 配置与重载

文件 用途
config.yml 经济、存储、限制、传送、战斗、拍卖、氏族、聊天
items.yml 自定义物品
recipes.yml 合成、熔炼、禁用的配方
brewing.yml 自定义酿造
fishing.yml 物种、小游戏、买家
achievements.yml 进度与奖励
effects.yml 粒子、音效、长矛
extensions.yml 监狱和扩展命令节流
lang/*.yml Bukkit 翻译

重载命令

/ve reload
/vex reload
/language reload
/customitem reload
/recipe reload
/fish reload
/achievementedit reload
  • /ve reload 更新核心配置。
  • /vex reload 重载扩展定义、语言、配方和内容权限默认值。
  • 特定内容的重载命令使用共享的扩展重载路径。
  • 存储和 server-id 不支持热切换。

在可用处使用 enabled 开关,并利用权限控制访问。GUI 文本可翻译,但此版本未为每个菜单提供通用的 YAML 布局编辑器。


? 发行说明与验证

这是一个发布候选版(Release Candidate)。

包含的报告涵盖 156 项核心检查、18 项扩展-核心检查 和 42 项 MockBukkit 检查,涉及持久性、事务、签名、配方匹配、鱼类销售跟踪和成就奖励。

这些报告不能替代在每个平台、远程数据库、物理游戏玩法或多区域 Folia 设置上的真实服务器测试。

本源码发布中的所有功能均可免费使用,无需付费激活、许可证检查或试用过期。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源