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...")
 
 
Line 1: Line 1:
 
== Introduction ==
 
== Introduction ==
  
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.
  
 
{| 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 || Type || ISP_PLH
 
|-
 
|-
| byte || ReqI || 0 unless this is a reply to a TINY_IPB request
+
| byte || ReqI || 0 unless this is a reply to a TINY_PLH request
 
|-
 
|-
| byte || NumB || number of bans in this packet
+
| byte || NumP || number of players in this packet
 
|-
 
|-
| byte || Sp0 ||
+
| PlayerHCap || HCaps [PLH_MAX_PLAYERS] || 0 to PLH_MAX_PLAYERS (NumP)
|-
 
| byte || Sp1 ||
 
|-
 
| byte || Sp2 ||
 
|-
 
| byte || Sp3 ||
 
|-
 
| in_addr || BanIPs [IPB_MAX_BANS] || IP addresses, 0 to IPB_MAX_BANS (NumB)
 
 
|}
 
|}
  
Line 31: Line 23:
 
=== 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.
  
 
[[Category:InSim packets]]
 
[[Category:InSim packets]]

Latest revision as of 19:56, 10 February 2026

Introduction

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

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)

Packet Details

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.