The handy-dandy Boomerang!
Hold Fire to throw it. Aim up and down while holding fire to change its path. Release fire to bring it back. Even if you move around, IT STILL FOLLOWS YOU! AMAZING!

Electro Boomer: Draw2Throw Mode - Hold FIRE and move the cursor around with UP/DOWN/LEFT/RIGHT or the mouse to draw a line. Release FIRE to throw the boomerang, which will follow the line you drew. Toggle modes by opening the PIE MENU and selecting the AI Gold Dig option.

Electro Boomer: Draw2Throw Gravity Mode - Works the same way as normal D2T Mode, but is harmless(kinda) and has a gravity effect while it follows the line.

Standard Mode:


note: Boomerang is much faster in-game. ^These^ are also old gifs.

Draw2Throw Mode:


Draw2Throw Gravity Mode:


--Rocket Boomer-- A boomerang with 2 rockets attached to each wing. When the boomerang hits an object, the rockets explode! The Draw mode on the Rocket boomer has the rockets explode at the end of the line. The next mode is Fire Rain mode, where an explosion of small bombs and napalm rain from the end of the drawn line.

Standard Mode:


Draw Mode:


Fire Rain Mode:
Need to gif this later.


--Earth Boomer-- A boomerang that attacks by spinning twin boulders and defends by creating walls of hard dirt. Note: Earth Boomer is actually green in-game.
Standard Mode:


Terrain Mode:



NEW --Stinger Boomer-- This boomerang can lock-on and home in on objects. Standard mode works the same way as the Electro Boomer's. In Draw Mode, move the cursor over an object to lock onto it and release fire for the boomerang to follow the drawn path and attack the object. In Frenzy Mode, draw a line and the boomerang will attack anything close to the end of the line.
Draw Mode:


Frenzy Mode:



Updates:
(1-10-09)
-Complete mouse support

(1-9-10)
-Added Stinger Boomer

(1-4-10)
-Boomerangs would not work if multiple were used at the same time, that's fixed
-Earrth Boomer is now green

(1-2-10)
-Added Earth Boomer
-Made mod compatable with both windows and mac

(12-31-09)
-Added Rocket Boomer

(12-29-09)
-Added Gravity Draw mode, which is like draw mode with gravity effects and no damaging particles.

(12-28-09) Again
-If the AI used the boomerang while it was in Draw mode, they would get multiple boomerangs in their inventory. *Fixed

(12-28-09)
-Draw2Throw Mode: draw a line and the boomerang follows the path
-Added electric sounds effects
-boomerangs work properly when crossing map seams

(10-28-09)
-Better rotation appearance
-Boomerang doesn't disappear when you die
-You can now use the boomerang with a shield

(10-25-09)again
-Mouse support added. Both control types aim up and down to move boomerang.

(10-25-09)
-Less terrain damage

(10-24-09)
-Re-did Lua script

Credits:
CaveCricket48 - Sprites, Lua Scripting
Grif - Lua help
PhantomAGN - How to concatenate
Valve - Sounds

Enjoy!

Windows + Mac Version

Looks like it's a second behind itself, is that fixed in the release version? What if it doesn't make it back?

The boomerang doesn't actually track the user, but kindof warps back to the actor. The reload is fixed in the released version.

Only the original thrower can catch it.

It would be nice if this was a TDE instead, so when you throw it you actually lose it, and have it go back into the player's inventory when it comes back, or have them have to go pick it up if they miss.

Plus you could decide how far you want to throw it.

Seems like an interesting idea, but I'm not sure it's possible to make it work right.
What you want is:

Throw it.
It does stuff, and then comes back the the point it was thrown from.
Your Actor automatically catches it if it touches him and he threw it.

Now, by the look of it you've got the 1st and 2nd points done, although in the form of a gun instead of a throwable object.
Problem is, if you want to make it a throwable object, you'll need to code it very differently, and possibly incorporate sparkle magic to make it follow the desired path.

Reminds me of Ty the Tasmanian Devil.

DLing. Get results later.

Now that I know Lua, I re-did the script. Now it follows you (the thrower) and you can change its flight pattern by holding fir and pressing up/down.

Before the lua implant, I was like 'meeh...just a gun shaped like a boomerang.'

But now, it's definitely worth the download. A really fun weapon to use, and good for hitting from behind covers in open areas.

Great job, Cricket.

I noticed that the boomerang still emitted damging particles when it was underground, that's fixed now. Also, added a gif to the OP to demonstrate what you can do with it.

Press up/down to make it move... right, I'm not jetpacking to make that bad boy go up into a stronghold!

could you make a button slow it down? (so that it damages something longer) if you could slow it down as its going through an actor then that actor would get shredded rather than maimed

Whoops, forgot about mouse users. Fixed.



Tell me a good button to put that feature on and I'll do it tomorrow.

F possibly or C Would be good I would say z but thats pretty much used up by everyone else already and might be a pain to use with some other mods (ie: DarkStorm)

Edit:

Mouse suport?: Oh Hell yes! (and here i was using my keyboard)