54 lines
2.7 KiB
Plaintext
54 lines
2.7 KiB
Plaintext
|
This example demonstrates a simple mod which adds a console command to print some text.
|
||
|
|
|
||
|
|
Fire up the codebase and open up SysCmds.cpp. Around line 2730, you will see some text that looks like this:
|
||
|
|
|
||
|
|
cmdSystem->AddCommand( "centerview", Cmd_CenterView_f, CMD_FL_GAME, "centers the view" );
|
||
|
|
cmdSystem->AddCommand( "god", Cmd_God_f, CMD_FL_GAME|CMD_FL_CHEAT, "enables god mode" );
|
||
|
|
cmdSystem->AddCommand( "notarget", Cmd_Notarget_f, CMD_FL_GAME|CMD_FL_CHEAT, "disables the player as a target" );
|
||
|
|
|
||
|
|
Let's turn that into:
|
||
|
|
|
||
|
|
cmdSystem->AddCommand( "centerview", Cmd_CenterView_f, CMD_FL_GAME, "centers the view" );
|
||
|
|
//mymod begin
|
||
|
|
cmdSystem->AddCommand( "myCommand", Cmd_MyCommand_f, CMD_FL_GAME, "my brand new command" );
|
||
|
|
//mymod end
|
||
|
|
cmdSystem->AddCommand( "god", Cmd_God_f, CMD_FL_GAME|CMD_FL_CHEAT, "enables god mode" );
|
||
|
|
cmdSystem->AddCommand( "notarget", Cmd_Notarget_f, CMD_FL_GAME|CMD_FL_CHEAT, "disables the player as a target" );
|
||
|
|
|
||
|
|
Now let's go to line 458, above the void Cmd_God_f( const idCmdArgs &args ) function, and let's add:
|
||
|
|
|
||
|
|
//mymod begin
|
||
|
|
void Cmd_MyCommand_f( const idCmdArgs &args ) {
|
||
|
|
gameLocal.Printf("I am a banana!\n");
|
||
|
|
}
|
||
|
|
//mymod end
|
||
|
|
|
||
|
|
Now compile, and you should end up with a ./releasedll/gamex86.dll file. Using a program like WinRAR or WinZip,
|
||
|
|
take that file and put it in a zip file. Now you will want to create a file called "binary.conf". The contents
|
||
|
|
of that file should look like this:
|
||
|
|
|
||
|
|
// add flags for supported operating systems in this pak
|
||
|
|
// one id per line
|
||
|
|
// name the file binary.conf and place it in the game pak
|
||
|
|
// 0 win-x86
|
||
|
|
// 1 mac-ppc
|
||
|
|
// 2 linux-x86
|
||
|
|
0
|
||
|
|
|
||
|
|
Add that binary.conf file into the zip file with the gamex86.dll. You should now have a zip file with those two
|
||
|
|
files in it. Rename the zip file to game00.pk4, and head over to your Prey folder. Under your Prey folder you will
|
||
|
|
have a base folder. Likewise, you want to create your mod folder next to base (not in base!), so let's make a folder
|
||
|
|
called mymod, and put the game00.pk4 we just made in there. Now you should have a file called something like:
|
||
|
|
C:\Program Files\Prey\mymod\game00.pk4
|
||
|
|
So, in the mymod folder, create a file called description.txt. In that file, just put something like:
|
||
|
|
My Mod!
|
||
|
|
And save it. Now start Prey up. In the lower-right of the main menu you'll see the "Mods" option. Click it, and
|
||
|
|
you should see your "My Mod!" mod on the list. Click it and then click "Load MOD". Now bring down the console
|
||
|
|
(ctrl+alt+~), and type myCommand and hit enter. If all is well, your message will be displayed.
|
||
|
|
|
||
|
|
For an example of the final package, check out the mymod folder (in the same folder as this text file).
|
||
|
|
|
||
|
|
|
||
|
|
Rich Whitehouse
|
||
|
|
( http://www.telefragged.com/thefatal/ )
|