{"url":"https://levimc.org/mods/github.com/carefly/RLXMoney/","id":"github.com/carefly/RLXMoney","name":"RLXMoney","description":"A comprehensive money management plugin for Minecraft servers based on LeviLamina framework","owner":"carefly","logo":"https://levimc.org/mods/icons/77300fa2fada245c-288.webp","repository":"https://github.com/carefly/RLXMoney","issues":"https://github.com/carefly/RLXMoney/issues","releases":"https://github.com/carefly/RLXMoney/releases","stars":0,"downloads":44,"updated":"2026-04-12T11:53:53Z","published":"2025-12-07T05:02:38Z","created":"2025-10-24T01:27:10Z","license":"CC0-1.0","side":["server"],"platform":["win-x64"],"gameVersions":["1.26.10"],"tags":["platform:levilamina","type:mod","economy","money"],"latest":{"variant":"","version":"26.10.5","install":"lip install github.com/carefly/RLXMoney@26.10.5"},"readmes":[{"file":"README.md","lang":"zh-Hans","text":"# RLXMoney\n\n[![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)](https://github.com/carefly/RLXMoney)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![LeviLamina](https://img.shields.io/badge/LeviLamina-compatible-green.svg)](https://github.com/LiteLDev/LeviLamina)\n[![C++20](https://img.shields.io/badge/C%2B%2B-20-blue.svg)](https://en.wikipedia.org/wiki/C%2B%2B20)\n\n基于LeviLamina框架的Minecraft服务器经济系统插件，提供完整的虚拟货币系统和交易管理功能。采用分层架构设计，具备高性能、高可靠性和良好的扩展性。\n\n## 📋 功能特性\n\n### 💰 核心经济功能\n- **多币种支持**: 灵活的货币配置系统，支持不同币种独立管理\n- **玩家金钱管理**: 余额查询、设置、增加、扣除\n- **玩家间转账**: 支持玩家之间互相转账（可配置手续费）\n- **交易记录**: 完整的交易历史记录和查询功能\n- **财富排行榜**: 实时更新的财富排行榜\n- **新玩家初始化**: 自动给新玩家发放初始金额\n\n### 🛠️ 管理功能\n- **配置热重载**: 支持运行时重新加载配置文件\n- **动态初始金额**: 管理员可动态修改新玩家初始金额\n- **数据持久化**: SQLite数据库存储，支持WAL模式优化\n\n\n## 💬 命令系统\n\n### 普通玩家命令\n\n| 命令                                | 权限要求 | 说明                                           | 示例                                                  |\n| ----------------------------------- | -------- | ---------------------------------------------- | ----------------------------------------------------- |\n| `/money query [币种]`               | 无       | 查询自己当前余额（不指定币种则显示所有币种）   | `/money query` 或 `/money query gold`                 |\n| `/money history [币种]`             | 无       | 查看自己的交易记录（不指定币种则显示所有币种） | `/money history` 或 `/money history gold`             |\n| `/money pay <玩家名> <金额> [币种]` | 无       | 给其他玩家转账（不指定币种使用默认币种）       | `/money pay Steve 100` 或 `/money pay Steve 100 gold` |\n\n### 管理员命令（仅限OP）\n\n| 命令                                   | 说明                         | 示例                       |\n| -------------------------------------- | ---------------------------- | -------------------------- |\n| `/moneyop set <玩家名> <金额> [币种]`  | 设置玩家余额                 | `/moneyop set Steve 5000`  |\n| `/moneyop give <玩家名> <金额> [币种]` | 给玩家增加金钱               | `/moneyop give Steve 100`  |\n| `/moneyop take <玩家名> <金额> [币种]` | 扣除玩家金钱                 | `/moneyop take Steve 50`   |\n| `/moneyop check <玩家名> [币种]`       | 查看指定玩家余额             | `/moneyop check Steve`     |\n| `/moneyop his <玩家名> [币种]`         | 查看指定玩家交易记录         | `/moneyop his Steve`       |\n| `/moneyop top [币种]`                  | 查看财富排行榜               | `/moneyop top`             |\n| `/moneyop setinitial <金额>`           | 设置默认币种的新玩家初始金额 | `/moneyop setinitial 2000` |\n| `/moneyop getinitial`                  | 查看默认币种的当前初始金额   | `/moneyop getinitial`      |\n| `/moneyop reload`                      | 重新加载配置文件             | `/moneyop reload`          |\n\n### 币种管理命令（仅限OP）\n\n| 命令                          | 说明         | 示例                          |\n| ----------------------------- | ------------ | ----------------------------- |\n| `/moneyop currency list`      | 查看所有币种 | `/moneyop currency list`      |\n| `/moneyop currency info <ID>` | 查看币种详情 | `/moneyop currency info gold` |\n\n### 权限说明\n\n- **普通玩家**: 可使用所有 `/money` 开头的命令进行基础经济操作\n- **管理员（OP）**: 可使用 `/moneyop` 开头的命令进行服务器管理操作\n- 权限检查基于 LeviLamina 的 OP 系统，无需额外配置权限节点\n\n## ⚙️ 配置文件\n\n配置文件位于 `plugins/RLXModeResources/data/money/config.json`：\n\n```json\n{\n    \"database\": {\n        \"path\": \"plugins/RLXModeResources/data/money/money.db\",\n        \"optimization\": {\n            \"wal_mode\": true,\n            \"cache_size\": 2000,\n            \"synchronous\": \"NORMAL\",\n            \"temp_store\": \"memory\"\n        }\n    },\n    \"currencies\": {\n        \"gold\": {\n            \"name\": \"金币\",\n            \"symbol\": \"§6\",\n            \"enabled\": true,\n            \"initialBalance\": 1000,\n            \"maxBalance\": 1000000000,\n            \"minTransferAmount\": 1,\n            \"transferFee\": 0,\n            \"feePercentage\": 0.0,\n            \"allowPlayerTransfer\": true,\n            \"displayFormat\": \"§6{}{}\"\n        },\n        \"diamond\": {\n            \"name\": \"钻石\",\n            \"symbol\": \"§b\",\n            \"enabled\": true,\n            \"initialBalance\": 100,\n            \"maxBalance\": 100000000,\n            \"minTransferAmount\": 1,\n            \"transferFee\": 1,\n            \"feePercentage\": 2.0,\n            \"allowPlayerTransfer\": true,\n            \"displayFormat\": \"§b{}{}\"\n        }\n    },\n    \"default_currency\": \"gold\",\n    \"top_list\": {\n        \"default_count\": 10,\n        \"max_count\": 50,\n        \"update_interval\": 300\n    },\n    \"logging\": {\n        \"enable_debug\": false,\n        \"log_transactions\": true,\n        \"log_retention_days\": 30\n    }\n}\n```\n\n### 配置项说明\n\n#### 数据库配置\n- **path**: SQLite数据库文件路径\n- **wal_mode**: WAL模式，提高并发性能\n- **cache_size**: 缓存大小（页面数）\n- **synchronous**: 同步模式（OFF/NORMAL/FULL）\n- **temp_store**: 临时存储位置\n\n#### 币种配置\n每个币种支持以下配置：\n- **name**: 币种显示名称\n- **symbol**: 币种符号（支持颜色代码）\n- **enabled**: 是否启用该币种\n- **initialBalance**: 新玩家该币种初始余额\n- **maxBalance**: 最大余额限制（0表示无限制）\n- **minTransferAmount**: 最小转账金额\n- **transferFee**: 固定转账手续费\n- **feePercentage**: 百分比手续费（0.0-100.0）\n- **allowPlayerTransfer**: 是否允许玩家间转账\n- **displayFormat**: 显示格式（第一个{}为符号，第二个{}为金额）\n\n#### 全局配置\n- **default_currency**: 默认币种ID\n\n#### 排行榜配置\n- **default_count**: 默认显示数量\n- **max_count**: 最大显示数量\n- **update_interval**: 更新间隔（秒）\n\n#### 日志配置\n- **enable_debug**: 是否启用调试日志\n- **log_transactions**: 是否记录交易日志\n- **log_retention_days**: 日志保留天数\n\n## 🔐 权限系统\n\nRLXMoney 使用基于 LeviLamina 框架的简化权限系统：\n\n### 权限实现\n\n- **普通玩家命令** (`/money`)：所有玩家均可使用，包括余额查询、转账、交易记录查看\n- **管理员命令** (`/moneyop`)：仅限服务器管理员（OP）使用，包括玩家管理、配置管理、币种管理\n\n### 权限检查机制\n\n插件使用 LeviLamina 内置的 OP 系统进行权限验证：\n- 普通玩家命令无需任何特殊权限\n- 管理员命令要求玩家具有 OP 权限（`isOperator()` 返回 true）\n- 无需额外配置权限节点或安装权限插件\n\n## 🔌 插件集成\n\nRLXMoney 提供完整的 API 接口供其他插件调用：\n\n```cpp\n// 基础操作\nrlx_money::RLXMoneyAPI::getBalance(playerXuid, currencyId)           // 获取余额\nrlx_money::RLXMoneyAPI::getAllBalances(playerXuid)                    // 获取所有币种余额\nrlx_money::RLXMoneyAPI::setBalance(playerXuid, currencyId, amount)     // 设置余额\nrlx_money::RLXMoneyAPI::addMoney(playerXuid, currencyId, amount)       // 增加金钱\nrlx_money::RLXMoneyAPI::reduceMoney(playerXuid, currencyId, amount)    // 扣除金钱\nrlx_money::RLXMoneyAPI::transferMoney(fromXuid, toXuid, currencyId, amount) // 转账\n\n// 查询操作\nrlx_money::RLXMoneyAPI::playerExists(playerXuid)                      // 检查玩家是否存在\nrlx_money::RLXMoneyAPI::hasSufficientBalance(playerXuid, currencyId, amount) // 检查余额是否充足\nrlx_money::RLXMoneyAPI::getTopBalanceList(currencyId, limit)           // 获取财富排行榜\nrlx_money::RLXMoneyAPI::getPlayerTransactions(playerXuid, currencyId, page, pageSize) // 获取交易历史\nrlx_money::RLXMoneyAPI::getPlayerTransactionCount(playerXuid)          // 获取交易记录总数\n\n// 币种和统计\nrlx_money::RLXMoneyAPI::getEnabledCurrencyIds()                        // 获取所有启用的币种ID\nrlx_money::RLXMoneyAPI::getDefaultCurrencyId()                         // 获取默认币种ID\nrlx_money::RLXMoneyAPI::getTotalWealth(currencyId)                     // 获取服务器总财富\nrlx_money::RLXMoneyAPI::getPlayerCount()                                // 获取玩家总数\nrlx_money::RLXMoneyAPI::isValidAmount(amount)                          // 验证金额是否有效\n```\n\n## 💾 数据存储\n\nRLXMoney 使用 SQLite 数据库安全存储所有经济数据：\n\n- **事务保护**: 所有操作都通过事务确保数据完整性，失败时自动回滚\n- **高性能**: 使用 WAL 模式优化并发访问\n- **数据持久化**: 所有经济数据自动保存到 SQLite 数据库\n- **手动备份**: 建议定期手动备份数据库文件（`money.db`）\n\n## 🚀 部署指南\n\n### 安装步骤\n\n1. **下载插件**\n   ```bash\n   # 从 Releases 下载对应版本\n   wget https://github.com/carefly/RLXMoney/releases/latest/download/RLXMoney.dll\n   ```\n\n2. **放置文件**\n   ```\n   server/\n   ├── plugins/\n   │   └── RLXMoney.dll\n   └── RLXModeResources/\n       └── data/\n           └── money/\n               ├── config.json\n               └── money.db\n   ```\n\n3. **配置权限**\n   无需额外配置权限节点，插件使用 LeviLamina 内置的 OP 系统进行权限验证\n\n4. **重启服务器**\n   插件会自动初始化数据库和配置\n\n### 升级指南\n\n1. 备份现有数据（复制 `money.db` 文件）\n2. 停止服务器\n3. 替换插件文件\n4. 重启服务器（数据库结构会自动创建，兼容现有数据）\n\n### 备份策略\n\n- 定期备份 `money.db` 文件\n- 保留 `config.json` 配置文件\n- 建议使用版本控制系统跟踪配置变更\n\n## 📄 许可证\n\n本项目采用 MIT 许可证，详见 [LICENSE](LICENSE) 文件。\n\n## 🆘 支持\n\n### 获取帮助\n\n- **问题反馈**: [GitHub Issues](https://github.com/carefly/RLXMoney/issues)\n- **讨论交流**: [GitHub Discussions](https://github.com/carefly/RLXMoney/discussions)\n\n### 常见问题\n\n<details>\n<summary>插件无法加载？</summary>\n\n检查以下项目：\n1. LeviLamina 版本是否兼容\n2. 插件文件是否放置在正确位置\n3. 查看服务器日志中的错误信息\n</details>\n\n<details>\n<summary>数据库连接失败？</summary>\n\n确认：\n1. 数据库文件路径是否正确\n2. 目录权限是否足够\n3. 磁盘空间是否充足\n</details>\n\n<details>\n<summary>命令无法使用？</summary>\n\n检查：\n1. 权限配置是否正确\n2. 命令格式是否符合要求\n3. 玩家是否在线（部分命令需要）\n</details>\n\n---\n\n**⭐ 如果这个项目对你有帮助，请给我们一个 Star！**\n"}],"gallery":[],"versions":[{"version":"26.10.5","prerelease":false,"released":"2026-04-12T11:53:53Z","releaseUrl":"https://github.com/carefly/RLXMoney/releases/tag/v26.10.5","manifestUrl":"https://github.com/carefly/RLXMoney/blob/v26.10.5/tooth.json","info":{"name":"RLXMoney","description":"A comprehensive money management plugin for Minecraft servers based on LeviLamina framework","tags":["platform:levilamina","type:mod","economy","money"],"logo":"https://github.com/carefly/RLXMoney/raw/main/avatar.png"},"variants":{"":[{"side":"server","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina":"26.10.5"}}]}},{"version":"26.10.4","prerelease":false,"released":"2026-04-11T04:18:48Z","releaseUrl":"https://github.com/carefly/RLXMoney/releases/tag/v26.10.4","manifestUrl":"https://github.com/carefly/RLXMoney/blob/v26.10.4/tooth.json","info":{"name":"RLXMoney","description":"A comprehensive money management plugin for Minecraft servers based on LeviLamina framework","tags":["platform:levilamina","type:mod","economy","money"],"logo":"https://github.com/carefly/RLXMoney/raw/main/avatar.png"},"variants":{"":[{"side":"server","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina":"Required LeviLamina version range"}}]}},{"version":"1.9.9","prerelease":false,"released":"2026-04-02T12:13:49Z","releaseUrl":"https://github.com/carefly/RLXMoney/releases/tag/v1.9.9","manifestUrl":"https://github.com/carefly/RLXMoney/blob/v1.9.9/tooth.json","info":{"name":"RLXMoney","description":"A comprehensive money management plugin for Minecraft servers based on LeviLamina framework","tags":["platform:levilamina","type:mod","economy","money"],"logo":"https://github.com/carefly/RLXMoney/raw/main/avatar.png"},"variants":{"":[{"side":"server","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina":"Required LeviLamina version range"}}]}},{"version":"1.9.7","prerelease":false,"released":"2026-03-04T11:55:46Z","releaseUrl":"https://github.com/carefly/RLXMoney/releases/tag/v1.9.7","manifestUrl":"https://github.com/carefly/RLXMoney/blob/v1.9.7/tooth.json","info":{"name":"RLXMoney","description":"A comprehensive money management plugin for Minecraft servers based on LeviLamina framework","tags":["platform:levilamina","type:mod","economy","money"],"logo":"https://github.com/carefly/RLXMoney/raw/main/avatar.png"},"variants":{"":[{"side":"server","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina":"Required LeviLamina version range"}}]}},{"version":"1.9.6","prerelease":false,"released":"2026-02-26T09:20:31Z","releaseUrl":"https://github.com/carefly/RLXMoney/releases/tag/v1.9.6","manifestUrl":"https://github.com/carefly/RLXMoney/blob/v1.9.6/tooth.json","info":{"name":"RLXMoney","description":"A comprehensive money management plugin for Minecraft servers based on LeviLamina framework","tags":["platform:levilamina","type:mod","economy","money"],"logo":"https://github.com/carefly/RLXMoney/raw/main/avatar.png"},"variants":{"":[{"side":"server","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina":"Required LeviLamina version range"}}]}},{"version":"1.9.5","prerelease":false,"released":"2026-02-08T02:37:18Z","releaseUrl":"https://github.com/carefly/RLXMoney/releases/tag/v1.9.5","manifestUrl":"https://github.com/carefly/RLXMoney/blob/v1.9.5/tooth.json","info":{"name":"RLXMoney","description":"A comprehensive money management plugin for Minecraft servers based on LeviLamina framework","tags":["platform:levilamina","type:mod","economy","money"],"logo":"https://github.com/carefly/RLXMoney/raw/main/avatar.png"},"variants":{"":[{"side":"server","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina":"Required LeviLamina version range"}}]}},{"version":"1.9.2","prerelease":false,"released":"2026-01-30T13:26:53Z","releaseUrl":"https://github.com/carefly/RLXMoney/releases/tag/v1.9.2","manifestUrl":"https://github.com/carefly/RLXMoney/blob/v1.9.2/tooth.json","info":{"name":"RLXMoney","description":"A comprehensive money management plugin for Minecraft servers based on LeviLamina framework","tags":["platform:levilamina","type:mod","economy","money"],"logo":"https://github.com/carefly/RLXMoney/raw/main/avatar.png"},"variants":{"":[{"side":"server","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina":"Required LeviLamina version range"}}]}},{"version":"1.0.1","prerelease":false,"released":"2025-12-15T16:10:02Z","releaseUrl":"https://github.com/carefly/RLXMoney/releases/tag/v1.0.1","manifestUrl":"https://github.com/carefly/RLXMoney/blob/v1.0.1/tooth.json","info":{"name":"RLXMoney","description":"A comprehensive money management plugin for Minecraft servers based on LeviLamina framework","tags":["platform:levilamina","type:mod","economy","money"],"logo":"https://github.com/carefly/RLXMoney/raw/main/avatar.png"},"variants":{"":[{"side":"server","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina":"Required LeviLamina version range"}}]}},{"version":"1.0.0","prerelease":false,"released":"2025-12-07T05:02:38Z","releaseUrl":"https://github.com/carefly/RLXMoney/releases/tag/v1.0.0","manifestUrl":"https://github.com/carefly/RLXMoney/blob/v1.0.0/tooth.json","info":{"name":"RLXMoney","description":"A comprehensive money management plugin for Minecraft servers based on LeviLamina framework","tags":["platform:levilamina","type:mod","economy","money"],"logo":"https://github.com/carefly/RLXMoney/raw/main/avatar.png"},"variants":{"":[{"side":"server","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina":"Required LeviLamina version range"}}]}}],"dependencies":{"github.com/liteldev/levilamina":{"id":"github.com/LiteLDev/LeviLamina","name":"LeviLamina","owner":"LiteLDev","url":"https://levimc.org/mods/github.com/LiteLDev/LeviLamina/"}},"requiredBy":[]}