Raycast Hitbox 4.0: For all your melee needs!

Current Version: V.4.0 Stable (07/02/2021)

Upgrading from 3.xx to 4.0

Please note that V4 is not backwards compatible with V3. There are a few API changes that were introduced in V4 to better suit modern code etiquette. Here are the changes you need to know if you want to make your code compliant with V4:

Raycast Hitbox 4.0: For all your melee needs! - #597 by Swordphin123

Notable Features

  • Accurate, performant, and easy to use!
  • Use attachments or vectors to make your hitboxes in seconds!
  • Attachment pairing to create straight-line hit detection!
  • Support for automated individual part hit tracking, humanoid only, or even unfiltered hits!
  • Hitbox distinction (for example, smash bros tippers!)
  • Hitbox Time Scheduler, set and forget; let the module turn off the hitbox for you!
  • Supports Mesh Deformation!
  • No credits necessary and full help support available!

Introduction

Hi there! I just released a module that focuses on raycast hitboxing, so things like melee weapons will probably be the most useful. But feel free to let me know what other projects you will use this for!

OR

Example Place

Direct download
RaycastHitboxShowcaseV4.rbxl (107.4 KB)
(do note that these places won’t be updated, so if this module gets an update, you have to do it)


Original Post & Examples

A few years back, I’ve been intrigued by the design of MORDHAU and Chivalry since I wanted accurate hitboxing while making it simple to do across a variety of different weapon shapes and sizes. Here’s a timestamp of how MORDHAU did their hitbox for their swords which may prove to be helpful.

Warning: Does include realistic depiction of blood so please be aware before opening

It basically fires a ray from an attachment placed on the weapon every frame. Do note that the red lines are visualizations purposes only, they do not last that long.

I also made it so you can adjust the placements of where the raycasting starts via attachments so I can fit it on different weapon shapes easily without hardcoding it. Here is the same system but the attachments are spread out a little to compensate for larger hitboxes.


How To Use

Thankfully, it is very simple. Head over to my Github wiki which has extensive documentation and examples that will get you up and running in less than a few minutes!


Why Raycasting over Touched, Region3, etc… ?

I had a little thought process on the end of this thread, so you can check it out if you’re curious on why I opted to go for raycast.


Limitations

  • HitStart only hits a target once (so multiple rays don’t hit the same target). Call HitStop to reset this target pool so you can hit the same targets again. The module supports different detection modes, so if you dislike this functionality, there is a way to change it.
  • Wide objects requires a lot of attachments to be working correctly

Update Log

Current Version V.4.0 Stable (07/02/2021)
  • Rewrote module to more legible and with more common coding etiquette
  • Typechecking
  • Minor hit detection optimizations
  • Significantly more optimized debug visualizer rays
  • Different Detection Modes
  • Mesh Deformation support
  • Debug Visualizer rays no longer give false positives to the hit detection
  • Debug Visualizer rays switched to LineHandleAdornments
  • Module is now Rojo-compliant at Github
  • More Information: Raycast Hitbox 4.0: For all your melee needs! - #597 by Swordphin123

Previous Versions & Downloads
V.3.3 Stable (02/25/2021)
V.3.2 Stable (11/18/2020)
  • HitStop switched to table.clear, for much better table reuse performance
V.3.1 Stable (11/14/2020)
  • New OnUpdate Event
  • Switched AncestryChanged to CollectionService to fix memory leaks
  • Removed RenderStepped sync rate
  • Fixed some inconsistent signal error messages
V.3.0 Stable (10/15/2020)
  • New Hit Distinction group feature
  • Significantly improved hit detection performance
  • No longer need to disconnect OnHit events!
  • Everything should now be ipairs
V.2.3 Stable (10/13/2020)
  • Removed redundant function calls in MainHandler
  • Significantly improved HitStart/HitStop performance
  • Removed CollectionService ‘RaycastEnabled’ tag (if you were relying on this, it is no longer supported)
  • Fixed inaccuracy issues when a hitbox was deleted
    RaycastHitboxV2.rbxm (9.0 KB)
