This article's documentation is for anything that uses the Source engine. Click here for more information.

spraycan

From Valve Developer Community
Revision as of 13:12, 2 April 2025 by Nescius (talk | contribs) (→‎Example vscript use: can be simpler actually)
Jump to navigation Jump to search
edit
Icon-NotInFGD.png
This entity is not in the FGD by default.
It should not be put directly in a map because it can only be configured through code.
C++ Class hierarchy
CSprayCan
CPointEntity
CBaseEntity
C++ player.cpp

spraycan is an entity available in all Source Source games except Counter-Strike: Global Offensive Counter-Strike: Global Offensive. This is the entity that applies player-chosen spray on walls when they use their spray bind (impulse 201).

ConVars

Cvar/Command Parameters or default value Descriptor Effect
decalfrequency 10 seconds How much must a player wait in seconds before they are able to spray another time
r_spray_lifetime 10 Number of rounds player sprays are visible
Note.pngNote:In Left 4 Dead seriesLeft 4 Dead series sprays disappear after r_spray_lifetime / 2 rounds
cl_logofile Spraypoint logo decal.
cl_playerspraydisable 0 Disable visibility of player sprays.

Example vscript use

Note.pngNote:Tested in Left 4 Dead 2

Can be used to spray a spray of a chosen connected player. Following function takes player handle of a player from whose eye position and angles spraycan is created at and handle of the player whose spray we want to use.

function Spray(sprayer, sprayowner) {
    local spraycan = SpawnEntityFromTable("spraycan", {
    	origin = sprayer.EyePosition(),
    	angles = sprayer.EyeAngles().ToKVString(),
    	vscripts = "spraycan_setup", //vscripts key needs to be non-empty for the entity to work, can be even non existent file
        nextthink = 1, //won't work without this
    	thinkfunction = "RocketRaccoonSupremacy" //thinkfunction key needs to be non-empty for the entity to work
    });
	NetProps.SetPropEntity(self, "m_hOwnerEntity", sprayowner);
	EmitSoundOn("SprayCan.Paint", self);
}

spraycan_setup.nut contains:

function RocketRaccoonSupremacy() {
    EntFire("!self", "Kill", "", 2); //entity killed after 2 seconds just in case something fails
    return 999;
}

See also