Bullet Hole Decals

Bullet Hole Decals

I've decided to post this as a resource because I believe most people don't know that this function exists for projectiles.

Here's how to set it up:

N.B. I will be using the standard crossbow.cs script as a reference

In your weapon file go to the datablock ProjectileData(CrossbowProjectile) section and add this to the bottom of that datablock before the last };

decals[0] = CrossbowDecal1;
   decals[1] = CrossbowDecal2;
   decals[2] = CrossbowDecal3;
   decals[3] = CrossbowDecal4;
   decals[4] = CrossbowDecal5;
   decals[5] = CrossbowDecal6;

The whole thing should look like this:

datablock ProjectileData(CrossbowProjectile)
{
   projectileShapeName = "~/data/shapes/crossbow/projectile.dts";
   directDamage        = 20;
   radiusDamage        = 20;
   damageRadius        = 1.5;
   areaImpulse         = 200;

   explosion           = CrossbowExplosion;
   waterExplosion      = CrossbowWaterExplosion;

   particleEmitter     = CrossbowBoltEmitter;
   particleWaterEmitter= CrossbowBoltBubbleEmitter;

   splash              = CrossbowSplash;

   muzzleVelocity      = 100;
   velInheritFactor    = 0.3;

   armingDelay         = 0;
   lifetime            = 5000;
   fadeDelay           = 5000;
   bounceElasticity    = 0;
   bounceFriction      = 0;
   isBallistic         = false;
   gravityMod          = 0.80;

   hasLight            = true;
   lightRadius         = 4;
   lightColor          = "0.5 0.5 0.25";

   hasWaterLight       = true;
   waterLightColor     = "0 0.5 0.5";

[b]//Decal Data Start[/b]
   decals[0] = CrossbowDecal1;
   decals[1] = CrossbowDecal2;
   decals[2] = CrossbowDecal3;
   decals[3] = CrossbowDecal4;
   decals[4] = CrossbowDecal5;
   decals[5] = CrossbowDecal6;
[b]//Decal Data End[/b]
};

Then directly above this datablock set up your decal data which should look something like this:

datablock DecalData(CrossbowDecal1)
{
   sizeX       = 0.05;
   sizeY       = 0.05;
   textureName = "~/data/shapes/chaingun/textures/bullethole1";
};
datablock DecalData(CrossbowDecal2 : CrossbowDecal1)
{
   textureName = "~/data/shapes/chaingun/textures/bullethole2";
};

datablock DecalData(CrossbowDecal3 : CrossbowDecal1)
{
   textureName = "~/data/shapes/chaingun/textures/bullethole3";
};
datablock DecalData(CrossbowDecal4 : CrossbowDecal1)
{
   textureName = "~/data/shapes/chaingun/textures/bullethole4";
};
datablock DecalData(CrossbowDecal5 : CrossbowDecal1)
{
   textureName = "~/data/shapes/chaingun/textures/bullethole5";
};
datablock DecalData(CrossbowDecal6 : CrossbowDecal1)
{
   textureName = "~/data/shapes/chaingun/textures/bullethole6";
};

That's it, now when your projectile hits something it will leave a decal. You can adjust how long this decal lasts, max number of decals, and whether decals are enabled or disabled by going into starter.fps\client\prefs.cs and adjusting...

$pref::Decal::decalTimeout = "5000";
$pref::Decal::maxNumDecals = "256";
$pref::decalsOn = "1";

...accordingly.

Hope this is useful.

P.S. Make sure you're texture paths within the datablock DecalData are valid.

EDIT July 31st 2006 - Your weapon's projectile must have an explosion specified for decals to work!
E.g.

explosion           = CrossbowExplosion;