PhysicalBall

---

⚽ PhysicalBall

football, volleyball — a plugin for Bukkit/Spigot/Paper that adds a football, volleyball to Minecraft with full control mechanics, a skin system, and flexible configuration. Perfect for mini-games like football, volleyball, or just for fun on your server.

---

🎮 Ball Controls

* Right-Click a block while holding the ball → light kick. * Right-Click a block while holding the ball → stronger kick. * Right-Click a block while holding the ball → powerful upward kick. * Right-Click a block while holding the ball → pick up the ball. * Right-Click a block while holding the ball → throw the ball (strength depends on settings). * Right-Click a block while holding the ball → charge a throw (shows power bar on screen). * Right-Click a block while holding the ball → throw with charged power. * Right-Click a block while holding the ball → place the ball on the ground.

---

🛠 Commands

| Command | Description | Permission | | -------------------------- | ------------------------------------------------------------------- | ------------------------ | | `/physicalball reload` | Reloads configurations (`config.yml`, `messages.yml`, `skins.yml`). | `physicalball.reload` | | `/physicalball skin` | Reset the current ball skin to the default one. | `physicalball.skin` | | `/physicalball skin menu` | Open the skin selection menu. | `physicalball.skin.menu` | | `/physicalball skin <url>` | Set a skin using a URL from `textures.minecraft.net`. | `physicalball.skin.url` |

---

⚙️ Configuration

* `skins.yml` — physics parameters (gravity, speed, bounce energy, auto-despawn). * `skins.yml` — customizable messages (supports color codes `&`). * `skins.yml` — list of available ball skins (name, url, permission, custom block message).

--- This project is based on the original work by Evgenii Egorin (2023), licensed under the MIT License.

Modifications, improvements, and additional features by PWRazer (RazerAtheriez) (2025).