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 (自定义钩子)
?️ 用法与设置
创建竞技场
- 输入
/koth wand获取 KoTH 权杖。 - 左键点击山头的一个角,右键点击对角。
- 输入
/koth create <arenaName>保存该区域。 - 在生成的
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/ 目录中。
VelKoth
A modern, high-performance King of the Hill (KoTH) plugin built for PaperMC 1.21+ utilizing Java 21 features.
VelKoth supports multiple capture modes (CAPTURE and SCORE), O(1) mathematical region boundary checks for supreme performance, an automated integrated scheduler, and a robust configurable database-backed reward and statistics system.
? Features
- Modern Architecture: Compiled against Paper 1.21+ using Java 21, Folia-supported Regional/Entity Schedulers, and the Incendo Cloud V2 native Brigadier command framework.
- Multiple Capture Modes:
CAPTURE: Traditional KoTH where one player must hold the hill uninterrupted for the duration.SCORE: Point-based KoTH where players accumulate capture seconds until they reach the target score.
- High Performance Regions: Both Cuboid and Cylinder regions utilise O(1) containment algorithms removing loop-based block checks for zero server TPS impact.
- Team Plugin Integrations: Fully supports team and faction capturing! Players in the same team, faction, or party can capture hills together without contesting. Supports 12+ plugins natively.
- Advanced Display Visuals: Leverages modern Paper Adventure API to push ActionBars, custom BossBars, on-screen Titles, Particle effects, and Sounds. Includes FastBoard-powered Scoreboards (with smart-overrides for plugins like TAB and SimpleScore) and native Paper TextDisplay Holograms that are fully chunk-safe.
- Robust Storage System: Fully asynchronous SQLite/MySQL HikariCP connection pooling storing player total wins, daily wins, and weekly wins.
- bStats Metrics Integration: Uses anonymous metrics tracking to keep developers informed on adoption rates and usage.
- Scheduler Integration: Define exactly when specific arenas should run via Cron-like syntax or simple time formats. Now supports Dynamic Scheduling via in-game commands.
- Dynamic Configuration: Built on Okaeri Configs for instant YAML hot-reloading. Every system message, GUI layout, and internal setting can be modified.
- Comprehensive Rewards: Execute commands, distribute ItemStacks (with overflow drop handling), or give Vault Economy money to the winners.
- Enhanced PlaceholderAPI: Comprehensive support for multi-arena events, absolute/specific next event countdowns, and human-readable time formatting.
- Developer API: Features a full suite of Bukkit Events (
KothStartEvent,KothWinEvent,KothCaptureStartEvent, etc.) and a staticVelKothAPIstate accessor for developers.
⚙️ Dependencies
- PaperMC 1.21.x+
- Java 21
- Vault (Optional - Required for Economy rewards)
- PlaceholderAPI (Optional - Exposes extensive placeholders)
%koth_arena[_<id>]%,%koth_time[_formatted][_<id>]%%koth_owner[_<id>]%,%koth_players[_<id>]%%koth_next_arena[_<id>]%,%koth_next_time[_formatted][_<id>]%
- Supported Team Plugins (Optional - Allows team members to capture together)
- BetterTeams, Factions (UUID/Saber), GangsPlus, Guilds, KingdomsX
- SuperiorSkyblock2, Towny Advanced, UltimateClans, Parties, AxParties
- LandClaimPlugin (Custom hook)
?️ Usage & Setup
Creating an Arena
- Grab the KoTH Wand by typing
/koth wand. - Left-Click one corner of your hill, and Right-Click the opposite corner.
- Type
/koth create <arenaName>to save the region. - Modify specific rules, timers, and rewards for this arena in the generated
plugins/VelKoth/arenas.ymlconfiguration!
Administering Events
- Start an event manually:
/koth start <arenaName> - Pause an ongoing event (maintaining times/scores):
/koth pause <arenaName> - Stop an event completely:
/koth stop <arenaName> - Configure automatic daily/weekly events in
plugins/VelKoth/config.yml.
? Commands
VelKoth features a robust, auto-completing Brigadier command hierarchy.
| Command | Permission | Description |
|---|---|---|
/koth help |
velkoth.use |
View available commands |
/koth stats |
velkoth.use |
View your personal KoTH wins (Daily/Weekly/All-time) |
/koth next <name> |
velkoth.use |
See when is the next Koth gonna start |
/koth list |
velkoth.admin |
View all arenas and their current status |
/koth wand |
velkoth.admin |
Receive the region selection wand |
/koth create <name> |
velkoth.admin |
Create a new arena from your wand selection |
/koth delete <name> |
velkoth.admin |
Permanently delete an arena |
/koth start <name> |
velkoth.admin |
Force start an arena immediately |
/koth pause <name> |
velkoth.admin |
Pause an active capture session |
/koth resume <name> |
velkoth.admin |
Resume a paused capture session |
/koth stop <name> |
velkoth.admin |
Stop an active arena prematurely |
/koth schedule add <day> <time> <arena> |
velkoth.admin |
Add a new event to the automated schedule |
/koth schedule list |
velkoth.admin |
View all currently scheduled events |
/koth schedule remove <index> |
velkoth.admin |
Remove a scheduled event by its list index |
/koth set mode <arena> <CAPTURE|SCORE> |
velkoth.admin |
Change the win condition (Hold timer or Cumulative points) |
/koth set time <arena> <seconds> |
velkoth.admin |
Set the required capture time |
/koth set score <arena> <maxScore> |
velkoth.admin |
Set the target score for SCORE mode |
/koth set grace <arena> <seconds> |
velkoth.admin |
Set the grace period before capture resets |
/koth reward add <arena> <reward> |
velkoth.admin |
Add a new win reward (supports Commands, Economy, Items) |
/koth reward list <arena> |
velkoth.admin |
View all configured rewards for an arena in detail |
/koth reward remove <arena> <index> |
velkoth.admin |
Remove a specific reward by index |
/koth reward clear <arena> |
velkoth.admin |
Clear all rewards for an arena |
/koth reload |
velkoth.admin |
Hot-reload all .yml configuration files |
? Rewards
VelKoth supports a powerful reward system that can be managed entirely in-game or via arenas.yml. Rewards are granted to the winning player (or all online members of a team/faction if team hooks are active).
Supported Reward Types
| Type | Format | Example |
|---|---|---|
| Command | COMMAND:<cmd> or <cmd> |
COMMAND:give %player% netherite_ingot 1 |
| Economy | ECONOMY:<amount> |
ECONOMY:1000 (Requires Vault) |
| Item | ITEM:<material>[:<amount>] |
ITEM:GOLD_BLOCK:3 |
Reward Placeholders
%player%: Name of the winner.%arena%: ID of the arena.
Viewing Rewards
You can see exactly what rewards are configured for an arena using:
/koth reward list <arena>
This will display a numbered list of rewards with human-readable descriptions (e.g., Command: give <player> diamond 1).
? Permissions
velkoth.use: Default permission granted to all players allowing them to view help and check their personal statistics.velkoth.admin: Default OP permission granting full administrative access to edit arenas, bypass timers, and trigger events.
? Building from Source
To compile the standalone shadow JAR natively (including the Cloud command libraries and Okaeri configs):
git clone https://github.com/YourName/VelKoth.git
cd VelKoth
./gradlew clean shadowJar
Your compiled plugin will be deposited in /build/libs/.
下载 VelKoth
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VelKoth
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VelKoth
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VelKoth
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VelKoth
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VelKoth
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VelKoth
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VelKoth
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VelKoth
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VelKoth
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
修复了当插件在正在进行的 KOTH 中重新加载时,其全息图仍然保留的问题。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
使床在所有维度中爆炸的模组
插件
为 Armor Poser 模组添加兼容性
插件
SkyBlock、OneBlock、Boxed、SkyGrid、AcidIsland、CaveBlock、Poseidon、StrangerRealms——以及更多!这些只是由 BentoBox 支持的基于岛屿的游戏模式之一。来自原版 ASkyBlock 的作者。
插件
一个高度兼容、功能完善且稳定的 TPA 模组
插件
AbAcc AbAcc 是一款适用于 Minecraft 服务器的管理插件,可简化玩家作弊检测与举报管理工作。工作人员可以发起并管理对可疑玩家的检查流程,并在检查完成后将其释放。
评论 0
登录后参与评分
还没有评论,来抢沙发吧