⚽ NeaFutbol
专为 Minecraft 大厅和街机网络设计的现代、轻量级足球小游戏。具备自定义球体物理效果、全息实时比分板、自动队伍平衡、进球烟花、持久化玩家统计数据以及原生 PlaceholderAPI 集成。
概览
NeaFutbol 将服务器中的任何区域变为一个交互式足球体育场。玩家加入比赛,被分配到身穿彩色皮革盔甲的队伍(蓝队 vs 红队),并竞争进球。一切运行流畅,无需依赖繁重的外部插件,也不会影响服务器 TPS。
功能
- ⚽ 真实球体物理:平滑的球体轨迹计算,支持可配置的踢击力度(
kick-power)、发射高度(kick-height)、传球速度(pass-power)、摩擦减速以及边界反弹。
- ? 实时浮动全息图:原生、轻量的浮动比分板,显示实时比赛时间、队伍得分以及动态颜色编码进度条。
- ? 自动队伍平衡:自动将加入的玩家分配到蓝队和红队,并配备对应颜色的队伍盔甲。
- ? 3D 进球检测:精确的进球碰撞箱检测,触发烟花、庆祝标题、音效以及球体中心重置。
- ? 持久化玩家统计:按玩家 UUID 追踪生涯进球数、胜场数和已参加的比赛场次。
- ? PlaceholderAPI 支持:为 TAB、计分板插件、全息图和聊天格式化器提供完整的占位符套件。
- ? 出界检测:检测球体是否离开场地,并发起公平的界外球重启。
- ? 孤立实体清理:内置
/nf purgeholo 命令,用于清理残留的全息图或球体实体。
- ? 完全可配置:所有消息、标题、音效和计时器均可通过
config.yml 和 lang.yml 进行自定义。
占位符
NeaFutbol 提供原生的 PlaceholderAPI 扩展变量:
| 占位符 |
作用域 |
描述 |
示例 |
%neafutbol_goals% |
玩家 |
玩家职业生涯总进球数 |
15 |
%neafutbol_wins% |
玩家 |
职业生涯总胜场数 |
9 |
%neafutbol_matches% |
玩家 |
已参加的比赛总数 |
24 |
%neafutbol_team% |
玩家 |
当前所属队伍(Blue、Red 或 None) |
Blue |
%neafutbol_in_game% |
玩家 |
玩家当前是否在比赛中 |
true |
%neafutbol_score_blue% |
比赛 |
蓝队当前进球数 |
2 |
%neafutbol_score_red% |
比赛 |
红队当前进球数 |
1 |
%neafutbol_match_score% |
比赛 |
实时综合比分 |
2 - 1 |
%neafutbol_match_time% |
比赛 |
格式化的剩余比赛时间(MM:SS) |
04:12 |
%neafutbol_time_seconds% |
比赛 |
比赛剩余的原始秒数 |
252 |
%neafutbol_match_state% |
比赛 |
当前游戏状态(Playing、Waiting) |
Playing |
%neafutbol_players% |
比赛 |
当前活跃玩家数量 |
4 |
%neafutbol_max_players% |
比赛 |
配置的最大玩家容量 |
4 |
命令
主要命令:/neafutbol(别名:/nf、/futbol)。
玩家命令
| 命令 |
权限 |
描述 |
/nf join |
neafutbol.join |
加入匹配队列或正在进行的比赛。 |
/nf leave |
neafutbol.use |
离开当前比赛并返回之前的位置。 |
/nf help |
neafutbol.use |
显示帮助菜单。 |
管理员命令
| 命令 |
权限 |
描述 |
/nf wand |
neafutbol.admin |
获取用于选择边界和球门的选区工具。 |
/nf setarena |
neafutbol.admin |
使用你的选区工具保存场地边界。 |
| `/nf setgoal <team1 |
team2>` |
neafutbol.admin |
| `/nf setspawn <team1 |
team2 |
lobby>` |
/nf setball |
neafutbol.admin |
设置中心球体的出生点。 |
/nf setholo |
neafutbol.admin |
生成或移动浮动比分板全息图。 |
/nf removeholo |
neafutbol.admin |
移除当前的比分板全息图。 |
/nf purgeholo |
neafutbol.admin |
清理孤立的盔甲架或残留的球体实体。 |
/nf forcestart |
neafutbol.admin |
强制立即开始比赛倒计时。 |
/nf reload |
neafutbol.admin |
热重载 config.yml 和 lang.yml。 |
权限
| 权限 |
描述 |
默认值 |
neafutbol.use |
访问基本玩家命令和帮助菜单。 |
所有人 |
neafutbol.join |
允许加入足球比赛。 |
所有人 |
neafutbol.admin |
完全访问竞技场配置和管理员命令。 |
OP |
设置指南
在 5 分钟内设置好可用的足球竞技场:
- 建造体育场:构建带有封闭边界(墙壁/玻璃)和两端球门网的场地。
- 定义场地边界:
- 运行
/nf wand 获取选区工具。
- 左击角落 1(底部角落)。
- 右击角落 2(对角线顶部的相对角落)。
- 运行
/nf setarena。
- 定义球门区域:
- 使用
/nf wand 选中蓝队球门内部,然后运行 /nf setgoal team1。
- 使用
/nf wand 选中红队球门内部,然后运行 /nf setgoal team2。
- 设置出生点:
- 站在蓝队应出生的位置,运行
/nf setspawn team1。
- 站在红队应出生的位置,运行
/nf setspawn team2。
- 站在等待大厅处,运行
/nf setspawn lobby。
- 站在场地的正中心,运行
/nf setball。
- 添加浮动比分板:
- 飞到希望放置比分板的位置,运行
/nf setholo。
配置
config.yml
game:
min-players: 2 # 开始比赛所需的最少玩家数
max-players: 4 # 每场比赛的最大玩家容量
duration-seconds: 300 # 比赛时长(秒)(5分钟)
countdown-seconds: 60 # 比赛开始前的大厅倒计时
goal-radius: 2.0 # 进球检测半径
team-armor: true # 自动装备彩色皮革盔甲
ball:
skin: "MHF_CoconutB" # 足球的头像皮肤
y-modifier: -0.5 # 球体重心高度偏移
hitbox-range: 3.5 # 踢球的交互半径
kick-power: 1.2 # 踢球速度
kick-height: 0.6 # 射门时的垂直提升高度
pass-power: 1.2 # 地面传球速度
支持
⚽ NeaFutbol
Modern, lightweight soccer minigame designed for Minecraft lobbies and arcade networks. Features custom ball physics, holographic live scoreboards, automatic team balancing, goal fireworks, persistent player statistics, and native PlaceholderAPI integration.
Overview
NeaFutbol turns any area in your server into an interactive soccer stadium. Players join matches, get assigned to teams (Blue vs. Red) with colored leather armor, and compete to score goals. Everything runs smoothly without heavy external dependencies or impacting server TPS.
Features
- ⚽ Realistic Ball Physics: Smooth ball trajectory calculations with configurable kick power (
kick-power), launch height (kick-height), passing speed (pass-power), friction deceleration, and boundary bounces.
- ? Real-Time Floating Hologram: Native, lightweight floating scoreboard displaying live match time, team scores, and a dynamic color-coded progress bar.
- ? Auto Team Balancing: Automatically assigns joining players to Blue and Red teams with colored team armor.
- ? 3D Goal Detection: Precise goal hitbox detection triggering fireworks, celebratory titles, sound effects, and central ball reset.
- ? Persistent Player Statistics: Tracks lifetime goals, wins, and matches played per player UUID.
- ? PlaceholderAPI Support: Full suite of placeholders for TAB, scoreboard plugins, holograms, and chat formatters.
- ? Out-of-Bounds Detection: Detects when the ball leaves the field and initiates a fair throw-in restart.
- ? Orphan Entity Cleanup: Built-in
/nf purgeholo command to clean up any leftover hologram or ball entities.
- ? Fully Configurable: All messages, titles, sounds, and timers can be customized via
config.yml and lang.yml.
Placeholders
NeaFutbol provides native PlaceholderAPI expansion variables:
| Placeholder |
Scope |
Description |
Example |
%neafutbol_goals% |
Player |
Total career goals scored by the player |
15 |
%neafutbol_wins% |
Player |
Total career matches won |
9 |
%neafutbol_matches% |
Player |
Total matches played |
24 |
%neafutbol_team% |
Player |
Current team (Blue, Red, or None) |
Blue |
%neafutbol_in_game% |
Player |
Whether the player is currently in a match |
true |
%neafutbol_score_blue% |
Match |
Current goals scored by Blue Team |
2 |
%neafutbol_score_red% |
Match |
Current goals scored by Red Team |
1 |
%neafutbol_match_score% |
Match |
Live consolidated match score |
2 - 1 |
%neafutbol_match_time% |
Match |
Formatted remaining match time (MM:SS) |
04:12 |
%neafutbol_time_seconds% |
Match |
Raw seconds remaining in the match |
252 |
%neafutbol_match_state% |
Match |
Current game state (Playing, Waiting) |
Playing |
%neafutbol_players% |
Match |
Current number of active players |
4 |
%neafutbol_max_players% |
Match |
Configured maximum player capacity |
4 |
Commands
Primary command: /neafutbol (Aliases: /nf, /futbol).
Player Commands
| Command |
Permission |
Description |
/nf join |
neafutbol.join |
Join the matchmaking queue or active match. |
/nf leave |
neafutbol.use |
Leave the current match and return to previous location. |
/nf help |
neafutbol.use |
Display the help menu. |
Admin Commands
| Command |
Permission |
Description |
/nf wand |
neafutbol.admin |
Receive the selection stick tool for boundaries and goals. |
/nf setarena |
neafutbol.admin |
Save field boundaries using your wand selection. |
| `/nf setgoal <team1 |
team2>` |
neafutbol.admin |
| `/nf setspawn <team1 |
team2 |
lobby>` |
/nf setball |
neafutbol.admin |
Set the center ball spawn point. |
/nf setholo |
neafutbol.admin |
Spawn or move the floating scoreboard hologram. |
/nf removeholo |
neafutbol.admin |
Remove the active scoreboard hologram. |
/nf purgeholo |
neafutbol.admin |
Clean up orphaned armor stands or residual ball entities. |
/nf forcestart |
neafutbol.admin |
Force the match countdown to start immediately. |
/nf reload |
neafutbol.admin |
Hot-reload config.yml and lang.yml. |
Permissions
| Permission |
Description |
Default |
neafutbol.use |
Access to basic player commands and help menu. |
Everyone |
neafutbol.join |
Allows joining soccer matches. |
Everyone |
neafutbol.admin |
Full access to arena configuration and admin commands. |
OP |
Setup Guide
Set up a working soccer arena in under 5 minutes:
- Build the Stadium: Construct your field with enclosed boundaries (walls/glass) and goal nets at both ends.
- Define Field Boundaries:
- Run
/nf wand to get the selection stick.
- Left-click corner 1 (bottom corner).
- Right-click corner 2 (opposite diagonal top corner).
- Run
/nf setarena.
- Define Goal Areas:
- Select the interior of the Blue goal with
/nf wand and run /nf setgoal team1.
- Select the interior of the Red goal with
/nf wand and run /nf setgoal team2.
- Set Spawn Locations:
- Stand where Blue team should spawn and run
/nf setspawn team1.
- Stand where Red team should spawn and run
/nf setspawn team2.
- Stand at the waiting lobby and run
/nf setspawn lobby.
- Stand in the exact center of the field and run
/nf setball.
- Add Floating Scoreboard:
- Fly to where you want the scoreboard floating and run
/nf setholo.
Configuration
config.yml
game:
min-players: 2 # Minimum players required to start match
max-players: 4 # Maximum player capacity per match
duration-seconds: 300 # Match length in seconds (5 minutes)
countdown-seconds: 60 # Lobby countdown before match starts
goal-radius: 2.0 # Goal detection radius
team-armor: true # Automatically equip colored leather armor
ball:
skin: "MHF_CoconutB" # Skull skin for soccer ball
y-modifier: -0.5 # Height offset for ball center of mass
hitbox-range: 3.5 # Interaction radius for kicking
kick-power: 1.2 # Ball shoot velocity
kick-height: 0.6 # Vertical lift on shots
pass-power: 1.2 # Ground pass velocity
Support
评论 0
登录后参与评分
还没有评论,来抢沙发吧