cheshire_chess 0.2.3

A terminal chess app — tactics training, live multiplayer, game rooms, and custom pieces
Documentation 
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

use serde::{Deserialize, Serialize};

// ── Client → Server ────────────────────────────────────────────────

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(tag = "type")]
pub enum ClientMsg {
    SetName { name: String },
    ListRooms,
    CreateRoom { name: String },
    JoinRoom { room_id: u32 },
    LeaveRoom,

    // Game tables within a room
    CreateTable,                         // create a table, wait for opponent
    JoinTable { table_id: u32 },         // sit down to play or spectate
    LeaveTable,                          // stand up from table

    // Moves (applies to whichever table you're at)
    MakeMove { uci: String },
    Resign,
    Rematch,

    // Main board (moderator only)
    SetMainBoardMode { mode: BoardMode },
    MainBoardMove { uci: String },

    // Chat (goes to the whole room)
    SendChat { body: String },
}

// ── Server → Client ────────────────────────────────────────────────

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(tag = "type")]
pub enum ServerMsg {
    Welcome { your_id: u32 },
    Error { msg: String },

    // Room browsing
    RoomList { rooms: Vec<RoomInfo> },

    // Room state
    RoomJoined { room: RoomInfo, players: Vec<PlayerInfo>, tables: Vec<TableInfo> },
    PlayerJoined { player: PlayerInfo },
    PlayerLeft { player_id: u32 },

    // Game tables
    TableCreated { table: TableInfo },
    TableUpdated { table: TableInfo },
    TableRemoved { table_id: u32 },
    TableJoined { table: TableInfo, fen: String },

    // Game events (within a table)
    GameStarted { table_id: u32, white: u32, black: u32, fen: String },
    MoveMade { table_id: u32, uci: String, fen: String },
    GameOver { table_id: u32, reason: String, winner: Option<u32> },

    // Main board
    MainBoardUpdate { mode: BoardMode, fen: String },

    // Chat
    ChatMessage { sender: String, body: String, kind: ChatKind },
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct RoomInfo {
    pub id: u32,
    pub name: String,
    pub player_count: u32,
    pub table_count: u32,
    pub active_games: u32,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PlayerInfo {
    pub id: u32,
    pub name: String,
    pub status: PlayerStatus,
    pub table_id: Option<u32>,
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub enum PlayerStatus {
    Idle,
    Playing,
    Spectating,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TableInfo {
    pub id: u32,
    pub white: Option<PlayerRef>,
    pub black: Option<PlayerRef>,
    pub spectator_count: u32,
    pub has_game: bool,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PlayerRef {
    pub id: u32,
    pub name: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub enum BoardMode {
    Tutorial,
    Game,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub enum ChatKind {
    Player,
    System,
    Spectator,
}

pub const DEFAULT_PORT: u16 = 7878;
pub const CENTRAL_SERVER_PORT: u16 = 7880;