Skip to content

Add Castle Siege & Guild Alliance ServerToClient packet definitions #736

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
Copilot wants to merge 3 commits into
base: master
Choose a base branch
from
Draft

Add Castle Siege & Guild Alliance ServerToClient packet definitions #736

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
63175bf
Initial plan
Copilot Mar 24, 2026
ccd8163
Initial progress report - planning phase
Copilot Mar 24, 2026
ec79b5c
Add Castle Siege and Guild Alliance S→C packet definitions to ServerT…
Copilot Mar 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions docs/Packets/C1-11-ObjectHitExtended_by-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,8 @@ The damage is shown at the object which received the hit.
| 1 | 1 | Byte | 16 | Packet header - length of the packet |
| 2 | 1 | Byte | 0x11 | Packet header - packet type identifier |
| 3 << 0 | 4 bit | DamageKind | | Kind |
| 3 << 4 | 1 bit | Boolean | | IsRageFighterStreakHit |
| 3 << 5 | 1 bit | Boolean | | IsRageFighterStreakFinalHit |
| 3 << 6 | 1 bit | Boolean | | IsDoubleDamage |
| 3 << 7 | 1 bit | Boolean | | IsTripleDamage |
| 4 | 2 | ShortLittleEndian | | ObjectId |
Expand All @@ -34,7 +36,7 @@ Defines the kind of the damage.
| 1 | IgnoreDefenseCyan | Cyan color, usually used by ignore defense damage. |
| 2 | ExcellentLightGreen | Light green color, usually used by excellent damage. |
| 3 | CriticalBlue | Blue color, usually used by critical damage. |
| 4 | LightPink | Light pink color. |
| 4 | ReflectedLightPink | Light pink color, usually used by reflected damage. |
| 5 | PoisonDarkGreen | Dark green color, usually used by poison damage. |
| 6 | ReflectedDarkPink | Dark pink color, usually used by reflected damage. |
| 6 | DarkPink | Dark pink color. |
| 7 | White | White color. |
6 changes: 4 additions & 2 deletions docs/Packets/C1-11-ObjectHit_by-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,8 @@ The damage is shown at the object which received the hit.
| 3 | 2 | ShortBigEndian | | ObjectId |
| 5 | 2 | ShortBigEndian | | HealthDamage |
| 7 << 0 | 4 bit | DamageKind | | Kind |
| 7 << 4 | 1 bit | Boolean | | IsRageFighterStreakHit |
| 7 << 5 | 1 bit | Boolean | | IsRageFighterStreakFinalHit |
| 7 << 6 | 1 bit | Boolean | | IsDoubleDamage |
| 7 << 7 | 1 bit | Boolean | | IsTripleDamage |
| 8 | 2 | ShortBigEndian | | ShieldDamage |
Expand All @@ -33,7 +35,7 @@ Defines the kind of the damage.
| 1 | IgnoreDefenseCyan | Cyan color, usually used by ignore defense damage. |
| 2 | ExcellentLightGreen | Light green color, usually used by excellent damage. |
| 3 | CriticalBlue | Blue color, usually used by critical damage. |
| 4 | LightPink | Light pink color. |
| 4 | ReflectedLightPink | Light pink color, usually used by reflected damage. |
| 5 | PoisonDarkGreen | Dark green color, usually used by poison damage. |
| 6 | ReflectedDarkPink | Dark pink color, usually used by reflected damage. |
| 6 | DarkPink | Dark pink color. |
| 7 | White | White color. |
38 changes: 38 additions & 0 deletions docs/Packets/C1-B2-00-CastleSiegeStatusResponse_by-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# C1 B2 00 - CastleSiegeStatusResponse (by server)

## Is sent when

After the player requested the current castle siege status from a castle siege npc.

## Causes the following actions on the client side

The client shows the castle siege status.

## Structure

| Index | Length | Data Type | Value | Description |
|-------|--------|-----------|-------|-------------|
| 0 | 1 | Byte | 0xC1 | [Packet type](PacketTypes.md) |
| 1 | 1 | Byte | 46 | Packet header - length of the packet |
| 2 | 1 | Byte | 0xB2 | Packet header - packet type identifier |
| 3 | 1 | Byte | 0x00 | Packet header - sub packet type identifier |
| 4 | 1 | Byte | | Result |
| 5 | 1 | Byte | | State |
| 6 | 2 | ShortBigEndian | | StartYear |
| 8 | 1 | Byte | | StartMonth |
| 9 | 1 | Byte | | StartDay |
| 10 | 1 | Byte | | StartHour |
| 11 | 1 | Byte | | StartMinute |
| 12 | 2 | ShortBigEndian | | EndYear |
| 14 | 1 | Byte | | EndMonth |
| 15 | 1 | Byte | | EndDay |
| 16 | 1 | Byte | | EndHour |
| 17 | 1 | Byte | | EndMinute |
| 18 | 2 | ShortBigEndian | | SiegeStartYear |
| 20 | 1 | Byte | | SiegeStartMonth |
| 21 | 1 | Byte | | SiegeStartDay |
| 22 | 1 | Byte | | SiegeStartHour |
| 23 | 1 | Byte | | SiegeStartMinute |
| 24 | 8 | String | | GuildName |
| 32 | 10 | String | | GuildMasterName |
| 42 | 4 | IntegerBigEndian | | RemainingTime |
20 changes: 20 additions & 0 deletions docs/Packets/C1-B2-01-CastleSiegeRegistrationResponse_by-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# C1 B2 01 - CastleSiegeRegistrationResponse (by server)

