一款面向 Paper 1.21+ / Java 21 的现代、异步、模块化核心插件套件——作为 EssentialsX 的纯净替代方案,其设计围绕三大原则:零主线程 I/O、真正懒加载的模块以及仅使用现代 API(Adventure/MiniMessage、Brigadier、兼容 Folia)。
亮点
- 全异步处理 — 所有持久化操作均通过 HikariCP 在专用线程池上运行,并返回
CompletableFuture。服务器主线程永远不会直接访问数据库或磁盘。
- 异步传送 —
getChunkAtAsync → 安全检查 → teleportAsync,因此传送过程绝不会强制进行同步区块加载。
- 真正懒加载的模块 — 在
config.yml 中禁用的模块不会被类加载:无监听器、无命令、无额外开销。
- 精确的经济系统 — 定点数货币(避免浮点数误差)、带索引的
/baltop 命令以及完整的交易日志。
- 玩家级国际化 (i18n) — MiniMessage 格式的消息根据每位玩家的客户端语言环境自动选择。内置七种语言(英语、土耳其语、西班牙语、德语、法语、俄语、中文),升级时会自动补全缺失的键值。
- 兼容 Folia — 提供区域/实体调度器抽象,不存在共享可变状态。
- 任意存储,零配置 — 默认使用 SQLite(无需安装任何东西),或为网络环境使用 MySQL / MariaDB。捆绑了所有三种 JDBC 驱动,且在 MySQL/MariaDB 环境下数据库会自动创建。
- 感知网络架构 — 当后端共享同一数据库时,持久化状态(封禁、静音、监狱、隐身、经济、家园等)会跟随玩家跨越代理服务器迁移;员工聊天可覆盖整个网络——无需 Redis。
- 员工管理工具 — 隐身、冻结、员工模式、员工聊天、举报、惩罚历史、聊天过滤、小号检测。
- 可选集成 — 注册为 Vault 经济提供商,并在检测到相应插件时提供 PlaceholderAPI 扩展(这两个插件本身未捆绑)。
命令参考
每个模块都可以在 config.yml 的 modules: 下关闭——被禁用的模块的命令将完全消失。<required> 参数为必填项,[optional] 为选填项。名称、传送点、家园、套装和玩家名均支持 Tab 补全。
阅读全文...
安装指南
- 将 jar 文件放入服务器的
plugins/ 文件夹。该插件基于 1.21.1 API 构建,可在 任何 Paper 1.21.x (1.21 – 1.21.11+) 版本上运行;不支持更旧的.major 版本(因为它所依赖的现代命令、Adventure 和调度器 API 在这些旧版本中尚不存在)。
- (可选)安装 Vault 和/或 PlaceholderAPI 以启用集成。
- 启动服务器。配置文件和语言文件将在
plugins/BasisERA/ 目录下生成。
在 config.yml 中切换模块需要在完整重启后生效,而不是通过 /basisera reload 生效(reload 仅刷新配置值和语言,不重新加载已启用的模块列表)。当插件在更新中增加新选项时,现有的 config.yml 会自动补充这些新配置。
存储与网络
存储默认设置为 SQLite —— 单个文件,无需安装。对于网络环境(或仅需共享数据库的情况),请将其设置为 MySQL 或 MariaDB:
storage:
type: mariadb # sqlite | mysql | mariadb
pool-size: 8
mysql: # 以下键值 mysql 和 mariadb 通用
host: 127.0.0.1
port: 3306
database: basisera
username: basisera
password: secret
params: "?useSSL=false&characterEncoding=utf8"
所有三种 JDBC 驱动(SQLite、MySQL、MariaDB)均已捆绑,因此运行时不会下载任何内容。如果账户拥有 CREATE 权限,数据库本身会在首次启动时自动创建——你只需要提供服务器和用户即可。
将所有后端服务器指向同一个 MySQL/MariaDB 数据库,则玩家状态——包括封禁、静音、监狱、经济、家园、传送点、昵称和隐身——将被共享,从而在玩家跨服移动时保持同步。结合网络员工聊天 (/sca),这足以满足常见的代理网络需求,而无需 Redis。(即时的跨服动作——例如对当前位于其他服务器的玩家执行隐身——仍然需要实时的消息传递层,本插件未包含此功能。)
许可证
本项目依据 MIT License 发布——只要保留版权声明,即可免费用于修改、分发,包括商业用途。
如果您在使用该插件时遇到任何问题,请前往 GitHub 页面并提交 Issue 进行说明。这可能是基本的使用问题,也可能是您希望在该插件中看到的新功能。如果我认为您的想法可行,我会将其添加到插件中。
A modern, asynchronous, modular essentials suite for Paper 1.21+ / Java 21 — a clean-room alternative to EssentialsX built around three principles: zero main-thread I/O, truly lazy modules, and modern APIs only (Adventure/MiniMessage, Brigadier, Folia-ready).
Highlights
- Async everything — all persistence runs on a dedicated pool via HikariCP and returns
CompletableFuture. The server thread never touches the database or disk.
- Async teleports —
getChunkAtAsync → safety check → teleportAsync, so teleporting never
forces a synchronous chunk load.
- Truly lazy modules — a module disabled in
config.yml is never class-loaded: no listeners,
no commands, no cost.
- Exact economy — fixed-point money (no floating point), an indexed
/baltop, and a full
transaction log.
- Per-player i18n — MiniMessage messages, chosen automatically from each player's client
locale. Seven languages ship in the box (English, Turkish, Spanish, German, French, Russian,
Chinese), with automatic key top-up on upgrade.
- Folia-ready — region/entity scheduler abstractions, no shared mutable state.
- Any storage, zero setup — SQLite by default (nothing to install), or MySQL / MariaDB for
networks. All three JDBC drivers are bundled, and on MySQL/MariaDB the database is created
automatically.
- Network-aware — persisted state (bans, mutes, jails, vanish, economy, homes…) follows a
player across a proxy when the backends share one database, and staff chat can span the whole
network — no Redis required.
- Staff tooling — vanish, freeze, staff mode, staff chat, reports, punishment history, chat
filter, alt-account detection.
- Optional integrations — registers as a Vault economy provider and ships a
PlaceholderAPI expansion when those plugins are present (neither is bundled).
Command reference
Every module can be switched off in config.yml under modules: — a disabled module's commands
disappear entirely. <required> arguments are mandatory, [optional] ones are not. Names, warps,
homes, kits and players all tab-complete.
Read More...
Installing
- Drop the jar into your server's
plugins/ folder. It is built against the 1.21.1 API and runs
on any Paper 1.21.x (1.21 – 1.21.11+); older majors aren't supported (the modern command,
Adventure and scheduler APIs it relies on don't exist there).
- (Optional) Install Vault and/or
PlaceholderAPI for the integrations.
- Start the server. Configuration and language files are generated under
plugins/BasisERA/.
Toggling a module in config.yml takes effect on a full restart, not on /basisera reload
(reload refreshes config values and languages, not which modules are loaded). When the plugin
gains new options in an update, your existing config.yml is topped up automatically.
Storage & networks
Storage defaults to SQLite — a single file, nothing to install. For a network (or just a
shared database) set it to MySQL or MariaDB:
storage:
type: mariadb # sqlite | mysql | mariadb
pool-size: 8
mysql: # these keys are shared by mysql and mariadb
host: 127.0.0.1
port: 3306
database: basisera
username: basisera
password: secret
params: "?useSSL=false&characterEncoding=utf8"
All three JDBC drivers (SQLite, MySQL, MariaDB) are bundled, so nothing is downloaded at runtime.
If the account has CREATE rights, the database itself is created automatically on first
start — you only need the server and a user.
Point every backend server at the same MySQL/MariaDB and per-player state — bans, mutes,
jails, economy, homes, warps, nicknames and vanish — is shared, so it follows players as they
move between servers. Combined with network staff chat (/sca), this covers the common
proxy-network needs without Redis. (Instant cross-server actions — e.g. vanishing someone who is
on another server right now — would still need a live messaging layer and aren't included.)
License
Released under the MIT License — free to use, modify and distribute, including
commercially, as long as the copyright notice is kept.
If you are having any problem with the plugin, get into the github page and go to the issues to explain it. It can be a basic problem. It can be a new feature you want to see in the plugin.
If i see no problem with what's your idea i will added to the plugin.
评论 0
登录后参与评分
还没有评论,来抢沙发吧