This wiki is archived and useful information is being migrated to the main bzflag.org website

bz_getPublicDescription

From BZFlagWiki
Revision as of 10:44, 19 October 2011 by Sigonasr2 (Talk | contribs) (Create API Function Page. Include Example.)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

bz_ApiString bz_getPublicDescription ()


Retrieves the string with the title of the server, generally displayed on the list server when players are finding a game to join. This is what you would specify with the -publictitle BZFS option.

Returns:
A string containing the public title / description of the server.


Example

A simple greeting that tells the player what server and port they are on. This may be useful to remove the hassle of modifying greetings for a server that hosts many ports.

case bz_ePlayerJoinEvent: {
	if (bz_getPublic()) {
		bz_sendTextMessagef(BZ_SERVER,((bz_PlayerJoinPartEventData_V1*)eventData)->playerID,"Welcome!");
		bz_sendTextMessagef(BZ_SERVER,((bz_PlayerJoinPartEventData_V1*)eventData)->playerID,
			"You are playing on %s",bz_getPublicDescription().c_str());
		bz_sendTextMessagef(BZ_SERVER,((bz_PlayerJoinPartEventData_V1*)eventData)->playerID,
			"           @ %s:%d",bz_getPublicAddr().c_str(),bz_getPublicPort());
	}
}break;