V.2.2 Stable (8/22/2020)
  • Added WarningMessage bool
  • Minor performance improvements
  • Folder/readability reorganization
  • Documentation improvements
  • GetHitbox returned
V.2.1 EXPERIMENTAL (6/05/2020)
  • Now uses new Raycast API!
  • Removed Hitbox.ignoreList
  • Added Hitbox.raycastParams
  • OnHit now returns 3 arguments: hit, humanoid, raycastResults
V.2.0 EXPERIMENTAL (5/30/2020)
  • Removed RaycastHitbox:DebugMode
  • Removed HitStart([damage value]) argument
  • Removed DontCheckForTransparency
  • New HitboxObject:DebugMode
  • Major Performance Improvements
    RaycastHitboxV2.rbxm (8.4 KB)
V.1.53 BETA (4/03/2020)
  • Updated some outdated API
  • Clarified some troubleshooting steps
  • Added a new troubleshooting question
  • Added warnings whenever it detects rays are not being shown
    RaycastHitbox153.lua (17.9 KB)
V.1.52 BETA (3/25/2020)
  • Fixed LinkAttachment position errors
V.1.51 BETA (3/24/2020)
  • Fixed SetPoints position errors (should now be as accurate as attachments)
  • Credits to @Shurikanz for the find
V.1.5 BETA (3/23/2020)
  • New HitboxObject:RemovePoints
  • New HitboxObject:LinkAttachments
  • New HitboxObject:UnlinkAttachments
V.1.3 & V.1.4 BETA (1/28/2020)
  • Initialize should now return a hitbox and not nil
  • Mild performance increases
  • New Function: PartsMode (documentation is in the script)
1.21 BETA (10/30/2019)
  • Removed RaycastHitbox:HitStart
  • Removed RaycastHitbox:HitStop
  • DebugRays remade with constraints/attachments to help low-end devices
  • Initialization performance improved
1.2 BETA (10/27/2019)
  • New HitboxObject:SetPoints(Instance part, table vectorPoints)
  • New RaycastHitbox:DebugMode(boolean true/false)
  • Recursive now supports all instance types (no longer have to be a model!)
  • Ignore list now automatically includes Terrain
1.1 BETA (10/24/2019)
  • Deprecated RaycastHitbox:HitStart
  • Deprecated RaycastHitbox:HitStop
  • RaycastHitbox now returns HitboxObject
  • New HitboxObject:HitStart
  • New HitboxObject:HitStop
  • New HitboxObject.OnHit:Connect(Instance part, Instance humanoid)
  • New RaycastHitbox:GetHitbox(Instance model)
  • Possible Issue - Heartbeat loop might not successfully disconnect when deinitializing, but happens sometimes (need confirmation)
1.0 BETA
  • Initial Release

Like this module? Please consider donating a little to support my future works!

You can additionally file additional pull requests or bugs at my github repository (though if you DO have bugs, replying to this thread is much faster)


My other modules:
Inverse Kinematics and Procedural Animation
Part Pooling

