Subscribe to download
Offset hoverballs

This is an unofficial remake/update of Marum's Hoverballs, an addon which hasn't been updated since September of 2016.

Offset hoverballs are entities that float at a certain distance from the ground underneath them, adjusting their height automatically to account for slopes, stairs, and uneven terrain. This makes them perfect for building hover vehicles of all kinds!









This version features several updates and fixes over the original, including:
▸ Now properly hovers over props and entities! Make bridges and ramps, go nuts!
▸ Experimental 'Slippery mode' allows your vehicles to slide down slopes.
▸ Wiremod integration, if wire is installed on your server/singleplayer game.
▸ Sleek-ish UI that shows info when looking at a hoverball.
▸ Full duplicator / advdupe / advdupe2 support, bugs from the original have been squished.
▸ Can now assign keys to adjust hover offset and toggle hovering on and off.
▸ Built in airbrakes to slow down your vehicles without relying on thrusters.
▸ Can now click hoverballs to update their values without having to remove and replace them.
▸ Update settings on a whole contraption in one go by shift + clicking the base prop.
▸ Configuration options for everything you could want, and probably some stuff you didn't.
▸ Full multi-language translation support. See community translations section below.
▸ Lasers! Everybody loves lasers.


▸"My offset hoverballs spawn as an error!"
Spawn your hoverballs using the 'Hoverball - Offset' tool. It can be found in the Construction menu. Do not spawn them directly using the entity in the 'Others' tab as this will result in an error model.

▸"My hover vehicle keeps bouncing up and down!"
Either your vehicle is too light or your offset hoverball force value is too high. Try making your contraption heavier or adjusting your hoverball force value in the spawner tool. Tweaking the 'hover damping' (springiness) setting may also help.

▸"I've found a bug!"
Please create a discussion or leave a comment and I'll try to sort it.
(Or if you're good at lua and already know how to fix it then by all means please submit a PR to the GitHub!)

▸"Why do my hoverballs have lines coming out the bottom?"
That laser line is to visualise the trace that the hoverball uses to detect whatever is below it.
Originally a debug thing but I left it in because it looks cool. By default it should only show when you're holding the toolgun, or if you have the checkbox ticked to show them all the time. Both can be switched off in the menu if you want.

▸"Why are there two wire inputs for height?"
The 'Set height' input is used for setting the absolute hover height, So giving it a value of 100 will make the hoverball float 100 units above the surface.
The 'Adjust height' input emulates pressing the up/down hotkeys, for smooth height ajustments. Input any positive value for going up, negative for down. A value of 0 does nothing.

▸"Your code is messy as hell"
Yes, it is. If you'd like to help improve this addon then feel free to submit a PR to the GitHub[github.com], I'd appreciate it!


If you're a cunning linguist and want to help translate this addon into other languages then you can find the translation files on the GitHub[github.com] in the resource/localization/ folder. All help is appreciated.

• This addon wouldn't exist at all without Marum's original version.
  
• With extra features, optimisations, and spaghetti wrangling by dvdvideo1234 on GitHub.
  
• Turkish translation by NovaDiablox.
  
• Bulgarian translation by dvdvideo1234.

Tags for Steam search:
hoverball, hoverbike, hover vehicle, Marum's hoverballs update, float, floater, repulsor, repel, incline, slope, slippery, sled, wire, wiremod compatible, sony