Easy Bullet Holes (Godot Decal Tutorial) 

A little tip: Making the bullet holes big and adding foggy dust and stone particles can make it look like those from F.E.A.R

For anyone looking at this in 2023, Godot 4 now has real decal nodes available and it makes it much easier to implement the bullet holes now without too much fancy maths. You need to rotate the decal node specifically ( Parent rotation doesn't seem to do the trick properly for some reason ) and then follow the tutorial along as normal and it should all work fine. As others have mentioned in the comments, to deal with any stretching issues, make sure to add the decal to the root rather than as a child of the raycasted collider.

For those wondering how to make the decals work on slopes/ground: func check_collision(): if raycast.is_colliding(): var collider = raycast.get_collider() var b = b_decal.instance() # if collider.is_in_group("Enemies"): # collider.queue_free() # print("killed " + collider.name) # get_tree().get_root().add_child(b) ## **this line preserves scale of decal too! ** b.global_transform.origin = raycast.get_collision_point() var surface_dir_up = Vector3(0,1,0) var surface_dir_down = Vector3(0,-1,0) if raycast.get_collision_normal() == surface_dir_up: b.look_at(raycast.get_collision_point() + raycast.get_collision_normal(), Vector3.RIGHT) elif raycast.get_collision_normal() == surface_dir_down: b.look_at(raycast.get_collision_point() + raycast.get_collision_normal(), Vector3.RIGHT) else: b.look_at(raycast.get_collision_point() + raycast.get_collision_normal(), Vector3.DOWN)

you can also tween the alpha transparency of the bullet hole before it disappears so it disappears gradually. really simple way to do bullet decals, nice tut. EDIT: also if you have a normal map texture for the bullet hole, it will look like it has depth.

Fix for Floors and cealing: var surface_direction_up = Vector3(0, 1, 0) var surface_direction_down = Vector3(0, -1, 0) if raycast.get_collision_normal() == surface_direction_up: b.look_at(raycast.get_collision_point() + raycast.get_collision_normal(), Vector3.RIGHT) elif raycast.get_collision_normal() == surface_direction_down: b.look_at(raycast.get_collision_point() + raycast.get_collision_normal(), Vector3.RIGHT) else: b.look_at(raycast.get_collision_point() + raycast.get_collision_normal(), Vector3.DOWN)

Once again thank you so much for all those great videos. Keep up the good job.

Dang, this will help with a lot of stuff, thanks!

Nice tutorial, I was stuck to convert the normal to an angle and the solution was the look_at. Note that Godot 4.0 has a decal node, it works on rounded surfaces. I suggest a tutorial on doing math with current ammo and ammo in pack remaining. For example if you have 1/2 after reloading you should have 3/0 and be unable to reload.

Very helpful! this along with the comments got my decals working perfectly

Amazing tutorial straight to the point no fluff. Love it subscribed!

Very easy to understand Please make a demo on 'muzzle flashes'....

This would be a great way to program sprays/tags like in CSGO or Overwatch.

Prediction : After 1 year Garbaj will have all the tutorials we need to make a fully functional Fortnite , PUBG , Free Fire , GTA 5 , anything

Very good tips thanks. I think typing the code is in general more easily understandable than pasting it. Or it could be my personal taste.

For those of you using Godot 3.x, RayCasts are actually not necessarily needed (although they may still be preferred). You can follow this same method, but use the KinematicCollision gathered from the collision with the same results (at least from what I have tested). Of course, this only applies to objects that actually tie into Godot's physics system. You cannot project these decals from a camera using KinematicCollisions. Here is the method: -------------------------------------------------- # Grab the KinematicCollision from move_and_collide() (or move_and_slide by iterating through the slides) var collider : KinematicCollision = move_and_collide(velocity * delta) # KinematicCollisions give you the same info a RayCast collision will give you if collider != null || collider.collider != null: var b = BulletDecal.instance() collider.collider.add_child(b) b.global_transform.origin = collider.position b.look_at(collider.position + collider.normal, Vector3.UP) --------------------------------------------------

Oh my god, I have been trying to find out how to make a texture background transparent as a .png for the past few days. It's been bothering the hell out of me. Didn't come for that but I'm glad I found it here.

Thank you! Just what I need

You never cease to impress me.

yo, the bullet holes dont work with maps made with csg combiner, some subtracted parts will return a normal of (0, 1, 0) causing the bullet to stand still in the raycast point, can u find a way to fix that plz, to replroduce make a csg map and make a hole somewhere with subtract thing and test the bulletholes

Nice tutorial 👍👍👍 AND love the Spas-12 shotgun model

Thank you I have been looking for this.

Thank you very much! I had a lot of problems with decal rotation.

Something to consider! If you shoot on a curved surface it obviously won't bend. Same as for the edges of flat surfaces!

That's cool and all but how do you make it face the floor or ceiling?

i know this is a late comment but this system WILL NOT WORK if the collision normal points directly up. the look at function uses the second argument as the 'up vector' for the rotation to take place around, so if the normal happens to align with this vector, the entire rotation will fail

I needed this!

I came here after the shotgun tutorial.the shotgun works perfect but to impliment this in shotguns raycast do I have to make like 10 bullet hole scenes

Excellent tutorial 🔥

your videos is amaaaaaaaaaazing

Rotating the decal along the y axis will only work for perfectly vertical walls, not ground or slopes etc. You should construct a new basis for the decal such that decal.basis.z == normal. Given a normal and a distance from origin, you can describe the plane in space that contains the polygon. You can then use pythagoras theorem to generate a random point on that plane given a random vector 3 whose dot product with the normal is negative. Let x-axis be the normalized vector from contact to that point. Let y-axis = normal.cross(x). Let x-axis = normal. Construct basis from these vector and assign to decal.

Great Tutorial bruh ❤️️

I hope one day we will make this using shaders

im getting this error while shooting on ground how can i fix this? E 0:00:14.389 look_at_from_position: Up vector and direction between node origin and target are aligned, look_at() failed. Condition "p_up.cross(p_target - p_pos) == Vector3()" is true. scene/3d/spatial.cpp:691 @ look_at_from_position() Weapon.gd:92 @ _fire() Weapon.gd:51 @ _process()

How do i get it to work with your shotgun tutorial? I have tried but only one decal seems to appear.

great tutorial. thank you!

Attempt to call function 'add_child' in base 'null instance' on a null instance.

Great video! But i noticed that some of my bullet holes doesn't actually align themselves to the surface, mostly when i shoot the ground. Any idea about this?

The instanced decal scales itself to the collider... I can make it small etc. but its proportions always reflect the proportions on the wall it instances itself on. It's like the child (decal tscn) inherits the proportions of its parent. So, when I shoot a box, I get a square decal, but when I hit a rectangular wall, the decal will be a rectangle. How do I keep the size of the decal to its original size?

If you're getting errors when you're shooting at something that is not there, make sure it spawns the bullet_decal if Raycast is colliding. This is how I have mines if raycast.is_colliding(): raycast.get_collider().add_child(bd) bd.global_transform.origin = raycast.get_collision_point() bd.look_at(raycast.get_collision_point() + raycast.get_collision_normal(), Vector3.UP) bd is the name I gave to the variable the spawns the bullet_decal. Make sure to change it to whatever you named it. In the video's case then bd would be b

you need to update this one for godot 4

could this method work for making footprints?

hey garabj i need help my decal is not working with this error "E 0:00:02.526 look_at_from_position: Up vector and direction between node origin and target are aligned, look_at() failed. Condition "p_up.cross(p_target - p_pos) == Vector3()" is true. scene/3d/spatial.cpp:692 @ look_at_from_position() Player.gd:49 @ _physics_process()" pls help

Im not sure why but this doesnt work for me I have the exact same code and the decal doesnt turn flat on the surface and it doesnt even draw on to the surface instead it draws it behind the wall , off the wall so its floating away from the wall at a good distence

if you dont want the game to crash if you're not hitting anything, this is the fix: PS, just change the raycast name back to whatever yours is called! if bulletcast.is_colliding(): var b = bulletdecal.instance() bulletcast.get_collider().add_child(b) b.global_transform.origin = bulletcast.get_collision_point() b.look_at(bulletcast.get_collision_point() + bulletcast.get_collision_normal(), Vector3.UP)

Hello, I have a little problem, i have an assault rifle and want to have bullet holes but it only works if I can once If I hold "fire" it does damage but dont do bullet holes

i am so lucky that i found that channel

I have to change the code a little to don't crash whenever you shoot to the sky and in case you add_child to an escalated object, the bullet will not stretch out: if Input.is_action_just_pressed("fire"): var b = bulletDecal.instance() if(aimCast.get_collider() != null): get_tree().root.add_child(b) b.global_transform.origin = aimCast.get_collision_point() b.look_at(aimCast.get_collision_point() + aimCast.get_collision_normal(), Vector3.UP)

I'm getting this error: Attempt to call function 'get_collider' in base 'null instance' on a null instance

when my decal have texture the game freeze a bit when first fire, but not when the material just a albedo color... i use godot 3.3 btw

Man, how do you always know exactly what I need? I tried doing this myself with 3d Sprites and ended disastrously...

Nice, thanks!

Great tutorial!!!!!!!!!!!!!!!!!!!!!!!!!! pls make one on melee attacks and special attacks....if possible :)