841 Likes
Experimental Inverse Kinematic and Procedural Animations
Laggy players can't register weapon hits, best way to get around without "trusting the client"
How to make a perfect hitbox?
Custom Enemies and Hit Detection
How do I make a clean hitbox?
Alternative to welding hit-boxes?
A better way of hit detection when .Touched isn't available?
Simple Punch Script
Ways to implement melee hit detection?
Touched Randomly works
Best method for hitbox detection?
How to make a good melee? with a good hitbox
Most Efficient and Performance wise method for Cube-like Hitboxes?
Is it a bad idea to handle hitboxes with GetTouchingParts?
What is the best way to cast large projectiles?
Best way to go about punching system collision detection?
Combat doesn't detect hit sometimes?
Creating attachments along part
I need some tips on a combat system
How do I make a melee system like this?
What is the most efficient way to create a fighting system?
MeleeHitboxModule not following model until after a hit
Is it even possible to have an accurate weapon hitbox that grabs all touching parts (including noncollide)?
Making a making a hitbox more accurate?
Detecting If A Tool Is Interacting With An Object
Melee Raycast problems?
Trouble with region3s and latency
Combat Warriors Information
How to use Raycast Hitbox Module Serversided?
VVG's "Survive a Plane Crash" Credits
Touched event sometime not registering, when used on ServerSide
How do i secure my remote event?
.Touched or RayCasting for meele weapons?
Making a combat game with ranged weapons? FastCast may be the module for you!
Best method for hit boxs?
Multiple ray casts to find a target (client sided) good or bad idea?
Is magnitude too costly for a sword?
Best method for detecting characters touching each other?
Feedback on sword script I made
Melee Hitboxes - What Is The Best Solution, and is the Touched event really that bad?
What is a good method for hit detection on my sword?
Melee Hitboxes - What Is The Best Solution, and is the Touched event really that bad?
What is the best way to make a melee tool damage?
What is a good method for hit detection on my sword?
BodyVelocity is not working for high ping players
Need help with raycast hitbox
How would I go by this fast-paced combat?
How to find every vector3 point inside of a part?
Tired of using Touched for weapon hitboxes? Use HitboxCaster
Tired of using Touched for weapon hitboxes? Use HitboxCaster
How create wounds on players damaged by swords?
Hitbox creation function
How do I go about making a parry with a sword
Upcoming Optimization to Collision Detection System - Beta Test on Mac Clients soon
How to do hit detection for a fast and large projectile
Zone+ v1 (deprecated) | Retrieving players within an area/zone
What is the best option for hitbox?
Punch Script Punches without button being pressed
Can i weld a Region to a player?
My thoughts about client side vs server hit detection
Creating a script for melee fighting
Projectile damages caster
Having trouble figuring out how to get my touch event to work
Best Simple Hitbox for basic combats?
Hitbox reviewal
Magnitude Vs Hotboxing or RayCasting
Breaking a player's attack mid way through
How can I raycast a part
Ban Hammer for King Of The Hill game
Populus Romanus Credits
How would I go about kicking a ball?
How do i extend a sword hitbox?
RayCasting: Can You Ignore Something Based On A Part's Name?
Which method would be most reliable for Touched?
How Would I make a Raycast hitbox
How to do raycasting!
How do so many PVP games run combat so smoothly?
How do you make a your Combat system in your games
Making a combat game with ranged weapons? FastCast may be the module for you!
Grab Player tool
Game Latency Issue
Help with Raycast
What Are Raycasting HitBoxs?
How to prevent certain output?
What should I use to make a punching combat system?
Is there anyway to do a Raycast with a bigger width?
Gun projectile with raycast hitbox
ClientCast - A Client-based, Idiosyncratic Hitbox System!
How can I improve this combat system?
Touched not connecting
Best way to have player damage each other by touch
Melee hitbox handling
Problems with script logic with tools
Combat Testing Information
Why does my sword only work when I put it in starterpack
What kind of hitbox should I use for different sized characters? (Punch Combat)
Melee client lag compensation
Raycast hitbox animation issue (Rays are inaccurate)
Creating an unkown sword slash effect
"Gladiator" project(similar to Chivalry, Mordhau)
Lag with BasePart.Touched
Is there such a thing as good square shaped hitbox detection for combat?
Could a TextLabel (or buttons) detect if there is a Humanoid on It?
Best method for hitbox detection?
How do u throw a sword w/ FastCast module?
Unique game concept - Looking for a scripter
Part Pooling - Increase performance with many parts
Best way to go about punching system collision detection?
Increasing Ray Thickness & Making Ray Hit Multiple Targets
How to debounce Touch events client side?
How would I use magnitude to check if a player is near a tree for an axe script
Touched Event Alternatives?
What is your best way to create a hitbox?
Why do some stuff stop working in my game?
Better way to detect hits for a combat system
How to make my skill detect players and do damage?
Attacks Effecting Multiple Targets
Weapons only doing damage after reaching a keyframe
Scripting Resources Mega List
What's the best way to do a hitbox to check in front of the player?

