开源 游戏模式 [转载][支持Folia]VelKoth|山顶之战插件 1.0.3

[MD]  # 👑 VelKoth **一款现代、高性能的山顶之战插件** 一款为 PaperMC 1.21+ 构建、利用 Java 21 特性的现代高性能 **山顶之战** 插件，VelKoth 支持多种占领模式（`CAPTURE` 与 `SCORE`）、采用 O(1) 数学区域边界检查以实现极致性能、内置自动化调度器，以及一套基于数据库的稳健可配置奖励与统计系统 [](https://papermc.io/) [](https://www.oracle.com/java/) [](https://github.com/Velmax-Studios/VelKoth) [](https://discord.gg/fGyDyp3Ak4) > ⚠️ **开发版本** > > 开发版本会根据最新提交自动生成，可能包含未完成的功能、破坏性变更或实验性代码，**不建议在生产环境中使用** > > **若您选择运行开发版本：** > > * 可能会遇到错误、崩溃或功能不完整 > * 配置与数据格式可能随时变更 > * 不保证向后兼容性 > > 仅用于测试、抢先体验或反馈贡献 📦 **下载最新开发版本：** [GitHub 发布页](https://github.com/Velmax-Studios/VelKoth/releases) * * * ## 🚀 特性 * **现代架构**：基于 Paper 1.21+ 与 Java 21 编译，**支持 Folia 的区域/实体调度器**，并采用 Incendo Cloud V2 原生 Brigadier 命令框架 * **多种占领模式**： * `CAPTURE`：传统山顶之战，一名玩家需无间断占领山顶直至达成时长 * `SCORE`：积分制山顶之战，玩家累积占领秒数直至达到目标分数 * **高性能区域**：立方体与圆柱体区域均采用 O(1) 包含算法，摒弃基于循环的方块检测，实现零服务器 TPS 影响 * **团队插件集成**：完全支持团队与阵营共同占领！同团队、阵营或队伍的玩家可协作占领而无冲突，原生支持 12+ 款插件 * **高级显示效果**：利用现代 Paper Adventure API 推送动作栏、自定义 Boss 栏、屏幕标题、粒子效果与音效，集成 **FastBoard 驱动的计分板**（兼容 TAB 与 SimpleScore 等插件）以及原生 **Paper TextDisplay 全息投影**（完全区块安全） * **稳健存储系统**：全异步 SQLite/MySQL HikariCP 连接池，存储玩家总胜场、日胜场与周胜场 * **bStats 指标集成**：使用匿名指标追踪，帮助开发者了解采用率与使用情况 * **调度器集成**：通过类 Cron 语法或简单时间格式精确定义竞技场运行时间，现支持 **通过游戏内命令进行动态调度** * **动态配置**：基于 Okaeri Configs 实现 YAML 即时热重载，所有系统消息、GUI 布局与内部设置均可修改 * **综合奖励系统**：可执行命令、分发物品堆（含溢出处理）或通过 Vault 经济系统发放奖金 * **增强型 PlaceholderAPI**：全面支持多竞技场事件、绝对/特定下一事件倒计时，以及人类可读的时间格式化 * **开发者 API**：提供完整的 Bukkit 事件套件（`KothStartEvent`、`KothWinEvent`、`KothCaptureStartEvent` 等）及静态 `VelKothAPI` 状态访问器 * * * ## ⚙️ 依赖 * **PaperMC** 1.21.x+ * **Java 21** * [Vault](https://www.spigotmc.org/resources/vault.34315/) _(可选 - 经济奖励所需)_ * [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) _(可选 - 提供大量占位符)_ * `%koth_arena[_<id>]%`、`%koth_time[_formatted][_<id>]%` * `%koth_owner[_<id>]%`、`%koth_players[_<id>]%` * `%koth_next_arena[_<id>]%`、`%koth_next_time[_formatted][_<id>]%` * **支持的团队插件** _(可选 - 允许团队成员共同占领)_ * BetterTeams、Factions (UUID/Saber)、GangsPlus、Guilds、KingdomsX * SuperiorSkyblock2、Towny Advanced、UltimateClans、Parties、AxParties * LandClaimPlugin (自定义钩子) * * * ## 🛠️ 使用与设置 ### 创建竞技场 1. 输入 `/koth wand` 获取山顶之战魔杖 2. 左键点击山顶一角，右键点击对角 3. 输入 `/koth create <arenaName>` 保存区域 4. 在生成的 `plugins/VelKoth/arenas.yml` 配置文件中修改该竞技场的特定规则、计时器与奖励！ ### 管理事件 * **手动启动事件**：`/koth start <arenaName>` * **暂停进行中事件**：`/koth pause <arenaName>` _(保留时间/分数)_ * **完全停止事件**：`/koth stop <arenaName>` * **自动化**：在 `plugins/VelKoth/config.yml` 中配置每日/每周自动事件 * * * ## 🪧 命令 VelKoth 提供稳健、自动补全的 Brigadier 命令层级 `/koth help` `velkoth.use` 查看可用命令 `/koth stats` `velkoth.use` 查看个人山顶之战胜场（日/周/总计） `/koth next <name>` `velkoth.use` 查看下一场山顶之战开始时间 `/koth list` `velkoth.admin` 查看所有竞技场及其当前状态 `/koth wand` `velkoth.admin` 获取区域选择魔杖 `/koth create <name>` `velkoth.admin` 根据魔杖选择创建新竞技场 `/koth delete <name>` `velkoth.admin` 永久删除竞技场 `/koth start <name>` `velkoth.admin` 强制立即启动竞技场 `/koth pause <name>` `velkoth.admin` 暂停进行中的占领 `/koth resume <name>` `velkoth.admin` 恢复已暂停的占领 `/koth stop <name>` `velkoth.admin` 提前停止进行中的竞技场 `/koth schedule add <day> <time> <arena>` `velkoth.admin` 向自动调度添加新事件 `/koth schedule list` `velkoth.admin` 查看所有已调度事件 `/koth schedule remove <index>` `velkoth.admin` 按列表索引移除调度事件 `/koth reload` `velkoth.admin` 热重载所有 `.yml` 配置文件 * * * ## 📜 权限 * **`velkoth.use`**：默认授予所有玩家，允许查看帮助与查询个人统计 * **`velkoth.admin`**：默认 OP 权限，授予编辑竞技场、绕过计时器与触发事件的完全管理权限 * * * ## 📦 从源码构建 如需原生编译独立阴影 JAR（包含 Cloud 命令库与 Okaeri 配置）： ```bash git clone [https://github.com/Velmax-Studios/VelKoth.git](https://github.com/Velmax-Studios/VelKoth.git) cd VelKoth ./gradlew clean shadowJar ``` [/MD]