Cockatrice/libcockatrice_protocol/libcockatrice/protocol/pb/moderator_commands.proto
Lukas Brübach 5e1aab2492 [Protocol] Add alt match evidence and search depth
ServerInfo_UserAlt gains match_reason, depth, and shared_count so moderators can see why an account was flagged and how far it sits from the investigated user. Command_GetUserAlts gains a depth parameter (default 1) for transitive alt-of-alt searches. No behavior change: server still answers depth 1 and leaves the new fields empty until the follow-up server/client layers land.
2026-11-02 21:53:42 +01:00

199 lines
5.7 KiB
Protocol Buffer

syntax = "proto2";
import "developer_commands.proto";
message ModeratorCommand {
enum ModeratorCommandType {
BAN_FROM_SERVER = 1000;
BAN_HISTORY = 1001;
WARN_USER = 1002;
WARN_HISTORY = 1003;
WARN_LIST = 1004;
VIEWLOG_HISTORY = 1005;
GRANT_REPLAY_ACCESS = 1006;
FORCE_ACTIVATE_USER = 1007;
GET_ADMIN_NOTES = 1008;
UPDATE_ADMIN_NOTES = 1009;
ADD_CARD_ART_RULE = 1010;
REMOVE_CARD_ART_RULE = 1011;
LIST_CARD_ART_RULES = 1012;
GET_USER_SESSIONS = 1013;
GET_USER_ALTS = 1014;
GET_MODERATOR_LAST_LOGINS = 1015;
RESET_USER_PASSWORD = 1016;
REMOVE_USER_AVATAR = 1017;
REMOVE_USER_BANNER = 1018;
CLEAR_BLACKLISTED_BANNERS = 1019;
REPORT_LIST = 1200;
REPORT_ASSIGN = 1201;
REPORT_RESOLVE = 1202;
REPLAY_DOWNLOAD_BY_GAME_ID = 1203;
REPORT_USER_INFO = 1204;
REPORT_STATS = 1205;
REPORT_REOPEN = 1206;
}
extensions 100 to max;
}
message Command_BanFromServer {
extend ModeratorCommand {
optional Command_BanFromServer ext = 1000;
}
optional string user_name = 1;
optional string address = 2;
optional uint32 minutes = 3;
optional string reason = 4;
optional string visible_reason = 5;
optional string clientid = 6;
optional uint32 remove_messages = 7;
}
message Command_GetBanHistory {
extend ModeratorCommand {
optional Command_GetBanHistory ext = 1001;
}
optional string user_name = 1;
}
message Command_WarnUser {
extend ModeratorCommand {
optional Command_WarnUser ext = 1002;
}
optional string user_name = 1;
optional string reason = 2;
optional string clientid = 3;
optional uint32 remove_messages = 4;
}
message Command_GetWarnHistory {
extend ModeratorCommand {
optional Command_GetWarnHistory ext = 1003;
}
optional string user_name = 1;
}
message Command_GetWarnList {
extend ModeratorCommand {
optional Command_GetWarnList ext = 1004;
}
optional string mod_name = 1;
optional string user_name = 2;
optional string user_clientid = 3;
}
message Command_ViewLogHistory {
extend ModeratorCommand {
optional Command_ViewLogHistory ext = 1005;
}
extend DeveloperCommand {
optional Command_ViewLogHistory dev_ext = 1001;
}
optional string user_name = 1; // user that created message
optional string ip_address = 2; // ip address of user that created message
optional string game_name = 3; // client id of user that created the message
optional string game_id = 4; // game number the message was sent to
optional string message = 5; // raw message that was sent
repeated string log_location = 6; // destination of message (ex: main room, game room, private chat)
required uint32 date_range = 7; // the length of time (in minutes) to look back for
optional uint32 maximum_results = 8; // the maximum number of query results (page size when paginating)
optional uint32 offset = 9 [default = 0]; // rows to skip for pagination, ORDER BY log_time DESC
optional string before_time = 10; // page those rows against this `log_time` snapshot (newest first page row)
}
message Command_GrantReplayAccess {
extend ModeratorCommand {
optional Command_GrantReplayAccess ext = 1006;
}
optional uint32 replay_id = 1;
optional string moderator_name = 2;
}
message Command_ForceActivateUser {
extend ModeratorCommand {
optional Command_ForceActivateUser ext = 1007;
}
optional string username_to_activate = 1;
optional string moderator_name = 2;
}
message Command_GetAdminNotes {
extend ModeratorCommand {
optional Command_GetAdminNotes ext = 1008;
}
optional string user_name = 1;
}
message Command_UpdateAdminNotes {
extend ModeratorCommand {
optional Command_UpdateAdminNotes ext = 1009;
}
optional string user_name = 1;
optional string notes = 2;
}
message Command_AddCardArtRule {
extend ModeratorCommand {
optional Command_AddCardArtRule ext = 1010;
}
optional string card_name = 1;
optional string card_provider_id = 2;
optional string mode = 3; // "ALLOW" or "DENY"
optional string reason = 4;
}
message Command_RemoveCardArtRule {
extend ModeratorCommand {
optional Command_RemoveCardArtRule ext = 1011;
}
optional string card_name = 1;
optional string card_provider_id = 2;
}
message Command_ListCardArtRules {
extend ModeratorCommand {
optional Command_ListCardArtRules ext = 1012;
}
}
message Command_GetUserSessions {
extend ModeratorCommand {
optional Command_GetUserSessions ext = 1013;
}
optional string user_name = 1;
optional uint32 limit = 2 [default = 110];
}
message Command_GetUserAlts {
extend ModeratorCommand {
optional Command_GetUserAlts ext = 1014;
}
optional string user_name = 1;
optional uint32 depth = 2 [default = 1]; // BFS depth: 1 = direct matches only, up to 3 for transitive alts-of-alts
}
message Command_GetModeratorLastLogins {
extend ModeratorCommand {
optional Command_GetModeratorLastLogins ext = 1015;
}
}
message Command_RemoveUserAvatar {
extend ModeratorCommand {
optional Command_RemoveUserAvatar ext = 1017;
}
optional string user_name = 1;
}
message Command_RemoveUserBanner {
extend ModeratorCommand {
optional Command_RemoveUserBanner ext = 1018;
}
optional string user_name = 1;
}
message Command_ClearBlacklistedBanners {
extend ModeratorCommand {
optional Command_ClearBlacklistedBanners ext = 1019;
}
}