Magical Fruit

MagicFruits brings a completely new gameplay layer to your Minecraft server.
Collect, spin, and master 12 legendary fruits – each with its own right‑click and crouch‑right‑click abilities.

🔺ISSUES

For more details

---

✨ Features

🍎 12 Unique Fruits

Fruit	Primary Ability	Secondary Ability
Cyclone Fury	Dash with 10x speed, launch enemies	Summon a tornado that sucks up blocks & slams them
Tsunami	Water geysers that launch entities skyward	Transform into a devastating tsunami wave
Dracula Bites	Blood Phase – every 3rd hit heals you	Become a bat, fly freely and bite enemies
Nature Hammer	Hook & control a player, then launch them	Summon an oak hammer that smashes enemies
Void	Invisibility + night vision	Random teleport with particles
Thunder	Conduit power + dolphin's grace	Strike lightning at targeted block
Throne	Damage‑reflecting shield (50% reduction)	Summon a 3x3 obsidian wall with knockback
Wind Monster	Float & auto‑slam 5x5 area (wind version)	Same but with electric damage & lightning
Star	Supernova – orbiting stars, beams, area damage	Black hole – pulls & crushes enemies
Thief	GUI to steal another player’s ability	Freeze everyone within 30 blocks (2 min cooldown)
Portal	Create two portals (15s to connect)	Summon a portal that lets you call any online player
Buddha	Strength + resistance	Temporary invulnerability

🎡 Spin System

• New players get a free spin (toggable).
• Admins can start spins for self, specific player, or all players.
• 15‑second spinning animation with particles and floating item previews.
• Random fruit reward – shown with a fancy title and sound.

🎮 Admin Dashboard

• One‑click GUI to give fruits, manage spins, reset player data.
• Toggle first‑join reward on/off.
• Toggle drop‑on‑death on/off.
• Adjust cooldown duration & spin duration.
• Enable/disable particles and sounds.

🔥 Advanced Mechanics

• Separate cooldowns for primary/secondary abilities.
• XP bar + action bar cooldown timer.
• CustomModelData support – ready for resource packs.
• Grace period command – protect new players during events.
• 100% Paper 1.21.4 – uses latest API.

---

📦 Commands

Command	Description
/magicfruits	Open admin dashboard
/magicfruits spin [player/all]	Start fruit spin
/magicfruits give <player> <fruit>	Give a specific fruit
/magicfruits reset <player/all>	Reset player data
/magicfruits grace start <minutes>	Start grace period
/magicfruits grace stop	End grace period
/magicfruits reload	Reload config

Permissions: magicfruits.admin (default OP)

---

🛠️ Installation

1. Download the JAR file.
2. Place it in your server’s plugins folder.
3. Restart the server.
4. (Optional) Install CIT_reborn or CIT Resewn and add the included resource pack for custom fruit textures.

---

🔧 Resource Pack Required

Perfect for servers that want a premium, unique look.

---

📜 Requirements

• Paper 1.21-1.21.11 (Spigot may work but not officially tested)
• Java 21+

---

💬 Support & Feedback

Found a bug or have a suggestion?
Open an issue on our GitHub or join our Discord (link inside config).
Please include server version, error logs, and steps to reproduce.

---

❤️ Credits

Designed & coded for the Minecraft community.
All fruit models and abilities are original.