CalyxAPI

插件

· 作者 FrediFret

适用于服务器管理、经济系统、聊天、家园、小游戏和外观装饰的模块化插件——可扩展的模块 API 用于添加附加功能(支持德语/英语,Brigadier 命令,SQLite/MySQL)。

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

最新 1.0.0 · 1.21.11 · Paper / Purpur

一键开服(送7天)

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

安装

  1. 从 Modrinth 下载 CalyxAPI:CalyxAPI-1.0.0.jar(插件版本 1.0.0)。
  2. 将其放入服务器的 plugins/ 文件夹。
  3. 启动服务器 — 文件将在 plugins/CalyxAPI/ 下创建。
  4. 编辑 config.yml 以启用/禁用模块。
  5. 修改配置后运行 /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 测试附加插件(如果已安装)

免责声明

早期版本 — 核心框架和模块框架稳定;具体的游戏玩法功能仍在实现中。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源