BasisEra

插件

· 作者 EmpeRa0

一款面向 Paper 1.21+ / Java 21 的现代、异步、模块化核心功能套件——一个基于三大原则构建的 EssentialsX 全新替代品:零主线程 I/O、真正懒加载的模块,以及仅使用现代 API(Adventure/MiniMessage、Brigadier、Folia-

0 本站下载 0 关注 更新于 3 个月前

最新 1.7.0 · 1.21.11 · Bukkit / BungeeCord

一键开服(送7天)

BasisEra Logo and Highlights Section Titles 一款面向 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 补全。

阅读全文...

安装指南

  1. 将 jar 文件放入服务器的 plugins/ 文件夹。该插件基于 1.21.1 API 构建,可在 任何 Paper 1.21.x (1.21 – 1.21.11+) 版本上运行;不支持更旧的.major 版本(因为它所依赖的现代命令、Adventure 和调度器 API 在这些旧版本中尚不存在)。
  2. (可选)安装 Vault 和/或 PlaceholderAPI 以启用集成。
  3. 启动服务器。配置文件和语言文件将在 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 进行说明。这可能是基本的使用问题,也可能是您希望在该插件中看到的新功能。如果我认为您的想法可行,我会将其添加到插件中。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源