This wiki was in read-only mode for many years, but can now be edited again. A lot of information will need to be updated.
Bz givePlayerFlag: Difference between revisions
Jump to navigation
Jump to search
Clarify what flagType ACTUALLY returns. |
→Description: typo |
||
| (One intermediate revision by one other user not shown) | |||
| Line 15: | Line 15: | ||
|flagType | |flagType | ||
|const char* | |const char* | ||
|The flag code of the flag to give to the player | |The flag code of the flag to give to the player. | ||
|- | |- | ||
|force | |force | ||
| Line 25: | Line 23: | ||
==Description== | ==Description== | ||
This API function will give the specified player the specified flag. If the player has no flag, they will get a flag. If they have a flag and the force parameter is true the new flag code will replace the old flag code. If the force | This API function will give the specified player the specified flag. If the player has no flag, they will get a flag. If they have a flag and the force parameter is true the new flag code will replace the old flag code. If the force parameter is false, and the player has a flag, no action will be taken. | ||
Latest revision as of 22:52, 25 November 2016
| BZFS API Documentation This page contains part of the BZFS API documentation for use by Plug-ins on the BZFS server. |
| BZFS API Function. This page documents a BZFS_API Function, that is provided by the BZFS game server for plug-ins to call. |
Prototype
BZF_API bool bz_givePlayerFlag ( int playerID, const char* flagType, bool force );
Parameters
| name | type | value desription |
|---|---|---|
| playerId | int | the player that is to get the flag. |
| flagType | const char* | The flag code of the flag to give to the player. |
| force | bool | replace the existing flag if it exists |
Description
This API function will give the specified player the specified flag. If the player has no flag, they will get a flag. If they have a flag and the force parameter is true the new flag code will replace the old flag code. If the force parameter is false, and the player has a flag, no action will be taken.