Blog for Anders Dahnielson at GarageGames.com

Showing Bare Bones for Torque 1.4

Anders Dahnielson — 2005-12-30T21:32:02+00:00

I've decided to use this space on GG to chronicle my endeavours into game making as a TGE n00b. It will probably not be very novel. Just a diary over what I've done, how I'm thinking and what I'm aiming for.

Introduction

After having fixed the file system bug on Linux and compiled the TGE demo binary without file redirection enabled (see previous post for details) I was finally ready to create the base my game prototype could be built upon.

I'm no expert in Torque, scripting or modding. This is just a description of my own dabblings in creating a minimal bare bone framework to use as a starting point. So I will at this point subtract more than add to the project. I start by creating a brand new project directory and then copy all the necessary files over from the SDK's example directory, then modify and remove files from the copy.

Copying All We Need

Start by creating a directory for the project. All the files and folders we need to copy do we find in the SDK's 'example' directory.

* First we need to copy our compiled Torque binary and any necessary support libraries to our project.

* Next copy the 'common' directory and all its subdirs.

* Do the same with the 'creator' directory.

* And likewise with the 'tutorial.base', but rename it to 'game'.

* Finaly copy the 'main.cs' from the 'example' dir to our project dir.

What All That Stuff Was

A quick run through...

* The 'common' directory contain commonly shared code implemented in TorqueScript that your game and the TGE editors can use. We copy it since the editors need it, but we are free to ignore it and implement our own version of the functions we may need in our game code. (The reason for that is so we can drop in an updated version of the 'common' without having to merge it with our own modified code.)

* The 'creator' directory contain all the editors we need to create a game. Just like with the 'common' we do not have to ship it with our game.

* The 'game' directory will contain all code and resources for our game. It will contain all the files we will create or modify. This is the directory you should concentrate on exploring.

Big Ol' Main Entrance

When running the Torque binary it will look for a script called 'main.cs' in the directory the binary was executed from. That script is responsible for initialising, executing all the necessary script and setting up the engine.

I will reuse the regular 'main.cs' script and just change the folowing line...

$defaultGame = "demo";

...to read...

$defaultGame = "game";

Well, that's all for now. You can remove all the add mod and game stuff from the command line processing if you like. But that's kinda handy to keep around.

Fixing the Default Mission

Modify the 'game/main.cs' file and change the line...

$Editor::newMissionOverride = "tutorial.base/data/missions/flat.mis";

...in the onStart function to read...

$Editor::newMissionOverride = "game/data/missions/flat.mis";

So that it will find the default mission that we will use as a starting point for all the other missions we will create.

Fixing the Console Key Binding

I've seen that more people than I had problem toggling the console. The regular tilde keybinding may be alright on a US_en keyboard but on other layouts it won't work.

So find the following line in 'game/client/default.bind.cs'...

GlobalActionMap.bind(keyboard, "tilde", toggleConsole);

...and change it to something like...

GlobalActionMap.bind(keyboard, "alt backspace", toggleConsole);

Now I can press Alt + Backspace to toggle the console.

The Game File Hierarchy

Here's an overview of the current directory layout in 'game':

/game
  /client               -- all the client side scripts
    /ui                 -- all gui definitions
      /buttons          -- bitmaps for the bitmap buttons
  /data                 -- contain all game data
    /interiors          -- all the DIF files and their textures
    /missions           -- all the mission files and their terrain height maps
    /shapes             -- all the objects in a scene and their associated files
      /3dtorquelogo
      /markers
      /particles
      /player
    /skies              -- textures for the skies
    /sound              -- sound effect files
    /terrains           -- terrain textures
    /water              -- water textures
  /server               -- all the server side scripts