## Is sent when

After the player requested to register his guild for the next castle siege.

## Causes the following actions on the client side

The client shows the result of the registration attempt.

## Structure

| Index | Length | Data Type | Value | Description |
|-------|--------|-----------|-------|-------------|
| 0 | 1 | Byte | 0xC1 | [Packet type](PacketTypes.md) |
| 1 | 1 | Byte | 13 | Packet header - length of the packet |
| 2 | 1 | Byte | 0xB2 | Packet header - packet type identifier |
| 3 | 1 | Byte | 0x01 | Packet header - sub packet type identifier |
| 4 | 1 | Byte | | Result |
| 5 | 8 | String | | GuildName |
19 changes: 19 additions & 0 deletions docs/Packets/C1-B2-02-CastleSiegeUnregisterResponse_by-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# C1 B2 02 - CastleSiegeUnregisterResponse (by server)

## Is sent when

After the player requested to un-register his guild from the next castle siege.

## Causes the following actions on the client side

The client shows the result of the un-registration attempt.

## Structure

| Index | Length | Data Type | Value | Description |
|-------|--------|-----------|-------|-------------|
| 0 | 1 | Byte | 0xC1 | [Packet type](PacketTypes.md) |
| 1 | 1 | Byte | 5 | Packet header - length of the packet |
| 2 | 1 | Byte | 0xB2 | Packet header - packet type identifier |
| 3 | 1 | Byte | 0x02 | Packet header - sub packet type identifier |
| 4 | 1 | Byte | | Result |
21 changes: 21 additions & 0 deletions docs/Packets/C1-B2-03-CastleSiegeRegistrationStateResponse_by-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# C1 B2 03 - CastleSiegeRegistrationStateResponse (by server)

## Is sent when

After the player requested the current registration state of his guild.

## Causes the following actions on the client side

The client shows the current registration state including the number of submitted guild marks.

## Structure

| Index | Length | Data Type | Value | Description |
|-------|--------|-----------|-------|-------------|
| 0 | 1 | Byte | 0xC1 | [Packet type](PacketTypes.md) |
| 1 | 1 | Byte | 20 | Packet header - length of the packet |
| 2 | 1 | Byte | 0xB2 | Packet header - packet type identifier |
| 3 | 1 | Byte | 0x03 | Packet header - sub packet type identifier |
| 4 | 8 | String | | GuildName |
| 12 | 4 | IntegerBigEndian | | GuildMarkCount |
| 16 | 4 | IntegerBigEndian | | RegistrationId |
21 changes: 21 additions & 0 deletions docs/Packets/C1-B2-04-CastleSiegeMarkRegistrationResponse_by-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# C1 B2 04 - CastleSiegeMarkRegistrationResponse (by server)

## Is sent when

After the player submitted a guild mark for the castle siege registration.

## Causes the following actions on the client side

The client shows the updated guild mark count.

## Structure

| Index | Length | Data Type | Value | Description |
|-------|--------|-----------|-------|-------------|
| 0 | 1 | Byte | 0xC1 | [Packet type](PacketTypes.md) |
| 1 | 1 | Byte | 17 | Packet header - length of the packet |
| 2 | 1 | Byte | 0xB2 | Packet header - packet type identifier |
| 3 | 1 | Byte | 0x04 | Packet header - sub packet type identifier |
| 4 | 1 | Byte | | Result |
| 5 | 8 | String | | GuildName |
| 13 | 4 | IntegerBigEndian | | GuildMarkCount |
21 changes: 21 additions & 0 deletions docs/Packets/C1-B2-05-CastleSiegeDefenseBuyResponse_by-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# C1 B2 05 - CastleSiegeDefenseBuyResponse (by server)

## Is sent when

After the player requested to buy a castle siege defense structure (gate or statue).

## Causes the following actions on the client side

The client shows the result of the buy request.

## Structure

