NeptuneFFA
概览
NeptuneFFA 是一个高性能、基于套装(Kit)的无差别竞技(Free-For-All, FFA)引擎,专为 Neptune Core 练习框架设计。
核心功能
选择器菜单
玩家界面围绕一个动态图形用户界面(GUI)构建,可通过 /ffa 命令或与指定的大厅物品交互来访问。
- 实时竞技场诊断:当悬停在任何套装图标上时,GUI 会显示当前活跃战斗者的数量、当前地图名称以及竞技场距离预定重置剩余的确切秒数。
- 动态 GUI 重置:打开期间,GUI 会实时更新计时器和玩家计数(每 1 秒),无需玩家关闭并重新打开界面。
- 自定义槽位映射与填充物:服务器管理员可以设置自定义 GUI 大小(9 到 54 个槽位),并将特定槽位手动分配给热门套装。其余套装自动分配,空槽位可以使用可自定义的材料(如彩色染色玻璃板)填充,并带有自定义显示名称。
- 一键交互:左击套装加入对应的活跃竞技场。右击当前活跃套装退出竞技场并返回大厅。
管理控制
/ffaadmin 界面提供对活跃竞技场和配置的实时游戏内控制。
- 会话监控器:以可视化列表形式显示所有活跃会话,展示玩家数量、当前竞技场设置以及自动重置前的剩余时间。支持右键点击会话以强制立即回滚地图并踢出玩家。
- 套装设置面板:允许管理员切换 FFA 状态、切换世界生成块回滚、调整重置间隔以及管理出生点位置。
- 交互式出生点编辑器:打开子菜单,显示该套装的所有已注册出生点。管理员可以点击添加当前位置、传送至现有出生点或清除它们。
- 实时槽位排列器:允许管理员在玩家 GUI 中直观地重新排列套装图标。左击增加槽位索引,右击减少索引,Shift+左击使图标整行移动。所有更改即时保存到配置文件。
机制
方块回滚
对于允许放置或破坏方块的套装(例如 CrystalPVP 或 BuildUHC),NeptuneFFA 会追踪方块交互。在会话重置时(手动触发或倒计时结束):
- 会话中的所有玩家安全传送回大厅。
- 放置的方块通过内存或蓝图文件自动还原。
- 竞技场会话在 3 秒延迟后重新开放,供玩家使用。
战斗标记
为了防止战斗日志记录(Combat Logging),NeptuneFFA 内置了战斗标记追踪器:
- 战斗标记计时器:直接在玩家的操作栏(Action Bar)上显示倒计时(例如,“Combat Tag: 8s”),支持完整的十六进制代码和 MiniMessage 格式。
- 命令与日志保护:在战斗状态下阻止命令预处理事件和传送。被标记时断开连接将触发死亡惩罚,击杀数将被转移并更新统计信息。
格式化
支持 MiniMessage 格式、标准聊天颜色(例如 &a)以及十六进制格式(例如 &#FF5555)。这些样式系统会在菜单、计分板、操作栏和聊天警报中被完全解析。
配置
插件使用位于 plugins/NeptuneFFA/ 文件夹中的三个主要文件:
config.yml
控制全局参数、大厅物品布局、全局倒计时和计分板配置。
ffa:
# 提供给大厅玩家以访问选择器的物品
lobby-item:
enabled: true
slot: 8
material: DIAMOND_SWORD
name: "&c&lFree For All &7(Right Click)"
lore:
- "&7Jump into an FFA arena"
respawn-delay-seconds: 5
reset-warning-seconds: [60, 30, 10, 5]
track-neptune-kit-stats: true
# 处于 "IN_FFA" 状态的玩家的计分板行
scoreboard:
update-interval-ticks: 20
title: "&c&lFFA"
lines:
- "&7&m--------------------"
- "&fKit: &c<ffa_kit>"
- "&fArena: &e<ffa_arena>"
- "&fPlayers: &a<ffa_players>"
- " "
- "&6Reset in: &e<ffa_reset_timer>"
- " "
- "&7- Session -"
- "&fKills: &a<ffa_session_kills>"
- "&fDeaths: &c<ffa_session_deaths>"
- "&fStreak: &e<ffa_session_streak>"
- "&fBest Streak: &6<ffa_session_best_streak>"
- "&fKDR: &b<ffa_session_kdr>"
- " "
- "&7- Lifetime -"
- "&fKills: &a<ffa_lifetime_kills>"
- "&fDeaths: &c<ffa_lifetime_deaths>"
- "&fBest Streak: &6<ffa_lifetime_best_streak>"
- "&fKDR: &b<ffa_kdr>"
- " "
- "&7- Ranking -"
- "&fGlobal Rank: &d#<ffa_rank>"
- "&fTop Killer: &e<ffa_top_killer> &7(<ffa_top_killer_kills>)"
- "&fKills to Pass: &c<ffa_kills_to_next_rank>"
- " "
- "&bserver.net"
- "&7&m--------------------"
kits.yml
存储每个已注册套装的配置。由游戏内管理菜单自动编辑。
kits:
NoDebuff:
enabled: true # 切换 FFA 可用性
arena: CastleTop # 链接的 Neptune 竞技场名称
worldgen: false # 切换方块回滚
reset-interval-minutes: 10 # 重新开放/回滚倒计时间隔
respawn-delay-override: -1 # 覆盖全局延迟(-1 表示禁用)
gui-slot: 4 # GUI 按钮槽位覆盖(-1 表示自动槽位)
spawn-points: # 序列化出生点位置
- "world,0.5,64.0,0.5,90.0,0.0"
messages.yml
定义本地化文本和聊天格式。支持十六进制颜色代码和 MiniMessage 标签。
ffa-join: "&a{player} &7加入了 FFA &e({kit})&7。"
ffa-leave: "&c{player} &7离开了 FFA &e({kit})&7。"
ffa-kill: "&c{killer} &7击杀了 &c{victim} &8[&e{victim_session_kills} 次击杀&8]"
ffa-reset-warn: "&6[FFA] &e竞技场将在 &c{seconds}秒&e后重置!"
ffa-reset-kick: "&6[FFA] &e竞技场正在重置。正在将你返回大厅。"
ffa-reset-open: "&6[FFA] &e竞技场 &a{arena} &e已重新开放!"
ffa-respawn: "&7将在 &e{seconds}&7秒后重生..."
ffa-no-session: "&c该装备没有开放的 FFA 会话。"
ffa-not-in-ffa: "&c你不在 FFA 会话中。"
ffa-already-in: "&c你已经在 FFA 会话中了。"
命令
| 命令 |
描述 |
权限节点 |
/ffa |
打开交互式 FFA 装备选择菜单 |
无(默认) |
/ffa join <kit> |
直接加入指定装备的 FFA 会话 |
无(默认) |
/ffa leave |
离开当前 FFA 会话并返回大厅 |
无(默认) |
/ffa list |
列出所有活跃的 FFA 会话及当前玩家数量 |
无(默认) |
/ffa stats [player] |
查看自己或其他玩家的 FFA 统计数据 |
neptuneffa.stats.others(用于查看他人) |
/ffaadmin |
打开 FFA 管理员控制面板 GUI |
neptuneffa.admin |
/ffaadmin reload |
重载配置文件并重建会话 |
neptuneffa.admin |
/ffaadmin reset <kit> |
强制重置指定装备的竞技场会话 |
neptuneffa.admin |
/ffaadmin addspawn <kit> |
将你的当前位置添加为该装备的出生点 |
neptuneffa.admin |
占位符
当这些占位符放置在记分板配置中或通过 PlaceholderAPI 全局解析时(使用 %neptuneffa_% 前缀),它们会动态解析:
| 记分板标签 |
PlaceholderAPI 变量 |
描述 |
<ffa_kit> |
%neptuneffa_session_kit% |
当前会话的装备名称 |
<ffa_arena> |
%neptuneffa_session_arena% |
当前会话的竞技场名称 |
<ffa_players> |
%neptuneffa_session_players% |
会话中的玩家总数 |
<ffa_reset_timer> |
%neptuneffa_session_reset_timer% |
格式化后的重置倒计时 (MM:SS) |
<ffa_session_kills> |
%neptuneffa_session_kills% |
在当前会话中的击杀数 |
<ffa_session_deaths> |
%neptuneffa_session_deaths% |
在当前会话中的死亡数 |
<ffa_session_streak> |
%neptuneffa_session_streak% |
当前的连续击杀连杀记录 |
<ffa_session_best_streak> |
%neptuneffa_session_best_streak% |
当前会话中的最高连杀记录 |
<ffa_session_kdr> |
%neptuneffa_session_kdr% |
当前会话的击杀/死亡比 |
<ffa_time_in_session> |
%neptuneffa_session_time% |
在会话中度过的时间(格式化) |
<ffa_lifetime_kills> |
%neptuneffa_lifetime_kills% |
所有会话中累计的总击杀数 |
<ffa_lifetime_deaths> |
%neptuneffa_lifetime_deaths% |
所有会话中累计的总死亡数 |
<ffa_lifetime_best_streak> |
%neptuneffa_lifetime_best_streak% |
生涯最高连杀记录 |
<ffa_lifetime_sessions> |
%neptuneffa_lifetime_sessions% |
累计加入的 FFA 会话次数 |
<ffa_kdr> |
%neptuneffa_lifetime_kdr% |
生涯累计击杀/死亡比 |
<ffa_ping> |
%neptuneffa_ping% |
玩家的活跃连接延迟(Ping) |
<ffa_rank> |
%neptuneffa_rank% |
基于击杀数的玩家全球排名 |
<ffa_top_killer> |
%neptuneffa_top_killer% |
拥有最高生涯击杀数的玩家名称 |
<ffa_top_killer_kills> |
%neptuneffa_top_killer_kills% |
排名第一玩家的击杀数 |
<ffa_kills_to_next_rank> |
%neptuneffa_kills_to_next_rank% |
超越上一名所需的击杀数 |
设置指南
- 在 Neptune 核心设置中定义你的练习装备配置。
- 打开
plugins/NeptuneFFA/kits.yml,并将装备名称作为键添加(需与 Neptune 的名称严格区分大小写匹配)。
- 设置
enabled: true,并在 arena 配置块中输入映射的 Neptune 竞技场名称。
- 站在竞技场中你想要设置的出生点位置,执行
/ffaadmin addspawn <kit>(或者通过 /ffaadmin GUI 下的 Kit Settings -> Spawn Points 添加)。添加多个点以启用随机出生点轮换。
- 执行
/ffaadmin reload 以实例化会话。现在竞技场已对玩家开放。
支持
支持服务器: Discord Server
NeptuneFFA
Overview
NeptuneFFA is a high-performance, kit-based Free-For-All (FFA) engine designed specifically for the Neptune Core practice framework.
Core Features
Selector Menu
The player interface is built around a dynamic Graphical User Interface (GUI) accessible via /ffa or by interacting with the designated lobby item.
- Real-Time Arena Diagnostics: When hovering over any kit icon, the GUI displays the number of active combatants, the active map name, and the exact seconds remaining before the arena undergoes a scheduled reset.
- Dynamic GUI Resets: The GUI updates its timers and player counts in real time (every 1 second) while open, eliminating the need for players to close and reopen the interface.
- Custom Slot Mapping and Fillers: Server administrators can set a custom GUI size (9 to 54 slots) and manually assign specific slots to popular kits. Remaining kits are auto-allocated, and empty slots can be filled with customizable materials (such as colored stained glass panes) with custom display names.
- One-Click Interaction: Left-clicking a kit joins the corresponding active arena. Right-clicking the active kit leaves the arena and returns the player to the lobby.
Admin Control
The /ffaadmin interface provides real-time control over active arenas and configurations directly in-game.
- Session Monitor: Provides a visual list of all active sessions, showing player counts, current arena settings, and remaining time before automated resets. It supports right-clicking a session to force an immediate map rollback and player kick.
- Kit Settings Panel: Enables admins to toggle FFA status, toggle worldgen block rollbacks, adjust reset intervals, and manage spawn locations.
- Interactive Spawn Editor: Opens a sub-menu showing all registered spawn points for a kit. Admins can click to add their current location, teleport to existing spawn points, or clear them.
- Live Slot Arranger: Allows admins to rearrange kit icons in the player GUI visually. Left-clicking increments the slot index, right-clicking decrements it, and shift-clicking jumps the icon by whole rows. All changes save to configuration files instantly.
Mechanics
Block Rollbacks
For kits that permit placing or breaking blocks (e.g., CrystalPVP or BuildUHC), NeptuneFFA tracks block interactions. Upon session resets (triggered manually or when the countdown timer expires):
- All players in the session are safely teleported back to the lobby.
- Placed blocks are automatically reverted in-memory or via schematic files.
- The arena session is re-opened and made available for players after a 3-second delay.
Combat Tagging
To prevent combat logging, NeptuneFFA features a built-in combat tag tracker:
- Combat Tag Timer: Displays a countdown directly in the player's action bar (e.g., "Combat Tag: 8s") supporting full hex codes and MiniMessage formatting.
- Command & Log Protection: Prevents command preprocess events and teleportation while in combat. Disconnecting while tagged triggers a death penalty, transferring kills and updating statistics.
Formatting
Supports MiniMessage formatting, standard chat colors (e.g., &a), and hexadecimal formatting (e.g., &#FF5555). These styling systems are fully parsed in menus, scoreboards, action bars, and chat alerts.
Configuration
The plugin uses three primary files located in the plugins/NeptuneFFA/ folder:
config.yml
Governs global parameters, the lobby item layout, global countdowns, and scoreboard configurations.
ffa:
# Item given to lobby players to access the selector
lobby-item:
enabled: true
slot: 8
material: DIAMOND_SWORD
name: "&c&lFree For All &7(Right Click)"
lore:
- "&7Jump into an FFA arena"
respawn-delay-seconds: 5
reset-warning-seconds: [60, 30, 10, 5]
track-neptune-kit-stats: true
# Scoreboard lines for players in the "IN_FFA" state
scoreboard:
update-interval-ticks: 20
title: "&c&lFFA"
lines:
- "&7&m--------------------"
- "&fKit: &c<ffa_kit>"
- "&fArena: &e<ffa_arena>"
- "&fPlayers: &a<ffa_players>"
- " "
- "&6Reset in: &e<ffa_reset_timer>"
- " "
- "&7- Session -"
- "&fKills: &a<ffa_session_kills>"
- "&fDeaths: &c<ffa_session_deaths>"
- "&fStreak: &e<ffa_session_streak>"
- "&fBest Streak: &6<ffa_session_best_streak>"
- "&fKDR: &b<ffa_session_kdr>"
- " "
- "&7- Lifetime -"
- "&fKills: &a<ffa_lifetime_kills>"
- "&fDeaths: &c<ffa_lifetime_deaths>"
- "&fBest Streak: &6<ffa_lifetime_best_streak>"
- "&fKDR: &b<ffa_kdr>"
- " "
- "&7- Ranking -"
- "&fGlobal Rank: &d#<ffa_rank>"
- "&fTop Killer: &e<ffa_top_killer> &7(<ffa_top_killer_kills>)"
- "&fKills to Pass: &c<ffa_kills_to_next_rank>"
- " "
- "&bserver.net"
- "&7&m--------------------"
kits.yml
Stores configurations for each registered kit. Edited automatically by the in-game admin menu.
kits:
NoDebuff:
enabled: true # Toggle FFA availability
arena: CastleTop # Linked Neptune arena name
worldgen: false # Toggle block resets
reset-interval-minutes: 10 # Re-open/rollback countdown interval
respawn-delay-override: -1 # Override global delay (-1 to disable)
gui-slot: 4 # GUI button slot override (-1 for auto-slot)
spawn-points: # Serialized spawn locations
- "world,0.5,64.0,0.5,90.0,0.0"
messages.yml
Defines localized text and chat formats. Supports hex codes and MiniMessage tags.
ffa-join: "&a{player} &7joined FFA &e({kit})&7."
ffa-leave: "&c{player} &7left FFA &e({kit})&7."
ffa-kill: "&c{killer} &7killed &c{victim} &8[&e{victim_session_kills} kills&8]"
ffa-reset-warn: "&6[FFA] &eArena resets in &c{seconds}s&e!"
ffa-reset-kick: "&6[FFA] &eArena is resetting. Returning you to lobby."
ffa-reset-open: "&6[FFA] &eArena &a{arena} &ehas reopened!"
ffa-respawn: "&7Respawning in &e{seconds}&7..."
ffa-no-session: "&cNo FFA session is open for that kit."
ffa-not-in-ffa: "&cYou are not in an FFA session."
ffa-already-in: "&cYou are already in an FFA session."
Commands
| Command |
Description |
Permission Node |
/ffa |
Opens the interactive FFA Kit Selector Menu |
None (Default) |
/ffa join <kit> |
Directly join the FFA session for the specified kit |
None (Default) |
/ffa leave |
Leave the current FFA session and return to the lobby |
None (Default) |
/ffa list |
List all active FFA sessions and current player counts |
None (Default) |
/ffa stats [player] |
View your own or another player's FFA statistics |
neptuneffa.stats.others (to view others) |
/ffaadmin |
Opens the FFA Admin Control Panel GUI |
neptuneffa.admin |
/ffaadmin reload |
Reload configuration files and rebuild sessions |
neptuneffa.admin |
/ffaadmin reset <kit> |
Force-resets the specified kit's arena session |
neptuneffa.admin |
/ffaadmin addspawn <kit> |
Add your current location as a spawn point for a kit |
neptuneffa.admin |
Placeholders
These placeholders resolve dynamically when placed in the scoreboard config or parsed globally via PlaceholderAPI (using the %neptuneffa_% prefix):
| Scoreboard Tag |
PlaceholderAPI Variable |
Description |
<ffa_kit> |
%neptuneffa_session_kit% |
The name of the active session's kit |
<ffa_arena> |
%neptuneffa_session_arena% |
The name of the active session's arena |
<ffa_players> |
%neptuneffa_session_players% |
Total player count in the session |
<ffa_reset_timer> |
%neptuneffa_session_reset_timer% |
Formatted reset countdown (MM:SS) |
<ffa_session_kills> |
%neptuneffa_session_kills% |
Kills achieved in the current session |
<ffa_session_deaths> |
%neptuneffa_session_deaths% |
Deaths suffered in the current session |
<ffa_session_streak> |
%neptuneffa_session_streak% |
Active consecutive killstreak |
<ffa_session_best_streak> |
%neptuneffa_session_best_streak% |
Highest killstreak in the current session |
<ffa_session_kdr> |
%neptuneffa_session_kdr% |
Kill/Death ratio for the current session |
<ffa_time_in_session> |
%neptuneffa_session_time% |
Formatted duration spent in the session |
<ffa_lifetime_kills> |
%neptuneffa_lifetime_kills% |
Cumulative lifetime kills across all sessions |
<ffa_lifetime_deaths> |
%neptuneffa_lifetime_deaths% |
Cumulative lifetime deaths across all sessions |
<ffa_lifetime_best_streak> |
%neptuneffa_lifetime_best_streak% |
Best killstreak achieved lifetime |
<ffa_lifetime_sessions> |
%neptuneffa_lifetime_sessions% |
Cumulative number of FFA sessions joined |
<ffa_kdr> |
%neptuneffa_lifetime_kdr% |
Cumulative lifetime Kill/Death ratio |
<ffa_ping> |
%neptuneffa_ping% |
The player's active ping connection latency |
<ffa_rank> |
%neptuneffa_rank% |
Player's global placement based on kills |
<ffa_top_killer> |
%neptuneffa_top_killer% |
Name of the player with the highest lifetime kills |
<ffa_top_killer_kills> |
%neptuneffa_top_killer_kills% |
Kill count of the top ranked player |
<ffa_kills_to_next_rank> |
%neptuneffa_kills_to_next_rank% |
Kills required to overtake the rank ahead |
Setup Guide
- Define your practice kit configuration in the Neptune core settings.
- Open
plugins/NeptuneFFA/kits.yml and add the kit name as a key (matching Neptune's name case-sensitively).
- Set
enabled: true and input the mapped Neptune arena name in the arena configuration block.
- Stand at the desired spawn point locations in your arena and execute
/ffaadmin addspawn <kit> (or add it via the /ffaadmin GUI under Kit Settings -> Spawn Points). Add multiple points to enable random spawn cycling.
- Execute
/ffaadmin reload to instantiate the session. The arena is now open for players.
Support
Support Server: Discord Server
评论 0
登录后参与评分
还没有评论,来抢沙发吧