RTS Game Setup

Download Site

This isn't an example game similar to the starter.fps kit, instead I used the tutorial.base as a starting point. It doesn't come with content. That being said, I am planning on making a kind of starter.rts folder that will contain that sort of stuff.

Let's get started. . . .
First off, download and extract the "base" folder. Place "tutorial.rts" inside your "example" folder, and place the "editor" folder inside you "example/common" folder.

Now while your still in the "common" folder, open up "main.cs". Find the function "initBaseClient" (second function from the top), and put this at the bottom of it.

exec("./editor/cursors.cs");

Next, open the "example/main.cs" file. Change "$defaultGame" to:

$defaultGame = "tutorial.rts";

Congratulations! Now you only have to alter the engine code, and your done.

We'll start by making a tiny adjustment to the camera.
Open "Engine/game/camera.cc" file, and find the function "void Camera::processTick". In the last "if" statement before the end of this function, put:

vec.z = 0;

right after:

mObjToWorld.getColumn(2,&vec);

This will keep the camera from rising or falling as you move around.


Now, open your "Engine/editor/worldEditor.h" file. Find "class WorldEditor : public EditTSCtrl" and add this right after "public:"

Point3F getMouse3DPos();

Now scroll down and add this after "bool collide(const Gui3DMouseEvent & event, CollisionInfo & info);"

Point3F collidePos(const Gui3DMouseEvent & event, CollisionInfo & info);

Now open your "Engine/editor/worldEditor.cc" file. Find the function "WorldEditor::on3DRightMouseDown", and put this inside of it:

Con::executef(this, 1, "onRightMouseDown");

Now copy and paste all of this at the very bottom of the same file:

//-----------------------------------------------------------
//RTS CODE START---------------------------------------------
//-----------------------------------------------------------
Point3F WorldEditor::collidePos(const Gui3DMouseEvent & event, CollisionInfo & info)
{
   Point3F startPnt = event.pos;
   Point3F endPnt = event.pos + event.vec * mProjectDistance;

   RayInfo ri;
   bool hit;
   if(mBoundingBoxCollision)
      hit = gServerContainer.collideBox(startPnt, endPnt, 0xFFFFFFFF, &ri);
   else
      hit = gServerContainer.castRay(startPnt, endPnt, 0xFFFFFFFF, &ri);

   if(hit)
   {
      info.pos = ri.point;
      info.obj = ri.object;
      info.normal = ri.normal;
      AssertFatal(info.obj, "WorldEditor::collide - client container returned non SceneObject");
   }
   return(info.pos);
}

Point3F WorldEditor::getMouse3DPos()
{
   CollisionInfo info;
   return collidePos(mLastMouseEvent, info);
}

ConsoleMethod( WorldEditor, getMouse3DPos, const char*, 2, 2, "")
{
   char *returnBuffer = Con::getReturnBuffer(256);
   const Point3F& mat = object->getMouse3DPos();
   dSprintf(returnBuffer,256,"%g %g %g",mat.x,mat.y,-1);
   return returnBuffer;
}
//-----------------------------------------------------------
//RTS CODE END-----------------------------------------------
//-----------------------------------------------------------

Congrats again! At this point your pretty much done. Go ahead and give it a try. Use the world editor to drop some bots in the game and move em around a bit.

All that's left is add building placement code, and path-finding. Since not all RTS games have the option to place buildings wherever you want, and a lot of people already have path-finding code, you can stop right here if you want. (The rest of the code isn't required)

In the same file you were just in, ("Engine/editor/worldEditor.cc"), put this at the top of "WorldEditor::on3DMouseMove":

//For building placement preview
   Con::executef(this, 1, "onMouseMove");

Now put this at the top of "WorldEditor::on3DMouseDown":

//For building placement preview
   Con::executef(this, 1, "onLeftMouseDown");

Great! Now the last thing is path-finding. (if you have your own path-finding, you can skip this part)

Open your "engine/sim/simPath.cc" file. In the function "Marker::onAdd", comment out these lines:

if(gEditingMission)
      onEditorEnable();

Add these lines right after those:

mNetFlags.set(Ghostable);
   setScopeAlways();
   addToScene();

and in the function "Marker::onRemove", comment out these lines:

if(gEditingMission)
      onEditorDisable();

Add this after those lines:

mNetFlags.clear(Ghostable);
  clearScopeAlways();
  removeFromScene();

Now find the functions "onEditorEnable" and "onEditorDisable", and comment out everything inside them. Last but not least, find the function "Marker::renderObject", and comment out the line:

wireWedge(.25, Point3F(0, 0, 0));

To use your new path finding, place path markers around objects that should be navigated. When I do the "starter.rts" file, I'll try and make a function that does this when a new building is created.

Congratulations for the last time! Your done. Please let me know if your having any problems. If you want to see how the engine changes you made are being used, take a look at the "tutorial.rts/client/commander.cs" file.