LuxEconomy
一个简洁优雅的 Paper 服务器经济插件,支持 MySQL 和 Vault 集成。
概述
LuxEconomy 为您的服务器提供了一个轻量级的经济系统,拥有精美的格式化消息、完全自定义选项以及无缝的 Vault 集成。玩家可以查看余额、互相转账,管理员则可以通过强大的工具管理整个经济系统。

✨ 特性
玩家经济
- 使用
/bal 查看您的余额
- 使用
/pay 向其他玩家转账
- 美观的余额显示格式
- 为新玩家提供自动初始资金
管理员管理
- 为单个玩家设置金额
- 给玩家增加或扣除资金
- 一次性重置或设置所有玩家的余额
- 完全掌控经济系统

集成与自定义
- 完整的 Vault 经济支持(可与其他插件配合使用)
- MySQL 数据库用于持久化存储
- 使用 MiniMessage 格式完全自定义消息
- 所有命令均支持 Tab 补全
- 可配置新玩家的初始资金
? 安装
要求
- Paper 1.21+
- MySQL Server
- Vault 插件(可选,但推荐安装)
设置步骤
-
下载并放置
- 下载
LuxEconomy.jar
- 将其放入您的
plugins/ 文件夹中
- 启动服务器(它将创建默认配置文件)
-
配置数据库
- 打开
plugins/LuxEconomy/config.yml
- 设置您的 MySQL 凭据:
database:
host: "localhost"
port: 3306
name: "luxeconomy"
username: "root"
password: ""
-
完成!
- 插件加载并自动创建数据表
- 玩家在首次加入时获得初始资金
? 命令
玩家命令
查看余额
/bal [player]
查看您自己或其他玩家的余额。
转账
/pay <player> <amount>
向其他玩家转账。请先检查余额以确保资金充足。
管理员命令
管理玩家余额
/eco give <player|self> <amount>
给玩家添加资金。使用 self 给自己加钱。
/eco set <player|self> <amount>
将玩家的余额设置为指定金额。
/eco remove <player|self> <amount>
从玩家余额中扣除资金。
批量操作
/econadmin setall <amount>
将所有玩家的余额设置为同一金额。适用于经济重置。
/econadmin reset
将所有人的余额重置为 $0.00。请谨慎使用。
? 权限
使用您的权限插件(如 LuckPerms 等)授予玩家以下权限:
luxeconomy.admin # 访问 /eco 和 /econadmin 命令
默认情况下,只有 OP(管理员)才能访问管理员命令。
⚙️ 配置
config.yml - 数据库与经济设置
database:
host: "localhost"
port: 3306
name: "luxeconomy"
username: "root"
password: ""
economy:
starting-balance: 100.0 # 新玩家获得的初始金额
messages.yml - 自定义所有消息
所有消息均使用 MiniMessage 格式来支持颜色和样式。
颜色代码:
<#7FFF00> - 酸橙绿(成功)
<#cc444c> - 深红(错误)
<#aaccee> - 浅蓝(金额)
<gray> - 灰色文本
<white> - 白色文本
<bold> - 粗体文本
自定义消息示例:
pay:
success_sender: "<#7FFF00><bold>Sent <reset><#aaccee>$%amount% <gray>to %player%"
可用占位符:
%amount% - 金额数量
%player% - 玩家名称
%count% - 玩家数量
? 数据库
LuxEconomy 会自动创建和管理 MySQL 数据库。
表:player_balance
uuid - 玩家的唯一标识符
username - 玩家名称
balance - 当前金额
无需手动设置数据库。
? Vault 集成
LuxEconomy 会自动向 Vault 注册。Jobs、商店和 Minions 等其他插件可以使用您的经济系统。
对于插件开发者:
RoyalEconomy economy = (RoyalEconomy) Bukkit.getServer()
.getServicesManager()
.getRegistration(net.milkbowl.vault.economy.Economy.class)
.getProvider();
economy.getBalance(player);
economy.withdrawPlayer(player, 100);
economy.depositPlayer(player, 50);
? 自定义示例
更改初始资金
编辑 config.yml:
economy:
starting-balance: 500.0
更改成功提示颜色
编辑 messages.yml:
pay:
success_sender: "<#FF6B00><bold>Sent <reset><white>$%amount% to %player%"
添加货币符号
编辑 messages.yml:
balance:
self: "<gray>? Balance: <white>%amount%"
? 使用技巧
发送前检查余额
在使用 /pay 之前,请务必检查您的余额:
/bal # 查看您的余额
/pay User 50 # 给他们转账 $50
批量重置经济
重置所有人的余额(小心!):
/econadmin reset
设置统一金额
给每个人发放 $1000:
/econadmin setall 1000
给予新玩家资金
在 config.yml 中更改初始资金:
starting-balance: 250.0 # 新玩家将获得 $250
❓ 常见问题
问:我可以将此插件与其他经济插件一起使用吗?
答:不可以,只能有一个经济提供者处于活动状态。请选择一个经济插件。
问:我如何备份玩家数据?
答:请备份您的 MySQL 数据库。请联系您的主机提供商了解备份流程。
问:玩家可以看到其他玩家的余额吗?
答:可以,通过 /bal <player> 查看。您可以通过编辑权限来移除这一功能。
问:这能在旧版 Paper 上运行吗?
答:需要 Paper 1.21+。请升级您的服务器以兼容。
问:如何从另一个经济插件迁移?
答:设置初始资金,然后使用 /econadmin setall 将资金平均分配给所有人。
? 故障排除
插件无法启动
- 检查
config.yml 中的 MySQL 连接配置
- 确认 MySQL 服务器正在运行
- 检查防火墙/端口访问权限
“No registered Vault provider” 错误
- 必须安装 Vault 插件
- LuxEconomy 必须在 Vault 之后加载
- 完全重启服务器
玩家未获得初始余额
- 检查
config.yml 中的 economy.starting-balance
- 初始余额仅适用于新玩家
- 对现有玩家使用
/econadmin setall
数据库连接被拒绝
- 验证 MySQL 凭据是否正确
- 确保 MySQL 服务器可访问
- 检查主机/端口设置
? 许可证
LuxEconomy 按原样提供供您服务器使用。
支持
插件出现问题?请检查以下内容:
- 配置 - 验证
config.yml 和 messages.yml
- 数据库 - 测试 MySQL 连接
- 权限 - 检查权限节点分配
- 更新 - 确保您正在运行最新版本
简单。干净。可靠。
LuxEconomy
A simple, elegant economy plugin for Paper servers with MySQL support and Vault integration.
Overview
LuxEconomy provides a lightweight economy system for your server with beautiful formatted messages, complete customization, and seamless Vault integration. Players can check balances, send money to each other, and admins can manage the economy with powerful tools.

