Difference between revisions of "IS PEN"

From LFS Manual
Jump to navigationJump to search
(Created page with "== Introduction == The '''PEN'''alty packet is sent by LFS when a player receives a penalty, or their penalty is cleared. {| class="wikitable" |+ IS_PEN packet properties |-...")
 
Line 1: Line 1:
== Introduction ==
+
{{Infobox InSim packet
 +
| description  = Penalty given or cleared
 +
| size          = 8
 +
| type_key      = ISP_PEN
 +
| type_value    = 30
 +
| direction    = in
 +
| prev          = [[IS_CCH]]
 +
| next          = [[IS_TOC]]
 +
}}
  
 
The '''PEN'''alty packet is sent by LFS when a player receives a penalty, or their penalty is cleared.
 
The '''PEN'''alty packet is sent by LFS when a player receives a penalty, or their penalty is cleared.
 +
 +
== Packet details ==
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 24: Line 34:
 
| byte || Sp3 ||  
 
| byte || Sp3 ||  
 
|}
 
|}
 
== Packet Details ==
 
  
 
=== Size ===
 
=== Size ===
Line 76: Line 84:
 
== Notes ==
 
== Notes ==
  
The [[#Reason|Reason]] is only accurate if the penalty is given by LFS, as there is no way to assign a penalty other than using one of the <code>/p_dt</code>, <code>/p_sg</code>, <code>/p_30</code>, <code>/p_45</code> commands, which all result in PENR_ADMIN.
+
The [[#Reason|Reason]] is only accurate if the penalty is given by LFS, as there is no way to assign a penalty other than using one of the {{kbd|/p_dt}}, {{kbd|/p_sg}}, {{kbd|/p_30}}, {{kbd|/p_45}} commands, which all result in PENR_ADMIN.
 +
 
 +
{{InSim packets}}
  
 
[[Category:InSim packets]]
 
[[Category:InSim packets]]

Revision as of 11:01, 14 February 2026

IS_PEN
Penalty given or cleared
Overview
Size 8
Type ISP_PEN (30)
Usage info
Previous packet
IS_CCH
Next packet
IS_TOC

The PENalty packet is sent by LFS when a player receives a penalty, or their penalty is cleared.

Packet details

IS_PEN packet properties
Type Name Description
byte Size 8
byte Type ISP_PEN
byte ReqI 0
byte PLID player's unique id
byte OldPen old penalty value (PENALTY_x)
byte NewPen new penalty value
byte Reason penalty reason (PENR_x)
byte Sp3

Size

The size of the packet is always 8 bytes.

Type

The packet type from the ISP_ enumeration, always ISP_PEN.

ReqI

ReqI is always equal to zero.

PLID

The player's unique ID.

LapsDone

The number of completed laps.

Flags

Player flags (see IS_NPL#Flags).

FuelAdd

If /showfuel yes, show the fuel added in percent; otherwise 255.

OldPen

The penalty value before receiving this packet, from the PENALTY_ enumeration.

NewPen

The penalty value after receiving this packet, from the PENALTY_ enumeration.

Reason

The reason for the penalty change, from the PENR_ enumeration:

  • PENR_UNKNOWN: Unknown or cleared penalty
  • PENR_ADMIN: Penalty given by an admin
  • PENR_WRONG_WAY: Wrong way driving
  • PENR_FALSE_START: Starting before green light
  • PENR_SPEEDING: Speeding in the pit lane
  • PENR_STOP_SHORT: Stop-go pit stop too short
  • PENR_STOP_LATE: Compulsory stop is too late

Notes

The Reason is only accurate if the penalty is given by LFS, as there is no way to assign a penalty other than using one of the /p_dt, /p_sg, /p_30, /p_45 commands, which all result in PENR_ADMIN.


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