q3_ui - docs: Implement horizontal scrolling description about the selected gametype on GAME SERVER menu, change 'First Person Vis' to 'First Person Vis Mode' on BFP OPTIONS menu and describe correctly about the project on Q3 source code history on README

Author: LegendaryGuard

README.md

@@ -84,7 +84,7 @@ Bid For Power is a total conversion for QuakeIII that plays nothing like the ori
 
 The project was started on Quake 2, that's where they were getting organized playing Quake and learn some programming there.
 
-The source code is said to have started from SDK 1.17 point release after the release of Quake 3 Arena (December 2, 1999). It continued to be updated, including the addition of `cg_particles.c` in 1.29, until 1.31. 
+The source code is said to have started from SDK 1.15c released on January 14, 2000. It continued to be updated, including the addition of `cg_particles.c` in 1.29, until 1.31. 
 More info can be found in [Quake 3 Arena changelog version history](https://discourse.ioquake.org/t/quake-3-changelog-version-history/375).
 
 The original source code appears to be lost, but the assets and some docs are available in various places. Nonetheless, not all sources are accessible.
@@ -139,6 +139,7 @@ The highest priority goal is to copy and recreate the complete logical structure
 You'll notice some differences and things that the original Bid For Power didn't have/were forgotten, incomplete or poorly made such as:
 - some adjusted UI buttons
 - BFP OPTIONS menu is upgraded, big explosions and smoke options are back (these were removed after RC/beta versions), also shell and ring options are available and these are options are interactive with explosion type option. Sprite and particle aura types are available on aura type option
+- in the first GAME SERVER menu has a horizontal scrolling description about the selected gametype
 - SERVER INFO menu displays all server info (on original BFP, the info was badly displayed and nothing was shown) and it has pagination
 - DRIVER INFO menu is fixed (on original BFP crashes) and it has pagination on extensions
 - explosion dynamic lights are back (these were broken after RC/beta versions)

source/q3_ui/ui_bfpoptions.c

@@ -74,7 +74,7 @@ static const char *auratype_items[] = {
 static const char *viewpoint_items[] = {
 	"Third Person",
 	"First Person",
-	"First Person Vis",
+	"First Person Vis Mode",
 	NULL
 };
 
@@ -274,7 +274,7 @@ static void BFPOptions_Event( void* ptr, int notification ) {
 			BFPOptions_Viewpoint_Setup( 0, 0 );
 			break;
 
-		case 2: // First Person Vis
+		case 2: // First Person Vis Mode
 			BFPOptions_Viewpoint_Setup( 0, 1 );
 			break;
 		}

source/q3_ui/ui_startserver.c

@@ -70,6 +70,7 @@ typedef struct {
 	menutext_s		banner;
 
 	menulist_s		gametype;
+	menutext_s		gametypedesc; // BFP - Gametype description
 	menubitmap_s	mappics[MAX_MAPSPERPAGE];
 	menubitmap_s	mapbuttons[MAX_MAPSPERPAGE];
 	menubitmap_s	arrows;
@@ -123,6 +124,22 @@ static int gametype_remap2[] = {	// Take a look on gametype_items indexes
 	6,	// GT_TLMS (6)			->	"Team Last Man Standing"
 	4	// GT_CTF (7)			->	"Capture the Flag"
 };
+static char* gametype_description[] = { // BFP - Gametype description
+	// "Free For All"
+	"Basic deathmatch game but with use of all the attacks and characters. Players are allowed to perform 20 different attacks as well as overpower opponents by engaging in power struggles.",
+	// "Tournament"
+	"Players fight 1 vs 1 battles while others wait as spectators.",
+	// "Survival"
+	"Faster paced tournament-style game. Two players fight. When one player dies, he is removed from the fight and the spectator who has been waiting longest enters the game. The winner does not get healed in between rounds, and the scores of spectators are visible. The first player to reach the fraglimit is the winner, and the map restarts in order to set the spawn power level back to the g_basePL setting.",
+	// "Monster"
+	"A deathmatch but with an extra: a monster who has more ki and health than the rest of the players. The one with the most frags wins.",
+	// "Capture the Flag"
+	"Two teams compete to capture both flags and return them to their bases for points.",
+	// "Team Deathmatch"
+	"Two teams to fight on a deathmatch but with use of all the attacks and characters.",
+	// "Team Last Man Standing"
+	"The players in a last man standing game start with all available attacks. Once a player is killed, he must wait until the end of the round before restarting."
+};
 
 static void UI_ServerOptionsMenu( qboolean multiplayer );
 
@@ -414,6 +431,79 @@ static void StartServer_LevelshotDraw( void *self ) {
 }
 
 
+/*
+==================================
+StartServer_GametypeDescriptionScrollDraw
+==================================
+*/
+static void StartServer_GametypeDescriptionScrollDraw( void *self ) { // BFP - Gametype description scroll
+	static int	previousGametype = -1;
+	static int	currentDescWidth = 0;
+	static int	descStartTime = 0;
+
+	const char	*desc = gametype_description[s_startserver.gametype.curvalue];
+
+	int			offset;
+	const int	SCROLLSPEED = 140;
+	int			elapsedTime;
+	int			xPos;
+	const int	YPOS = 383;
+
+	// update text width and timer when gametype changes
+	if ( s_startserver.gametype.curvalue != previousGametype ) {
+		// BFP - NOTE: When adding a new gametype and its own description, 
+		// first debug using:
+#if 0
+			currentDescWidth = UI_ProportionalStringWidth( desc );
+			Com_Printf( "currentDescWidth: %d\n", currentDescWidth );
+			if ( s_startserver.gametype.curvalue == GT_NEWGT ) {
+				currentDescWidth = value; // value to adjust
+			}
+#endif
+		// and set the value when the last character ends up off-screen,
+		// adding the new GT_* in the switch with the new value. 
+		// Make sure what number of GT_* while assigning in s_startserver.gametype.curvalue
+
+		// handle proportional strings to keep the scroll animation correctly
+		switch ( s_startserver.gametype.curvalue ) {
+		case GT_FFA:
+			currentDescWidth = 2106;
+			break;
+		case GT_TOURNAMENT:
+			currentDescWidth = 1125;
+			break;
+		case ( GT_SURVIVAL - 1 ):
+			currentDescWidth = 3890;
+			break;
+		case ( GT_MONSTER - 1 ):
+			currentDescWidth = 1700;
+			break;
+		case ( GT_CTF - 3 ):
+			currentDescWidth = 1302;
+			break;
+		case GT_TEAM:
+			currentDescWidth = 1302;
+			break;
+		case GT_TLMS:
+			currentDescWidth = 1904;
+			break;
+		}
+
+		descStartTime = uis.realtime;
+		previousGametype = s_startserver.gametype.curvalue;
+	}
+
+	// calculate scroll offset
+	elapsedTime = uis.realtime - descStartTime;
+	offset = ( elapsedTime * SCROLLSPEED / 1000 ) % currentDescWidth;
+
+	// determine starting x position (right edge of screen)
+	xPos = 640 - offset;
+
+	UI_DrawString( xPos, YPOS, desc, UI_LEFT|UI_SMALLFONT, text_color_highlight );
+}
+
+
 /*
 =================
 StartServer_MenuInit
@@ -467,6 +557,11 @@ static void StartServer_MenuInit( void ) {
 	s_startserver.gametype.generic.y		= 368;
 	s_startserver.gametype.itemnames		= gametype_items;
 
+	// BFP - Gametype description
+	s_startserver.gametypedesc.generic.type		= MTYPE_PTEXT;
+	s_startserver.gametypedesc.string			= ""; // handle string, without that, DLL/SO crashes
+	s_startserver.gametypedesc.generic.ownerdraw = StartServer_GametypeDescriptionScrollDraw;
+
 	for (i=0; i<MAX_MAPSPERPAGE; i++)
 	{
 		x =	(i % MAX_MAPCOLS) * (128+8) + 52; // BFP - modified map columns, before (i % MAX_MAPCOLS) * (128+8) + 188
@@ -568,6 +663,7 @@ static void StartServer_MenuInit( void ) {
 	Menu_AddItem( &s_startserver.menu, &s_startserver.banner );
 
 	Menu_AddItem( &s_startserver.menu, &s_startserver.gametype );
+	Menu_AddItem( &s_startserver.menu, &s_startserver.gametypedesc ); // BFP - Gametype description
 	for (i=0; i<MAX_MAPSPERPAGE; i++)
 	{
 		Menu_AddItem( &s_startserver.menu, &s_startserver.mappics[i] );