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 eAllowPlayer: Difference between revisions
Jump to navigation
Jump to search
New page: {{BZFS_API_Doc}} {{BZFS_API_Events}} {{API_Docs_that_need_work}} ==Overview== The '''bz_eAllowPlayer''' is an API event that is called each time a player joins to allow a plug-in to overr... |
m typo fix |
||
| (One intermediate revision by one other user not shown) | |||
| Line 1: | Line 1: | ||
{{BZFS_API_Doc}} | {{BZFS_API_Doc}} | ||
{{BZFS_API_Events}} | {{BZFS_API_Events}} | ||
==Overview== | ==Overview== | ||
The '''bz_eAllowPlayer''' is an API event that is called each time a player | The '''bz_eAllowPlayer''' is an API event that is called each time a player connects to the server. This event is called after all internal allow/deny logic. | ||
==Data== | ==Data== | ||
'''bz_eAllowPlayer''' returns the '''bz_AllowPlayerEventData_V1''' data class. | '''bz_eAllowPlayer''' returns the '''bz_AllowPlayerEventData_V1''' data class. | ||
| Line 19: | Line 19: | ||
|playerID | |playerID | ||
|int | |int | ||
| | |This value is the player ID for the joining player. | ||
|- | |- | ||
|callsign | |callsign | ||
|[[bz_ApiString]] | |[[bz_ApiString]] | ||
| | |This value is the callsign for the player. | ||
|- | |- | ||
|ipAddress | |ipAddress | ||
|[[bz_ApiString]] | |[[bz_ApiString]] | ||
| | |This value is the IPv4 address of the player. | ||
|- | |- | ||
|reason | |reason | ||
|[[bz_ApiString]] | |[[bz_ApiString]] | ||
| | |This value is the reason for any denials of admittance, it will be reported back to the player. | ||
|- | |- | ||
|allow | |allow | ||
|bool | |bool | ||
|This value | |This value is the current allow/deny state for the join. Plug-ins wishing to overide the server allow/deny logic can change this value. | ||
|- | |- | ||
|eventTime | |eventTime | ||
|double | |double | ||
|This value is the time | |This value is the local server time of the event. | ||
|} | |} | ||
==Uses== | ==Uses== | ||
This is a modification event, plug-ins may override the allow/deny logic choice themselves. This is the primary hook for plug-ins that wish to implement custom ban list systems. | |||
Latest revision as of 01:27, 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 Event. This page documents a BZFS event that is called by the game server to notify plug-ins of various actions and state changes in the game world.
Overview
The bz_eAllowPlayer is an API event that is called each time a player connects to the server. This event is called after all internal allow/deny logic.
Data
bz_eAllowPlayer returns the bz_AllowPlayerEventData_V1 data class.
| name | type | value description |
|---|---|---|
| eventType | bz_eEventType | bz_eAllowPlayer |
| playerID | int | This value is the player ID for the joining player. |
| callsign | bz_ApiString | This value is the callsign for the player. |
| ipAddress | bz_ApiString | This value is the IPv4 address of the player. |
| reason | bz_ApiString | This value is the reason for any denials of admittance, it will be reported back to the player. |
| allow | bool | This value is the current allow/deny state for the join. Plug-ins wishing to overide the server allow/deny logic can change this value. |
| eventTime | double | This value is the local server time of the event. |
Uses
This is a modification event, plug-ins may override the allow/deny logic choice themselves. This is the primary hook for plug-ins that wish to implement custom ban list systems.