VelKoth

插件

· 作者 AyoSynk

一款现代、高性能的“山丘之王”(King of the Hill)模组

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

最新 1.0.9 · 26.1.2 · Folia / Paper

一键开服(送7天)
VelKoth Banner

VelKoth

一款为 PaperMC 1.21+ 构建的现代、高性能 King of the Hill (KoTH) 插件,利用 Java 21 特性打造。

VelKoth 支持多种占领模式(CAPTURE 和 SCORE),采用 O(1) 复杂度的数学区域边界检查以实现极致性能,具备自动化的集成调度器,以及基于数据库的强大可配置奖励与统计系统。

? 功能特性

  • 现代架构:基于 Paper 1.21+ 编译,使用 Java 21,支持 Folia Regional/Entity Schedulers,并采用 Incendo Cloud V2 原生 Brigadier 命令框架。
  • 多种占领模式:
    • CAPTURE:传统 KoTH 模式,玩家必须连续不间断地占领山头直到时间结束。
    • SCORE:积分制 KoTH 模式,玩家通过累积占领秒数直至达到目标分数获胜。
  • 高性能区域判定:长方体和圆柱体区域均采用 O(1) 包含算法,移除基于循环的方块检查,确保对服务器 TPS 零影响。
  • 团队插件集成:完全支持团队和阵营占领!同一团队、阵营或队伍的玩家可共同占领山头而无需竞争。原生支持 12+ 款插件。
  • 高级显示视觉效果:利用现代 Paper Adventure API 推送 ActionBars、自定义 BossBars、屏幕标题、粒子效果和音效。包括由 FastBoard 驱动的计分板(针对 TAB 和 SimpleScore 等插件进行智能覆盖)以及原生 Paper TextDisplay 全息图,完全安全适应区块加载。
  • 健壮的存储系统:完全异步的 SQLite/MySQL HikariCP 连接池,存储玩家的总胜场、每日胜场和每周胜场。
  • bStats 指标集成:使用匿名指标追踪,让开发者了解采用率和使用情况。
  • 调度器集成:通过类 Cron 语法或简单的时间格式精确定义特定竞技场运行的时间。现在支持通过游戏内命令进行 动态调度。
  • 动态配置:基于 Okaeri Configs 构建,支持 YAML 即时热重载。所有系统消息、GUI 布局和内部设置均可修改。
  • 综合奖励系统:执行命令、分发 ItemStack(含溢出掉落处理),或向胜利者发放 Vault Economy 货币。
  • 增强的 PlaceholderAPI:全面支持多竞技场事件、绝对/特定下一个事件的倒计时以及人类可读的时间格式化。
  • 开发者 API:提供完整的 Bukkit 事件套件(如 KothStartEvent、KothWinEvent、KothCaptureStartEvent 等)和供开发者使用的静态 VelKothAPI 状态访问接口。

⚙️ 依赖项

  • PaperMC 1.21.x+
  • Java 21
  • Vault (可选 - 需要用于经济奖励)
  • PlaceholderAPI (可选 - 暴露大量占位符)
    • %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 获取 KoTH 权杖。
  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 胜利记录(每日/每周/总计)
/koth next <name> velkoth.use 查看下一个 Koth 何时开始
/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 set mode <arena> <CAPTURE|SCORE> velkoth.admin 更改获胜条件(占领计时或累计积分)
/koth set time <arena> <seconds> velkoth.admin 设置所需的占领时间
/koth set score <arena> <maxScore> velkoth.admin 设置 SCORE 模式的目标分数
/koth set grace <arena> <seconds> velkoth.admin 设置重置占领前的宽限期
/koth reward add <arena> <reward> velkoth.admin 添加新的胜利奖励(支持命令、经济、物品)
/koth reward list <arena> velkoth.admin 详细查看某个竞技场的所有配置奖励
/koth reward remove <arena> <index> velkoth.admin 通过索引移除特定奖励
/koth reward clear <arena> velkoth.admin 清除某个竞技场的所有奖励
/koth reload velkoth.admin 热重载所有 .yml 配置文件

? 奖励

VelKoth 支持强大的奖励系统,可以通过游戏内命令或 arenas.yml 进行完全管理。奖励将发放给获胜玩家(如果启用了团队挂钩,则发放给团队/派系的所有在线成员)。

支持的奖励类型

类型 格式 示例
命令 COMMAND:<cmd> 或 <cmd> COMMAND:give %player% netherite_ingot 1
经济 ECONOMY:<amount> ECONOMY:1000(需要 Vault)
物品 ITEM:<material>[:<amount>] ITEM:GOLD_BLOCK:3

奖励占位符

  • %player%: 获胜者的名称。
  • %arena%: 竞技场的 ID。

查看奖励

你可以使用以下命令查看为某个竞技场配置的具体奖励: /koth reward list <arena> 这将显示带有可读描述的编号奖励列表(例如 Command: give <player> diamond 1)。


? 权限

  • velkoth.use: 默认授予所有玩家的权限,允许他们查看帮助并检查个人统计数据。
  • velkoth.admin: 默认 OP 权限,授予完整的访问权限以编辑竞技场、绕过计时器并触发事件。

? 从源代码构建

要以原生方式编译独立的 shadow JAR(包括 Cloud 命令库和 Okaeri 配置):

git clone https://github.com/YourName/VelKoth.git
cd VelKoth
./gradlew clean shadowJar

编译后的插件将保存在 /build/libs/ 目录中。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源