Making a combat game with ranged weapons? FastCast may be the module for you!

[knijntn]

@Xan_TheDragon

wind

Hello, I was just curious if the wind functionality was ever added. That would be great!!

[MastahProdigy (Cyke)]

Hey, sorry to bump this but I’m curious.

Did you use the RayPierce functionality of FastCast which allows bullets the chance to ricochet (or pierce through surfaces. Depends on how you write your OnRayPierce function)?

And if so, how did you handle this if you’re replicating caster information to all the clients? Ricochets can be extremely unpredictable depending on how you write your OnRayPierce function and I am just lost on how I would ensure each client’s replicated bullet follows the same ricochet path.

EDIT: In hindsight, I probably should have just DMed you. My apologies if this pinged a bunch of people.

[egmanegeggggggggg]

i dont know where to ask, but do i have to create a caster for each weapon or can i use one caster for multiple guns?
lets say i was using fastcast on client with a viewmodel gun, and i added weapon switching
do i have to make a new caster for each weapon in the inventory, or do i make one caster and include the weapon stats in each projectile?

EDIT: whoops, shoulda scrolled down a bit
apparently you dont need to

[a19_9 (Nol)]

having a bigger hitbox for wider projectiles is now possible with blockcast and spherecast, is it possible to get an updat e?

[asherppan (concat_nate)]

This does not work, there are gaps in between my ConeHandles that occur pretty often. This forces me to either turn down the speed to an unplayable number or have really inconsistent raycasts. (I’m raycasting on the server)

Edit:
Example of such inconsistency:

[laheitorzito303030]

Hi, i would like to know how can i remove the gravity, because when i put the gravity nil, it just… get’s broken, so how can i disable the gravity?

[BrAlMeSo_Mc (200k)]

Set gravity to 0, I guess.
(I haven’t tested it with gravity 0)

[Cedestius]

This module is honestly quite old, so I dont expect it to have updates anytime soon. However, this does beg the question:

Since Shapecasts are now a thing, will this be added as a potential future update? If not, how easy should it be to modify the code to make it so FastCast can use Shapecasting? For projectiles that might have a larger dimension, this might be useful.

[Cedestius]

Set the acceleration of your newBehavior to a value of 0 or Vector3.new(0,0,0). This should remove any physics from your projectile.

[TheDoom_Boy (Tomi)]

Can anyone explain how does he add an additional parameter to Caster:FireWithBlacklist? As I understand the first parameter it takes would be the origin, but he passes his own data. I would also like to do this but I don’t understand how exactly to do that.

@Quoteory

For the sake of simplicity I’m only using one caster on the server and one on the client for all projectiles, server is for damage and replicating to other clients, and client is for rendering your own projectiles instantly (before remote firing the server) and rendering projectiles sent by the server

ProjectileReplication_Client Module

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local TweenService = game:GetService("TweenService")

local Quire = require(ReplicatedStorage:WaitForChild("Shared").Quire)
local NetworkUtil = Quire("NetworkUtil")
local Caster = Quire("FastCast").new()
local Repr = Quire("Repr")

local projectileReplicationEvent = NetworkUtil:GetRemoteEvent("ProjectileReplicationEvent")
local projectileFolder = ReplicatedStorage:WaitForChild("Projectiles")
local workspaceProjectiles = workspace:WaitForChild("Projectiles")

-- black list setup and updating
local blacklist = {workspaceProjectiles}

local function onPlayerAdded(player)
	local function onCharacterAdded(character)
		table.insert(blacklist, character)
		character.AncestryChanged:Connect(function(_, parent)
			if parent then return end
			table.remove(blacklist, table.find(blacklist, character))
		end)
	end
	if player.Character then onCharacterAdded(player.Character) end	
	player.CharacterAdded:Connect(onCharacterAdded)
end

for _, player in ipairs(Players:GetPlayers()) do
	onPlayerAdded(player)
end

Players.PlayerAdded:Connect(onPlayerAdded)

-- Projectiles
-- fireball
local fireBallProjectile = projectileFolder.FireballPart
local fireBallTweenTime = .2
local fireBallFadeTweenInfo = TweenInfo.new(fireBallTweenTime)
local fireBallTweenProperties = {Transparency = 1}


local ProjectileReplication_Client = {}

function ProjectileReplication_Client.fireProjectile(projectileData, origin, direction, velocity, _, _, ignoreWater, bulletAcceleration, canPierceFunction)
	if projectileData.projectileType == "Fireball" then
		local projectileCosmeticPart = fireBallProjectile:Clone()
		projectileCosmeticPart.Parent = workspaceProjectiles
		
		projectileData.fireBallFadeTween = TweenService:Create(projectileCosmeticPart, fireBallFadeTweenInfo, fireBallTweenProperties)
		
		Caster:FireWithBlacklist(
			projectileData,
			origin, 
			direction, 
			velocity, 
			blacklist,
			projectileCosmeticPart,
			ignoreWater,
			bulletAcceleration,
			canPierceFunction
		)
		
	end