Awesome module! Very useful and very accurate! I suggest adding a way so you can control what happens when you hit something. For example if I wanted to be able to also hit certain parts with my weapon to destroy them I could. Have it so it will return “hit” like the touched function does. Just a suggestion! Would make this module 10/10 just by having that feature! Good work! Keep it up!

36 Likes

Awesome, Thank you for considering the request!

I’ll provide further feedback when I get to it.


@Swordphin123

https://gist.github.com/howmanysmall/d3681cdf315245927b6b4d3da852d077

I asked a friend to make a more optimized version of the script.


I also notice that you are using a lot of Rays, can it be reduced to using only a few maybe 5?

One in the top left, top right, bottom left, bottom right, and middle along with the Hitbox

Instead of creating many horizontal Rays can you create less with Vertical Rays and still have the same or better performance?

Perhaps the Attachement could automatically be created and all you need to do is create a HitBox part, then use CFrame to get the size and sides of the part then create Damage points depending on how big it is.

17 Likes

Okay now I have to use it given that it’s an open source resource now. I absolutely have to.

From the moment I first saw those hitboxes in action, that became one of my new favourite development-related threads. Being able to work with the logic behind it is a blessing and I thank you very much for sharing this resource with the community.

Melee hitboxes are definitely a rising topic on the DevForum as developers are creating more melee-centric games and a common question throughout the forums is how to achieve accurate hitboxes while accounting for several factors, up to determining which method is most performant and suitable.

Setting the thread to watching to keep up with any discussion. Thank you so much for this.

40 Likes

Thank you! I planned on something like that but ran out of time to make yesterday :sleepy: If I have time today I will absolutely update it with that functionality.

13 Likes

Very nice, This is the best hitbox script i’ve seen so far!

15 Likes

This feature looks AMAZING! Completely ignoring the practical uses for is the ‘SwordShieldMan’ looks cool twirling around a sword covered with red laser beams (aka. hitbox thingies).

In terms of practical uses, I believe this is going to be amazing to use, especially since detecting the.Touched event on a low end device is… Ya know…

Unfortunately as much as I love the rays following the weapon I feel my players may not feel the same way so I guess I wont have that enabled in my projects :frowning:

In conclusion just thank you, this is such a well made solution to one of the most irritating problems on roblox and I didn’t even have to go through a pack of harribos keeping my mind focused enough to script it!

Just to confirm, the thing about using the beams was a joke @ScriptingSupport

12 Likes

AFAIK the rays are only intended for debugging purposes and you aren’t meant to actually enable them within a production environment.

14 Likes

Ah thank you! Before I could reply to your DM, I see you already edited it so I’ll just reply here instead. Let’s start from the top.

  1. There are some slight changes in the optimized version that I think are unnecessary, but overall I think it is ultimately an improvement. DebugRay code was copied directly from the raycasting wiki so take it up with the writers :upside_down_face:. Still at work, so I’ll look at the optimizations a bit more thoroughly later.

  2. I assume you are talking about the SwordNShield NPC above. I’m not sure what you mean by vertical rays, but I suppose if I am visualizing it correctly, something like a ray starting from a sword handguard to the end of it’s blade tip. There is a possibility that you can increase performance with vertical rays like this, but speedy swiping motions will not have a guarantee that it will hit if the target are between the vertical rays between the last and current frame. This will be no different than using a touched event imo (faster physics = less likely to hit).

  3. Automatic attachment generation sounds neat, and I can probably try something like that. Though this may become intricate and difficult if it has meshes or weird shapes, and may even reduce performance depending on its complexity.

Overall, for simple swords, I would just string the attachments along the blade, and maximum 15 of them. Though the SwordNShield NPC has no problem having over 180+ rays being made at once.

14 Likes

I went to art school, this is what they call a master piece

