SimpleEconomy 轻量经济插件

SimpleEconomy 轻量经济插件
一款简单轻量的 Minecraft 服务端经济插件，原生兼容 Vault 与 PlaceholderAPI，支持 SQLite（默认）与 MySQL/MariaDB 存储，为服务器提供开箱即用的金币系统。
基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | SimpleEconomy |
| 开发者 | Improve（Modrinth 署名） |
| 最新版本 | 以 Modrinth 版本页为准 |
| 许可协议 | GPL-3.0-or-later |
| 兼容版本 | Minecraft Java 1.20.5–1.20.6、1.21.x |
| 运行平台 | Paper、Purpur |
| 运行环境 | Java（具体版本随 Minecraft 版本匹配） |
| 项目地址 | https://modrinth.com/plugin/simpleeconomy |
简介

SimpleEconomy 是一款主打简单、轻量的服务端经济插件。它用最精简的方式为服务器提供完整的金币（余额）系统：玩家查询余额、互相转账，管理员发放或调整资金，全部通过几条核心命令完成。

插件原生实现了 Vault 的 Economy 接口，因此任何依赖 Vault 的插件（商店、拍卖、任务、领地等）都能直接识别并使用 SimpleEconomy 作为经济后端，无需额外适配。同时提供 PlaceholderAPI 扩展，可将余额、排名等信息嵌入计分板、Tab 列表、菜单等界面。

数据存储方面，SimpleEconomy 默认使用 SQLite（零配置、开箱即用），也支持切换到 MySQL / MariaDB，满足多服务端共享同一经济数据库的网络环境需求。
核心特性
Vault 经济兼容
完整实现 Vault Economy 接口，作为大多数经济相关插件的默认后端，无缝对接商店、任务、领地等生态。
PlaceholderAPI 支持
内置 PAPI 扩展，提供余额、缩写余额、财富排名、总余额、玩家数等占位符，便于在计分板、Tab、GUI 中展示经济信息。
双数据库存储
默认 SQLite，无需任何配置即可使用；可切换为 MySQL / MariaDB，适用于跨服共享经济数据的网络环境。
轻量高效
功能聚焦、代码精简，不捆绑冗余模块，对服务端性能影响极小，适合从小型社区服到中型网络的各类规模。
核心命令齐全
覆盖玩家查余额、转账，以及管理员增减、设置、重置余额等常用操作，满足日常经济管理的全部基础需求。
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Paper、Purpur（兼容 Spigot/Paper 生态） |
| Minecraft 版本 | 1.20.5–1.20.6、1.21.x |
| 前置插件 | Vault（必装）——本插件通过 Vault 暴露经济接口 |
| 可选插件 | PlaceholderAPI（按需，用于占位符功能） |
| 数据库 | SQLite（默认，无需配置）或 MySQL / MariaDB |
安装方法
从 Modrinth 下载 SimpleEconomy 的 jar 文件
将 jar 放入服务端 plugins/ 目录
确保 Vault 也已放入 plugins/ 目录（PlaceholderAPI 按需）
启动或重启服务端，插件自动生成配置文件
如需切换数据库或多服务端共享，编辑配置后重载插件
提示：单服务端、小规模场景推荐使用默认的 SQLite，零配置即可运行；跨服网络或玩家量较大时再切换到 MySQL / MariaDB。
命令一览
命令示例板块已按需求省略，下表仅列命令与说明。权限节点详见官方文档（本文按需求不展开）。
玩家命令

| 命令 | 说明 |
| --- | --- |
| /bal [player] | 查看自己的余额，或指定玩家的余额 |
| /pay <player> <amount> | 向另一名玩家转账指定金额 |
| /baltop | 显示服务器财富榜前 10 名玩家 |
管理员命令

| 命令 | 说明 |
| --- | --- |
| /eco give <player> <amount> | 为玩家增加余额 |
| /eco take <player> <amount> | 从玩家余额中扣除金额 |
| /eco set <player> <amount> | 将玩家余额设为指定值 |
| /eco reset <player> | 将玩家余额重置为默认值 |
| /simpleeconomy reload | 重载插件配置 |
注：/eco 系列命令要求 simpleeconomy.eco 权限；/simpleeconomy reload 要求 simpleeconomy.se 权限。
占位符（PlaceholderAPI）

启用 PlaceholderAPI 后可使用以下占位符：

| 占位符 | 说明 |
| --- | --- |
| %se_balance% | 玩家完整余额（保留两位小数） |
| %se_balance_formatted% | 缩写格式余额（如 1.5K、2M、3B） |
| %se_rank% | 玩家按余额的财富排名 |
| %se_total% | 全服经济总余额（缩写格式） |
| %se_players% | 拥有余额的玩家总数 |
使用场景
生存 / 冒险服：配合 Vault 商店插件搭建金币经济体系
任务与奖励：任务插件通过 Vault 接口向玩家发放金币
跨服网络：MySQL 存储实现多服务端共享同一钱包
排行榜与计分板：用 PAPI 占位符在界面实时展示余额与排名
相关链接
Modrinth 项目页：https://modrinth.com/plugin/simpleeconomy
Modrinth 源代码：见项目页 "查看源代码" 链接
Vault（前置）：https://modrinth.com/plugin/vault