OxFunds
OxFunds 是一款适用于 Paper 服务器的多货币经济插件。它专为希望在不依赖单一货币的情况下构建灵活经济系统的服务器而设计。
您可以创建和管理多种货币,为每种货币设置独立的名称、符号、格式和限制,并在整个服务器的经济系统中使用它们。
核心功能
OxFunds 提供了一个内置保护机制、集成支持和管理工具的多货币框架:
- 可配置货币: 支持同时运行多个独立货币(例如 Gold、Iron、Shards、Tokens),并允许自定义名称、符号和格式。
- 玩家支付与余额: 内置玩家间转账指令和即时余额查询功能。
- 集成支持: 原生支持 PlaceholderAPI,可在计分板/菜单中显示余额;可选集成 PlayerPoints;以及具有自定义转换率的基于经验值(XP)的经济功能。
- 交易保护: 可配置的交易限额、余额上限以及可疑交易保护,以维持经济系统的稳定性。
- 交易日志: 详细记录货币转移信息,包括参与玩家、货币类型、金额和元数据。
- 数据存储与 Discord 通知: 持久化自动保存玩家数据,并支持可选的 Discord Webhook 以发送交易警报。
玩家与管理员指令
OxFunds 为玩家和管理员提供了直观的游戏内指令。
玩家指令
/pay <player> <amount> <currency> — 直接向其他玩家转移货币。
/balance — 查看您当前的货币余额。
/balance <player> — 查看其他玩家的公开余额。
管理员指令
/oxfunds status — 查看系统整体状态和数据库状态。
/oxfunds info <player> — 检查特定玩家的详细经济信息。
/oxfunds reload — 热重载插件配置文件,无需重启服务器。
/oxfunds help — 显示管理员指令帮助菜单。
/givepoints <player> <amount> <currency> — 向玩家余额中添加货币。
/takepoints <player> <amount> <currency> — 从玩家余额中扣除货币。
占位符
安装 PlaceholderAPI 后,OxFunds 会暴露动态占位符,可用于计分板、聊天、TAB 列表和 UI 菜单:
%oxfunds_balance_<currency>% — 特定货币的原始数值余额。
%oxfunds_balance_<currency>_formatted% — 格式化后的余额输出(例如 $1,000 或 100 Shards)。
%oxfunds_currency_<currency>_displayname% — 配置的货币显示名称。
%oxfunds_currency_<currency>_symbol% — 配置的货币符号。
安装与部署
系统设置说明、前置条件和操作指南。
要求
- 服务器平台: 现代 Paper 服务器(或兼容分支)。
- 环境: 仅限服务端插件(无需客户端修改)。
- 可选依赖项: PlaceholderAPI(用于占位符)和 PlayerPoints(用于跨积分集成)。
快速设置
- 下载最新的
OxFunds.jar 发布版本。
- 将文件放入服务器的
plugins/ 目录中。
- 启动或重启服务器以生成默认配置文件。
- 在配置文件中调整货币参数、格式、交易限额和存储选项。
- 执行
/oxfunds reload 或重启服务器以应用更改。
数据与建议
- 目标受众: 非常适合需要自定义多层级经济系统的生存服、SMP、RPG 和网络服务器。
- 备份: 玩家经济数据会自动保存。建议生产环境中的服务器管理员定期备份 OxFunds 数据文件夹。
鸣谢
由 ItzRealOrionX 用 ❤️ 开发。
OxFunds
OxFunds is a multi-currency economy plugin for Paper servers. It is built for servers that want a flexible economy system without relying on a single currency.
You can create and manage multiple currencies, give each currency its own name, symbol, formatting, and limits, and use them throughout your server's economy.
Core Features
OxFunds provides a multi-currency framework with built-in protections, integrations, and administrative tools:
- Configurable Currencies: Support for running multiple independent currencies simultaneously (e.g., Gold, Iron, Shards, Tokens) with custom names, symbols, and formatting.
- Player Payments & Balances: Built-in player-to-player transfer commands and instant balance checking.
- Integrations: Native support for PlaceholderAPI to display balances across scoreboards/menus, optional PlayerPoints integration, and XP-based economy features with custom conversion rates.
- Transaction Protections: Configurable transaction limits, balance caps, and suspicious transaction protection to maintain economy stability.
- Transaction Logging: Detailed logging of currency transfers, including participating players, currency types, amounts, and metadata.
- Data Storage & Discord Notifications: Persistent automatic player data saving and optional Discord webhook support for transaction alerts.
Player & Admin Commands
OxFunds provides straightforward in-game commands for both players and administrators.
Player Commands
/pay <player> <amount> <currency> — Transfer currency directly to another player.
/balance — View your current currency balances.
/balance <player> — View another player's public balance.
Administrative Commands
/oxfunds status — View overall system and database status.
/oxfunds info <player> — Inspect detailed economy information for a specific player.
/oxfunds reload — Hot-reload plugin configuration files without restarting.
/oxfunds help — Display the admin command help menu.
/givepoints <player> <amount> <currency> — Administer and add currency to a player's balance.
/takepoints <player> <amount> <currency> — Deduct currency directly from a player's balance.
Placeholders
When PlaceholderAPI is installed, OxFunds exposes dynamic placeholders for scoreboards, chat, TAB, and UI menus:
%oxfunds_balance_<currency>% — Raw numeric balance for a specific currency.
%oxfunds_balance_<currency>_formatted% — Formatted balance output (e.g., $1,000 or 100 Shards).
%oxfunds_currency_<currency>_displayname% — Configured display name of the currency.
%oxfunds_currency_<currency>_symbol% — Configured currency symbol.
Installation & Deployment
System setup instructions, prerequisites, and operational guidelines.
Requirements
- Server Platform: Modern Paper server (or compatible fork).
- Environment: Server-side plugin only (no client-side modifications required).
- Optional Dependencies: PlaceholderAPI (for placeholders) and PlayerPoints (for cross-points integration).
Quick Setup
- Download the latest
OxFunds.jar release.
- Place the file into your server's
plugins/ directory.
- Start or restart the server to generate default configuration files.
- Adjust currency parameters, formatting, transaction limits, and storage options in the configuration files.
- Execute
/oxfunds reload or restart the server to apply your changes.
Data & Recommendations
- Target Audience: Ideal for Survival, SMP, RPG, and network servers that require custom multi-tier economies.
- Backups: Player economy data is saved automatically. Server administrators should maintain regular backups of the OxFunds data folder on production environments.
Credits
Developed with ❤️ by ItzRealOrionX.
评论 0
登录后参与评分
还没有评论,来抢沙发吧