end

Caster.RayHit:Connect(function(projectileData, hitPart, hitPoint, normal, material, projectile)
	if projectileData.projectileType == "Fireball" then
		projectileData.fireBallFadeTween:Play()
		wait(fireBallTweenTime)
	end
	projectile:Destroy()
end)

Caster.LengthChanged:Connect(function(projectileData, castOrigin, segmentOrigin, segmentDirection, length, projectile)
	local baseCF = CFrame.new(segmentOrigin, segmentOrigin + segmentDirection)
	local projectHalfSize = projectile.Size.Z/2
	projectile.CFrame = baseCF * CFrame.new(0, 0, -(length - projectHalfSize))	
end)

projectileReplicationEvent.OnClientEvent:Connect(ProjectileReplication_Client.fireProjectile)

return ProjectileReplication_Client

ProjectileReplication_Server Module

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local Quire = require(ReplicatedStorage:WaitForChild("Shared").Quire)
local NetworkUtil = Quire("NetworkUtil")
local Caster = Quire("FastCast").new()


local projectileReplicationEvent = NetworkUtil:GetRemoteEvent("ProjectileReplicationEvent")
local workspaceProjectiles = workspace:WaitForChild("Projectiles")

-- black list setup and updating
local blacklist = {workspaceProjectiles}

local function onPlayerAdded(player)
	local function onCharacterAdded(character)
		table.insert(blacklist, character)
		character.AncestryChanged:Connect(function(_, parent)
			if parent then return end
			table.remove(blacklist, table.find(blacklist, character))
		end)
	end
	if player.Character then onCharacterAdded(player.Character) end	
	player.CharacterAdded:Connect(onCharacterAdded)
end

for _, player in ipairs(Players:GetPlayers()) do
	onPlayerAdded(player)
end

Players.PlayerAdded:Connect(onPlayerAdded)


local ProjectileReplication_Server = {}

function ProjectileReplication_Server.fireProjectile(projectileData, origin, direction, velocity, _, projectileCosmeticPart, ignoreWater, bulletAcceleration, canPierceFunction)
	Caster:FireWithBlacklist(
		projectileData,
		origin, 
		direction, 
		velocity, 
		blacklist,
		projectileCosmeticPart,
		ignoreWater,
		bulletAcceleration,
		canPierceFunction
	)
	for _, player in ipairs(Players:GetChildren()) do
		if projectileData.player ~= player then
			projectileReplicationEvent:FireClient(
				player, 
				projectileData,
				origin, 
				direction, 
				velocity, 
				projectileCosmeticPart,
				nil,
				ignoreWater,
				bulletAcceleration,
				canPierceFunction
			)
		end
	end	
end

Caster.RayHit:Connect(function(projectileData, hitPart, hitPoint, normal, material, projectile)
	local humanoid = hitPart and hitPart.Parent:FindFirstChild("Humanoid")
	if humanoid then
		humanoid:TakeDamage(projectileData.damage)
	end
end)

return ProjectileReplication_Server

Fireball_Client Tool Script

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local Players = game:GetService("Players")

local Quire = _G.Quire
local ProjectileReplication_Client = Quire("ProjectileReplication_Client")
local ProjectileReplication = Quire("ProjectileReplication")

local tool = script.Parent
local handle = tool:WaitForChild("Handle")
local player = game.Players.LocalPlayer
local mouse = player:GetMouse()
local character
local rightHand

local remotesFolder = tool.Remotes
local shootEvent = remotesFolder.ShootEvent

local statsFolder = tool.Stats
local stateFolder = tool.State
local SPEED = statsFolder.Speed.Value
local RANGE = statsFolder.Range.Value
local DAMAGE = statsFolder.Damage.Value
local PROJECTILE_TYPE = statsFolder.ProjectileType.Value
local FIREBALL_OFFSET = statsFolder.FireballOffset.Value
local GRAVITY = statsFolder.Gravity.Value
local COOLDOWN_TIME = statsFolder.CooldownTime.Value
local COOLDOWN_LOOP_WAIT = COOLDOWN_TIME * 1.2 -- leeway for network delay

local stateFolder = tool.State
local lastActivationTick = tick()


local looping = false

local function shoot()
	local now = tick()
	if now - lastActivationTick < COOLDOWN_TIME then return end
	lastActivationTick = now
	
	local origin = handle.Position + FIREBALL_OFFSET
	local mouseDirection = (mouse.Hit.Position - origin).Unit
	local direction = mouseDirection * RANGE
	local velocity = mouseDirection * SPEED
	local projectileCosmeticPart = nil
	local ignoreWater = true
	local bulletAcceleration = GRAVITY
	local canPierceFunction = function(hitPart, hitPoint, normal, material)
		return false	
	end
		
	local projectileData = {
		projectileType = PROJECTILE_TYPE,
		player = player,
		character = character,
	}
	
	ProjectileReplication_Client.fireProjectile(
		projectileData,
		origin, 
		direction, 
		velocity, 
		nil,
		projectileCosmeticPart,
		ignoreWater,
		bulletAcceleration,
		canPierceFunction
	)
	shootEvent:FireServer(mouseDirection)
