
MMOBoomerang (Add-on for MMOITEMS)
Java mod listed for Minecraft 1.21–26.x. Downloads from the MC Java Mods app on Android.
I don't know my version or loader
MMOBoomerang Add-on unofficial !
Throw your MMOItems weapons like real boomerangs.
MMOBoomerang is an add-on for MMOItems that adds a brand new BOOMERANG item type. Right click to throw it: it flies, bounces between enemies, applies your item's stats, skills and effects, then comes back to your hand — or drops where it landed, your choice.
Everything is configured per item, directly in the MMOItems edition GUI. No extra commands, no extra files.
📦 Installation
- Requires MMOItems and Mythiclib/MMOLib (see Compatibility).
- Drop the
MMOBoomerangjar matching your server into yourplugins/folder and restart. - The
BOOMERANGtype is added automatically to MMOItems. - Create your first boomerang:
/mi create BOOMERANG my_boomerang /mi edit BOOMERANG my_boomerang
🔧 Commands & permissions
| Command | Permission | Description |
|---|---|---|
/boomerang reload |
boomerang.admin (op) |
Reloads the config |
📝 Configuration
config.yml holds the default value of every option (used when an item doesn't set it) plus global settings: cooldown, max boomerangs in the air per player, hit radius, ricochet damage multiplier, durability loss, zigzag size, elemental particles, sounds and messages.
(not mandatory) works with this resource pack if u want :
- https://modrinth.com/resourcepack/the-legend-of-zelda-boomerang
- https://modrinth.com/resourcepack/batarangm1
- https://modrinth.com/resourcepack/boomerang-pack_m2
- https://modrinth.com/resourcepack/boomerang-pack_m1
✨ Features
🪃 A real MMOItems item type
- New
BOOMERANGtype, inheriting fromSWORD: all the regular weapon stats work (Attack Damage, crits, elements…). - Damage goes through MythicLib, so crits, elemental damage, defense and damage indicators all apply.
- Thrown hits deal projectile damage, melee hits stay regular weapon damage.
- The item's "on attack" abilities (fire_storm, wither, poison…) are cast on every mob hit, ricochets included.
- MMOItems restrictions are respected (level, class, broken items…).
- Durability: the boomerang wears out on every mob and block hit (MMOItems or vanilla durability, Unbreaking included).
🌀 6 throw shapes
| Shape | Behavior |
|---|---|
LINEAR |
Straight line to the target |
CURVE |
Wide looping arc, out on one side and back on the other |
ZIGZAG |
Straight line, zigzagging from side to side |
CIRCULAR |
Orbits around the player |
TRIANGLE |
Orbits around the player along a triangle |
SQUARE |
Orbits around the player along a square |
Choose the side or spin direction: right, left or random on every throw. Orbit shapes use the max range as their size and the ricochets as their number of laps — each mob is hit once per lap.
🎯 Ricochets
- Number of ricochets and max distance between two targets.
- Optional rehit: when no new mob is in range, the boomerang bounces back to an enemy it already hit.
- Damage multiplier on each ricochet (configurable).
⚙️ Per-item options (MMOItems GUI)
| Option | Description |
|---|---|
| Ricochets | Extra targets after the first one (or laps for orbit shapes) |
| Ricochet Range | Max distance between two targets |
| Rehit Previous Targets | Bounce back on mobs already hit when no new one is in range |
| Max Range | Throw distance (and orbit size) |
| Velocity | Flight speed |
| Throw Shape | LINEAR, CURVE, ZIGZAG, CIRCULAR, TRIANGLE, SQUARE |
| Throw Side | RIGHT, LEFT or RANDOM |
| Droppable | Drops on the last mob hit instead of coming back |
| Block Collision | Stops on walls, or flies through them |
| Item Pickup | Grabs one monster drop per throw and brings it back to you |
| Target Effects | Potion effects given to every mob hit |
| Elemental Particles | Particles matching the item's elements around the boomerang |
| Effect Particles | Colored particles matching the target effects |
| Trail Particle | Any particle trail, colored dust supported |
🧪 Target effects
Click the option in the GUI and simply type in chat:
{effect} {duration in seconds} {amplifier} {hide particles}
Examples: WITHER 10 1 true · POISON 5 0 false · SLOWNESS 3 1
Add as many effects as you want, one line each. Invalid input is rejected with a clear message.
✨ Visuals
- The item itself spins in the air (item display, smooth movement).
- Elemental aura: fire → flames, ice → snowflakes, thunder → sparks… (configurable per element, custom elements supported).
- Effect aura in each potion color, plus an optional trail particle (
CRIT,FLAME,DUST:#FF0000…). - Configurable throw, flight, hit and catch sounds.
🧲 Smart & safe pickup
- The boomerang only picks up items dropped by monsters: never items thrown by players, dead players' drops, broken blocks, displays or other boomerangs.
- One stack per throw (1 to 99 items), brought back to your inventory.
🛡️ No lost items
- Disconnect, world change or server shutdown: the boomerang is given back.
- Death: it drops on the ground.
- Dropped boomerangs can be locked so only the thrower can pick them up.
- Respects protection plugins through MythicLib (PvP, regions, parties…). Players can't be hit unless enabled.
🖥️ Compatibility
| Jar | Server | Minecraft |
|---|---|---|
MMOBoomerang-Paper |
Paper, Purpur | 1.21 → 26.3 |
MMOBoomerang-Spigot |
Spigot | 1.21 → 26.3 |
MMOBoomerang-CraftBukkit |
CraftBukkit | 1.21 → 26.3 |
MMOBoomerang-Folia |
Folia | 1.21.4 → 26.3 |
Requires Java 21+, MMOItems 6.10+ and MythicLib 1.7+ (they must support your server version too). Folia: MMOItems and MythicLib must also run on Folia.
Made by Totomag0. Bug reports and suggestions are welcome!
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21.11, 26.1.2, 26.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
MMOBoomerang (Add-on for MMOITEMS) is a free Minecraft Java mod. Compatible with Minecraft 1.21.11, 26.1.2, 26.2, 26.3 and newer. Downloaded 3 times (via Modrinth). Download it and open it directly in the game.


