Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for Ciran

Minecraft soccer plugin with teams, goals and a realistic ball to use!

Report Soccer?

Soccer

Bring fast-paced football action to your Paper server! Soccer is a modern fork of the original spigot-built PhysicalBall plugin, rebuilt into a complete soccer minigame with improved gameplay, match management, team support, and modern Paper compatibility.

Paper Required: This plugin is built specifically for Paper and is not guaranteed to work correctly on Spigot or Bukkit servers.


Features

Complete Soccer Minigame

  • Realistic physical soccer ball
  • Create multiple soccer games
  • Team-based gameplay
  • Automatic scoring system
  • Live match statistics

Goal System

  • Create persistent goals with an easy selection tool
  • Automatic goal detection
  • Configurable goal particles and sounds
  • Goal markers for easy field setup

Teams

  • Join Team 1 or Team 2
  • Decorative team hats while playing
  • Hats are automatically restored after leaving or respawning
  • Per-game player management

Custom Ball Skins

  • Built-in skin menu
  • Head-based ball skins
  • Permission support for premium skins

Effects

  • Configurable particle effects
  • Goal celebrations
  • Ball interaction effects
  • Broadcast goal sounds

Administration

  • Create and manage unlimited games
  • Activate match balls
  • View live match statistics
  • Simple admin commands
  • Configurable messages and localization

Commands

Command Description
/soccer game join <game> <1|2> Join a team in a game
/soccer game leave Leave your current game
/soccer games List all configured games
/soccer stats <game> View live game statistics
/soccer activate <game> Activate the held ball for a game
/soccer goal create <1|2> <game> Create a goal using the selection tool
/soccer goal remove <1|2> <game> Remove a saved goal
/soccer skin menu Open the skin selection menu

Permissions

Permission Description
soccer.use Allows use of Soccer commands

Server operators have access by default.


Configuration

The plugin includes several easy-to-edit configuration files:

  • config.yml – Ball physics, sounds, particles, and gameplay settings
  • messages.yml – All player messages and localization
  • skins.yml – Ball skins, menu configuration, and permissions

Game data, including matches and goals, is automatically saved in games.yml.


Why This Fork?

Compared to the original PhysicalBall plugin, this fork adds:

  • Modern Paper support
  • Full soccer match management
  • Persistent goals
  • Team system
  • Team hats
  • Live game statistics
  • Better commands
  • Improved configuration
  • New skin system
  • Better visual and sound effects
  • Ongoing maintenance and feature updates

Credits

Soccer is based on the original PhysicalBall project and is released under the MIT License.

A huge thank you to the original developers for creating the foundation that made this project possible.

Information

Category
Games
Published
July 5, 2026
License
MIT
21Downloads
0Stars

Pinned Versions

Members

1