Grimes: Created page with "{{Template:DCS_hooks_callbacks |fName= onPlayerTryConnect |vNum= 2.5.0 |par1= hook |par2= |par3= |par4= |desc= Occurs when a player initially att..."

2021-05-15T00:30:23Z

Created page with "{{Template:DCS_hooks_callbacks |fName= onPlayerTryConnect |vNum= 2.5.0 |par1= hook |par2= |par3= |par4= |desc= Occurs when a player initially att..."

New page

{{Template:DCS_hooks_callbacks

|fName= onPlayerTryConnect

|vNum= 2.5.0

|par1= [[DCS_server_hooks|hook]]

|par2=

|par3=

|par4=

|desc= Occurs when a player initially attempts to connect to the server. Can be used to force allow or deny access. Passed values are the users ip address, unique DCS identifier, their name, and the id that the player would have if they connected. Can be used to ban players from entering your server due to inappropriate name or past actions committed.

'''IMPORTANT: ''' If any value is returned with this function then any other callback that uses it will be ignored. If no choice is to be made, then do NOT return any value.

|rtnType= nothing

|rtnExample= Value 1: boolean
Return true will force allow the player into the server
Return false rejects the player from entering the server

Value 2: String
Message for why the player is not allowed into the server.

|reqType1= string

|reqName1= addr

|reqType2= string

|reqName2= ucid

|reqType3= string

|reqName3= name

|reqType4= number

|reqName4= playerId

|reqType5=

|optType1=

|optName1=

|optType2=

|related=
List of Callbacks: {{listOfDCSHooks}}

|examples= Checks the ucid of a user attempting to connect to see if that ucid is present in that table. If it is then it returns false thus preventing them from joining the server and displaying a message that they have been banned.

function myCall.onPlayerTryConnect(addr, name, ucid, id)
if someBannedList[ucid] then
return false, "Dude you have been banned")
end
end
|notes=
}}
[[Category:DCS Hooks|onPlayerTryConnect]]

DCS hook onPlayerTryConnect - Revision history

Grimes: Created page with "{{Template:DCS_hooks_callbacks |fName= onPlayerTryConnect |vNum= 2.5.0 |par1= hook |par2= |par3= |par4= |desc= Occurs when a player initially att..."