| Index | Length | Data Type | Value | Description |
|-------|--------|-----------|-------|-------------|
| 0 | 1 | Byte | 0xC1 | [Packet type](PacketTypes.md) |
| 1 | 1 | Byte | 13 | Packet header - length of the packet |
| 2 | 1 | Byte | 0xB2 | Packet header - packet type identifier |
| 3 | 1 | Byte | 0x05 | Packet header - sub packet type identifier |
| 4 | 1 | Byte | | Result |
| 5 | 4 | IntegerLittleEndian | | NpcNumber |
| 9 | 4 | IntegerLittleEndian | | NpcIndex |
21 changes: 21 additions & 0 deletions docs/Packets/C1-B2-06-CastleSiegeDefenseRepairResponse_by-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# C1 B2 06 - CastleSiegeDefenseRepairResponse (by server)

## Is sent when

After the player requested to repair a castle siege defense structure (gate or statue).

## Causes the following actions on the client side

The client shows the result of the repair request.

## Structure

| Index | Length | Data Type | Value | Description |
|-------|--------|-----------|-------|-------------|
| 0 | 1 | Byte | 0xC1 | [Packet type](PacketTypes.md) |
| 1 | 1 | Byte | 13 | Packet header - length of the packet |
| 2 | 1 | Byte | 0xB2 | Packet header - packet type identifier |
| 3 | 1 | Byte | 0x06 | Packet header - sub packet type identifier |
| 4 | 1 | Byte | | Result |
| 5 | 4 | IntegerLittleEndian | | NpcNumber |
| 9 | 4 | IntegerLittleEndian | | NpcIndex |
23 changes: 23 additions & 0 deletions docs/Packets/C1-B2-07-CastleSiegeDefenseUpgradeResponse_by-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
# C1 B2 07 - CastleSiegeDefenseUpgradeResponse (by server)

## Is sent when

After the player requested to upgrade a castle siege defense structure (gate or statue).

## Causes the following actions on the client side

The client shows the result of the upgrade request and the new upgrade values.

## Structure

| Index | Length | Data Type | Value | Description |
|-------|--------|-----------|-------|-------------|
| 0 | 1 | Byte | 0xC1 | [Packet type](PacketTypes.md) |
| 1 | 1 | Byte | 21 | Packet header - length of the packet |
| 2 | 1 | Byte | 0xB2 | Packet header - packet type identifier |
| 3 | 1 | Byte | 0x07 | Packet header - sub packet type identifier |
| 4 | 1 | Byte | | Result |
| 5 | 4 | IntegerLittleEndian | | NpcNumber |
| 9 | 4 | IntegerLittleEndian | | NpcIndex |
| 13 | 4 | IntegerLittleEndian | | NpcUpgradeType |
| 17 | 4 | IntegerLittleEndian | | NpcUpgradeValue |
23 changes: 23 additions & 0 deletions docs/Packets/C1-B2-08-CastleSiegeTaxInfoResponse_by-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
# C1 B2 08 - CastleSiegeTaxInfoResponse (by server)

## Is sent when

After the guild master opened the castle npc to manage the castle taxes.

## Causes the following actions on the client side

The client shows the current tax configuration and treasury amount.

## Structure

| Index | Length | Data Type | Value | Description |
|-------|--------|-----------|-------|-------------|
| 0 | 1 | Byte | 0xC1 | [Packet type](PacketTypes.md) |
| 1 | 1 | Byte | 19 | Packet header - length of the packet |
| 2 | 1 | Byte | 0xB2 | Packet header - packet type identifier |
| 3 | 1 | Byte | 0x08 | Packet header - sub packet type identifier |
| 4 | 1 | Byte | | TaxRateChaosMachine |
| 5 | 1 | Byte | | TaxRateNormal |
| 6 | 4 | IntegerBigEndian | | TaxRateLandOfTrials |
| 10 | 1 | Boolean | | IsPublicHuntingAllowed |
| 11 | 8 | LongBigEndian | | Treasury |
21 changes: 21 additions & 0 deletions docs/Packets/C1-B2-09-CastleSiegeTaxChangeResponse_by-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# C1 B2 09 - CastleSiegeTaxChangeResponse (by server)

## Is sent when

After the guild master changed the tax rate.

## Causes the following actions on the client side

The client shows the result of the tax rate change.

## Structure

| Index | Length | Data Type | Value | Description |
|-------|--------|-----------|-------|-------------|
| 0 | 1 | Byte | 0xC1 | [Packet type](PacketTypes.md) |
| 1 | 1 | Byte | 10 | Packet header - length of the packet |
| 2 | 1 | Byte | 0xB2 | Packet header - packet type identifier |
| 3 | 1 | Byte | 0x09 | Packet header - sub packet type identifier |
| 4 | 1 | Byte | | Result |
| 5 | 1 | Byte | | TaxType |
| 6 | 4 | IntegerBigEndian | | TaxRate |
20 changes: 20 additions & 0 deletions docs/Packets/C1-B2-10-CastleSiegeTributeWithdrawResponse_by-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# C1 B2 10 - CastleSiegeTributeWithdrawResponse (by server)