✨ Features
Player Economy
- Check your balance with
/bal
- Send money to other players with
/pay
- Beautiful formatted balance display
- Automatic starting balance for new players
Admin Management
- Set money for individual players
- Give/remove money from players
- Reset or set everyone's balance at once
- Complete economy control

Integration & Customization
- Full Vault economy support (works with other plugins)
- MySQL database for persistent storage
- Fully customizable messages using MiniMessage format
- Tab completion for all commands
- Configurable starting balance for new players
? Installation
Requirements
- Paper 1.21+
- MySQL Server
- Vault plugin (optional, but recommended)
Setup Steps
-
Download & Place
- Download
LuxEconomy.jar
- Place it in your
plugins/ folder
- Start your server (it will create default config files)
-
Configure Database
- Open
plugins/LuxEconomy/config.yml
- Set your MySQL credentials:
database:
host: "localhost"
port: 3306
name: "luxeconomy"
username: "root"
password: ""
- Save and restart the server
-
Done!
- Plugin loads and creates tables automatically
- Players get starting balance on first join
? Commands
Player Commands
Check Balance
/bal [player]
View your balance or another player's balance.
Send Money
/pay <player> <amount>
Send money to another player. Check balance first to ensure you have enough.
Admin Commands
Manage Player Balance
/eco give <player|self> <amount>
Give money to a player. Use self to give to yourself.
/eco set <player|self> <amount>
Set a player's balance to an exact amount.
/eco remove <player|self> <amount>
Remove money from a player's balance.
Bulk Operations
/econadmin setall <amount>
Set every player's balance to the same amount. Useful for economy resets.
/econadmin reset
Reset everyone's balance to $0.00. Use with caution.
? Permissions
Grant these to players using your permission plugin (LuckPerms, etc):
luxeconomy.admin # Access to /eco and /econadmin commands
By default, only OPs have access to admin commands.
⚙️ Configuration
config.yml - Database & Economy Settings
database:
host: "localhost"
port: 3306
name: "luxeconomy"
username: "root"
password: ""
economy:
starting-balance: 100.0 # Amount new players receive
messages.yml - Customize All Messages
All messages use MiniMessage format for colors and styling.
Color Codes:
<#7FFF00> - Lime green (success)
<#cc444c> - Dark red (errors)
<#aaccee> - Light blue (amounts)
<gray> - Gray text
<white> - White text
<bold> - Bold text
Example Custom Message:
pay:
success_sender: "<#7FFF00><bold>Sent <reset><#aaccee>$%amount% <gray>to %player%"
Available Placeholders:
%amount% - Money amount
%player% - Player name
%count% - Number of players
? Database
LuxEconomy automatically creates and manages the MySQL database.
Table: player_balance
uuid - Player's unique identifier
username - Player's name
balance - Current money amount
No manual database setup required.
? Vault Integration
LuxEconomy registers automatically with Vault. Other plugins like jobs, shops, and minions can use your economy system.
For Plugin Developers:
RoyalEconomy economy = (RoyalEconomy) Bukkit.getServer()
.getServicesManager()
.getRegistration(net.milkbowl.vault.economy.Economy.class)
.getProvider();
economy.getBalance(player);
economy.withdrawPlayer(player, 100);
economy.depositPlayer(player, 50);
? Customization Examples
Change Starting Balance
Edit config.yml:
economy:
starting-balance: 500.0
Change Success Color
Edit messages.yml:
pay:
success_sender: "<#FF6B00><bold>Sent <reset><white>$%amount% to %player%"
Add Currency Symbol
Edit messages.yml:
balance:
self: "<gray>? Balance: <white>%amount%"
? Usage Tips
Check Before Sending
Always check your balance before using /pay:
/bal # Check your balance
/pay User 50 # Send them $50
Bulk Reset Economy
Reset everyone's balance (careful!):
/econadmin reset
Set Everyone to Same Amount
Give everyone $1000:
/econadmin setall 1000
Give New Players Money
Change starting balance in config.yml:
starting-balance: 250.0 # New players get $250
❓ FAQ
Q: Can I use this with other economy plugins?
A: No, only one economy provider can be active. Choose one economy plugin.
Q: How do I backup player data?
A: Backup your MySQL database. Contact your host for backup procedures.
Q: Can players see other players' balances?
A: Yes, with /bal <player>. You can remove this by editing permissions.
Q: Does this work on older Paper versions?
A: Requires Paper 1.21+. Update your server for compatibility.
Q: How do I migrate from another economy plugin?
A: Set starting balance, then use /econadmin setall to distribute money equally to everyone.
? Troubleshooting
Plugin won't start
- Check MySQL connection in
config.yml
- Verify MySQL server is running
- Check firewall/port access
"No registered Vault provider" error
- Vault plugin must be installed
- LuxEconomy must load after Vault
- Restart server completely
Players don't receive starting balance
- Check
economy.starting-balance in config.yml
- Starting balance only applies to new players
- Use
/econadmin setall for existing players
Database connection refused
- Verify MySQL credentials are correct
- Ensure MySQL server is accessible
- Check host/port settings
? License
LuxEconomy is provided as-is for your server.
Support
Issues with the plugin? Check the following:
- Configuration - Verify
config.yml and messages.yml
- Database - Test MySQL connection
- Permissions - Check permission node assignments
- Updates - Ensure you're running the latest version
Simple. Clean. Reliable.
评论 0
登录后参与评分
还没有评论,来抢沙发吧