This shouldn’t be a problem if you use a Block Part as a HitBox, so it wouldn’t have weird shapes.

I see, then that could be an option for the Users to choose which type of Ray they want to use depending on the performance they want.

17 Likes

Can confirm, also went to an art school. Even Michelangelo will tremble at your pure brilliancy. Picasso lovers, watch yourself.

I do like the idea of vertical rays, in a way people can sacrifice accuracy for more performance so you’re right. Regarding block part as a hitbox, I suppose something like an irregular scythe weapon where the angles aren’t always rectangular and you want something especially accurate, it might not work but for most common use cases, I can see it working like you described.

13 Likes

Awesome module, however before i am going to use this ill be waiting for some more events to come out. I am currently creating lightsabers and i need the onhit event. So definately using this in the future!

6 Likes

New Update: V.1.1

Hey all, just updated some minor but beneficial changes to the module. You can read more in the “How To Use” and “Update Log” in the main thread if you want to know the changes. Thank you to those who have helped thus far, it was a great learning experience. I will keep updating it and optimizing as need be (and as much as I can within my limited timeframe!)

In summary, the Initialize function now returns a HitboxObject which you can use HitStart or HitStop on. It also has a new onhit function (example in the main thread). I’ve filled out some more information directly in the module, and the HitStart and HitStop used directly on the RaycastHitboxModule is deprecated (so use the returned HitboxObject instead). This variable system also allows you to manage multiple hitboxes, a good example is if you have a dual wielding sword character, you can disable hitboxes for one of the swords while keeping the other off hand on.

16 Likes

How computationally expensive is this? It doesn’t look too bad, but I imagine swords with large hitboxes (and many of them) would have a lot of overhead.

Very nice work :slight_smile:

5 Likes

There are definitely room for improvements, but from what I’ve tested, the performance was a lot better than using Region3 and Touched (in large quantities). The ShieldNSword npc above stretched about 181 raycasts a frame, and even in live production games with a plethora of other computation happening, server was still very smooth, fps drops were minimal, and this is also tested with multiple SwordNShield npcs at once. Though, if you’re really worried, it doesn’t hurt to test it out yourself.

Edit: Most games dont really have oversized swords, so honestly you should be doing 7 - 15 attachments per weapon, 1 stud apart for the most efficiency. It takes hundreds of rays a second to even consider performance drops.

11 Likes

For some reason, was not efficient on my testing.
There are a few points you should certainly consider for next update.

  1. Ignore should automatically include the terrain.
  2. Support for multiple hitboxes, such that sword skill hitboxes are bigger than normal attack hitboxes
  3. have damage with initialize function? Instead of passing it, every time you attack, you could have it set in the metatable.

If possible could you share a sword model that contains the sword (or any other free model scripted with this module) so that we could see how you require the module etc?

However, all in all, this module is really amazing and I appreciated trying it out, thanks!

What I’m currently using for touched event is setting a loop that gets the touching parts of a non-cancollide part in the tool, representing hitbox.

4 Likes

Thank you for your insights. What performance problems were you encountering in particular? I can probably do a quick mockup example later for you.

Regarding 2., V.1.1 should have support for multiple hit boxes, you just need a separate model containing those new attachments and then call initialize on that one. Unless I’m not understanding what you’re requesting then I apologize.

6 Likes

The raycasts are from old point to current point, yes?

If so, then rather than attachments there should be an option to pass a table of positions and a root part to do said positions relative to. This would reduce instance management and be preferable in my opinion.

5 Likes

Yeah, I edited the script so that the sword has is made of tables, each one being the hitbox.
And regarding performance, I believe the number of parts or the number of raycasts created/calculated were the reason for the lag.
Would really appreciate a quick example tool, thanks!

4 Likes

What was your setup? You’re usually capable of firing off hundreds of rays per frame without performance hits as short rays at inexpensive. Seems like a concern to me that you were experiencing performance hits with this, since to my understanding it does exactly that (short rays per frame).

6 Likes