CubeBall adds football gameplay to Minecraft servers with a physical falling-block ball, team-based matches, arena markers, configurable effects, and in-game admin commands.
It targets Minecraft Java Edition servers running Bukkit-compatible software such as Paper and Spigot.
- Play football with a configurable falling-block ball
- Create arenas directly in world with block markers for spawns and goals
- Run matches with blue, red, and spectator teams
- Use countdowns, round restarts, score tracking, max goals, and overtime
- Tune particles, sounds, goal animations, timings, and bounce behavior
- Manage everything in game with
/cb
- Minecraft Java Edition
- Bukkit API
1.13+ - Recommended server software: Paper
- Also intended for Bukkit, Spigot, and compatible forks
- Download the latest CubeBall JAR.
- Put it in the server
plugins/folder. - Start the server once to generate
config.yml. - Build a field and place the arena marker blocks.
- Run
/cb matchnear the arena. - Assign teams with
/cb team <BLUE|RED|SPECTATOR> <player>. - Start the game with
/cb start.
Default materials:
- Ball spawn:
EMERALD_BLOCK - Blue spawn:
BLUE_WOOL - Red spawn:
RED_WOOL - Blue goal:
BLUE_CONCRETE - Red goal:
RED_CONCRETE
These markers can be changed in config.yml.
Main command:
/cb
Common examples:
/cb reload/cb match/cb start/cb pause/cb resume/cb stop/cb team BLUE PlayerName/cb generate training-ball/cb remove training-ball
Permission:
cubeball.manage
The complete documentation is published at stellionix.github.io/Cubeball.
Useful pages:
./gradlew test shadowJarThe plugin artifact is generated in build/libs/.
Technical contribution guidelines are available in CONTRIBUTING.md.
This project is distributed under the LICENSE.