ItemOrbs | Magnetic Item Orbs [1.8-26.3]

ItemOrbs — Magnetic XP Orb Physics & Rocket Trails for Dropped Items

ItemOrbs brings dropped items in Minecraft to life by transforming them into floating, oscillating magnetic orbs that gracefully glide toward players like vanilla Experience Orbs, accompanied by cinematic firework rocket propulsion trails and 100% reliable, inventory-safe collection.

Powered by PacketEvents, ItemOrbs delivers buttery-smooth visual interpolation and particle rendering directly to client screens without the physics jitter or entity bloat typical of traditional item magnet plugins.

✨ Key Features

• Authentic Experience Orb Physics: Dropped items do not merely slide linearly; they bob up and down with sinusoidal waves and accelerate smoothly as they approach the player's center of mass.
• Rocket Spark Propulsion Trails: Flying items emit directional firework spark particles trailing behind them, creating a dynamic visual sensation of propulsion.
• PacketEvents-First Technology: Visual movement and particle effects are handled through low-overhead network packets, avoiding unnecessary server physics strain or server-side fake entity spawning.
• 100% Inventory Safety & Anti-Duplication: Items are never removed or altered until collection has been verified. Partially full inventories receive only what fits; items with remaining stacks stay safely in the world.
• Protection Plugin Integration: Native dispatch of EntityPickupItemEvent (or PlayerPickupItemEvent on legacy versions) allows claim plugins (WorldGuard, Towny, GriefPrevention, Residence) to protect claim boundaries.
• Multi-Player Spatial Locking: Each item entity is locked by only one attracting player at a time, eliminating competing player conflicts and jitter.
• Folia, Paper & Spigot Compatible: Built with regional scheduler abstractions to operate safely across Folia's multi-threaded regions as well as standard Paper and Spigot servers.
• Adventure MiniMessage: Fully customizable messages and command responses with gradient and modern text styling.

🎮 Commands & Permissions

• /itemorbs toggle — Toggles magnetic attraction on or off for your player. (Permission: itemorbs.use, Default: true)
• /itemorbs status — Displays current system health, active orbs count, and attraction radius. (Permission: itemorbs.admin, Default: op)
• /itemorbs reload — Reloads config.yml and restarts attraction tasks seamlessly. (Permission: itemorbs.admin, Default: op)

Aliases: /orbs, /itemorb

⚙️ Configuration Overview

ItemOrbs comes with a thoroughly commented config.yml allowing you to fine-tune every aspect of the attraction system:

• Attraction: Adjust attraction radius, initial base speed, maximum approach velocity, acceleration factors, and vertical floating oscillation wave parameters.
• Particles: Configure particle counts, spread offset, speed, and emission interval to optimize visual quality or minimize network bandwidth.
• Collection: Set custom pickup thresholds, sound effects, volume, and vanilla pickup delay enforcement.
• World Filtering: Whitelist or blacklist specific worlds easily.

📦 Requirements & Installation

1. Install PacketEvents 2.14.0+ in your server's plugins/ folder.
2. Drop ItemOrbs.jar into your plugins/ folder.
3. Restart your server or load via your preferred plugin manager.

Author: lHawk_
Discord Community & Support: https://minebuilders.com.br/discord