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 获取支持、提出建议或提问。
NBContest ?
NBContest is a lightweight, fast and highly customizable Minecraft plugin that allows you to host exciting server-wide contests such as farming, fishing, and mob hunting events. It encourages players to compete and earn configurable rewards with real-time visual feedback.
✨ Features
? Contest Types
- Farming Contest – Break random crops (wheat, carrots, potatoes, etc.)
- Fishing Contest – Catch as many fish as possible!
- Passive Mobs Contest – Kill cows, chickens, sheep and more!
- Hostile Mobs Contest – Kill hostile mobs like zombies and skeletons!
? Real-time Display System
? Rewards System
- Top 3 players receive configurable rewards
- Execute any console command as reward
- Support for multiple commands per rank
- Placeholder support (
%player%)
⏰ Automatic Event Scheduler
- Schedule multiple events per day
- Supports multiple times per event type
- Fully customizable timezone (e.g., Europe/Paris)
- Runs automatically based on server clock
- Enable/disable individual events
? Customization
- MiniMessage Support for rich text formatting
- Gradients, hex colors, formatting tags
- Hover and click events support
- Fully translatable via
messages.yml
- Configurable objectives (fixed or random)
- Custom material names for better localization
- Organized configuration with detailed comments
?️ Technical Features
- Lightweight and optimized for performance
- Adventure API integration for modern text components
- Paper/Purpur optimized
- No dependencies required (standalone)
- Automatic cleanup on server shutdown
⌨️ Commands
| Command |
Description |
Permission |
/nbcontest start <event> |
Start a contest (farming, fishing, hostiles_mobs, passive_mobs) |
nbcontest.admin |
/nbcontest stop |
Stop the current contest |
nbcontest.admin |
/nbcontest reload |
Reload config, schedule and language |
nbcontest.admin |
Event Types
farming - Harvesting contest
fishing - Fishing contest
hostiles_mobs - Monster hunt
passive_mobs - Animal culling
? Automatic Events
Auto-events can be scheduled using auto-events in the config. Each event can have multiple start times, and all times are based on the server's timezone.
Example:
auto-events:
enabled: true
farming:
- "14:00" # 2:00 PM
- "18:30" # 6:30 PM
fishing:
- "15:00" # 3:00 PM
You can configure the timezone with timezone: "Europe/Paris" (or any supported timezone ID).
⚙️ Configuration (config.yml)
# ========================================
# NBContest Configuration
# ========================================
# Plugin for managing competitive events on your Minecraft server
# Discord: https://discord.nb.studio/
# ========================================
# ========================================
# General Settings
# ========================================
# Duration of all events in seconds (default: 300 = 5 minutes)
duration: 300
# Timezone for auto-events scheduling
# Full list: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
# Examples: "Europe/Paris", "America/New_York", "Asia/Tokyo", "UTC"
timezone: "Europe/Paris"
# ========================================
# Display Settings
# ========================================
# Boss Bar Configuration
bossbar:
# Enable/disable the boss bar during contests
enabled: true
# Color of the boss bar
# Options: PINK, BLUE, GREEN, RED, YELLOW, PURPLE, WHITE
color: YELLOW
# Scoreboard Configuration
scoreboard:
# Enable/disable the live scoreboard during contests
# Shows: event name, time remaining, top 3 players, objective progress
enabled: true
# ========================================
# Contest Objective
# ========================================
objective:
# If true, use the fixed 'amount' value
# If false, use a random value between 'min' and 'max'
fixed: false
# Fixed objective amount (used when fixed: true)
amount: 100
# Random objective range (used when fixed: false)
min: 50
max: 500
# ========================================
# Auto-Events Scheduler
# ========================================
auto-events:
# Enable/disable automatic event scheduling
enabled: true
# Schedule for each event type (24-hour format: "HH:MM")
# You can add multiple times for the same event
farming:
- "14:00"
- "18:30"
fishing:
- "15:00"
hostiles_mobs:
- "16:00"
passive_mobs:
- "17:00"
# ========================================
# Event-Specific Settings
# ========================================
# Farming Contest
farming:
# Block types that can be harvested during farming contests
block-types:
- WHEAT
- POTATOES
- CARROTS
- BEETROOTS
- PUMPKIN
- MELON
- SUGAR_CANE
- COCOA_BEANS
- NETHER_WART
# ========================================
# Rewards Configuration
# ========================================
# Rewards are given to the top 3 players at the end of each contest
# You can use any console command with %player% placeholder
# Supports single command (string) or multiple commands (list)
rewards:
# Farming Contest 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 Contest Rewards
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"
# Hostile Mobs Contest Rewards
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 Contest Rewards
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 (messages.yml)
All messages support MiniMessage format for rich text formatting!
Available MiniMessage Tags
- Colors:
<red>, <green>, <blue>, <yellow>, <gold>, <aqua>, <white>, <gray>, <dark_gray>, etc.
- Formatting:
<bold>, <italic>, <underlined>, <strikethrough>
- Gradients:
<gradient:color1:color2>text</gradient>
- Hex colors:
<#FF5555>text</#FF5555>
Example Configuration
# ========================================
# Contest Messages
# ========================================
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%"
# ========================================
# Display (Boss Bar, Action Bar, Scoreboard)
# ========================================
# Boss Bar
bossbar.farming: "<gold>Time: <white>%time%s <green>- <white>%remaining% %material% left"
bossbar.generic: "<gold>Time: <white>%time%s"
# Action Bar
# Note: Action bar uses legacy color codes (&) because Minecraft action bar
# has limitations with Adventure components. Do not use MiniMessage here.
actionbar.farming: "&e%score% &f%material% harvested"
actionbar.fishing: "&e%score% &ffish caught"
actionbar.mobs: "&e%score% &fmobs killed"
# Scoreboard (Live Display)
# The scoreboard shows real-time contest information
# Can be enabled/disabled in 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>---"
# Leaderboard (End of Contest)
top-title: "<gold>Top 5 Players:"
top-line: "<gray>#%rank% <green>%player% <dark_gray>- <yellow>%score% %unit%"
# ========================================
# Event Names
# ========================================
event:
farming: "<aqua>Harvesting"
fishing: "<blue>Fishing"
hostiles_mobs: "<dark_red>Monster Hunt"
passive_mobs: "<dark_green>Culling"
# ========================================
# Units (for final leaderboard)
# ========================================
unit:
fishing: fish caught
hostiles_mobs: mobs killed
passive_mobs: mobs killed
# ========================================
# Material Names
# ========================================
# Customize how materials are displayed in messages
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 Messages
# ========================================
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."
? Placeholder Usage
These placeholders are used across messages and rewards:
| Placeholder |
Description |
Example |
%event% |
Event name (translated) |
"Harvesting" |
%material% |
Target material |
"wheat" |
%amount% |
Objective amount |
"100" |
%score% |
Player score |
"45" |
%player% |
Player name |
"Steve" |
%unit% |
Display unit |
"mobs killed" |
%time% |
Time left (seconds) |
"180" |
%minutes% |
Minutes remaining |
"3" |
%seconds% |
Seconds remaining |
"00" |
%remaining% |
Items remaining to goal |
"55" |
%rank% |
Player's rank |
"1" |
? Customization Examples
Gradient Titles
scoreboard.title: "<gradient:gold:yellow>⚔ CONTEST ⚔</gradient>"
Hex Colors
scoreboard.top-line: "<#FFD700>#%rank% <#00FF00>%player% <#FFFF00>%score%"
Emoji Support
scoreboard.title: "<gold>? CONTEST ?"
scoreboard.time: "⏱️ %minutes%:%seconds%"
scoreboard.remaining: "? %remaining% %material%"
? Display Options
You can enable/disable each display element independently:
| Element |
Config Option |
Description |
| Boss Bar |
bossbar.enabled: true |
Shows time and objective at the top |
| Scoreboard |
scoreboard.enabled: true |
Shows live leaderboard on the side |
| Action Bar |
Always enabled |
Shows personal score above hotbar |
Example configurations:
Minimal (Action Bar only)
bossbar:
enabled: false
scoreboard:
enabled: false
Full Display (All enabled)
bossbar:
enabled: true
scoreboard:
enabled: true
? Screenshots
Contest starting with boss bar and scoreboard
Real-time scoreboard showing top 3 players
Scoreboard with live updates and player rankings
Performance
- Lightweight design with minimal overhead
- Efficient scoreboard updates (1 per second)
- Optimized player score tracking
- Automatic cleanup on contest end
? Known Issues
- Action Bar: Due to Minecraft limitations, action bar only supports legacy color codes (
&e, &f, etc.) instead of MiniMessage format.
- Scoreboard: Text is limited to 40 characters per line (Minecraft limitation).
❤️ Credits
Created with ❤️ by 6rius
Join our Discord for support, suggestions, or questions.
评论 0
登录后参与评分
还没有评论,来抢沙发吧