end

local function shootLoop()
	if looping then return end
	looping = true
	
	while looping do
		shoot()
		wait(COOLDOWN_LOOP_WAIT)
	end
end

tool.Equipped:Connect(function()
	character = tool.Parent
	rightHand = character:WaitForChild("RightHand")
	mouse.TargetFilter = character
end)

tool.Unequipped:Connect(function()
	looping = false
end)

tool.Activated:Connect(shootLoop)
tool.Deactivated:Connect(function()
	looping = false
end)

Fireball_Server Tool Script

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local TweenService = game:GetService("TweenService")

local Quire = _G.Quire
local NetworkUtil = Quire("NetworkUtil")
local ProjectileReplication_Server = Quire("ProjectileReplication_Server")
local projectileReplicationEvent = NetworkUtil:GetRemoteEvent("ProjectileReplicationEvent")
local tool = script.Parent
local handle = tool:WaitForChild("Handle")
local player = Players:FindFirstChild(tool.Parent.Name) or tool:FindFirstAncestorOfClass("Player")
local character = player.Character
local rightHand = character.RightHand
local remotesFolder = tool.Remotes
local shootEvent = remotesFolder.ShootEvent

local statsFolder = tool.Stats
local SPEED = statsFolder.Speed.Value
local RANGE = statsFolder.Range.Value
local DAMAGE = statsFolder.Damage.Value
local PROJECTILE_TYPE = statsFolder.ProjectileType.Value
local FIREBALL_OFFSET = statsFolder.FireballOffset.Value
local GRAVITY = statsFolder.Gravity.Value
local COOLDOWN_TIME = statsFolder.CooldownTime.Value

local stateFolder = tool.State
local lastActivationTick = tick()

local function shoot(mouseDirection)
	local now = tick()
	if now - lastActivationTick < COOLDOWN_TIME then return end
	lastActivationTick = now
	
	local origin = handle.Position + FIREBALL_OFFSET
	local direction = mouseDirection * RANGE
	local velocity = mouseDirection * SPEED
	local projectileCosmeticPart = nil
	local ignoreWater = true
	local bulletAcceleration = GRAVITY
	local canPierceFunction = function(hitPart, hitPoint, normal, material)
		return false	
	end
	
	local projectileData = {
		projectileType = PROJECTILE_TYPE,
		damage = DAMAGE,
		player = player,
		character = character,
	}
	
	ProjectileReplication_Server.fireProjectile(
		projectileData,
		origin, 
		direction, 
		velocity, 
		nil,
		projectileCosmeticPart,
		ignoreWater,
		bulletAcceleration,
		canPierceFunction
	)
	
end	


shootEvent.OnServerEvent:Connect(function(plr, direction)
	if plr == player and assert(direction.Magnitude <= 1.1, "invalid direction") then
		shoot(direction)
	end
end)

It works, but is there any drawbacks when using only one caster for every projectile?, and I’m also having to pass an additional parameter (projectileData) to fast cast and passing it back through the events (RayHit, etc)

I haven’t had any performance issues yet, but I don’t have access to a large amount of testers to see if there will be

[Cedestius]

I just manually changed it myself to use :Shapecast() instead of :Raycast().

[Supercraft_2001]

Thank you for your modules，it is really what i am wanting to find！

[Quoteory]

It’s been a long time so I don’t remember clearly but I believe I edited the FastCast module itself and added the parameter/argument

[consuary]

I was wondering if there is any way to run the raycast instantly as i want to have hit detection on the client and on the server it will run a check to see if the hit is legal with on the server
edit:
i managed to make it instant.

[SubtleSummit]

Jittery issue with projectile on the client

[consuary]

is the projectile running on the server or on the client? i had to switch mine from being on the server to being on the client to avoid the projectile looking laggy

[SubtleSummit]

It is on the client, thats why it seemed weird to me how laggy it is.
Have you tried changing the camera subject to one of your projectiles?
Maybe you will experience the same lag…

[consuary]

I haven’t noticed any jittering in my projectiles, it doesn’t look that bad so I just wouldn’t worry about it. Does it also look bad when looking at it when the camera isn’t following it? also how are you moving the projectile?

[SubtleSummit]

it looks smooth from the outside because the jittering is unnoticeable from far away or with small objects.

Im using everything the same as the example gun

[Gordo_pica (Luca1006)]

@SubtleSummit

it looks smooth from the outside because the jittering is unnoticeable from far away or with small objects.

Have you tried making smaller segments for the cast?