NBContest

插件

· 作者 siriusbks

一个强大的竞赛插件,适用于农耕、钓鱼和怪物狩猎比赛。

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

最新 1.0.7 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

NBContest ?

NBContest 是一款轻量、快速且高度可定制的 Minecraft 插件,允许你举办激动人心的全服竞赛,例如农耕、钓鱼和怪物狩猎活动。它鼓励玩家竞争并赚取可配置的奖励,并提供实时视觉反馈。


✨ 功能特性

? 竞赛类型

  • 农耕竞赛 – 破坏随机作物(小麦、胡萝卜、土豆等)
  • 钓鱼竞赛 – 尽可能多地捕获鱼类!
  • 被动生物竞赛 – 击杀牛、鸡、羊等更多生物!
  • 敌对生物竞赛 – 击杀僵尸和骷髅等敌对生物!

? 实时显示系统

  • Boss Bar(可启用/禁用)

    • 显示剩余时间和全局目标
    • 可自定义颜色(PINK, BLUE, GREEN, RED, YELLOW, PURPLE, WHITE)
    • 完全支持 MiniMessage 以实现丰富的格式设置
  • 计分板(可启用/禁用) - 新增! ✨

    • 实时显示竞赛信息
    • 带有自定义格式的事件名称
    • 剩余时间(MM:SS 格式)
    • 目标进度(针对农耕事件)
    • 实时前三名排行榜
    • 仅显示活跃参与者
    • 可通过 messages.yml 完全自定义
  • 动作栏 (Action Bar)

    • 单个玩家分数显示
    • 实时更新
    • 支持旧版颜色代码以确保兼容性

? 奖励系统

  • 前三名玩家获得可配置的奖励
  • 执行任何控制台命令作为奖励
  • 支持每个排名多个命令
  • 支持占位符 (%player%)

⏰ 自动事件调度器

  • 每天安排多个事件
  • 支持每种事件类型有多个时间点
  • 完全可自定义时区(例如 Europe/Paris)
  • 基于服务器时钟自动运行
  • 可单独启用/禁用各个事件

? 自定义选项

  • MiniMessage 支持 用于丰富的文本格式
    • 渐变、十六进制颜色、格式标签
    • 支持悬停和点击事件
  • 完全可翻译 通过 messages.yml
  • 可配置目标(固定或随机)
  • 自定义材料名称 以获得更好的本地化效果
  • 结构化的配置 带有详细注释

?️ 技术特性

  • 轻量级且经过性能优化
  • Adventure API 集成以使用现代文本组件
  • 针对 Paper/Purpur 优化
  • 无需依赖项(独立运行)
  • 服务器关闭时自动清理

⌨️ 命令

命令 描述 权限
/nbcontest start <event> 开始竞赛 (farming, fishing, hostiles_mobs, passive_mobs) nbcontest.admin
/nbcontest stop 停止当前竞赛 nbcontest.admin
/nbcontest reload 重新加载配置、调度和语言文件 nbcontest.admin

事件类型

  • farming - 收获竞赛
  • fishing - 钓鱼竞赛
  • hostiles_mobs - 怪物狩猎
  • passive_mobs - 动物屠宰

? 自动事件

可以使用配置文件中的 auto-events 来安排自动事件。每个事件可以有多个开始时间,所有时间都基于服务器的时区。

示例:

auto-events:
  enabled: true
  farming:
    - "14:00"  # 下午 2:00
    - "18:30"  # 下午 6:30
  fishing:
    - "15:00"  # 下午 3:00

你可以使用 timezone: "Europe/Paris"(或任何 支持的时区 ID)来配置时区。


⚙️ 配置 (config.yml)

# ========================================
#        NBContest 配置
# ========================================
# 用于管理 Minecraft 服务器上竞技事件的插件
# Discord: https://discord.nb.studio/
# ========================================

# ========================================
# 常规设置
# ========================================

# 所有事件的持续时间(秒)(默认:300 = 5 分钟)
duration: 300

# 自动事件调度的时区
# 完整列表:https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
# 示例:"Europe/Paris", "America/New_York", "Asia/Tokyo", "UTC"
timezone: "Europe/Paris"

# ========================================
# 显示设置
# ========================================

# Boss Bar 配置
bossbar:
  # 在竞赛期间启用/禁用 Boss Bar
  enabled: true
  
  # Boss Bar 的颜色
  # 选项:PINK, BLUE, GREEN, RED, YELLOW, PURPLE, WHITE
  color: YELLOW

