Basic Dual Weilding

ever wanted to at least get simple dual weilding into your game, well now you can!

this was very easy to implement. started it after reading this thread www.garagegames.com/mg/forums/result.thread.php?qt=23585

this resource only has limited functionality so any feedback and help code will be apreciated.
for now you can only dual weild when you spawn.

well now we shall get to business.

1. open your weapon.cs and add this line under $WeaponSlot

$DualWeaponSlot = 1

i perfer to do it like this because it keeps my code clean.

2. open your client/config.cs file and add this to the end:

movemap.bind (mouse0, "button1", altTrigger);

also open your client/default.bind.cs file and add this to the end:

movemap.bind (mouse0, "button1", altTrigger);

this maps your right mouse button to fire the left gun.

EDIT: I think i have created a different way to mount on contact. This will replace step 3. Open your weapon.cs and change from this:

function Weapon::onPickup(%this, %obj, %shape, %amount)
{
   // The parent Item method performs the actual pickup.
   // For player's we automatically use the weapon if the
   // player does not already have one in hand.
   if (Parent::onPickup(%this, %obj, %shape, %amount)) {
      serverPlay3D(WeaponPickupSound,%obj.getTransform());

      if (%shape.getClassName() $= "Player" && 
            %shape.getMountedImage($WeaponSlot) == 0)  {
         %shape.use(%this);
      }
   }
}

to

function Weapon::onPickup(%this, %obj, %shape, %amount)
{
   // The parent Item method performs the actual pickup.
   // For player's we automatically use the weapon if the
   // player does not already have one in hand.
   if (Parent::onPickup(%this, %obj, %shape, %amount)) {
      serverPlay3D(WeaponPickupSound,%obj.getTransform());

      if (%shape.getClassName() $= "Player" && 
            %shape.getMountedImage($WeaponSlot) == 0)  {
         %shape.use(%this);
      }

 if (%shape.getClassName() $= "Player" && 
            %shape.getMountedImage($WeaponSlot) == 1 && 
            %shape.getMountedImage($DualWeaponSlot) == 0)  {
         %shape.mountImage(%this.dualImage, $DualWeaponSlot);
      }

 if (%shape.getClassName() $= "Player" && 
            %shape.getMountedImage($WeaponSlot) == 1 && 
            %shape.getMountedImage($DualWeaponSlot) == 1)  {
         %shape.throw(%obj.dualImage, 1);
         %shape.mountImage(%this.dualImage, $DualWeaponSlot);
   }
}

go to the weapon datablock and add a dualImage

datablock ItemData(Crossbow)
{
   // Mission editor category
   category = "Weapon";

   // Hook into Item Weapon class hierarchy. The weapon namespace
   // provides common weapon handling functions in addition to hooks
   // into the inventory system.
   className = "Weapon";

   // Basic Item properties
   shapeFile = "~/data/shapes/crossbow/weapon.dts";
   mass = 1;
   elasticity = 0.2;
   friction = 0.6;
   emap = true;

	// Dynamic properties defined by the scripts
	pickUpName = "a crossbow";
	image = CrossbowImage;
	[b]dualImage = DualCrossbowImage;[/b]
};

now open your weapon you want to dual weild and copy your ShapeBaseImage and rename it( I perfer to put "Dual" at the end).

//////////////////////////////////////////////////////////////////////////////////////
////
//// Dual image for dual weilding
////
//////////////////////////////////////////////////////////////////////////////////////

datablock ShapeBaseImageData(DualCrossbowImage)
{
   // Basic Item properties
   shapeFile = "~/data/shapes/crossbow/weapon.dts";
   emap = true;

   // Specify mount point & offset for 3rd person, and eye offset
   // for first person rendering.
   mountPoint = 1;
   eyeOffset = "-0.1 0.4 -0.6";

   // 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 = false;

   // Add the WeaponImage namespace as a parent, WeaponImage namespace
   // provides some hooks into the inventory system.
   className = "WeaponImage";

   // Projectile && Ammo.
   item = Crossbow;
   ammo = CrossbowAmmo;
   projectile = CrossbowProjectile;
   projectileType = Projectile;

   // 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]                     = "Preactivate";
   stateTransitionOnLoaded[0]       = "Activate";
   stateTransitionOnNoAmmo[0]       = "NoAmmo";

   // Activating the gun.  Called when the weapon is first
   // mounted and there is ammo.
   stateName[1]                     = "Activate";
   stateTransitionOnTimeout[1]      = "Ready";
   stateTimeoutValue[1]             = 0.6;
   stateSequence[1]                 = "Activate";

   // Ready to fire, just waiting for the trigger
   stateName[2]                     = "Ready";
   stateTransitionOnNoAmmo[2]       = "NoAmmo";
   stateTransitionOnTriggerDown[2]  = "Fire";

   // Fire the weapon. Calls the fire script which does 
   // the actual work.
   stateName[3]                     = "Fire";
   stateTransitionOnTimeout[3]      = "Reload";
   stateTimeoutValue[3]             = 0.2;
   stateFire[3]                     = true;
   stateRecoil[3]                   = LightRecoil;
   stateAllowImageChange[3]         = false;
   stateSequence[3]                 = "Fire";
   stateScript[3]                   = "onFire";
   stateSound[3]                    = CrossbowFireSound;

   // Play the relead animation, and transition into
   stateName[4]                     = "Reload";
   stateTransitionOnNoAmmo[4]       = "NoAmmo";
   stateTransitionOnTimeout[4]      = "Ready";
   stateTimeoutValue[4]             = 0.8;
   stateAllowImageChange[4]         = false;
   stateSequence[4]                 = "Reload";
   stateEjectShell[4]               = true;
   stateSound[4]                    = CrossbowReloadSound;

   // No ammo in the weapon, just idle until something
   // shows up. Play the dry fire sound if the trigger is
   // pulled.
   stateName[5]                     = "NoAmmo";
   stateTransitionOnAmmo[5]         = "Reload";
   stateSequence[5]                 = "NoAmmo";
   stateTransitionOnTriggerDown[5]  = "DryFire";

   // No ammo dry fire
   stateName[6]                     = "DryFire";
   stateTimeoutValue[6]             = 1.0;
   stateTransitionOnTimeout[6]      = "NoAmmo";
   stateSound[6]                    = CrossbowFireEmptySound;
};

now you should have two image datablocks. the image and the dualImage. make shure you also change the mount point and offset. when you pickup a second weapon it should auto dual.
ps i havent had time to test yet.
/EDIT

4. open your game.cs and add the following lines to gameConnection::createPlayer

%player.setInventory(yourweapon, 1);
           %player.setInventory(yourweaponAmmo, 100);
           %player.mountImage(yourweapon, $WeaponSlot);

           %player.setInventory(yoursecondweapon, 1);
           %player.setInventory(yoursecondweaponAmmo, 100);
           %player.mountImage(yoursecondweapon, $DualWeaponSlot);

5 start your game and try it out

ps: this is my first resource so if it sounds confusing just post here and i will change it.
i am also constantly updating this resorce so it can have the maximum nuber of features possible.