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.
Pinned Versions
Pages
Members
