Project Chimera
Меню

Исходники

148 строк · 8 КиБ

code/crates/chl-kb/src/anticheat.rs

1//! Are We Anti-Cheat Yet — держит ли анти-чит игры Linux/Proton вообще.
2//!
3//! Тот же довод, что и у [`crate::protondb`]: источник английский, но
4//! отдаёт ровно один статус из пяти известных значений ([`Status`]) —
5//! переводится без потерь, русского свода по анти-читам под Linux нет.
6//! Правило «только русскоязычные источники» защищает от языкового барьера
7//! в *содержании* (длинный текст гайда или прохождения по-английски —
8//! не то же самое, что по-русски); один статус барьера не создаёт, если
9//! на экране всегда русское слово, а не английский токен.
10//!
11//! Официального API по `appid` нет — проект отдаёт один файл `games.json`
12//! со всем списком, и матчить приходится по названию. Сопоставление
13//! **точное**, без регистра и без попыток угадать: ошибочно показанное
14//! «анти-чит не работает» или «анти-чит работает» опаснее, чем честное
15//! «данных нет» — человек либо зря откажется от игры, либо потеряет время
16//! на игру, где сервер забанит за то, что анти-чит решит, будто это чит.
17
18use anyhow::{Context, Result};
19use chl_covers::wikipedia::USER_AGENT;
20use serde::{Deserialize, Serialize};
21
22const GAMES_JSON_URL: &str =
23 "https://raw.githubusercontent.com/AreWeAntiCheatYet/AreWeAntiCheatYet/HEAD/games.json";
24
25/// Статус анти-чита. Пять значений проекта на день написания (сверено
26/// живьём — см. тест) плюс запасной вариант на будущее.
27#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
28pub enum Status {
29 /// Разработчик анти-чита явно отказался поддерживать Linux/Proton.
30 Denied,
31 /// Анти-чит определённо не даёт играть — банит, крашит, не пускает.
32 Broken,
33 /// Поддержка объявлена, но ещё не выпущена.
34 Planned,
35 /// Работает, но неофициально: разработчик поддержку не заявлял, и
36 /// это может перестать работать в любом следующем обновлении.
37 Running,
38 /// Разработчик официально поддерживает Linux/Proton.
39 Supported,
40 Unknown(String),
41}
42
43impl Status {
44 fn from_wire(raw: &str) -> Self {
45 match raw {
46 "Denied" => Status::Denied,
47 "Broken" => Status::Broken,
48 "Planned" => Status::Planned,
49 "Running" => Status::Running,
50 "Supported" => Status::Supported,
51 other => Status::Unknown(other.to_string()),
52 }
53 }
54
55 pub fn title_ru(&self) -> String {
56 match self {
57 Status::Denied => "разработчик отказался поддерживать Linux".to_string(),
58 Status::Broken => "не работает под Linux".to_string(),
59 Status::Planned => "поддержка Linux заявлена, но ещё не вышла".to_string(),
60 Status::Running => "работает, но неофициально — может сломаться в любом обновлении".to_string(),
61 Status::Supported => "официально поддерживается на Linux".to_string(),
62 Status::Unknown(raw) => format!("неизвестный статус Are We Anti-Cheat Yet: {raw}"),
63 }
64 }
65}
66
67#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
68pub struct Report {
69 pub status: Status,
70 /// Какой именно анти-чит — их у игры бывает и два сразу (например, у
71 /// DayZ: BattlEye и VAC).
72 pub anticheats: Vec<String>,
73 pub url: String,
74}
75
76#[derive(Deserialize)]
77struct GameEntry {
78 name: String,
79 status: String,
80 reference: String,
81 anticheats: Vec<String>,
82}
83
84/// Ищет игру по точному названию, без учёта регистра. `Ok(None)` — в
85/// списке такой игры нет вовсе, что для этого проекта означает «у игры нет
86/// известного анти-чита» гораздо чаще, чем «данных не хватает»: список
87/// собирается по играм, у которых анти-чит вообще есть.
88pub fn fetch(game: &str) -> Result<Option<Report>> {
89 let mut response = ureq::Agent::config_builder()
90 .timeout_global(Some(std::time::Duration::from_secs(15)))
91 .build()
92 .new_agent()
93 .get(GAMES_JSON_URL)
94 .header("User-Agent", USER_AGENT)
95 .call()
96 .context("не удалось обратиться к Are We Anti-Cheat Yet")?;
97 let text = response.body_mut().read_to_string().context("обрыв ответа Are We Anti-Cheat Yet")?;
98 let games: Vec<GameEntry> =
99 serde_json::from_str(&text).context("ответ Are We Anti-Cheat Yet не разбирается")?;
100
101 let found = games.into_iter().find(|g| g.name.eq_ignore_ascii_case(game));
102 Ok(found.map(|g| Report {
103 status: Status::from_wire(&g.status),
104 anticheats: g.anticheats,
105 url: if g.reference.is_empty() {
106 "https://areweanticheatyet.com/".to_string()
107 } else {
108 g.reference
109 },
110 }))
111}
112
113#[cfg(test)]
114mod tests {
115 use super::*;
116
117 #[test]
118 fn известные_значения_разбираются_а_новое_не_роняет() {
119 assert_eq!(Status::from_wire("Supported"), Status::Supported);
120 assert_eq!(Status::from_wire("Denied"), Status::Denied);
121 assert_eq!(Status::from_wire("Изгнан"), Status::Unknown("Изгнан".to_string()));
122 }
123
124 #[test]
125 fn у_каждого_значения_есть_русское_название() {
126 for s in [
127 Status::Denied,
128 Status::Broken,
129 Status::Planned,
130 Status::Running,
131 Status::Supported,
132 Status::Unknown("x".to_string()),
133 ] {
134 assert!(!s.title_ru().is_empty());
135 }
136 }
137
138 /// Живой прогон — пропускается по умолчанию, требует сеть. DayZ в
139 /// списке есть точно (BattlEye и VAC, статус на день написания —
140 /// Supported).
141 #[test]
142 #[ignore]
143 fn живой_прогон_против_настоящего_awacy() {
144 let report = fetch("DayZ").expect("запрос не должен упасть").expect("DayZ есть в списке");
145 assert!(!report.anticheats.is_empty());
146 }
147}
148