## Is sent when

After the guild master requested to withdraw tax money from the castle treasury.

## Causes the following actions on the client side

The client shows the result of the withdrawal and the withdrawn amount.

## Structure

| Index | Length | Data Type | Value | Description |
|-------|--------|-----------|-------|-------------|
| 0 | 1 | Byte | 0xC1 | [Packet type](PacketTypes.md) |
| 1 | 1 | Byte | 13 | Packet header - length of the packet |
| 2 | 1 | Byte | 0xB2 | Packet header - packet type identifier |
| 3 | 1 | Byte | 0x10 | Packet header - sub packet type identifier |
| 4 | 1 | Byte | | Result |
| 5 | 8 | LongBigEndian | | Money |
19 changes: 19 additions & 0 deletions docs/Packets/C1-B2-11-CastleSiegeJoinSideNotification_by-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# C1 B2 11 - CastleSiegeJoinSideNotification (by server)

## Is sent when

The server notifies the player of which siege side (attacker/defender) they are on.

## Causes the following actions on the client side

The client updates the castle siege mini-map accordingly.

## Structure

| Index | Length | Data Type | Value | Description |
|-------|--------|-----------|-------|-------------|
| 0 | 1 | Byte | 0xC1 | [Packet type](PacketTypes.md) |
| 1 | 1 | Byte | 5 | Packet header - length of the packet |
| 2 | 1 | Byte | 0xB2 | Packet header - packet type identifier |
| 3 | 1 | Byte | 0x11 | Packet header - sub packet type identifier |
| 4 | 1 | Byte | | Side; 0 = defender, 1 = attacker, 2 = neutral |
20 changes: 20 additions & 0 deletions docs/Packets/C1-B2-12-CastleSiegeGateOperateResponse_by-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# C1 B2 12 - CastleSiegeGateOperateResponse (by server)

## Is sent when

After a guild member of the castle owner requested to toggle a castle gate.

## Causes the following actions on the client side

The client shows the result of the gate toggle operation.

## Structure

| Index | Length | Data Type | Value | Description |
|-------|--------|-----------|-------|-------------|
| 0 | 1 | Byte | 0xC1 | [Packet type](PacketTypes.md) |
| 1 | 1 | Byte | 7 | Packet header - length of the packet |
| 2 | 1 | Byte | 0xB2 | Packet header - packet type identifier |
| 3 | 1 | Byte | 0x12 | Packet header - sub packet type identifier |
| 4 | 1 | Byte | | Result |
| 5 | 2 | ShortBigEndian | | GateIndex |
19 changes: 19 additions & 0 deletions docs/Packets/C1-B2-13-CastleSiegeCrownStateUpdate_by-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# C1 B2 13 - CastleSiegeCrownStateUpdate (by server)

## Is sent when

The server updates the state of the castle crown during the siege.

## Causes the following actions on the client side

The client updates the crown state display.

## Structure

| Index | Length | Data Type | Value | Description |
|-------|--------|-----------|-------|-------------|
| 0 | 1 | Byte | 0xC1 | [Packet type](PacketTypes.md) |
| 1 | 1 | Byte | 5 | Packet header - length of the packet |
| 2 | 1 | Byte | 0xB2 | Packet header - packet type identifier |
| 3 | 1 | Byte | 0x13 | Packet header - sub packet type identifier |
| 4 | 1 | Byte | | State; 0 = locked, 1 = available |
20 changes: 20 additions & 0 deletions docs/Packets/C1-B2-14-CastleSiegeCrownAccessState_by-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# C1 B2 14 - CastleSiegeCrownAccessState (by server)

## Is sent when

The server updates the access state of the castle crown during the siege.

## Causes the following actions on the client side

The client updates the crown access state and accumulated time display.

## Structure

| Index | Length | Data Type | Value | Description |
|-------|--------|-----------|-------|-------------|
| 0 | 1 | Byte | 0xC1 | [Packet type](PacketTypes.md) |
| 1 | 1 | Byte | 9 | Packet header - length of the packet |
| 2 | 1 | Byte | 0xB2 | Packet header - packet type identifier |
| 3 | 1 | Byte | 0x14 | Packet header - sub packet type identifier |
| 4 | 1 | Byte | | State |
| 5 | 4 | IntegerBigEndian | | AccumulatedTimeMs |
Loading