AuroraDominion 是一款高性能的 Minecraft Paper 插件(1.21.x),旨在追踪并加冕在 WorldGuard 定义的具体区域中击杀数最多的玩家。
该插件具备完全可定制的视觉公告、异步数据库存储功能,以及一个缓存的 PlaceholdersAPI (PAPI) 扩展,便于在计分板、聊天或 FancyHolograms 等外部全息图插件中轻松显示统计数据。
? 功能特性
- WorldGuard 监控:自动追踪并统计发生在配置的区域边界内的 PvP 死亡事件。
- 可定制的输出 (
messages.yml & config.yml):编辑聊天广播、标题、副标题、动作栏提示以及每个监控区域的自定义显示名称。
- 强大的连接池:使用 HikariCP 实现异步 SQLite(本地文件)和 MySQL/MariaDB(外部池)连接。
- 防刷保护:可配置同一对玩家注册击杀之间的冷却时间(秒),以防止排行榜被刷分。
- 无卡顿设计:所有数据库事务和占位符更新均在主线程之外运行,确保零 TPS 影响。
- PlaceholdersAPI (PAPI) 支持:直接从活动内存缓存提供排行榜统计数据,防止刻延迟。
- 自定义生成位置:提供简单的命令来注册全息图的坐标向量。
- 文件更新保护:替换
.jar 文件不会覆盖或修改现有的配置更改。
?️ 命令与权限
命令
/auroradominion (别名: /ad, /dominion)
/ad reload: 立即重新加载配置(config.yml、messages.yml、hologram-locations.yml)并刷新扩展缓存。
/ad sethologram <region>: 将你当前的坐标设置为该区域全息图的生成位置。
权限
auroradominion.use: 授予基本命令访问权限(默认:所有人)。
auroradominion.admin: 授予管理权限以重载配置和设置全息图点位(默认:OP)。
? 占位符 (PAPI)
使用以下 PlaceholdersAPI 键值在任何地方接入 AuroraDominion 数据:
%auroradominion_dominant_<region>%: 该区域当前领先玩家的名称。
%auroradominion_dominant_kills_<region>%: 该区域领先玩家的击杀数。
%auroradominion_top_<pos>_name_<region>%: 该区域排名 <pos>(1 到 10)的玩家用户名。
%auroradominion_top_<pos>_kills_<region>%: 该区域排名 <pos>(1 到 10)的击杀数。
(示例:%auroradominion_top_1_name_pvp_arena% 返回 PvP Arena 中排名第一的玩家用户名)
? 安装与要求
- 确保你的服务器运行 Paper 1.21.x(Java 21 或更高版本)。
- 在你的
plugins 文件夹中安装必要的库:
- WorldGuard(必需 - 用于区域边界检查)。
- PlaceholderAPI(推荐 - 用于解析占位符)。
- FancyHolograms(推荐 - 用于引用我们的占位符构建最高击杀全息图)。
- 将
AuroraDominion.jar 放入 plugins 文件夹。
- 重启服务器以生成配置文件。
AuroraDominion is a high-performance Minecraft Paper plugin (1.21.x) designed to track and crown the player with the most kills inside specific regions defined by WorldGuard.
The plugin features fully customizable visual announcements, asynchronous database storage, and a cached PlaceholdersAPI (PAPI) expansion to easily display statistics in scoreboards, chat, or external hologram plugins like FancyHolograms.
? Features
- WorldGuard Monitoring: Automatically tracks and counts PvP deaths occurring physically inside configured region boundaries.
- Customizable Output (
messages.yml & config.yml): Edit chat broadcasts, titles, subtitles, action bar notices, and custom display names for each monitored region.
- Robust Connection Pooling: Asynchronous SQLite (local file) and MySQL/MariaDB (external pool) connections using HikariCP.
- Anti-Farm Protection: Configurable cooldown in seconds between registered kills of the same player pair to prevent leaderboard farming.
- Lag-Free Design: All database transactions and placeholder updates run completely off the main thread to ensure zero TPS impact.
- PlaceholdersAPI (PAPI) Support: Serve leaderboard statistics straight from an active memory cache to prevent tick lag.
- Custom Spawning Positions: Straightforward command to register coordinate vectors for holograms.
- File Update Protection: Replacing the
.jar file will not overwrite or modify existing config edits.
?️ Commands and Permissions
Commands
/auroradominion (aliases: /ad, /dominion)
/ad reload: Instantly reloads configurations (config.yml, messages.yml, hologram-locations.yml) and flushes expansions cache.
/ad sethologram <region>: Sets your current coordinates as the spawning location of the region's hologram.
Permissions
auroradominion.use: Grants basic access to comandos (Default: everyone).
auroradominion.admin: Grants administrative permission to reload and set hologram points (Default: OP).
? Placeholders (PAPI)
Hook AuroraDominion data anywhere using these PlaceholdersAPI keys:
%auroradominion_dominant_<region>%: Name of the current leading player in the region.
%auroradominion_dominant_kills_<region>%: Kills count of the dominant player in the region.
%auroradominion_top_<pos>_name_<region>%: Username at rank <pos> (1 to 10) in the region.
%auroradominion_top_<pos>_kills_<region>%: Kills count at rank <pos> (1 to 10) in the region.
(Example: %auroradominion_top_1_name_pvp_arena% returns the username of the top 1 player in the PvP Arena)
? Installation & Requirements
- Ensure your server runs Paper 1.21.x (Java 21 or higher).
- Install the necessary libraries in your
plugins folder:
- WorldGuard (Required - for region bounds check).
- PlaceholderAPI (Recommended - for placeholder resolving).
- FancyHolograms (Recommended - to build top kills holograms referencing our placeholders).
- Place
AuroraDominion.jar inside the plugins folder.
- Restart your server to generate config files.
评论 0
登录后参与评分
还没有评论,来抢沙发吧