How-to give a player dynamic agility

First off, open your player.h. after the lines:

Point3F mLastPos; ///< Holds the last position for physics updates
Point3F mLastWaterPos; ///< Same as mLastPos, but for water

add:

S32 agility;

S32 runForce;
S32 maxForwardSpeed;
S32 maxBackwardSpeed;
S32 maxSideSpeed;
S32 maxUnderwaterForwardSpeed;
S32 maxUnderwaterBackwardSpeed;
S32 maxUnderwaterSideSpeed;
S32 jumpForce;

Why: This places your agility settings unde the player namespace, not the PlayerData namespace,w hich is shared by ALL players, but ours is diffrent for each player.

After the lines:

void onCameraScopeQuery(NetConnection *cr, CameraScopeQuery *);
void writePacketData(GameConnection *conn, BitStream *stream);
void readPacketData (GameConnection *conn, BitStream *stream);
U32 packUpdate (NetConnection *conn, U32 mask, BitStream *stream);
void unpackUpdate(NetConnection *conn, BitStream *stream);

Add:

void setAgility(S32 value);

Why: Thisis is the definition of a function that not only sets your agility, but also updates your speed and forces accordingly.

Open player.cc and after:

mBubbleEmitterTime = 10.0;
mLastWaterPos.set( 0.0, 0.0, 0.0 );

mMountPending = 0;

Add:

agility = 10;

runForce = 4320;
maxForwardSpeed = 14;
maxBackwardSpeed = 13;
maxSideSpeed = 13;
maxUnderwaterForwardSpeed = 8.4;
maxUnderwaterBackwardSpeed = 7.8;
maxUnderwaterSideSpeed = 7.8;
jumpForce = 747;

Why: This gives your agility fields something to be at the startup.

After:

U32 retMask = Parent::packUpdate(con, mask, stream);

Add:

if (stream->writeFlag(mask & CharMask))
stream->writeInt(agility,5);

Why: This sends the agility field to the client to hekp the serevr and the client remain in sync.

After:

Parent::unpackUpdate(con,stream);

Add:

if (stream->readFlag())
{
S32 agility = stream->readInt(5);
setAgility(agility);
}

Why this is where the lient recieves the agility variable and updfates the other fields with the setAgility function that has not yet been made.

After:

}
F32 energy = stream->readFloat(EnergyLevelBits) * mDataBlock->maxEnergy;
setEnergyLevel(energy);
}

Add:

static void cSetAgility(SimObject *ptr, S32, const char **argv)
{
Player* obj = static_cast(ptr);
obj->setAgility(dAtof(argv[2]));
}

void Player::setAgility(S32 value)
{
if(value > 0)
agility = value;
else
agility = 1;

runForce = 4320.0 * (agility / 10.0);
maxForwardSpeed = 14.0 * (agility / 10.0);
maxBackwardSpeed = 13.0 * (agility / 10.0);
maxSideSpeed = 13.0 * (agility / 10.0);

maxUnderwaterForwardSpeed = 8.4 * (agility / 10.0);
maxUnderwaterBackwardSpeed = 7.8 * (agility / 10.0);
maxUnderwaterSideSpeed = 7.8 * (agility / 10.0);

jumpForce = 747.0 * (agility / 10.0);

if(isServerObject())
setMaskBits(CharMask);
}

Why: These two functions both set the agility and update the agility related fields. the first one is a console method that can be used in the torque console.

After:

Con::addVariable("Player::minWarpTicks",TypeF32,&sMinWarpTicks);
Con::addVariable("Player::maxWarpTicks",TypeS32,&sMaxWarpTicks);
Con::addVariable("Player::maxPredictionTicks",TypeS32,&sMaxPredictionTicks);

Add:

Con::addCommand("Player", "setAgility", cSetAgility, "obj.setAgility(value)", 3, 8);

Why: This links our console method into the Torque console.

REPLACE!!!:

// Clamp water movement
if (move->y > 0)
{
if( mWaterCoverage >= 0.9 )
moveSpeed = getMax(mDataBlock->maxUnderwaterForwardSpeed * move->y,
mDataBlock->maxUnderwaterSideSpeed * mFabs(move->x));
else
moveSpeed = getMax(mDataBlock->maxForwardSpeed * move->y,
mDataBlock->maxSideSpeed * mFabs(move->x));
}
else
{
if( mWaterCoverage >= 0.9 )
moveSpeed = getMax(mDataBlock->maxUnderwaterBackwardSpeed * mFabs(move->y),
mDataBlock->maxUnderwaterSideSpeed * mFabs(move->x));
else
moveSpeed = getMax(mDataBlock->maxBackwardSpeed * mFabs(move->y),
mDataBlock->maxSideSpeed * mFabs(move->x));
}

With:

// Clamp water movement
if (move->y > 0)
{
if( mWaterCoverage >= 0.9 )
moveSpeed = getMax(maxUnderwaterForwardSpeed * move->y,
maxUnderwaterSideSpeed * mFabs(move->x));
else
moveSpeed = getMax(maxForwardSpeed * move->y,
maxSideSpeed * mFabs(move->x));
}
else
{
if( mWaterCoverage >= 0.9 )
moveSpeed = getMax(maxUnderwaterBackwardSpeed * mFabs(move->y),
maxUnderwaterSideSpeed * mFabs(move->x));
else
moveSpeed = getMax(maxBackwardSpeed * mFabs(move->y),
maxSideSpeed * mFabs(move->x));
}

Why: This makes it so movement is controlled by the fields in Player not PlayerData.

Replace:

F32 maxAcc = (mDataBlock->runForce / mMass) * TickSec;

With:

F32 maxAcc = (runForce / mMass) * TickSec;

Why: Same as last reason.

Replace:

F32 impulse = mDataBlock->jumpForce / mMass;

With:

F32 impulse = jumpForce / mMass;

Why: Same reason again.

And there you go. To use it, get a player's handle and int the torque console type .setAgility()