Appearance
ARCHITECTURE R-TYPE
📊 DIAGRAMME D'ARCHITECTURE COMPLÈTE
┌─────────────────────────────────────────────────────────────────────────┐
│ R-TYPE ARCHITECTURE │
└─────────────────────────────────────────────────────────────────────────┘
COUCHE 1: NETWORKING (TCP/UDP)
═══════════════════════════════════════════════════════════════════════════
┌──────────────────────────────────────────────────────────────────┐
│ ServerHub (TCP - Port 4242) │
│ - Gère Lobby │
│ - Liste des rooms │
│ - Création/Join rooms │
│ - RoomManager │
└────────────────┬─────────────────────────────────────────────────┘
│
┌───────────┼───────────┬───────────────┐
│ │ │ │
↓ ↓ ↓ ↓
┌────────┐ ┌────────┐ ┌────────┐ ┌────────────┐
│ Room 1 │ │ Room 2 │ │ Room 3 │ │ Room N... │
│UDP:5001│ │UDP:5002│ │UDP:5003│ │UDP:5000+N │
└────┬───┘ └────┬───┘ └────┬───┘ └──────┬─────┘
│ │ │ │
↓ ↓ ↓ ↓
ServerRoom ServerRoom ServerRoom ServerRoom
(Process) (Process) (Process) (Process)
COUCHE 2: GAME LOGIC (Server Authoritative)
═══════════════════════════════════════════════════════════════════════════
Chaque ServerRoom contient:
┌─────────────────────────────────────────────────────────────┐
│ ServerRoom │
│ ┌────────────────────────────────────────────────────────┐│
│ │ GameServer (ECS Registry) ││
│ │ ││
│ │ ┌──────────────┐ ┌──────────────┐ ┌─────────────┐ ││
│ │ │ Physics │ │ Collision │ │ Shooter │ ││
│ │ │ System │ │ System │ │ System │ ││
│ │ │ - Gravity │ │ - Detection │ │ - Auto fire │ ││
│ │ │ - Velocity │ │ - Resolution │ │ - Cooldown │ ││
│ │ │ - Boundaries │ │ - Damage │ │ │ ││
│ │ └──────────────┘ └──────────────┘ └─────────────┘ ││
│ │ ││
│ │ ┌──────────────┐ ┌──────────────┐ ││
│ │ │ Spawn │ │ Movement │ ││
│ │ │ System │ │ System │ ││
│ │ │ - Enemies │ │ - Input │ ││
│ │ │ - Powerups │ │ - Apply vel │ ││
│ │ └──────────────┘ └──────────────┘ ││
│ └────────────────────────────────────────────────────────┘│
│ │
│ ┌────────────────────────────────────────────────────────┐│
│ │ Packet Processing ││
│ │ - InputPacket → processPlayerInput() ││
│ │ - Sequence number validation ││
│ │ - Duplicate/OOO detection ││
│ └────────────────────────────────────────────────────────┘│
│ │
│ ┌────────────────────────────────────────────────────────┐│
│ │ State Broadcasting ││
│ │ - GameStatePacket (20Hz) ││
│ │ - Entity snapshots ││
│ │ - Score, game_over ││
│ └────────────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────────────┘
COUCHE 3: CLIENT (Graphical + Networking)
═══════════════════════════════════════════════════════════════════════════
┌──────────────────────────────────────────────────────────────┐
│ r-type_graphical_client │
│ │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ RTypeGame (State Machine) │ │
│ │ │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────────────┐ │ │
│ │ │ MENU │ → │ LOBBY │ → │ PLAYING │ │ │
│ │ │ State │ │ State │ │ State │ │ │
│ │ └──────────┘ └──────────┘ └──────────────────┘ │ │
│ │ │ │
│ └────────────────────────────────────────────────────────┘ │
│ │
│ MENU STATE: │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ - Singleplayer │ │
│ │ - Multiplayer ← Transition vers LOBBY │ │
│ │ - Options │ │
│ │ - Quit │ │
│ └────────────────────────────────────────────────────────┘ │
│ │
│ LOBBY STATE: │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ ClientHub (TCP) │ │
│ │ ├─ requestRoomList() │ │
│ │ ├─ createRoom(name) │ │
│ │ └─ joinRoom(id) │ │
│ │ │ │
│ │ UI: │ │
│ │ ┌──────────────────────────────────────────────────┐ │ │
│ │ │ ROOM NAME PLAYERS STATUS │ │ │
│ │ │ TestRoom 2/4 Waiting [JOIN] │ │ │
│ │ │ CoopMode 1/4 Waiting [JOIN] │ │ │
│ │ │ HardcoreRun 4/4 In Game │ │ │
│ │ └──────────────────────────────────────────────────┘ │ │
│ │ │ │
│ │ [C] Create Room [R] Refresh [ESC] Back to Menu │ │
│ └────────────────────────────────────────────────────────┘ │
│ │
│ PLAYING STATE: │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ ClientRoom (UDP) │ │
│ │ ├─ sendInput(InputPacket) │ │
│ │ ├─ receiveState(GameStatePacket) │ │
│ │ └─ getCurrentRTT() │ │
│ │ │ │
│ │ Game Rendering: │ │
│ │ ┌──────────────────────────────────────────────────┐ │ │
│ │ │ R-TYPE GAME │ │ │
│ │ │ │ │ │
│ │ │ [Player] →→→→ [Enemy] ←←←← │ │ │
│ │ │ │ │ │
│ │ │ Score: 1500 Lives: 3 │ │ │
│ │ └──────────────────────────────────────────────────┘ │ │
│ │ │ │
│ │ Network Metrics Overlay: │ │
│ │ ┌──────────────────────────────────────────────────┐ │ │
│ │ │ 📡 Network Metrics │ │ │
│ │ │ RTT: 45ms ★★★★☆ │ │ │
│ │ │ Loss: 0.1% │ │ │
│ │ │ ↑ Up: 8.3 KB/s │ │ │
│ │ │ ↓ Down: 12.5 KB/s │ │ │
│ │ │ 📦 Sent/Recv: 523/498 │ │ │
│ │ │ FPS: 60 │ │ │
│ │ │ [F3] Toggle │ │ │
│ │ └──────────────────────────────────────────────────┘ │ │
│ └────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────┘
COUCHE 4: PACKETS & COMPRESSION
═══════════════════════════════════════════════════════════════════════════
PacketsManager
┌────────────────────────────────────────────────────────────┐
│ Serialization/Deserialization │
│ ┌──────────────┐ ┌──────────────┐ ┌─────────────────┐ │
│ │ InputPacket │ │ GameState │ │ Login/Logout │ │
│ │ - playerId │ │ Packet │ │ Packets │ │
│ │ - sequence │ │ - frame │ │ │ │
│ │ - moveUp/ │ │ - entities[] │ │ │ │
│ │ Down/etc │ │ - score │ │ │ │
│ └──────────────┘ └──────────────┘ └─────────────────┘ │
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌─────────────────┐ │
│ │ Ping/Pong │ │ Spawn/ │ │ Room │ │
│ │ Packets │ │ Destroy │ │ Packets │ │
│ │ - pingId │ │ Packets │ │ - list │ │
│ │ - timestamp │ │ │ │ - create │ │
│ └──────────────┘ └──────────────┘ └─────────────────┘ │
│ │
│ Compression (LZ4) │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ GameStatePacket: 480 bytes → 182 bytes (62% saving) │ │
│ └──────────────────────────────────────────────────────┘ │
│ │
│ Encryption (XOR) │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ Basic obfuscation for packet data │ │
│ └──────────────────────────────────────────────────────┘ │
│ │
│ Metrics Tracking │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ - recordPacketSent(bytes) │ │
│ │ - recordPacketReceived(bytes) │ │
│ │ - getMetrics() → NetworkMetrics struct │ │
│ │ - packets_sent/received │ │
│ │ - bytes_sent/received │ │
│ │ - bandwidth_up/down KB/s │ │
│ │ - avg_packet_size │ │
│ │ - uptime │ │
│ └──────────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────────┘
COUCHE 5: ECS (Entity Component System)
═══════════════════════════════════════════════════════════════════════════
Registry
┌────────────────────────────────────────────────────────────┐
│ Entities │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Entity 1 │ │ Entity 2 │ │ Entity 3 │ │ Entity N │ │
│ │ Player 1 │ │ Enemy 1 │ │ Bullet 1 │ │ ... │ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
│ │
│ Components (SparseArray) │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ Position │ [x:100, y:200] [x:350, y:150] ... │ │
│ │ Velocity │ [vx:5, vy:0] [vx:-2, vy:3] ... │ │
│ │ Health │ [hp:100] [hp:50] ... │ │
│ │ Damage │ [dmg:10] [dmg:25] ... │ │
│ │ Sprite │ [tex:player] [tex:enemy1] ... │ │
│ │ Rigidbody │ [DYNAMIC] [KINEMATIC] ... │ │
│ │ Gravity │ [fx:0,fy:9.8] [none] ... │ │
│ │ Boundary │ [0,800,0,600] [0,800,0,600] ... │ │
│ └──────────────────────────────────────────────────────┘ │
│ │
│ Systems (operate on Components) │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ PhysicsSystem: │ │
│ │ for entity with (Position, Velocity, Gravity): │ │
│ │ velocity += gravity * dt │ │
│ │ position += velocity * dt │ │
│ │ checkBoundaries(position, boundary) │ │
│ └──────────────────────────────────────────────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ CollisionSystem: │ │
│ │ for entity1 with (Position, Hitbox): │ │
│ │ for entity2 with (Position, Hitbox): │ │
│ │ if collides(entity1, entity2): │ │
│ │ handleCollision(entity1, entity2) │ │
│ └──────────────────────────────────────────────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ ShooterSystem: │ │
│ │ for entity with (ShooterComponent, Position): │ │
│ │ shootTimer += dt │ │
│ │ if shootTimer >= shootInterval: │ │
│ │ spawnBullet(position) │ │
│ │ shootTimer = 0 │ │
│ └──────────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────┐
│ R-TYPE ARCHITECTURE │
└─────────────────────────────────────────────────────────────────────────┘
COUCHE 1: NETWORKING (TCP/UDP)
═══════════════════════════════════════════════════════════════════════════
┌──────────────────────────────────────────────────────────────────┐
│ ServerHub (TCP - Port 4242) │
│ - Gère Lobby │
│ - Liste des rooms │
│ - Création/Join rooms │
│ - RoomManager │
└────────────────┬─────────────────────────────────────────────────┘
│
┌───────────┼───────────┬───────────────┐
│ │ │ │
↓ ↓ ↓ ↓
┌────────┐ ┌────────┐ ┌────────┐ ┌────────────┐
│ Room 1 │ │ Room 2 │ │ Room 3 │ │ Room N... │
│UDP:5001│ │UDP:5002│ │UDP:5003│ │UDP:5000+N │
└────┬───┘ └────┬───┘ └────┬───┘ └──────┬─────┘
│ │ │ │
↓ ↓ ↓ ↓
ServerRoom ServerRoom ServerRoom ServerRoom
(Process) (Process) (Process) (Process)
COUCHE 2: GAME LOGIC (Server Authoritative)
═══════════════════════════════════════════════════════════════════════════
Chaque ServerRoom contient:
┌─────────────────────────────────────────────────────────────┐
│ ServerRoom │
│ ┌────────────────────────────────────────────────────────┐│
│ │ GameServer (ECS Registry) ││
│ │ ││
│ │ ┌──────────────┐ ┌──────────────┐ ┌─────────────┐ ││
│ │ │ Physics │ │ Collision │ │ Shooter │ ││
│ │ │ System │ │ System │ │ System │ ││
│ │ │ - Gravity │ │ - Detection │ │ - Auto fire │ ││
│ │ │ - Velocity │ │ - Resolution │ │ - Cooldown │ ││
│ │ │ - Boundaries │ │ - Damage │ │ │ ││
│ │ └──────────────┘ └──────────────┘ └─────────────┘ ││
│ │ ││
│ │ ┌──────────────┐ ┌──────────────┐ ││
│ │ │ Spawn │ │ Movement │ ││
│ │ │ System │ │ System │ ││
│ │ │ - Enemies │ │ - Input │ ││
│ │ │ - Powerups │ │ - Apply vel │ ││
│ │ └──────────────┘ └──────────────┘ ││
│ └────────────────────────────────────────────────────────┘│
│ │
│ ┌────────────────────────────────────────────────────────┐│
│ │ Packet Processing ││
│ │ - InputPacket → processPlayerInput() ││
│ │ - Sequence number validation ││
│ │ - Duplicate/OOO detection ││
│ └────────────────────────────────────────────────────────┘│
│ │
│ ┌────────────────────────────────────────────────────────┐│
│ │ State Broadcasting ││
│ │ - GameStatePacket (20Hz) ││
│ │ - Entity snapshots ││
│ │ - Score, game_over ││
│ └────────────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────────────┘
COUCHE 3: CLIENT (Graphical + Networking)
═══════════════════════════════════════════════════════════════════════════
┌──────────────────────────────────────────────────────────────┐
│ r-type_graphical_client │
│ │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ RTypeGame (State Machine) │ │
│ │ │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────────────┐ │ │
│ │ │ MENU │ → │ LOBBY │ → │ PLAYING │ │ │
│ │ │ State │ │ State │ │ State │ │ │
│ │ └──────────┘ └──────────┘ └──────────────────┘ │ │
│ │ │ │
│ └────────────────────────────────────────────────────────┘ │
│ │
│ MENU STATE: │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ - Singleplayer │ │
│ │ - Multiplayer ← Transition vers LOBBY │ │
│ │ - Options │ │
│ │ - Quit │ │
│ └────────────────────────────────────────────────────────┘ │
│ │
│ LOBBY STATE: │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ ClientHub (TCP) │ │
│ │ ├─ requestRoomList() │ │
│ │ ├─ createRoom(name) │ │
│ │ └─ joinRoom(id) │ │
│ │ │ │
│ │ UI: │ │
│ │ ┌──────────────────────────────────────────────────┐ │ │
│ │ │ ROOM NAME PLAYERS STATUS │ │ │
│ │ │ TestRoom 2/4 Waiting [JOIN] │ │ │
│ │ │ CoopMode 1/4 Waiting [JOIN] │ │ │
│ │ │ HardcoreRun 4/4 In Game │ │ │
│ │ └──────────────────────────────────────────────────┘ │ │
│ │ │ │
│ │ [C] Create Room [R] Refresh [ESC] Back to Menu │ │
│ └────────────────────────────────────────────────────────┘ │
│ │
│ PLAYING STATE: │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ ClientRoom (UDP) │ │
│ │ ├─ sendInput(InputPacket) │ │
│ │ ├─ receiveState(GameStatePacket) │ │
│ │ └─ getCurrentRTT() │ │
│ │ │ │
│ │ Game Rendering: │ │
│ │ ┌──────────────────────────────────────────────────┐ │ │
│ │ │ R-TYPE GAME │ │ │
│ │ │ │ │ │
│ │ │ [Player] →→→→ [Enemy] ←←←← │ │ │
│ │ │ │ │ │
│ │ │ Score: 1500 Lives: 3 │ │ │
│ │ └──────────────────────────────────────────────────┘ │ │
│ │ │ │
│ │ Network Metrics Overlay: │ │
│ │ ┌──────────────────────────────────────────────────┐ │ │
│ │ │ 📡 Network Metrics │ │ │
│ │ │ RTT: 45ms ★★★★☆ │ │ │
│ │ │ Loss: 0.1% │ │ │
│ │ │ ↑ Up: 8.3 KB/s │ │ │
│ │ │ ↓ Down: 12.5 KB/s │ │ │
│ │ │ 📦 Sent/Recv: 523/498 │ │ │
│ │ │ FPS: 60 │ │ │
│ │ │ [F3] Toggle │ │ │
│ │ └──────────────────────────────────────────────────┘ │ │
│ └────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────┘
COUCHE 4: PACKETS & COMPRESSION
═══════════════════════════════════════════════════════════════════════════
PacketsManager
┌────────────────────────────────────────────────────────────┐
│ Serialization/Deserialization │
│ ┌──────────────┐ ┌──────────────┐ ┌─────────────────┐ │
│ │ InputPacket │ │ GameState │ │ Login/Logout │ │
│ │ - playerId │ │ Packet │ │ Packets │ │
│ │ - sequence │ │ - frame │ │ │ │
│ │ - moveUp/ │ │ - entities[] │ │ │ │
│ │ Down/etc │ │ - score │ │ │ │
│ └──────────────┘ └──────────────┘ └─────────────────┘ │
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌─────────────────┐ │
│ │ Ping/Pong │ │ Spawn/ │ │ Room │ │
│ │ Packets │ │ Destroy │ │ Packets │ │
│ │ - pingId │ │ Packets │ │ - list │ │
│ │ - timestamp │ │ │ │ - create │ │
│ └──────────────┘ └──────────────┘ └─────────────────┘ │
│ │
│ Compression (LZ4) │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ GameStatePacket: 480 bytes → 182 bytes (62% saving) │ │
│ └──────────────────────────────────────────────────────┘ │
│ │
│ Encryption (XOR) │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ Basic obfuscation for packet data │ │
│ └──────────────────────────────────────────────────────┘ │
│ │
│ Metrics Tracking │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ - recordPacketSent(bytes) │ │
│ │ - recordPacketReceived(bytes) │ │
│ │ - getMetrics() → NetworkMetrics struct │ │
│ │ - packets_sent/received │ │
│ │ - bytes_sent/received │ │
│ │ - bandwidth_up/down KB/s │ │
│ │ - avg_packet_size │ │
│ │ - uptime │ │
│ └──────────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────────┘
COUCHE 5: ECS (Entity Component System)
═══════════════════════════════════════════════════════════════════════════
Registry
┌────────────────────────────────────────────────────────────┐
│ Entities │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Entity 1 │ │ Entity 2 │ │ Entity 3 │ │ Entity N │ │
│ │ Player 1 │ │ Enemy 1 │ │ Bullet 1 │ │ ... │ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
│ │
│ Components (SparseArray) │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ Position │ [x:100, y:200] [x:350, y:150] ... │ │
│ │ Velocity │ [vx:5, vy:0] [vx:-2, vy:3] ... │ │
│ │ Health │ [hp:100] [hp:50] ... │ │
│ │ Damage │ [dmg:10] [dmg:25] ... │ │
│ │ Sprite │ [tex:player] [tex:enemy1] ... │ │
│ │ Rigidbody │ [DYNAMIC] [KINEMATIC] ... │ │
│ │ Gravity │ [fx:0,fy:9.8] [none] ... │ │
│ │ Boundary │ [0,800,0,600] [0,800,0,600] ... │ │
│ └──────────────────────────────────────────────────────┘ │
│ │
│ Systems (operate on Components) │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ PhysicsSystem: │ │
│ │ for entity with (Position, Velocity, Gravity): │ │
│ │ velocity += gravity * dt │ │
│ │ position += velocity * dt │ │
│ │ checkBoundaries(position, boundary) │ │
│ └──────────────────────────────────────────────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ CollisionSystem: │ │
│ │ for entity1 with (Position, Hitbox): │ │
│ │ for entity2 with (Position, Hitbox): │ │
│ │ if collides(entity1, entity2): │ │
│ │ handleCollision(entity1, entity2) │ │
│ └──────────────────────────────────────────────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ ShooterSystem: │ │
│ │ for entity with (ShooterComponent, Position): │ │
│ │ shootTimer += dt │ │
│ │ if shootTimer >= shootInterval: │ │
│ │ spawnBullet(position) │ │
│ │ shootTimer = 0 │ │
│ └──────────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────────┘
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
🔄 FLOW DE DONNÉES COMPLET
Flow 1: Connexion Initiale
Client ServerHub ServerRoom
│ │ │
│ TCP Connect (4242) │ │
├───────────────────────────>│ │
│ │ │
│ LoginPacket │ │
├───────────────────────────>│ │
│ │ │
│ LoginResponsePacket │ │
│<───────────────────────────┤ │
│ (success, playerId) │ │
│ │ │
│ requestRoomList() │ │
├───────────────────────────>│ │
│ │ │
│ RoomListPacket │ │
│<───────────────────────────┤ │
│ [Room1, Room2, Room3...] │ │
│ │ │
│ joinRoom(roomId) │ │
├───────────────────────────>│ │
│ │ │
│ │ SpawnRoom (if needed) │
│ ├─────────────────────────>│
│ │ │
│ RoomJoinedPacket │ │
│<───────────────────────────┤ │
│ (roomId, port:5001) │ │
│ │ │
│ Disconnect TCP │ │
│ Connect UDP (5001) │ │
├───────────────────────────────────────────────────────>│
│ │ │
Client ServerHub ServerRoom
│ │ │
│ TCP Connect (4242) │ │
├───────────────────────────>│ │
│ │ │
│ LoginPacket │ │
├───────────────────────────>│ │
│ │ │
│ LoginResponsePacket │ │
│<───────────────────────────┤ │
│ (success, playerId) │ │
│ │ │
│ requestRoomList() │ │
├───────────────────────────>│ │
│ │ │
│ RoomListPacket │ │
│<───────────────────────────┤ │
│ [Room1, Room2, Room3...] │ │
│ │ │
│ joinRoom(roomId) │ │
├───────────────────────────>│ │
│ │ │
│ │ SpawnRoom (if needed) │
│ ├─────────────────────────>│
│ │ │
│ RoomJoinedPacket │ │
│<───────────────────────────┤ │
│ (roomId, port:5001) │ │
│ │ │
│ Disconnect TCP │ │
│ Connect UDP (5001) │ │
├───────────────────────────────────────────────────────>│
│ │ │
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
Flow 2: Game Loop (60Hz Client, 20Hz Server)
Client (60 FPS) ServerRoom (20 TPS) Client Render
│ │ │
│ Read Input │ │
├─────────► │ │
│ (↑ pressed) │ │
│ │ │
│ InputPacket │ │
│ seq#142, moveUp=true │ │
├───────────────────────────>│ │
│ │ │
│ │ Validate sequence │
│ │ (not duplicate/OOO) │
│ │ │
│ │ GameServer. │
│ │ processPlayerInput() │
│ │ │ │
│ │ ↓ │
│ │ PhysicsSystem.update() │
│ │ - Apply velocity │
│ │ - Update position │
│ │ │ │
│ │ ↓ │
│ │ CollisionSystem.update() │
│ │ - Check collisions │
│ │ - Apply damage │
│ │ │ │
│ │ ↓ │
│ │ ShooterSystem.update() │
│ │ - Auto fire bullets │
│ │ │ │
│ │ ↓ │
│ │ SpawnSystem.update() │
│ │ - Spawn enemies │
│ │ │
│ GameStatePacket │ │
│<───────────────────────────┤ │
│ frame#75, entities[...] │ │
│ score, gameOver │ │
│ │ │
│ applyGameState() │ │
├────────────────────────────────────────────────────────>│
│ │ Update positions
│ │ Update sprites
│ │ │
│ render() │ │
├────────────────────────────────────────────────────────>│
│ │ Draw background
│ │ Draw entities
│ │ Draw UI
│ │ Draw metrics
│ │ display()
Client (60 FPS) ServerRoom (20 TPS) Client Render
│ │ │
│ Read Input │ │
├─────────► │ │
│ (↑ pressed) │ │
│ │ │
│ InputPacket │ │
│ seq#142, moveUp=true │ │
├───────────────────────────>│ │
│ │ │
│ │ Validate sequence │
│ │ (not duplicate/OOO) │
│ │ │
│ │ GameServer. │
│ │ processPlayerInput() │
│ │ │ │
│ │ ↓ │
│ │ PhysicsSystem.update() │
│ │ - Apply velocity │
│ │ - Update position │
│ │ │ │
│ │ ↓ │
│ │ CollisionSystem.update() │
│ │ - Check collisions │
│ │ - Apply damage │
│ │ │ │
│ │ ↓ │
│ │ ShooterSystem.update() │
│ │ - Auto fire bullets │
│ │ │ │
│ │ ↓ │
│ │ SpawnSystem.update() │
│ │ - Spawn enemies │
│ │ │
│ GameStatePacket │ │
│<───────────────────────────┤ │
│ frame#75, entities[...] │ │
│ score, gameOver │ │
│ │ │
│ applyGameState() │ │
├────────────────────────────────────────────────────────>│
│ │ Update positions
│ │ Update sprites
│ │ │
│ render() │ │
├────────────────────────────────────────────────────────>│
│ │ Draw background
│ │ Draw entities
│ │ Draw UI
│ │ Draw metrics
│ │ display()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
Flow 3: PING/PONG pour RTT
Client ServerRoom
│ │
│ PingPacket │
│ pingId=123 │
│ timestamp=T1 │
├───────────────────────────>│
│ Store (pingId, T1) │
│ │
│ │ Receive Ping
│ │
│ PongPacket │
│<───────────────────────────┤
│ pingId=123 │
│ │
│ Calculate RTT: │
│ T2 = now() │
│ RTT = T2 - T1 │
│ _current_rtt = RTT │
│ │
Client ServerRoom
│ │
│ PingPacket │
│ pingId=123 │
│ timestamp=T1 │
├───────────────────────────>│
│ Store (pingId, T1) │
│ │
│ │ Receive Ping
│ │
│ PongPacket │
│<───────────────────────────┤
│ pingId=123 │
│ │
│ Calculate RTT: │
│ T2 = now() │
│ RTT = T2 - T1 │
│ _current_rtt = RTT │
│ │
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
Flow 4: Network Metrics Update
PacketsManager NetworkMetricsUI Render
│ │ │
│ recordPacketSent() │ │
├────────► │ │
│ _bytes_sent += 150 │ │
│ _packets_sent++ │ │
│ │ │
│ recordPacketReceived() │ │
├────────► │ │
│ _bytes_received += 480 │ │
│ _packets_received++ │ │
│ │ │
│ │ update() │
│ │ (every 1 sec) │
│ ├─────────► │
│ │ │
│ getMetrics() │ │
│<───────────────────────────┤ │
│ returns: │ │
│ - packets_sent: 523 │ │
│ - packets_received: 498 │ │
│ - bandwidth_up: 8.3 KB/s │ │
│ - bandwidth_down: 12.5 │ │
│ │ │
│ │ render() │
│ ├────────────────────>│
│ │ Draw overlay
│ │ with metrics
PacketsManager NetworkMetricsUI Render
│ │ │
│ recordPacketSent() │ │
├────────► │ │
│ _bytes_sent += 150 │ │
│ _packets_sent++ │ │
│ │ │
│ recordPacketReceived() │ │
├────────► │ │
│ _bytes_received += 480 │ │
│ _packets_received++ │ │
│ │ │
│ │ update() │
│ │ (every 1 sec) │
│ ├─────────► │
│ │ │
│ getMetrics() │ │
│<───────────────────────────┤ │
│ returns: │ │
│ - packets_sent: 523 │ │
│ - packets_received: 498 │ │
│ - bandwidth_up: 8.3 KB/s │ │
│ - bandwidth_down: 12.5 │ │
│ │ │
│ │ render() │
│ ├────────────────────>│
│ │ Draw overlay
│ │ with metrics
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28