LiteEco - Simple Economy Plugin 1.21.x - LiteEco - 轻量经济插件

LiteEco 插件文档

LiteEco 是一款轻量级、高性能的经济系统插件。开发者已回归并全力投入项目维护，致力于为现代服务器环境提供稳定、现代的解决方案。虽然更新可能更侧重于关键问题和社区建议，但插件的核心稳定性和性能将得到持续保障。

💡要求与兼容性

核心要求

• 推荐服务端软件：Paper 或 Folia（支持完整的多线程！）
• Paper API：必需。本插件无法在原生 Spigot 或 CraftBukkit 上运行。
• 代理支持：❌ 不支持（不支持 BungeeCord/Velocity）。

依赖插件

• 经济接口：Vault 或 VaultUnlocked（必需，用于经济系统链接）。
• 权限管理：LuckPerms（推荐）或 bPermissions。
• 变量支持：

- PlaceholderAPI (PAPI)：[点击阅读 - 下载](https://example.com)

- MiniPlaceholders：[点击阅读 - 下载](https://example.com)

已知冲突

• Towny：由于其生成假 UUID 的机制，兼容性可能受限。
• Treasury API：目前不支持。

🎮命令与权限

玩家命令

/money help

• 权限：lite.eco.help
• 描述：显示所有可用玩家命令的帮助信息。

/money bal [用户名] (货币类型)

• 权限：lite.eco.balance, lite.eco.balance.others
• 描述：查看自己或他人的余额。支持多种货币。

/money top

• 权限：lite.eco.top
• 描述：显示最富有玩家的排行榜。

/money pay <用户名> <金额> (货币类型)

• 权限：lite.eco.pay, lite.eco.pay.(货币类型)
• 描述：向另一名玩家转账。

管理员命令

/eco add/set/withdraw <用户名> <金额> (货币类型)

• 权限：lite.eco.admin.add, lite.eco.admin.set, lite.eco.admin.withdraw
• 描述：管理玩家余额。支持原版选择器（@a, @p）。

/eco database import/export <参数>

• 权限：lite.eco.admin.import / lite.eco.admin.export
• 描述：管理数据库迁移。现已包含更快的批处理功能。

/eco config lang/reload

• 权限：lite.eco.admin.lang / lite.eco.admin.reload
• 描述：快速更改语言或重载配置文件。

/eco debug <failmode/janitor/inspect/stress>

• 权限：lite.eco.admin.debug.*
• 描述：用于数据库测试和同步的高级调试工具。

🔧配置与文件

config.yml 主要设置

# LiteEco 官方设置
plugin:
  translation: EN_US
  prefix: "<dark_gray>[<green>Eco<dark_gray>] <dark_green>»</dark_green>"
  metrics: true
  vault-debug: false
  offline-suggestion-players: true

economy:
  currencies:
    dollars:
      currency_name: dollars
      currency_plural_name: dollars
      currency_singular_name: dollar
      currency_format: '$ <money>'
      starting_balance: 30
      balance_limit: 1000000
      balance_limit_check: true
      compact_display: false

  top_balances:
    filtering: false
    blacklist:
      - ExamplePlayerName
    monolog_activity: true

  formatting:
    currency_pattern: "#,##0.00"
    compacted_pattern: "#,##0.0##"
    currency_locale: en-US

database:
  connection:
    driverClassName: "org.sqlite.JDBC"
    jdbc_url: "jdbc:sqlite:plugins/LiteEco/database.db"
    username: user_name
    password: password
    sql-plugin-logger: false

✨视频教程

• 德国：相关视频教程（请参考原发布渠道获取链接）。

💡首页

本页面是 MoneyNote 插件的主要控制面板。在这里，您可以快速概览插件的运行状态、访问核心功能并进行基本配置。

插件状态

• 版本: 显示当前安装的 MoneyNote 插件版本。
• 运行状态: 指示插件是否已成功启用并正常运行。
• 数据库连接: 显示与配置的数据库（如 MySQL）的连接状态。

快速导航

此区域提供到插件各主要功能模块的快捷链接

• 插件设置: 配置插件的基本行为和参数。
• 数据库设置: 管理数据存储方式（如切换至 MySQL）。
• 经济设置: 配置与服务器经济系统相关的选项。
• 命令列表: 查看所有可用的玩家和管理员命令。
• 占位符: 获取可用于其他插件的玩家经济数据占位符列表。
• 导出与资金操作: 执行资金数据的批量导出或修改。
• 导入与第三方插件: 从其他经济插件导入数据或配置兼容性。

---

💡插件设置

在此页面配置 MoneyNote 插件的核心运行参数。

通用设置

• 语言: 选择插件的显示语言。
• 默认货币: 设置服务器经济系统的默认货币名称（如“金币”）。
• 启用日志: 是否记录经济交易日志，便于追踪和审计。

功能开关

• 允许负余额: 决定是否允许玩家的经济余额为负数。
• 启用利息系统: 是否开启定期向玩家余额支付利息的功能。
• 启用离线交易: 玩家是否可以向未在线的玩家转账。

数值设置

• 初始金额: 新玩家首次加入服务器时获得的初始资金。
• 最大金额: 单次交易或玩家账户允许的最大金额上限（防止溢出）。
• 利息率与周期: 配置利息计算的百分比和支付间隔时间。

---

💡数据库设置

在此页面配置 MoneyNote 的数据存储方式。插件默认使用本地文件存储，也支持 MySQL 数据库以实现跨服务器数据同步。

存储类型

• 使用 MySQL: 切换开关。关闭则使用本地文件（YAML）存储；开启则使用 MySQL 数据库存储。

MySQL 配置

当启用 MySQL 时，需要填写以下连接信息

• 地址: 数据库服务器的 IP 地址或域名（例如 localhost）。
• 端口: 数据库服务器的端口（默认为 3306）。
• 数据库名: 要使用的数据库名称。
• 用户名: 用于连接数据库的用户名。
• 密码: 对应用户的密码。
• 数据表前缀: 可选，为所有数据表名称添加统一前缀。

注意事项

• 切换到 MySQL 前，请确保已手动创建好指定的数据库。
• 修改存储类型后，可能需要重启服务器或使用重载命令来应用更改。
• 建议定期备份数据库，以防数据丢失。

---

💡经济设置

此页面用于配置与服务器整体经济系统相关的参数，影响货币的显示、获取与消耗。

货币显示

• 货币符号: 设置在金额前或后显示的符号（如 $ 或 金币）。
• 显示格式: 自定义金额的显示方式，例如使用千位分隔符（1,000）。

经济来源与消耗

• 启用任务奖励: 是否允许通过完成任务获得金钱。
• 启用怪物击杀奖励: 是否允许通过击杀怪物获得金钱。
• 启用商店系统: 是否启用内置或与外部商店插件的交易功能。
• 死亡惩罚: 设置玩家死亡时扣除金额的百分比或固定值。

交易设置

• 最低交易额: 单次转账或交易允许的最小金额。
• 交易手续费: 设置进行转账时收取的手续费比例或固定金额。

---

🎮命令

以下是 MoneyNote 插件提供的所有命令列表。< > 内为必填参数，[ ] 内为可选参数。

玩家命令

• /money 或 /bal - 查看自己的余额。
• /money top - 查看服务器财富排行榜。
• /pay <玩家名> <金额> - 向指定玩家转账一定金额。
• /baltop - 查看财富排行榜（别名）。

管理员命令

• /money give <玩家名> <金额> - 向指定玩家添加金额。
• /money take <玩家名> <金额> - 从指定玩家扣除金额。
• /money set <玩家名> <金额> - 将指定玩家的余额设为具体金额。
• /money reload - 重载插件的配置文件。
• /money version - 查看插件版本信息。

权限节点

• moneynote.use - 允许使用基础命令（如 /money, /pay）。
• moneynote.admin - 允许使用所有管理员命令。
• moneynote.bypass.fee - 豁免转账手续费。

---

🎮占位符

MoneyNote 提供了一系列占位符（Placeholders），可被支持 PlaceholderAPI 的插件（如聊天、计分板、称号插件）调用，以显示动态的经济数据。

玩家数据占位符

• %moneynote_balance% - 显示玩家的当前余额。
• %moneynote_balance_formatted% - 显示带货币符号和格式化的余额（如 $1,000）。
• %moneynote_balance_raw% - 显示未经格式化的原始数字余额。

服务器数据占位符

• %moneynote_top_name_<排名>% - 显示指定排名（如1,2,3）的玩家名称。
• %moneynote_top_balance_<排名>% - 显示指定排名玩家的余额。
• %moneynote_total_money% - 显示服务器所有玩家的资金总和。

使用方法

• 确保服务器已安装 PlaceholderAPI 插件。
• 在支持 PlaceholderAPI 的插件配置中，在需要的位置直接输入上述占位符。
• 占位符将在游戏中自动替换为对应的实时数据。

---

🔧导出与资金操作

此功能允许服务器管理员批量导出所有玩家的经济数据，或对资金进行大规模操作。

数据导出

• 导出格式: 通常支持导出为 CSV 或 JSON 文件。
• 导出内容: 包含玩家 UUID、玩家名、当前余额以及最后更新时间。
• 导出路径: 导出的文件将保存在插件的数据文件夹内。

批量资金操作

管理员可以通过编辑导出的文件，或使用特定命令，进行批量修改：

• 批量增加/减少: 为所有玩家或符合条件的一组玩家增加或减少一定比例/固定值的资金。
• 批量重置: 将所有玩家的余额重置为设定的初始金额。
• 资金修正: 当出现数据异常时，可用于手动校正玩家余额。

操作警告

• 在进行任何批量操作前，强烈建议先完整导出备份数据。
• 批量操作可能无法撤销，请谨慎执行。

---

🔧导入与第三方插件

此页面用于处理从其他经济插件迁移数据，或配置与第三方插件的兼容性。

数据导入

MoneyNote 支持从以下常见经济插件导入玩家余额数据：

• EssentialsX Econ
• CMI Econ
• PlayerPoints
• Vault（通过其链接的经济插件）

**导入步骤**

• 确保旧的经济插件已安装且数据正常。
• 在 MoneyNote 的导入界面选择源插件类型。
• 点击“开始导入”按钮，插件将自动读取并转移数据。
• 导入完成后，验证数据准确性，然后可安全移除旧的经济插件。

第三方插件兼容

• Vault 支持: MoneyNote 默认通过 Vault 接口提供经济服务，确保与需要经济系统的插件（如领地、商店插件）兼容。
• PlaceholderAPI: 如前所述，提供丰富的经济数据占位符。
• 其他兼容性: 确保与权限管理插件（如 LuckPerms）协同工作正常。

注意事项

• 导入过程不会删除原有插件的数据库，数据是复制的。
• 建议在服务器离线或低峰时段进行导入操作。
• 导入后，请检查核心功能（如转账、支付）是否正常工作。