✨ VaultEconomy
经济、服务器管理与自定义玩法——融为一体。
VaultEconomy 3.0.0-rc1 将持久化经济与拍卖行、氏族、传送、管理、自定义物品、配方、酿造、交互式钓鱼、成就和视觉效果结合在一起。
构建生存模式经济,创建 RPG 进度系统,奖励玩家的活动,或通过共享数据库连接多个服务器。
免费功能 • 服务端玩法 • 无需客户端模组 • 无需外部数据库

? 兼容性
声明的 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、领地或资源包。
? 安装
- 停止服务器并备份现有的插件和玩家数据。
- 移除旧的 VaultEconomy JAR 文件。
- 安装
VaultEconomy-3.0.0-rc1.jar。
- 保留现有的
plugins/VaultEconomy 目录。
- 启动服务器。
- 检查
/ve status 和 /vex status。
- 配置权限并使用非 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
- 将匹配的基药水放入酿造架。
- 如需燃料,加入烈焰粉。
- 加入原料,或者如果原版界面不接受,则手持该原料。
- 潜行右键点击酿造架,或注视它并运行
/brew start。
- 在完成之前保持背包不变。
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
要添加另一种语言:
- 将
en.yml 复制为新的语言代码,例如 de.yml。
- 在保留键和
{0} 风格占位符的同时翻译值。
- 重新加载并选择它:
/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 设置上的真实服务器测试。
本源码发布中的所有功能均可免费使用,无需付费激活、许可证检查或试用过期。
✨ VaultEconomy
Economy, server management, and custom gameplay — together.
VaultEconomy 3.0.0-rc1 combines a persistent economy with auctions, clans, teleportation, moderation, custom items, recipes, brewing, interactive fishing, achievements, and visual effects.
Build a Survival economy, create RPG progression, reward players for their activities, or connect multiple servers through a shared database.
Free features • Server-side gameplay • No required client mod • No external database required