# 计分板配置
scoreboard:
  # 在竞赛期间启用/禁用实时计分板
  # 显示:事件名称、剩余时间、前三名玩家、目标进度
  enabled: true

# ========================================
# 竞赛目标
# ========================================

objective:
  # 如果为 true,则使用固定的 'amount' 值
  # 如果为 false,则在 'min' 和 'max' 之间使用随机值
  fixed: false
  
  # 固定目标数量(当 fixed: true 时使用)
  amount: 100
  
  # 随机目标范围(当 fixed: false 时使用)
  min: 50
  max: 500

# ========================================
# 自动事件调度器
# ========================================

auto-events:
  # 启用/禁用自动事件调度
  enabled: true
  
  # 每种事件类型的计划(24 小时制:"HH:MM")
  # 你可以为同一事件添加多个时间
  farming:
    - "14:00"
    - "18:30"
  
  fishing:
    - "15:00"
  
  hostiles_mobs:
    - "16:00"
  
  passive_mobs:
    - "17:00"

# ========================================
# 特定事件设置
# ========================================

# 农耕竞赛
farming:
  # 在农耕竞赛中可以收获的方块类型
  block-types:
    - WHEAT
    - POTATOES
    - CARROTS
    - BEETROOTS
    - PUMPKIN
    - MELON
    - SUGAR_CANE
    - COCOA_BEANS
    - NETHER_WART

# ========================================
# 奖励配置
# ========================================
# 每次比赛结束时,前三名玩家将获得奖励
# 你可以使用任何控制台命令,并搭配 %player% 占位符
# 支持单个命令(字符串)或多个命令(列表)

rewards:
  # 农耕比赛奖励
  farming:
    top1:
      - "give %player% minecraft:diamond 5"
      - "eco give %player% 250"
      - "say Congratulations %player%, you won the Farming Contest!"
    top2:
      - "give %player% minecraft:emerald 10"
      - "eco give %player% 150"
    top3:
      - "give %player% minecraft:bread 32"
      - "say Good job %player%!"

  # 钓鱼比赛奖励
  fishing:
    top1:
      - "give %player% minecraft:trident 1"
      - "eco give %player% 200"
      - "say %player% caught the biggest fish!"
    top2:
      - "give %player% minecraft:cod 16"
      - "eco give %player% 100"
    top3:
      - "give %player% minecraft:salmon 16"

  # 敌对生物比赛奖励
  hostiles_mobs:
    top1:
      - "give %player% minecraft:netherite_ingot 1"
      - "effect give %player% strength 30 1"
      - "say %player% dominated the Monster Hunt!"
    top2:
      - "give %player% minecraft:iron_sword 1"
      - "eco give %player% 100"
    top3:
      - "give %player% minecraft:shield 1"

  # 被动生物比赛奖励
  passive_mobs:
    top1:
      - "give %player% minecraft:golden_apple 3"
      - "eco give %player% 200"
      - "say %player% is the best farmer!"
    top2:
      - "give %player% minecraft:cooked_beef 32"
      - "eco give %player% 120"
    top3:
      - "give %player% minecraft:leather 16"

---

## ? 消息 (`messages.yml`)

所有消息均支持 **MiniMessage** 格式以实现富文本格式化!

### 可用的 MiniMessage 标签
- **颜色**: `<red>`, `<green>`, `<blue>`, `<yellow>`, `<gold>`, `<aqua>`, `<white>`, `<gray>`, `<dark_gray>`, 等。
- **样式**: `<bold>`, `<italic>`, `<underlined>`, `<strikethrough>`
- **渐变**: `<gradient:color1:color2>text</gradient>`
- **十六进制颜色**: `<#FF5555>text</#FF5555>`

### 示例配置

