Basic TerrainDeformer Object for Torque

Download Code File

I'll provide you with a synopsis of how to add the resource. Bear in mind that you can see ~all~ of my changes to existing files by searching for my initials, RFB, in the .cc, .h, and .cs files.

1. Add terraindeformer.cc and .h to your engine/game/fx folder, then add them to your Torque Demo Project.

2. Edit engine/console/consoleTypes.h as per my comments in the included consoleTypes.h file. This is so the console recognizes TerrainDeformer as a console object.

// RFB ->
TypeTerrainDeformerDataPtr,
// <- RFB

3. Edit engine/game/objectTypes.h as per my comments in the included objectTypes.h file. This is so other objects know what sort of object a TerrainDeformer is.

// RFB ->
TerrainDeformerObjectType = bit(7),
// <- RFB

4. Edit example/starter.fps/server/scripts/crossbow.cs as per my comments in the included crossbow.cs file. The change here is to add a bit of code in function CrossbowProjectile::onCollision() so that if the projectile hits the terrain, it spawns a terrain deformer to make a crater.

// RFB ->
// if the projectile hit the terrain, create a terrain deformer
// and make a small crater
if (%col.getType() & $TypeMasks::TerrainObjectType)
{
%d = new TerrainDeformer() {
datablock = DefaultTerrainDeformer;
position = %pos;
depth = 1.0;
width = 10.0;
height = 10.0;
};
MissionCleanup.add(%d);
}
// <- RFB

5. Edit example/starter.fps/server/scripts/game.cs as per my comments in the included game.cs file. This change is required in order for the game to load the terrain deformer datablocks.

// RFB ->
exec("./terrainDeformer.cs");
// <- RFB

6. Add my terrainDeformer.cs file to your example/starter.fps/server/scripts/ folder. This file contains the DefaultTerrainDeformer datablock, and it's particle and sound emitter datablocks.

7. Place my burning.ogg file into your example/starter.fps/data/sound/ folder. This sound plays while the deformer is deforming.

8. Rebuild your entire solution.

Now go into your game, and fire the crossbow at the ground. You should see a smoking, hissing, crater appear.

-----------------------------------------------------------

Open terrainDeformer.cs and scroll to the bottom to see the DefaultTerrainDeformer datablock.

Valid values for the 'type' parameter are 0 for point deformation, and 1 for rectangle deformation.

Change the lifetime parameter if you want to slowly deform the terrain over time. This value is in Ticks and determines the time it takes in ticks to finish the work.

Change the sound, duration the sound plays, and the particle emitter.

Also notice that that position, depth, width, and height are set in the call to new TerrainDeformer() in function CrossbowProjectile::onCollision().

--------------------------------------------------------------------------------------------

***NOTE*** This resource is a work in progress. Stephen Zepp is adding additional features such as round craters, spline craters, and support for other deformer types.

There is no terrain relight, nor is there any scortched texture being applied to the terrain. I left these things out due to my busy schedule. I've tested the TerrainDeformer in multiplayer games. There are issues if you fire at the ground directly beneath you. The player will not simply drop down into the crater due to networking issues. I suggest applying a downward impulse to all objects in a given radius for this, or just simply blowing up anyone in the area of the crater when it is created.

I hope you like this basic TerrainDeformer, and that some of you will take it to a higher level. Good luck and have fun killing the ground. Thank you Stephen, for testing my code, and working on the RTS features and new deformer types.

Robert