Neptune FFA

插件

· 作者 Yowsef

在 Neptune Practice Core 中添加 FFA 游戏模式

0 本站下载 0 关注 更新于 2 周前

最新 1.5 · 26.2 · Paper / Spigot

一键开服(送7天)

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 会追踪方块交互。在会话重置时(手动触发或倒计时结束):

  1. 会话中的所有玩家安全传送回大厅。
  2. 放置的方块通过内存或蓝图文件自动还原。
  3. 竞技场会话在 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% 超越上一名所需的击杀数

设置指南

  1. 在 Neptune 核心设置中定义你的练习装备配置。
  2. 打开 plugins/NeptuneFFA/kits.yml,并将装备名称作为键添加(需与 Neptune 的名称严格区分大小写匹配)。
  3. 设置 enabled: true,并在 arena 配置块中输入映射的 Neptune 竞技场名称。
  4. 站在竞技场中你想要设置的出生点位置,执行 /ffaadmin addspawn <kit>(或者通过 /ffaadmin GUI 下的 Kit Settings -> Spawn Points 添加)。添加多个点以启用随机出生点轮换。
  5. 执行 /ffaadmin reload 以实例化会话。现在竞技场已对玩家开放。

支持

支持服务器: Discord Server

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源