```yaml
# ========================================
# 比赛消息
# ========================================
contest-started: "<green>[NBContest] <yellow>The %event% <yellow>contest has started!"
contest-ended: "<red>[NBContest] The contest has ended!"
no-participants: "<gray>No players participated in this contest."
farming-objective: "<gold>Goal: <yellow>Break %amount% %material%"

# ========================================
# 显示(Boss Bar、Action Bar、计分板)
# ========================================

# Boss Bar
bossbar.farming: "<gold>Time: <white>%time%s <green>- <white>%remaining% %material% left"
bossbar.generic: "<gold>Time: <white>%time%s"

# Action Bar
# 注意:由于 Minecraft 的 Action bar 对 Adventure 组件有限制,此处使用传统颜色代码 (&)。请勿在此处使用 MiniMessage。
actionbar.farming: "&e%score% &f%material% harvested"
actionbar.fishing: "&e%score% &ffish caught"
actionbar.mobs: "&e%score% &fmobs killed"

# 计分板(实时显示)
# 计分板会显示比赛的实时信息
# 可在 config.yml 中启用/禁用
scoreboard.title: "<gold><bold>CONTEST"
scoreboard.event: "<yellow>Event: <white>%event%"
scoreboard.time: "<aqua>Time: <white>%minutes%:%seconds%"
scoreboard.remaining: "<green>Remaining: <white>%remaining% %material%"
scoreboard.top-title: "<gold>Top Players:"
scoreboard.top-line: "<gray>#%rank% <green>%player%<dark_gray>: <yellow>%score%"
scoreboard.top-empty: "<gray>#%rank% <dark_gray>---"

# 排行榜(比赛结束时)
top-title: "<gold>Top 5 Players:"
top-line: "<gray>#%rank% <green>%player% <dark_gray>- <yellow>%score% %unit%"

# ========================================
# 事件名称
# ========================================
event:
  farming: "<aqua>Harvesting"
  fishing: "<blue>Fishing"
  hostiles_mobs: "<dark_red>Monster Hunt"
  passive_mobs: "<dark_green>Culling"

# ========================================
# 单位(用于最终排行榜)
# ========================================
unit:
  fishing: fish caught
  hostiles_mobs: mobs killed
  passive_mobs: mobs killed

# ========================================
# 材料名称
# ========================================
# 自定义消息中材料的显示方式
materials:
  WHEAT: wheat
  POTATOES: potatoes
  CARROTS: carrots
  BEETROOTS: beetroot
  PUMPKIN: pumpkins
  MELON: melons
  SUGAR_CANE: sugar cane
  COCOA_BEANS: cocoa beans
  NETHER_WART: nether wart

# ========================================
# 命令消息
# ========================================
command.no-permission: "<red>You do not have permission to use this command."
command.start.already-running: "<red>A contest is already running."
command.start.unknown-event: "<red>Unknown event: <gold>%event%"
command.start.success: "<green>Contest started: <gold>%event%"
command.stop.not-running: "<red>No contest is currently running."
command.stop.success: "<red>Contest stopped."
command.reload.success: "<green>NBContest configuration and messages reloaded."

? 占位符用法

这些占位符在消息和奖励中通用:

占位符 描述 示例
%event% 事件名称(已翻译) "Harvesting"
%material% 目标材料 "wheat"
%amount% 目标数量 "100"
%score% 玩家得分 "45"
%player% 玩家名称 "Steve"
%unit% 显示单位 "mobs killed"
%time% 剩余时间(秒) "180"
%minutes% 剩余分钟数 "3"
%seconds% 剩余秒数 "00"
%remaining% 距离目标的剩余物品数 "55"
%rank% 玩家排名 "1"

? 自定义示例

渐变标题

scoreboard.title: "<gradient:gold:yellow>⚔ CONTEST ⚔</gradient>"

十六进制颜色

scoreboard.top-line: "<#FFD700>#%rank% <#00FF00>%player% <#FFFF00>%score%"

Emoji 支持

scoreboard.title: "<gold>? CONTEST ?"
scoreboard.time: "⏱️ %minutes%:%seconds%"
scoreboard.remaining: "? %remaining% %material%"

? 显示选项

您可以独立启用或禁用每个显示元素:

元素 配置选项 描述
Boss Bar(首领血条) bossbar.enabled: true 在顶部显示时间和目标
Scoreboard(记分板) scoreboard.enabled: true 在侧边显示实时排行榜
Action Bar(操作栏) 始终启用 在快捷栏上方显示个人分数

示例配置:

极简模式(仅操作栏)

bossbar:
  enabled: false
scoreboard:
  enabled: false

完整显示(全部启用)

bossbar:
  enabled: true
scoreboard:
  enabled: true

? 截图

Contest 启动时,同时显示首领血条和记分板

实时记分板,展示前三名玩家

带有实时更新和玩家排名的记分板


性能

  • 轻量级设计,开销极小
  • 高效的记分板更新(每秒 1 次)
  • 优化的玩家分数追踪
  • 比赛结束时自动清理数据

? 已知问题

  • Action Bar(操作栏):由于 Minecraft 的限制,操作栏仅支持传统颜色代码(如 &e、&f 等),不支持 MiniMessage 格式。
  • Scoreboard(记分板):每行文本限制为 40 个字符(Minecraft 限制)。

❤️ 致谢

由 6rius 用 ❤️ 制作
加入我们的 Discord 获取支持、提出建议或提问。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源