Home›Java›Mods›MMOBoomerang (Add-on for MMOITEMS)
MMOBoomerang (Add-on for MMOITEMS)
ModsJava

MMOBoomerang (Add-on for MMOITEMS)

Java mod listed for Minecraft 1.21–26.x. Downloads from the MC Java Mods app on Android.

by Totomag0 · on Modrinth

Which build do you need?

This mod ships a separate file for every mod loader and every version of the game. Pick both, then download — the wrong build installs fine and then does nothing in the game.

Mod loader

Minecraft version

⬇ Download for 1.21.11–26.3 · Bukkit⬇ Download for 1.21.4–26.3 · Folia⬇ Download for 1.21.4–26.3 · Paper⬇ Download for 1.21.5–26.3 · Purpur⬇ Download for 1.21.11–26.3 · Spigot
I don't know my version or loader
Open the Minecraft launcher and look at the profile you play on — it names both, like fabric-loader-1.21.4. The version also shows in the bottom-right corner of the game's main menu.
No loader in the profile name? Then it's plain Minecraft, and these mods won't run — you need Fabric or NeoForge installed first.

MMOBoomerang Add-on unofficial !

modrinth discord youtube

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

  1. Requires MMOItems and Mythiclib/MMOLib (see Compatibility).
  2. Drop the MMOBoomerang jar matching your server into your plugins/ folder and restart.
  3. The BOOMERANG type is added automatically to MMOItems.
  4. 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 :

✨ Features

🪃 A real MMOItems item type

🌀 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

⚙️ 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

🧲 Smart & safe pickup

🛡️ No lost items


🖥️ 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!

discord

Quick facts

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.

Explore more