🧩 Compatibility
Declared Minecraft compatibility: 1.13–26.3.
| Platform |
Available functionality |
| Paper |
Gameplay systems, economy, commands, and supported additional APIs |
| Purpur |
Bukkit/Paper gameplay implementation |
| Spigot |
Bukkit gameplay implementation |
| Bukkit / CraftBukkit |
Bukkit gameplay implementation |
| Folia |
Gameplay implementation with entity, region, and global scheduling adapters |
| Velocity |
Network commands and optional shared economy |
| BungeeCord |
Network commands and optional shared economy |
Velocity and BungeeCord are proxies. Custom items, inventories, crafting, fishing, and other world mechanics run on the connected gameplay servers.
The compatibility range is maintainer-declared. Included automated API reports cover Spigot 1.13, Spigot 1.21.11, and Paper 26.2; they do not certify every intermediate release or a live 26.3 deployment.
Use the Java version required by your server software. Features such as newer attributes, Darkness, CustomModelData, virtual anvils, and furnace acceleration depend on available server APIs.
🌟 Main Features
| Category |
Included systems |
| Economy |
Balances, payments, leaderboards, custom currencies, Vault provider |
| Trading |
Auction house, taxes, expiration, purchase confirmation, delivery queue |
| Clans |
Roles, invitations, treasury, homes, storage upgrades, banners, diplomacy |
| Travel |
Spawn, homes, warps, teleport requests, previous locations, random teleportation |
| Community |
Private messages, mail, marriage, nicknames, prefixes, kits |
| Administration |
Moderation, combat restrictions, jail, inventory inspection, player controls |
| Custom content |
Items, potions, click actions, crafting, brewing, furnaces |
| Fishing |
Timing minigame, species, size variation, rarity, buyer menu |
| Progression |
Configurable achievements with money, items, and command rewards |
| Visuals |
Particle patterns, sounds, titles, charged spears |
| Storage |
11 selectable file and database backends |
| Languages |
English, Russian, and additional translation files |
The Bukkit plugin registers 108 root commands. Its extension catalog contains 391 command paths, with 819 static permission definitions and additional content-specific permissions.
These are command paths and permissions, not a claim of 391 unrelated gameplay systems.
🎮 Where Can You Use It?
- Survival: balances, homes, player trading, clans, fishing, and achievements.
- RPG: custom potions, special items, crafting chains, progression, and rewards.
- Community servers: communication, kits, marriage, moderation, and shared clan activities.
- Events: particles, player effects, charged spears, collectible rewards, and command-driven items.
- Networks: shared balances, server switching, and proxy messaging.
VaultEconomy supplies configurable systems. It does not automatically generate cities, quests, NPCs, land claims, or a resource pack.
📥 Installation
- Stop the server and back up existing plugin and player data.
- Remove the previous VaultEconomy JAR.
- Install
VaultEconomy-3.0.0-rc1.jar.
- Preserve the existing
plugins/VaultEconomy directory.
- Start the server.
- Check
/ve status and /vex status.
- Configure permissions and test with a non-operator account.
SQLite is the default backend and is created automatically.
Optional integrations
| Integration |
Purpose |
| Vault |
Connects compatible external plugins to the main economy |
| PlaceholderAPI |
Exposes balances and other plugin values |
| LuckPerms |
Optional permission management |
| LibsDisguises |
Actual mob disguises, with its required dependencies |
Built-in economy commands work without Vault.
If another plugin registers the same command, use the namespace:
/vaulteconomy:balance
/vaulteconomy:pay Alex 25
English setup
Edit config.yml:
language: en
currency:
symbol: "$"
singular: coin
plural: coins
Then run:
/ve reload
/language reload
/language set en
Bundled custom-content names may contain both languages. Edit those names separately in items.yml, fishing.yml, and achievements.yml.
💰 Economy and Custom Currencies
Main currency
/balance [player]
/pay <player> <amount>
/baltop [currency]
/eco give <player> <amount>
/eco take <player> <amount>
/eco set <player> <amount>
Aliases include /bal, /money, and /bits.
Additional currencies
Create tokens for events, progression, or rewards:
/point create tokens T
/point list
/point give tokens Alex 50
/point balance tokens Alex
/point pay tokens Alex 5
/baltop tokens
Administrative operations support give, take, and set.
Transaction handling
- Amounts use integer hundredths.
- Commands accept up to two decimal places.
- Invalid amounts, overflow, and self-payments are rejected.
- Transfers commit before success is reported.
- Failed storage operations are not reported as successful payments.
Vault exposes the main currency. Additional currencies use the plugin’s own commands and placeholders.
Vault bank accounts are not implemented. Clan treasuries use internal accounts.
🛍️ Auction House
Sell the item stack in your main hand:
/ah sell 250
Other commands:
/ah
/ah mine
/ah cancel <listing-id>
/ah claim
/claim
/ahelp
Included behavior
- Listing browser with seller and price.
- Purchase confirmation.
- Configurable sale tax.
- Offline seller payments.
- Listing expiration.
- Returns and purchases delivered through a queue.
- Administrative recovery tools for interrupted operations.
/claim collects the next queued delivery when inventory space is available.
auction:
tax-percent: 3.0
lifetime-seconds: 172800
limits:
auction: 5
172800 seconds equals 48 hours.
Recovery commands:
/ah recover list
/ah recover <operation-id> restore
/ah recover <operation-id> discard
Ambiguous item deliveries require an administrator to check records and inventories before choosing a recovery action.
🛡️ Clans and Social Features
Clans have four roles: member, officer, deputy, and owner.
Features include:
- Invitations and open joining.
- Treasury deposits and withdrawals.
- Clan home.
- Shared storage from 27 to 54 slots.
- Storage upgrades.
- Banners and clan chat.
- Promotions, demotions, and ownership transfer.
- PvP toggle.
- Alliances and war relationships.
/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
Permissions and clan roles are checked separately. A command permission does not automatically grant treasury authority.
Diplomacy does not include territory claiming.
Marriage and communication
/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>
🏠 Teleportation and Daily Utilities
| System |
Commands |
| Spawn |
/spawn, /setspawn |
| Homes |
/sethome, /home, /delhome, /homes |
| Warps |
/setwarp, /warp, /delwarp, /warps |
| Requests |
/tpa, /tpahere, /tpaccept, /tpdeny, /tptoggle, /tpcancel |
| Other travel |
/back, /rtp, /tp, /tphere, /tppos |
| Kits |
/kit, /kits, /createkit, /delkit |
| Information |
/rules, /motd, /list, /ping, /seen, /playtime |
Teleport requests expire after 60 seconds.
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
Teleport delays and cooldowns are measured in seconds.
Kits save main inventory contents, excluding armor and off-hand. Access requires the root kit permission and vaulteconomy.kit.<name>.
📦 Custom Items Without Java
Create reusable definitions in items.yml.
IDs use lowercase letters, numbers, underscores, and hyphens, with a maximum length of 48 characters.
Example: wand and potion
Merge these definitions into the existing items: section:
items:
wind_wand:
enabled: true
public: true
material: BLAZE_ROD
name: "&bWind Wand"
cooldown-seconds: 15
lore:
- "&7Right-click for Speed II."
- "&8Cooldown: 15 seconds"
actions:
right_click:
- "effect SPEED:8:2"
- "sound ENTITY_EXPERIENCE_ORB_PICKUP"
- "animation spiral"
- "message &bThe wind carries you forward!"
frost_potion:
enabled: true
public: true
material: POTION
name: "&bFrost Potion"
color: "66CCFF"
effects:
- "SLOWNESS:30:2"
- "RESISTANCE:30:1"
Apply and obtain:
/customitem reload
/customitem give wind_wand 1
/customitem give frost_potion 1 Alex
Item settings
| Field |
Purpose |
enabled |
Enables creation and configured action handling |
public |
Controls default use/place access |
material |
Existing Minecraft material |
name, lore |
Display name and description |
unbreakable |
Durability behavior |
model |
CustomModelData where supported |
color |
Potion color in hexadecimal RGB |
effects |
Custom potion effects |
cooldown-seconds |
Action activation delay |
actions |
Click and player-target actions |
kind |
Special behavior marker, such as spear |
furnace |
Custom furnace properties |
CustomModelData does not generate a texture. A compatible resource pack is needed for custom models or appearances.
Effect syntax
TYPE:seconds:level
STRENGTH:45:3 means Strength III for 45 seconds.
Potion definitions support durations of 1–86,400 seconds and levels 1–255, subject to available server effects.
Create with commands
/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
New definitions default to public: false. Change it in YAML or grant the specific content permission.
Additional management:
/customitem list
/customitem inspect <id>
/customitem clone <id> <new-id>
/customitem delete <id> confirm
/customitem menu
🪄 Item Actions
Triggers
right_click — right-click in the air or on a block.
left_click — left-click in the air or on a block.
target — right-click another player.
Actions
message <text>
effect TYPE:seconds:level
command <player-command>
console <console-command>
jail <cell>:<seconds>
sound <SOUND>
animation <style>
Command actions support {player} and {target}. Write commands without a leading slash.
Player commands use the player’s permissions. Console commands are administrator-defined actions.
Action use does not automatically consume the item.
Jail wand example
items:
prison_wand:
enabled: true
public: false
material: BLAZE_ROD
name: "&5Prison Wand"
cooldown-seconds: 5
actions:
target:
- "jail default:60"
- "sound BLOCK_ANVIL_LAND"
/jail set default
/customitem give prison_wand 1
Using it requires both:
vaulteconomy.item.use.prison_wand
vaulteconomy.item.target.prison_wand
Identity and updates
Custom items use HMAC-signed lore markers. Renaming an ordinary item does not turn it into a valid custom item.
Preserve the signing key stored in the backend.
Changing a definition affects future creation and action lookup. Existing item names, lore, and potion metadata are not automatically rebuilt in every inventory.
🔨 Crafting and Recipe Control
Recipes belong in recipes.yml.
Supported types:
shaped
shapeless
furnace
Shaped recipe
recipes:
frost_craft:
enabled: true
public: true
type: shaped
result: frost_potion
amount: 1
shape:
- " I "
- "IPI"
- " I "
ingredients:
I: ICE
P: POTION
Spaces represent empty slots.
Use custom:<id> for exact signed custom ingredients:
ingredients:
P: "custom:frost_potion"
Results use the item ID without custom:.
Signed custom items are not accepted as ordinary crafting ingredients simply because their material matches.
Recipe editor
/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
In commands, / separates rows and _ means an empty slot.
New recipes start disabled and private. Finish the definition, enable it, and configure its permissions.
Blocking recipes
/recipe block minecraft:diamond_sword
/recipe unblock minecraft:diamond_sword
/recipe blockresult DIAMOND_SWORD
/recipe unblockresult DIAMOND_SWORD
/recipe reload
Blocking uses the Bukkit recipe registry. Recipes registered later by another plugin may require another reload.
Smelting definitions require ordinary material inputs; exact custom ingredients are supported for crafting and brewing.
⚗️ Brewing and Custom Furnaces
Brewing — brewing.yml
recipes:
frost_brew:
enabled: true
public: true
base: POTION
ingredient: ICE
result: frost_potion
ticks: 200
fuel: true
- Put matching base potions into the stand.
- Add blaze powder when required.
- Add the ingredient, or hold it if the vanilla interface will not accept it.
- Sneak-right-click the stand or look at it and run
/brew start.
- Leave the inventory unchanged until completion.
200 ticks is approximately ten seconds at normal tick rate. One blaze powder supplies 20 cycles.
/brew create <id> <base> <ingredient> <result-id>
/brew ticks <id> <ticks>
/brew fuel <id> <true|false>
/brew enabled <id> <true|false>
Custom furnaces
Add this section to a custom FURNACE item:
furnace:
speed: 2
fuel-multiplier: 2
output-multiplier: 1
speed: 2 requests half the normal cooking time.
fuel-multiplier: 2 makes fuel last twice as long.
output-multiplier changes output quantity within stack limits.
Acceleration requires the relevant server API. Normal supported block drops can preserve custom furnace identity; explosions do not guarantee item recovery.
🎣 Interactive Fishing
Fishing adds a timing minigame after a qualifying vanilla catch.
The interface uses a moving indicator, green target zone, and hit/miss counters. Right-click or press the swap-hand key, normally F, inside the target zone.
Defaults:
game:
hits: 5
misses: 3
period-ticks: 40
window: 0.28
Five hits land the fish. Three misses or missed windows lose it. Moving more than eight blocks away ends the attempt.
Included species
- River Carp.
- Silver Salmon.
- Moon Ray.
- Abyss Puffer.
- Golden Leviathan.
Custom species — fishing.yml
species:
crystal_carp:
enabled: true
name: "&bCrystal Carp"
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
Weight is measured in kilograms; length in centimeters.
chance is a relative selection weight, not an independent percentage. Empty world and biome lists mean unrestricted selection.
Player commands
/fish menu
/fish price
/fish sell
/fish sellall
/fish list
/fish stats
/fish cancel
/fish animation ripple
Buyer
The buyer is a menu and command system, not an automatically spawned NPC.
/fish buyer set
/fish buyer require-location true
Location enforcement requires players to sell within six blocks of the saved point.
Price depends on base price, size, rarity, selection weight, and buyer multipliers.
Each generated fish has a signed serial number. A serial already sold cannot receive another payout.
Administrators can edit species with /fishspecies, buyer settings with /fish buyer, and difficulty with /fish difficulty.
✨ Effects and Charged Spears
Particle patterns
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
Spears
/spear give
/spear style storm
/spear styles
Hold the custom spear, sneak to charge, then throw within three seconds after releasing sneak.
Styles:
ember
storm
void
tidal
solar
Settings in 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
Screen darkening uses available potion effects, not a custom client shader.
🏆 Achievements
Create progression in 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: []
Triggers
block_break
block_place
kill
death
craft
join
vanilla_advancement
fish_catch
fish_sell
item_use
brew
spear_throw
Use match: "*" when no specific match is required.
/achievements
/achievements progress <id>
/achievements rewards <id>
/achievements claim <id>
/achievements claimall
Item rewards enter /claim. Reward commands support {player} and {uuid}.
Money, claimed status, and queued item rewards are recorded together. External console commands cannot share a transaction with another plugin; interrupted rewards may need inspection.
Administrative tools:
/achievementedit create <id> <trigger> <goal>
/achievementedit grant <id> <player>
/achievementedit reset <id> <player> confirm
/achievementedit pending <player>
Creative block breaking/placing does not count. Previously completed vanilla advancements are not automatically imported.
🛠️ Item Editing and Player Controls
Held-item editor
/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
Also supports material, amount, durability, item flags, CustomModelData, books, leather color, potion color, and player heads.
/itemedit edits the held item. /customitem edits reusable definitions.
Potion removal affects custom potion effects. It is not a universal editor for every vanilla base-potion property or another plugin’s custom metadata.
Player controls
/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
Additional controls include health, food, air, flight, movement, gravity, names, titles, velocity, effects, and disguises.
Attributes such as scale and interaction range require a server version that provides them.
Moderation and jail
/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
Jail preserves the sentence and return location. Sentence time continues while offline.
Inventory tools
/craft
/anvil
/enderchest [player]
/invsee <player>
/sejf
/repair [all]
Other-player inventory inspection is read-only. The personal safe has 54 slots.
🔑 Permissions
Core commands use:
vaulteconomy.<command>
Extension commands need both root and command-path permissions.
Example for freezing another player:
vaulteconomy.playerctl
vaulteconomy.playerctl.freeze
vaulteconomy.playerctl.freeze.others
Content permissions
| Permission |
Controls |
vaulteconomy.item.use.<id> |
Custom-item use |
vaulteconomy.item.give.<id> |
Giving that item |
vaulteconomy.item.place.<id> |
Placing its block |
vaulteconomy.item.target.<id> |
Player-target actions |
vaulteconomy.recipe.craft.<id> |
Crafting a recipe |
vaulteconomy.recipe.brew.<id> |
Starting custom brewing |
vaulteconomy.achievement.earn.<id> |
Achievement progress |
vaulteconomy.achievement.claim.<id> |
Achievement rewards |
vaulteconomy.kit.<name> |
Receiving a kit |
public: true changes applicable content defaults. It does not grant editing, giving, or target-action rights.
Activity permissions
vaulteconomy.fish.play
vaulteconomy.spear.use
vaulteconomy.effects.view
vaulteconomy.achievements.earn
Useful additional permissions
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
Rank limits
vaulteconomy.limit.homes.10
vaulteconomy.limit.auction.15
vaulteconomy.limit.rtp.5000
vaulteconomy.limit.near.200
Positive numeric permissions increase the configuration baseline, within built-in maximums.
LuckPerms examples
/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
Most editing and administrative commands default to operators. Everyday economy, social, fishing, and achievement commands are generally available to players, with additional checks where applicable.
Use:
/vex help [page]
/vex permissions [filter]
The archive contains the full permissions.json and docs/COMMAND_CATALOG.md. Help and extension command-path suggestions are permission-filtered.
💾 Storage
Choose one of 11 backends:
| Type |
Backend |
YAML |
YAML file |
JSON |
JSON file |
PROPERTIES |
Java Properties |
XML |
XML Properties |
CSV |
Key/value CSV |
SQLITE |
Embedded SQLite — default |
H2 |
Embedded H2 |
MYSQL |
MySQL |
MARIADB |
MariaDB |
POSTGRESQL |
PostgreSQL |
SQLSERVER |
Microsoft SQL Server |
These are selectable alternatives, not simultaneous replicas.
MySQL example
storage:
type: MYSQL
url: "jdbc:mysql://127.0.0.1:3306/minecraft"
username: minecraft
password: "CHANGE_ME"
PostgreSQL example
storage:
type: POSTGRESQL
url: "jdbc:postgresql://127.0.0.1:5432/minecraft"
username: minecraft
password: "CHANGE_ME"
JDBC drivers are included. Remote databases must exist and allow the plugin to create and use its table.
There is no dedicated SUPABASE, ORACLE, or CUSTOM_JDBC mode. A compatible hosted PostgreSQL service uses POSTGRESQL with its connection settings.
The backend stores plugin records, including balances, social data, auctions, locations, progress, and signing keys. Minecraft still manages world and player-inventory files.
Performance model
Storage saves complete state snapshots. SQL uses a shared locked record, so remote latency and frequent writes can affect performance.
Do not share file backends between server processes. Large-network throughput is not established by the included tests.
Backups and audit
/ve backup
/ve audit 25
Exports are stored in the plugin’s backups directory. The economy journal retains the latest 2,000 entries.
Backend changes require stopped-server export/import migration. Preserve storage.binding and the item-signing key. Instructions are included in docs/STORAGE_RU.md.
🌐 Velocity and BungeeCord
Proxy settings are stored in 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
Network commands
| Command |
Purpose |
/hub |
Connect to the configured hub |
/veserver [name] |
List servers or connect |
/veglist |
Network player list |
/gmsg <player> <message> |
Network private message |
/gstaff <message> |
Network staff chat |
/gbalance [player] |
Shared money balance |
/gpay <player> <amount> |
Shared-economy payment |
/geco give/take/set <player> <amount> |
Administrative money changes |
/veproxy |
Proxy-module status |
Permissions use:
vaulteconomy.proxy.<command>
vaulteconomy.proxy.server.<server-name>
Additional rights apply to other-player balances and administrative money operations.
Grant permissions on the proxy. Bukkit operator status does not automatically transfer.
Shared economy
Use a common remote SQL backend, matching player UUIDs, and different backend identities:
server-id: survival
server-id: skyblock
Proxy economy is disabled by default. Set economy.enabled=true after configuring storage.
Backend chat mutes and ignores do not automatically govern /gmsg.
🌍 Languages and Placeholders
Included Bukkit translations:
lang/en.yml
lang/ru.yml
To add another language:
- Copy
en.yml to a new language code, such as de.yml.
- Translate values while preserving keys and
{0}-style placeholders.
- Reload and select it:
/language reload
/language set de
Missing translations fall back to English. Some older event messages use the server language.
Content names and lore belong to their definition files and are not translated separately for each viewer.
Proxy translations use UTF-8 .properties files.
PlaceholderAPI
%vaulteconomy_balance%
%vaulteconomy_balance_formatted%
%vaulteconomy_points_tokens%
%vaulteconomy_clan%
%vaulteconomy_prefix%
%vaulteconomy_kills%
%vaulteconomy_deaths%
%vaulteconomy_storage%
The expansion registers automatically when PlaceholderAPI is installed.
⚙️ Configuration and Reloads
| File |
Purpose |
config.yml |
Economy, storage, limits, teleports, combat, auctions, clans, chat |
items.yml |
Custom items |
recipes.yml |
Crafting, smelting, blocked recipes |
brewing.yml |
Custom brewing |
fishing.yml |
Species, minigame, buyer |
achievements.yml |
Progression and rewards |
effects.yml |
Particles, sounds, spears |
extensions.yml |
Jail and extension command throttle |
lang/*.yml |
Bukkit translations |
Reload commands
/ve reload
/vex reload
/language reload
/customitem reload
/recipe reload
/fish reload
/achievementedit reload
/ve reload updates core configuration.
/vex reload reloads extension definitions, languages, recipes, and content permission defaults.
- Content-specific reload commands use shared extension reload paths.
- Storage and
server-id are not switched live.
Use enabled switches where available and permissions to control access. GUI text is translatable, but this release does not include a universal YAML layout editor for every menu.
🧪 Release Notes and Verification
This is a release candidate.
Included reports contain 156 core checks, 18 extension-core checks, and 42 MockBukkit checks covering persistence, transactions, signatures, recipe matching, fish-sale tracking, and achievement rewards.
These reports do not replace real-server testing of every platform, remote database, physical gameplay mechanic, or multi-region Folia setup.
All features in this source release are available without paid activation, license checks, or trial expiration.
评论 0
登录后参与评分
还没有评论,来抢沙发吧