This is the weapon_gun script:
//gun.cs
//audio
datablock AudioProfile(gunShot1Sound) <--- This is a datablock, basically they tell BL what to use for the add-on and how to use it. This one is a sound datablock.
{
filename = "./gunShot1.wav"; <-- the sound to use
description = AudioClose3d; <-- don't ask me what this is, just don't mess with it :P
preload = true; <-- preloads this sound (I think)
};
datablock AudioProfile(bulletHitSound)
{
filename = "./bulletHit.wav";
description = AudioClose3d;
preload = true;
};
//shell
datablock DebrisData(gunShellDebris) <-- the datablock for the gun shell
{
shapeFile = "./gunShell.dts"; <-- .dts shape/model to use
lifetime = 2.0;
minSpinSpeed = -400.0;
maxSpinSpeed = 200.0;
elasticity = 0.5;
friction = 0.2;
numBounces = 3;
staticOnMaxBounce = true;
snapOnMaxBounce = false;
fade = true;
gravModifier = 2;
};
//muzzle flash effects
datablock ParticleData(gunFlashParticle)
{
dragCoefficient = 3;
gravityCoefficient = -0.5;
inheritedVelFactor = 0.2;
constantAcceleration = 0.0;
lifetimeMS = 25;
lifetimeVarianceMS = 15;
textureName = "base/data/particles/star1";
spinSpeed = 10.0;
spinRandomMin = -500.0;
spinRandomMax = 500.0;
colors[0] = "0.9 0.9 0.0 0.9";
colors[1] = "0.9 0.5 0.0 0.0";
sizes[0] = 0.5;
sizes[1] = 1.0;
useInvAlpha = false;
};
datablock ParticleEmitterData(gunFlashEmitter)
{
ejectionPeriodMS = 3;
periodVarianceMS = 0;
ejectionVelocity = 1.0;
velocityVariance = 1.0;
ejectionOffset = 0.0;
thetaMin = 0;
thetaMax = 90;
phiReferenceVel = 0;
phiVariance = 360;
overrideAdvance = false;
particles = "gunFlashParticle"; <-- notice that this datablock "calls" a previous datablock, this is very useful and important
uiName = "Gun Flash"; <-- this makes it show up in the in-game menus, if you leave this out or leave the name as "" then it won't show up in-game.
};
datablock ParticleData(gunSmokeParticle)
{
dragCoefficient = 3;
gravityCoefficient = -0.5;
inheritedVelFactor = 0.2;
constantAcceleration = 0.0;
lifetimeMS = 525;
lifetimeVarianceMS = 55;
textureName = "base/data/particles/cloud";
spinSpeed = 10.0;
spinRandomMin = -500.0;
spinRandomMax = 500.0;
colors[0] = "0.5 0.5 0.5 0.9";
colors[1] = "0.5 0.5 0.5 0.0";
sizes[0] = 0.15;
sizes[1] = 0.15;
useInvAlpha = false;
};
datablock ParticleEmitterData(gunSmokeEmitter)
{
ejectionPeriodMS = 3;
periodVarianceMS = 0;
ejectionVelocity = 1.0;
velocityVariance = 1.0;
ejectionOffset = 0.0;
thetaMin = 0;
thetaMax = 90;
phiReferenceVel = 0;
phiVariance = 360;
overrideAdvance = false;
particles = "gunSmokeParticle";
uiName = "Gun Smoke";
};
datablock ParticleData(gunExplosionParticle)
{
dragCoefficient = 8;
gravityCoefficient = 1;
inheritedVelFactor = 0.2;
constantAcceleration = 0.0;
lifetimeMS = 700;
lifetimeVarianceMS = 400;
textureName = "base/data/particles/cloud";
spinSpeed = 10.0;
spinRandomMin = -50.0;
spinRandomMax = 50.0;
colors[0] = "0.9 0.9 0.9 0.3";
colors[1] = "0.9 0.5 0.6 0.0";
sizes[0] = 0.25;
sizes[1] = 0.75;
useInvAlpha = true;
};
datablock ParticleEmitterData(gunExplosionEmitter)
{
ejectionPeriodMS = 1;
periodVarianceMS = 0;
ejectionVelocity = 2;
velocityVariance = 1.0;
ejectionOffset = 0.0;
thetaMin = 89;
thetaMax = 90;
phiReferenceVel = 0;
phiVariance = 360;
overrideAdvance = false;
particles = "gunExplosionParticle";
useEmitterColors = true;
uiName = "Gun Hit Dust";
};
datablock ParticleData(gunExplosionRingParticle)
{
dragCoefficient = 8;
gravityCoefficient = -0.5;
inheritedVelFactor = 0.2;
constantAcceleration = 0.0;
lifetimeMS = 50;
lifetimeVarianceMS = 35;
textureName = "base/data/particles/star1";
spinSpeed = 500.0;
spinRandomMin = -500.0;
spinRandomMax = 500.0;
colors[0] = "1 1 0.0 0.9";
colors[1] = "0.9 0.0 0.0 0.0";
sizes[0] = 1;
sizes[1] = 0;
useInvAlpha = false;
};
datablock ParticleEmitterData(gunExplosionRingEmitter)
{
lifeTimeMS = 50;
ejectionPeriodMS = 3;
periodVarianceMS = 0;
ejectionVelocity = 0;
velocityVariance = 0.0;
ejectionOffset = 0.0;
thetaMin = 89;
thetaMax = 90;
phiReferenceVel = 0;
phiVariance = 360;
overrideAdvance = false;
particles = "gunExplosionRingParticle";
useEmitterColors = true;
uiName = "Gun Hit Flash";
};
datablock ExplosionData(gunExplosion)
{
//explosionShape = "";
soundProfile = bulletHitSound;
lifeTimeMS = 150;
particleEmitter = gunExplosionEmitter;
particleDensity = 5;
particleRadius = 0.2;
emitter[0] = gunExplosionRingEmitter;
faceViewer = true;
explosionScale = "1 1 1";
shakeCamera = false;
camShakeFreq = "10.0 11.0 10.0";
camShakeAmp = "1.0 1.0 1.0";
camShakeDuration = 0.5;
camShakeRadius = 10.0;
// Dynamic light
lightStartRadius = 0;
lightEndRadius = 2;
lightStartColor = "0.3 0.6 0.7";
lightEndColor = "0 0 0";
};
<-- The next part script deals with the CI icon -->
AddDamageType("Gun", '<bitmap:add-ons/Weapon_Gun/CI_gun> %1', '%2 <bitmap:add-ons/Weapon_Gun/CI_gun> %1',0.2,1);
datablock ProjectileData(gunProjectile) <-- the bullet datablock
{
projectileShapeName = "./bullet.dts";
directDamage = 30; <-- The amount of damage you want :D
directDamageType = $DamageType::Gun; <-- These two lines say which which CI
radiusDamageType = $DamageType::Gun; <-- Icon to use for each damage type
brickExplosionRadius = 0;
brickExplosionImpact = true; //destroy a brick if we hit it directly?
brickExplosionForce = 10;
brickExplosionMaxVolume = 1; //max volume of bricks that we can destroy
brickExplosionMaxVolumeFloating = 2; //max volume of bricks that we can destroy if they aren't connected to the ground
impactImpulse = 400; <-- How much the bullet will push
verticalImpulse = 400; <--
explosion = gunExplosion;
particleEmitter = ""; //bulletTrailEmitter;
muzzleVelocity = 90; <-- How fast the bullet is going when fired
velInheritFactor = 1;
armingDelay = 00;
lifetime = 4000;
fadeDelay = 3500;
bounceElasticity = 0.5;
bounceFriction = 0.20;
isBallistic = false; <-- if this is true, the bullet will fall as if gravity is effecting it
gravityMod = 0.0; <-- says how heavy the bullet is
hasLight = false;
lightRadius = 3.0;
lightColor = "0 0 0.5";
uiName = "Gun Bullet";
};
//////////
// item //
//////////
datablock ItemData(GunItem)
{
category = "Weapon"; // Mission editor category
className = "Weapon"; // For inventory system
// Basic Item Properties
shapeFile = "./pistol.dts";
rotate = false;
mass = 1;
density = 0.2;
elasticity = 0.2;
friction = 0.6;
emap = true;
//gui stuff
uiName = "Gun";
iconName = "./icon_gun";
doColorShift = true; <-- ColorShift tells the game if it should change the color of the item/icon, this only works if the icon/gun is partly transparent/has trans materials
colorShiftColor = "0.25 0.25 0.25 1.000";
// Dynamic properties defined by the scripts
image = gunImage;
canDrop = true;
};
////////////////
//weapon image//
////////////////
datablock ShapeBaseImageData(gunImage)
{
// Basic Item properties
shapeFile = "./pistol.dts";
emap = true;
// Specify mount point & offset for 3rd person, and eye offset
// for first person rendering.
mountPoint = 0;
offset = "0 0 0";
eyeOffset = 0; //"0.7 1.2 -0.5";
rotation = eulerToMatrix( "0 0 0" );
// When firing from a point offset from the eye, muzzle correction
// will adjust the muzzle vector to point to the eye LOS point.
// Since this weapon doesn't actually fire from the muzzle point,
// we need to turn this off.
correctMuzzleVector = true;
// Add the WeaponImage namespace as a parent, WeaponImage namespace
// provides some hooks into the inventory system.
className = "WeaponImage";
// Projectile && Ammo.
item = BowItem;
ammo = " ";
projectile = gunProjectile;
projectileType = Projectile;
casing = gunShellDebris;
shellExitDir = "1.0 -1.3 1.0";
shellExitOffset = "0 0 0";
shellExitVariance = 15.0;
shellVelocity = 7.0;
//melee particles shoot from eye node for consistancy
melee = false;
//raise your arm up or not
armReady = true;
doColorShift = true;
colorShiftColor = gunItem.colorShiftColor;//"0.400 0.196 0 1.000";
//casing = " ";
<<-- The next part can be confusing, it helps if you read the comments -- >>
// Images have a state system which controls how the animations
// are run, which sounds are played, script callbacks, etc. This
// state system is downloaded to the client so that clients can
// predict state changes and animate accordingly. The following
// system supports basic ready->fire->reload transitions as
// well as a no-ammo->dryfire idle state.
// Initial start up state
stateName[0] = "Activate";
stateTimeoutValue[0] = 0.15;
stateTransitionOnTimeout[0] = "Ready";
stateSound[0] = weaponSwitchSound;
stateName[1] = "Ready";
stateTransitionOnTriggerDown[1] = "Fire";
stateAllowImageChange[1] = true;
stateSequence[1] = "Ready";
stateName[2] = "Fire";
stateTransitionOnTimeout[2] = "Smoke";
stateTimeoutValue[2] = 0.14;
stateFire[2] = true;
stateAllowImageChange[2] = false;
stateSequence[2] = "Fire";
stateScript[2] = "onFire";
stateWaitForTimeout[2] = true;
stateEmitter[2] = gunFlashEmitter;
stateEmitterTime[2] = 0.05;
stateEmitterNode[2] = "muzzleNode";
stateSound[2] = gunShot1Sound;
stateEjectShell[2] = true;
stateName[3] = "Smoke";
stateEmitter[3] = gunSmokeEmitter;
stateEmitterTime[3] = 0.05;
stateEmitterNode[3] = "muzzleNode";
stateTimeoutValue[3] = 0.01;
stateTransitionOnTimeout[3] = "Reload";
stateName[4] = "Reload";
stateSequence[4] = "Reload";
stateTransitionOnTriggerUp[4] = "Ready";
stateSequence[4] = "Ready";
};
function gunImage::onFire(%this,%obj,%slot)
{
if(%obj.getDamagePercent() < 1.0)
%obj.playThread(2, shiftAway);
Parent::onFire(%this,%obj,%slot);
}
There is lots more stuff I could add in, but that's not very necessary because you can usually tell what that part of the script does just by looking at the script. I'll tell you more later, but for now just see if you can understand how the script works
Feel free to ask questions :P
also the semicolon ';' tells BL when that line is done. If you leave just one of these out the script might not work, so be careful.
