Start typing to search packages!
hitbox
By @chroma-hade
Roblox
Mirrored from WallyHitbox
Hitboxes for Lunora! Run them on the server, or on the attacker's client with the server checking every hit.
Server hitboxes are the plain kind: the server looks for overlaps every frame. Client hitboxes let the attacker's own screen decide what got hit, so hits feel instant, and the server checks each report so nobody lands a punch from across the map. Set IsClient = true on a player's hitbox to get the client kind. NPCs always run on the server.
Getting it
You need Lunora at ReplicatedStorage.Packages.Lunora.
Grab Hitbox.rbxm from the releases page and put it in ReplicatedStorage.Packages too.
If you use Wally, add both to your wally.toml:
[dependencies]
Lunora = "chroma-hade/lunora@1.0.3"
Hitbox = "chroma-hade/hitbox@1.0.2"
Setting it up
Hitbox comes with a service and a controller. Hand them to Lunora next to your own modules.
-- server
Lunora.AddModules(ReplicatedStorage.Packages.Hitbox.Server)
Lunora.AddModules(ServerStorage.Services)
Lunora.Start()
-- client
Lunora.AddModules(ReplicatedStorage.Packages.Hitbox.Client)
Lunora.AddModules(script.Parent.Controllers)
Lunora.Start()
With Wally, Packages.Hitbox is just a link, so the folders sit in _Index instead:
local HitboxFolder = ReplicatedStorage.Packages._Index["chroma-hade_hitbox@1.0.2"].hitbox
Lunora.AddModules(HitboxFolder.Server)
Using it
local Hitbox = require(ReplicatedStorage.Packages.Hitbox)
local Punch = Hitbox.new({
User = Character,
Size = Vector3.new(6, 5, 6),
PlaceData = { Offset = CFrame.new(0, 0, -3), Linger = true },
LifeTime = 0.1,
IsClient = true,
})
Punch:OnHit(function(Victim)
Victim.Humanoid:TakeDamage(10)
end)
Each victim gets hit once per hitbox. Anything with a Humanoid counts as a victim.
Sizeis aVector3for a box, or a number for a ball (that's the diameter).PlaceData.Offsetplaces it in front of the user'sHumanoidRootPart, andLingerkeeps it following them. UsePlaceData.CFrameinstead for a fixed spot.- Leave out
LifeTimeand it stays until you callPunch:Destroy().
Your rules
Hitbox doesn't know what blocking or ragdolls mean in your game, so you tell it. Set these once, in some module's Init.
Hitbox.SetResolver(function(Data, Victim, HitboxCFrame)
if Victim:GetAttribute("Blocking") and Data.Blockable then
return "Blocked"
end
return "Hit"
end)
Hitbox.SetFilter({ workspace.Characters })
Data is the exact table you passed to Hitbox.new, so you can stick your own fields in there, like Blockable above. Return "Hit", "Blocked" or "Ignore". "Blocked" runs :OnBlocked instead of :OnHit, and "Ignore" lets the victim get hit later in the same swing.
SetFilter limits hitboxes to those folders. Leave it out and everything counts.
How the server checks
The client tells the server who it hit and where the attacker was standing. The server only believes that spot if the attacker could have gotten there in time, based on their WalkSpeed and the ping. Nobody gets to swing from a spot they couldn't have walked to!
If your game moves characters some other way, like a dash, tell Hitbox how fast:
Hitbox.SetSpeedProvider(function(Character)
return Character:GetAttribute("DashSpeed") or 0
end)
Reports that still don't add up wait a moment to see if the server catches up, then get thrown out☆
Seeing them
Set a VisualHitbox attribute to true on ReplicatedStorage. Client hitboxes show up blue, server ones red.
Everything
Hitbox.new(Data) | Makes a hitbox and starts it |
hitbox:OnHit(Function) | Runs for each victim that got hit |
hitbox:OnBlocked(Function) | Runs for each victim your resolver blocked |
hitbox:ResetVictims() | Lets everyone it already hit get hit again |
hitbox:Destroy() | Stops it early |
Hitbox.SetResolver(Function) | Decides hit, blocked or ignored |
Hitbox.SetFilter(Folders) | Only check inside these folders |
Hitbox.SetSpeedProvider(Function) | Extra speed a character can have, on top of WalkSpeed |
License
MIT, so go wild☆ Just keep the license file around.
Package Details
Install command (Click to copy)
Version
1.0.2
License
MIT
Safe for commercial use
Automated license review — not legal advice.
