⚽ 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:

Commands

Primary command: /neafutbol (Aliases: /nf, /futbol).

Player Commands

Admin Commands

Permissions

Setup Guide

Set up a working soccer arena in under 5 minutes:

1. Build the Stadium: Construct your field with enclosed boundaries (walls/glass) and goal nets at both ends.
2. 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.
3. 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.
4. 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.
5. 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

• Author: Nea#9654
• GitHub Repository: NeaCol/NeaFutbol
• Issue Tracker: NeaCol/NeaFutbol Issues