Difference between revisions of "IS PLH"

From LFS Manual
Jump to navigationJump to search
(Created page with "== Introduction == The '''IP''' '''B'''ans packet is used to set a list of banned IP addresses on the host. {| class="wikitable" |+ IS_IPB packet properties |- ! Type !! Nam...")
 
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
== Introduction ==
+
{{Infobox InSim packet
 +
| description  = Sets player handicaps
 +
| sizetext      = 4 + NumP * 4
 +
| type_key      = ISP_PLH
 +
| type_value    = 66
 +
| direction    = in-out
 +
| prev          = [[IS_MAL]]
 +
| next          = [[IS_IPB]]
 +
}}
  
The '''IP''' '''B'''ans packet is used to set a list of banned IP addresses on the host.
+
The '''PL'''ayer '''H'''andicaps packet is used to set handicaps on specific players.
 +
 
 +
== Packet details ==
  
 
{| class="wikitable"
 
{| class="wikitable"
|+ IS_IPB packet properties
+
|+ IS_PLH packet properties
 
|-
 
|-
 
! Type !! Name !! Description
 
! Type !! Name !! Description
 
|-
 
|-
| byte || Size || 8 + NumB * 4
+
| byte || Size || 4 + NumP * 4
|-
 
| byte || Type || ISP_IPB
 
|-
 
| byte || ReqI || 0 unless this is a reply to a TINY_IPB request
 
 
|-
 
|-
| byte || NumB || number of bans in this packet
+
| byte || Type || ISP_PLH
 
|-
 
|-
| byte || Sp0 ||  
+
| byte || ReqI || 0 unless this is a reply to a TINY_PLH request
 
|-
 
|-
| byte || Sp1 ||  
+
| byte || NumP || number of players in this packet
 
|-
 
|-
| byte || Sp2 ||
+
| PlayerHCap || HCaps [PLH_MAX_PLAYERS] || 0 to PLH_MAX_PLAYERS (NumP)
|-
 
| byte || Sp3 ||
 
|-
 
| in_addr || BanIPs [IPB_MAX_BANS] || IP addresses, 0 to IPB_MAX_BANS (NumB)
 
 
|}
 
|}
 
== Packet Details ==
 
  
 
=== Size ===
 
=== Size ===
  
The size of the packet varies from 8 to 488 bytes depending on the value of [[#NumB|NumB]].
+
The size of the packet varies from 4 to 196 bytes depending on the value of [[#NumP|NumP]].
  
 
=== Type ===
 
=== Type ===
  
The packet type from the [[InSim_enumerations#ISP|ISP_]] enumeration, always ISP_IPB.
+
The packet type from the [[InSim_enumerations#ISP|ISP_]] enumeration, always ISP_PLH.
  
 
=== ReqI ===
 
=== ReqI ===
  
ReqI is equal to zero, unless the packet is a reply to a [[InSim_enumerations#TINY|TINY_IPB]] request.
+
ReqI is equal to zero, unless the packet is a reply to a [[InSim_enumerations#TINY|TINY_PLH]] request.
  
=== NumB ===
+
=== NumP ===
  
The number of IP addresses in this packet.
+
The number of players in this packet.
  
=== BanIPs ===
+
=== HCaps ===
  
The list of banned IPs, each byte represents a part of an IPv4 address (bytes 127-0-0-1 represent IP address 127.0.0.1). IPv6 is not supported.
+
The list of [[InSim_structs#PlayerHCap|PlayerHCap]] handicaps.
  
 
== Notes ==
 
== Notes ==
  
This packet can set up to 120 IP bans. To remove all bans, send this packet with 0 IPs.
+
This packet can set up to 48 player handicaps. To remove all handicaps, send this packet with 0 players.
 +
 
 +
{{InSim packets}}
  
 
[[Category:InSim packets]]
 
[[Category:InSim packets]]

Latest revision as of 12:44, 14 February 2026

IS_PLH
Sets player handicaps
Overview
Size 4 + NumP * 4
Type ISP_PLH (66)
Usage both ways
Previous packet
IS_MAL
Next packet
IS_IPB

The PLayer Handicaps packet is used to set handicaps on specific players.

Packet details

IS_PLH packet properties
Type Name Description
byte Size 4 + NumP * 4
byte Type ISP_PLH
byte ReqI 0 unless this is a reply to a TINY_PLH request
byte NumP number of players in this packet
PlayerHCap HCaps [PLH_MAX_PLAYERS] 0 to PLH_MAX_PLAYERS (NumP)

Size

The size of the packet varies from 4 to 196 bytes depending on the value of NumP.

Type

The packet type from the ISP_ enumeration, always ISP_PLH.

ReqI

ReqI is equal to zero, unless the packet is a reply to a TINY_PLH request.

NumP

The number of players in this packet.

HCaps

The list of PlayerHCap handicaps.

Notes

This packet can set up to 48 player handicaps. To remove all handicaps, send this packet with 0 players.


Initialisation IS_ISI
Version Information IS_VER
General Purpose IS_TINY · IS_SMALL · IS_TTC
State Reporting and Requests IS_STA · IS_SFP · IS_ISM
Text Messages and Key Presses IS_SCH · IS_MSO · IS_III · IS_MST · IS_MTC · IS_MSX · IS_MSL
Voting IS_VTN
Race Tracking IS_RST · IS_REO
Autocross IS_AXI · IS_AXO · IS_UCO · IS_OCO · IS_AXM
Connection Tracking IS_NCN · IS_CNL · IS_CPR · IS_ACR · IS_NCI · IS_SLC · IS_CIM
Car Tracking IS_NPL · IS_PLP · IS_PLL · IS_LAP · IS_SPX · IS_PIT · IS_PSF · IS_PLA · IS_PEN · IS_TOC · IS_FLG · IS_PFL · IS_FIN · IS_RES · IS_NLP · IS_MCI · IS_CRS · IS_CON · IS_OBH · IS_HLV · IS_CSC
Camera Control IS_SCC · IS_CPP
Replay Control IS_RIP
Screenshots IS_SSH
InSim Buttons IS_BFN · IS_BTN · IS_BTC · IS_BTT
AI Control IS_AIC · IS_AII
Other packets IS_MOD · IS_CCH · IS_PLC · IS_HCP · IS_JRR · IS_MAL · IS_PLH · IS_IPB