SimTX API v24/Packets/IpModerationRequest: Difference between revisions
m Clanker moved page SimTX API/Packets/IpModerationRequest to SimTX API v24/Packets/IpModerationRequest: Archive the v24 protocol reference |
Archive the v24 protocol reference: use the v24 templates, links and categories |
||
| Line 1: | Line 1: | ||
{{SimTX API navigation}} | {{SimTX API v24 navigation}} | ||
{{SimTX packet | {{SimTX packet v24 | ||
| name = IpModerationRequest | | name = IpModerationRequest | ||
| id = 9 | | id = 9 | ||
| hex = 0x09 | | hex = 0x09 | ||
| direction = c2s | | direction = c2s | ||
| session = [[SimTX API/Moderation session|Moderation]] | | session = [[SimTX API v24/Moderation session|Moderation]] | ||
| size = Variable | | size = Variable | ||
| permission = <code>moderation.manage</code> | | permission = <code>moderation.manage</code> | ||
| reply = [[SimTX API/Packets/IpModerationResult|IpModerationResult]] | | reply = [[SimTX API v24/Packets/IpModerationResult|IpModerationResult]] | ||
| group = moderation | | group = moderation | ||
}} | }} | ||
'''IpModerationRequest''' bans or unbans a client address. It is only accepted on a [[SimTX API/Moderation session|moderation session]]. | '''IpModerationRequest''' bans or unbans a client address. It is only accepted on a [[SimTX API v24/Moderation session|moderation session]]. | ||
== Layout == | == Layout == | ||
| Line 29: | Line 29: | ||
== Effects == | == Effects == | ||
A ban disconnects the address's receiver and transmitter sessions, sends a level 1 [[SimTX API/Packets/Banner|Banner]] to its control sessions, and rejects new game connections from it with <code>IP_BANNED</code>. | A ban disconnects the address's receiver and transmitter sessions, sends a level 1 [[SimTX API v24/Packets/Banner|Banner]] to its control sessions, and rejects new game connections from it with <code>IP_BANNED</code>. | ||
{{SimTX API navbox}} | {{SimTX API v24 navbox}} | ||
[[Category:SimTX API]] | [[Category:SimTX API v24]] | ||
Latest revision as of 16:15, 24 October 2026
| Packet ID | 9(0x09)
|
|---|---|
| Direction | Client → server |
| Session | Moderation |
| Body size | Variable |
| Permission | moderation.manage
|
| Answered by | IpModerationResult |
IpModerationRequest bans or unbans a client address. It is only accepted on a moderation session.
Layout[edit | edit source]
| Field | Type | Description |
|---|---|---|
packetId |
u8 |
Always 9.
|
action |
UTF |
BAN or UNBAN.
|
target |
UTF |
An IP address, or the callsign of a connected station whose address should be used. |
reason |
UTF |
Reason, shown to the banned user. |
durationSeconds |
i64 |
Ban duration. 0 means permanent. At most 3,650 days. Must not be negative. |
Effects[edit | edit source]
A ban disconnects the address's receiver and transmitter sessions, sends a level 1 Banner to its control sessions, and rejects new game connections from it with IP_BANNED.