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 <1\|2>` | Join a team in a game | | `/soccer game leave` | Leave your current game | | `/soccer games` | List all configured games | | `/soccer stats ` | View live game statistics | | `/soccer activate ` | Activate the held ball for a game | | `/soccer goal create <1\|2> ` | Create a goal using the selection tool | | `/soccer goal remove <1\|2> ` | 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.