Ok, as you already may know the game is split up into three parts: client, server and data. The splitting the code into a client and server part is obvious if you doing a multiplayer game (and when running a dedicated server there's no need to run the client part), but it can be a good design decision even for a single player game to split it up as well.

The data part contain all the game resources, missions (TGE's name for "levels"), terrain height maps, textures, 3d objects and animations (you name it...)

Gentlemen, Start Your Engines!

Now let us start it up and see if it works (well, it is supposed to work). If you want you can continue by following the GettingStarted.pdf tutorial, or read on if you already familiar with the editors.

Cleaning Up All The GUI

When starting up the game you're presented with the main menu of the Tutorial Base. Let's start by cleaning it up. Hit F10 to enter the GUI editor.

Start by removing the gray bar an all the buttons at the top and the RSS feed displays at the bottom. We leave the background as-is, it's nice until you have some game specific background image to replace it with.

Now create two new regular GuiButtonCtrl buttons, one which says "Exit" and trigger the "quit();" and another that says "Options" and trigger "Canvas.pushDialog(optionsDlg);". And save the GUI as 'mainMenuGui.gui'.

Click on the "Options" to make sure it works, then do the same with "Exit"...

To really get rid of the RSS feed stuff open up 'game/client/ui/mainMenuGui.gui' in a text editor and remove everything below the '//--- OBJECT WRITE END ---' line.

We continue our "Operation: Clean GUI" by removing the following files:

* game/client/ui/gameonebg.jpg
* game/client/ui/gray_bar.png
* game/client/ui/buttons/*

The ui directory should now contain the minimal GUI:

* background.png -- the background image
* loadingGui.gui -- the screen for loading missions
* mainMenuGui.gui -- the main menu
* optionsDlg.gui -- the options dialog
* playGui.gui -- the game play gui

Data

Actually we won't remove any of the data since it doesn't matter that much what we keep. Some of the stuff can come handy as stand-in objects and textures. For the first time we're actually ready to add stuff. Start adding terrain textures you've created or downloaded that you think you'll need, start adding interiors you've built and start adding objects to populate your world with.

Conclusion

As promised this entry haven't contained anything novel. But it's my first step to create a game prototype. Next I will add some content to play with, create some new missions and finally start groking the TorqueScript code.

Obstacles In the Development Path

Anders Dahnielson — 2005-12-30T00:17:13+00:00

Ok, since I bought my TGE license I haven't created anything yet. Well, I did once a long, long time ago almost managed to build TGE on Linux with the autotools (autoconf, automake, libtool, etc.) but screwed it all up by copying the wrong files when updating the tree to a later TGE version (I think I copied HEAD files when the autotool tree was based on TGE 1.2).

But this will hopefully change now when I together with a friend decided to make a game our "Project 2006". Especially with me bragging about how much easier it will be to make a finished game with TGE than sail another movie project into port.

So I pulled the latest TGE 1.4 from CVS and held my breatch while waiting for it to compile on my Gentoo GNU/Linux box. And it did!

But I soon bumped into an obstacle when trying to walk through the GettinStarted.pdf. I became very confused over the issue where the editors saved my files. Then I found out by accident that it all gets saved in a hidden dir in my home dir ~/.garagegames/torqueDemo/. I asked myself: Varför? Warum? Why?

Why isn't it saved in my games data dir? And how can I change this behaviour? The helpful answer found in the forum was the need to run with the -nohomedir option on the commanline. Now everything will be saved in the regular game/mod file hierarchy (note this is a GNU/Linux only TGE behaviour) including the "compiled" script dso files.

However, everything wasn't fine. First, all files, textures and other files, was listed in a flat namespace making it a veeery long scrollist in the file dialog. Second, running with the -nohomedir option would save the mission files et al. in the example dir (or whatever dir I ran the binary from) but in something like a home/anders/Torque-CVS/example/GameOne/... subdir in the example... Argh!!

This turned out to be caused by the same bug in the Linux specific parts of TGE codebase. For what Todd "zaz" Koeckeritz already had submited a patch.

Quote:

Had a bear of a time with the new file dialog. In fact I thought it was completely broken, but when I went to debug the problem, it turned out to be an issue with the use of dirent on certain file systems during the recursion in recurseDumpDirectories() and hasSubDirectory(). This is because they rely on dirent->d_type to be useful, which isn't guaranteed on all file system types. Once I fixed this problem the file dialog works much better.

After I aplied the patch everything was working much better. The new file dialog finaly made sense and stuff where no longer saved in some insane subdir hierarchies but in the proper places, the places you actually picked in the dialogs... Yes this is still an AAA game engine we're talking about. ;-)

Well, now when that's finaly working I'm off to create a bare bone framework (creating something similar to the MinApp tutorials) to build my prototype on.

Tuesday Apr 27 22:53

Anders Dahnielson — 2004-04-27T22:53:40+00:00

* Deleted my last FAT/FAT32 partition this weekend. Have not used any of the old Win32 partitions in two years... So lets see what I should do with them... ext3? reiserfs? :)

* I'm going to see if I can use the autotools suite (automake, autoconfig, libtool) as usual to build my Torque Game Engine on GNU/Linux, replacing the currently somewaht clunky makefile build system.

* It would also be really cool if I then could use the MinGW for GNU/Linux to crosscompile TGE and ending up bulding Win32 binaries entirely in a GNU/Linux environment. ;)