CalyxAPI
面向 CalyxMC 的模块化 Paper 1.21+ 服务器系统(Java 21),涵盖管理员、经济、聊天、家园、小游戏和装饰。通过开发者 API(类似 PlaceholderAPI 风格)使用插件扩展。
支持 MiniMessage(DE/EN)、Brigadier 命令,以及 SQLite 或 MySQL/MariaDB。
版本
| 组件 | 版本 | 分发方式 |
|---|---|---|
| 插件 (服务器) | 1.0.0 | Modrinth → CalyxAPI-1.0.0.jar 放入 plugins/ |
| API (开发者) | 1.0.0 | Maven de.calyx:CalyxAPI:1.0.0 |
插件和 API 的版本在未来的发布中可能会不同步。请确保 Gradle/Maven 中的 API 版本 相匹配。
功能
核心
- 模块化架构 — 在
config.yml中切换模块 - 德语与英语消息 (
messages_de.yml/messages_en.yml) /calyx管理中心(重载、版本、模块分支)- 默认使用 SQLite,可选 MySQL/MariaDB(HikariCP)
- 可选钩子:Vault、PlaceholderAPI、LuckPerms
模块
插件 1.0.0 内置模块:
| 模块 | 示例 |
|---|---|
| admin | /calyx admin, /ban, /kick |
| economy | /balance, /pay, /baltop |
| chat | /msg, /r |
| homes | /home, /sethome, /warp, /tpa |
| games | /game, /leave |
| cosmetics | /cosmetics |
多个命令在 1.0.0 中仅为框架,将在后续更新中实现。
要求
- Paper 1.21.4+(或兼容分支)
- Java 21
- 可选:Vault、PlaceholderAPI、LuckPerms
安装
- 从 Modrinth 下载 CalyxAPI:
CalyxAPI-1.0.0.jar(插件版本 1.0.0)。 - 将其放入服务器的
plugins/文件夹。 - 启动服务器 — 文件将在
plugins/CalyxAPI/下创建。 - 编辑
config.yml以启用/禁用模块。 - 修改配置后运行
/calyx reload(或重启服务器)。
开发者 API
用于附加插件。
仓库: DerGamer09 Repository
URL: https://repo.dergamer09.at/releases(公开,无需登录)
坐标: de.calyx:CalyxAPI:1.0.0(API 版本 1.0.0)
请使用 compileOnly — CalyxAPI 插件 JAR 仍需安装在服务器上。
Maven
pom.xml:
<repositories>
<repository>
<id>dergamer09-repository</id>
<name>DerGamer09 Repository</name>
<url>https://repo.dergamer09.at/releases</url>
</repository>
<repository>
<id>papermc</id>
<url>https://repo.papermc.io/repository/maven-public/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>de.calyx</groupId>
<artifactId>CalyxAPI</artifactId>
<version>1.0.0</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>io.papermc.paper</groupId>
<artifactId>paper-api</artifactId>
<version>1.21.4-R0.1-SNAPSHOT</version>
<scope>provided</scope>
</dependency>
</dependencies>
Gradle Kotlin
build.gradle.kts:
repositories {
mavenCentral()
maven("https://repo.papermc.io/repository/maven-public/")
maven {
name = "dergamer09Repository"
url = uri("https://repo.dergamer09.at/releases")
}
}
dependencies {
compileOnly("io.papermc.paper:paper-api:1.21.4-R0.1-SNAPSHOT")
compileOnly("de.calyx:CalyxAPI:1.0.0")
}
Gradle Groovy
build.gradle:
repositories {
mavenCentral()
maven { url 'https://repo.papermc.io/repository/maven-public/' }
maven {
name 'dergamer09Repository'
url 'https://repo.dergamer09.at/releases'
}
}
dependencies {
compileOnly 'io.papermc.paper:paper-api:1.21.4-R0.1-SNAPSHOT'
compileOnly 'de.calyx:CalyxAPI:1.0.0'
}
附加依赖
paper-plugin.yml:
dependencies:
server:
CalyxAPI:
load: BEFORE
required: true
join-classpath: true
API 用法
// 扩展 AbstractCalyxModule 并在 onEnable() 中注册:
new MyModule(this).register();
// 或者:
de.calyx.serversystem.api.CalyxAPI.registerModule(new MyModule(this));
- 通过
registerCommands(ModuleCommandRegistrar)使用 Brigadier 命令 - 事件:
CalyxModuleRegisterEvent、CalyxModuleUnregisterEvent
权限
| 权限 | 描述 |
|---|---|
calyx.admin |
/calyx 基础访问权限 |
calyx.admin.reload |
/calyx reload |
calyx.module.<id> |
/calyx <module> 分支 |
calyx.economy.* |
经济命令 |
calyx.homes.* |
家园 / 传送点 / tpa |
calyx.test |
测试附加插件(如果已安装) |
免责声明
早期版本 — 核心框架和模块框架稳定;具体的游戏玩法功能仍在实现中。
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
自定义你的Minecraft头像!
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