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 | |
| 18 | use anyhow::{Context, Result}; |
| 19 | use chl_covers::wikipedia::USER_AGENT; |
| 20 | use serde::{Deserialize, Serialize}; |
| 21 | |
| 22 | const 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)] |
| 28 | pub 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 | |
| 43 | impl 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)] |
| 68 | pub 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)] |
| 77 | struct GameEntry { |
| 78 | name: String, |
| 79 | status: String, |
| 80 | reference: String, |
| 81 | anticheats: Vec<String>, |
| 82 | } |
| 83 | |
| 84 | /// Ищет игру по точному названию, без учёта регистра. `Ok(None)` — в |
| 85 | /// списке такой игры нет вовсе, что для этого проекта означает «у игры нет |
| 86 | /// известного анти-чита» гораздо чаще, чем «данных не хватает»: список |
| 87 | /// собирается по играм, у которых анти-чит вообще есть. |
| 88 | pub 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)] |
| 114 | mod 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 |