ThomasT | 2012-08-19 02:56
Need sanity check on source modding and the -g option: Inconsistent and incorrect documentation?

I am attempting to understand Sauerbraten's mod development model. First, I have successfully compiled and run the Justice Edition and latest svn release of Sauerbraten as well as Tesseract, all under Mac OS X Snow Leopard. (Compiling and modifying the svn release has some issues on the Mac that I've solved but won't go into here unless someone would like to hear about them.)

Next, I've attempted to understand how source mods are made. I found http://cubeengine.com/forum.php4?action=display_thread&thread_id=1592 ("[MODDING] Your first Sauerbraten MOD, Tutorial 1"). It goes into great detail, describing how to create a new Sauserbraten mod by copying fpsgame, changing the makefile, etc. It then says to specify -g[modname] to execute the mod. However, the Sauerbraten configuration page (http://sauerbraten.org/docs/config.html#_minus_gn) says the -g option is used to specify the maximum number of bots a master can add to a server.

On the third hand, single stepping through the code leads to the argument parser in main() (i.e. SDL_main()) in engine/main.cpp). The parser indicates that the -g option is used to specify the log file! So it looks like the code, configuration documentation, and tutorial all disagree with each other.

Furthermore, after examining the included Makefile it looks like rpggame is not included, in disagreement with the tutorial. I've searched quadropolis for source mods, and it looks like every one at least that I could find just modifies the base source files and distributes the modified files in the mod. I've also done other fairly extensive searches of the web and have found no other information, except maybe a few other pages that say to specify the -g option to execute a mod.

Furthermore, the Mac OS X launcher internally sets the -grpg option to go into the (unused) rpg game code. I hacked the NIB file to actually exercise this path, and not unsurprisingly a log file called "rpg" was created in the user's default directory, sigh, and the rpg game code was never executed.

Lastly, after some more single-step spelunking and code analysis, I see that the game code is specified in the game namespace. This is true for both rpggame and fpsgame. What that means is (obviously) only one or the other but not both can be compiled into the code.

So of course what has happened is the source code has evolved to the point that it is out of sync with some code, documentation, and tutorials. Unfortunately this means it is all but impossible to discern the proper model for source modding the game engine at this point.

So could someone please provide me with some historical perspective on this (since I'm new to the forums)? Also, some guidance as to the proper current way to create and distribute source mods would be appreciated. Thanks in advance for your help!

0
points
 (0 votes)
User login
Users on Quadropolis
3 guests & no users online
10
points ]
 (1 vote)
Created 2020-05-16 23:15
1 week 2 days ago
Created 2020-05-14 12:56
1 week 5 days ago
224
points ]
 (23 votes)
Created 2012-10-20 09:56
7 years 31 weeks ago
Gangler
10
points ]
 (1 vote)
Created 2020-05-12 22:59
1 week 6 days ago
afroninja
46
points ]
 (5 votes)
Created 2020-01-15 07:47
18 weeks 6 days ago
20
points ]
 (2 votes)
Created 2020-04-29 18:35
3 weeks 5 days ago
LURKing
10
points ]
 (1 vote)
Created 2020-05-09 17:56
2 weeks 2 days ago
140
points ]
 (15 votes)
Created 2013-06-09 21:05
6 years 50 weeks ago
20
points ]
 (2 votes)
Created 2020-05-02 19:58
3 weeks 2 days ago
20
points ]
 (2 votes)
Created 2016-07-28 12:06
3 years 43 weeks ago
7YearBitch
20
points ]
 (2 votes)
Created 2020-03-16 20:09
10 weeks 20 hours ago
70
points ]
 (7 votes)
Created 2020-01-24 22:26
17 weeks 3 days ago
40
points ]
 (4 votes)
Created 2020-01-23 12:57
17 weeks 5 days ago
30
points ]
 (4 votes)
Created 2020-01-26 14:10
17 weeks 2 days ago
170
points ]
 (17 votes)
Created 2011-09-05 14:13
8 years 38 weeks ago
Sauce
71
points ]
 (8 votes)
Created 2018-08-22 19:15
1 year 39 weeks ago
Lord Kv
160
points ]
 (16 votes)
Created 2015-03-12 14:45
5 years 11 weeks ago
45
points ]
 (6 votes)
Created 2009-08-15 13:37
10 years 41 weeks ago
MisanthropX
74
points ]
 (8 votes)
Created 2019-12-05 20:57
24 weeks 4 days ago
Redon
105
points ]
 (11 votes)
Created 2019-10-24 21:41
30 weeks 4 days ago
Who's new
  • Akari
  • LURKing
  • Antknee55
  • gmiz
  • impala97