So... i'm having trouble with this part "attempt to call function 'add_child' in base 'null instance' on a null instance can someone help me?

Attempt to call function 'get_collider' in base 'null instance' on a null instance. can i pls get help

whenever i get to a certain number it crashes the game and shows the error "Attempt to call function 'add_child' in base 'null instance' on a null instance."

Still work but some change for Godot 4.0. It good ref builds.

my game crashes if i shoot up or aim at any one of my trees and if i look down my whole map turns black

if i shoot it on the ground it does not appear i mean it does but it does not face the right way

Goodshit

how to add this to the shotgun you made?

how to make multiplayer

Quick question: whenever I click fire, it freezes and says "attempt to call function 'get_collider' in base 'null instance' on a null instance. HELP

If I look at the ground and shoot it spawns bullet holes that follow the player around. Any ideas to fix this? Thanks

does anyone know how I can trace the ray cast with a line, or color the raycast to make it visible?

How to make a fps game in android godot???

Since many noobs will probably have some errors and problems here was my fix to some problems i had using the comments below as help (thank you!) # add this to the top since these are constants and won't be changed const SURFACE_DIRECTION_UP = Vector3(0, 1, 0) const SURFACE_DIRECTION_DOWN = Vector3(0, -1, 0) # the meat of the code, just like the tutorials but with two fixes (read the comments) var b = bullet_decal.instance() get_tree().get_root().add_child(b) # fix for streched decals (adds decal to world instead of making it a child to the mesh) b.global_transform.origin = raycast.get_collision_point() var coll_normal = raycast.get_collision_normal() if coll_normal == SURFACE_DIRECTION_UP or x == SURFACE_DIRECTION_DOWN: # fix for ceiling and floor decals b.look_at(raycast.get_collision_point() + coll_normal , Vector3.RIGHT) return # normal decals on walls and slopes b.look_at(raycast.get_collision_point() + coll_normal , Vector3.UP)

How do i set it to wall and floor and the map?

is there a way to handle the decals when there isn't a collider, like if you were to shoot at the skybox? I found out in my little test level that if I shoot into infinity it crashes the game

It does not work on the floor, please help.

When add it to the Advanced FPS controller it crashes

there's a bug where when you shoot something that's scaled up the bullet decal is scaled up too

Can you please make a short demo on generating endless road in 3d ....it would be great... i couldnt find one.....

Big pogs

it doesnt work on floors for me

idk why, but this tutorial didn't work for me at all

but in large distances the raycast will fall short and could not call the get_collider_point since it would not detect it and it would not be valid