LCUX-шимы
plugins/sys/gamestate/*.jsЧетыре небольших класса оборачивают сокет игрового клиента и превращают его шумные сообщения в три-четыре стабильных геттера плюс подписки на изменения. Долгого кэша нет: значение всегда читается из последнего сообщения, которое дошло по сокету.
Идентификаторы очередей группируются, а не сравниваются
Сокет сообщает числовой queueId, а плагинам важна группа режима: classic, ARAM или swiftplay. Соответствие живёт в одной таблице: новая очередь — одна строка, а не правки во всех вызовах.
const GAME_MODES = {
420: "CLASSIC SOLO",
440: "CLASSIC FLEX",
450: "ARAM",
1750: "ARENA \\ CHERRY",
480: "SWIFTPLAY"
};
const CLASSIC_GROUP = new Set([400, 420, 440, 870, 880, 890, 1750, 3100, 3130, 3120, 3110, 3140]);
const ARAM_GROUP = new Set([450, 2400, 3220, 3200, 3210, 3270]);
const SWIFT_GROUP = new Set([480]);
Три источника одной правды
Текущий queueId может прийти из сессии, из лобби или из матчмейкинга, и обновляются они не одновременно. ModeShim держит все три и предпочитает самый свежий не-null, а не доверяет одному источнику.
this._queueIdFromSession = null;
this._queueIdFromLobby = null;
this._queueIdFromMatchmaking = null;
getQueueId() {
return this._queueIdFromMatchmaking
?? this._queueIdFromLobby
?? this._queueIdFromSession;
}
Подписки через observe
У сокета есть помощник observe(), возвращающий отписку. Каждый шим подписывается на один эндпоинт, реагирует на eventType и держит свой Set слушателей. В stop() подписка отключается — после перезагрузки не остаётся висящих сокетов.
this._subscription = this.socket.observe(
'lol-inventory/v2/inventory/CHAMPION_SKIN',
(msg) => {
if (msg.eventType === 'Delete') this._removeSkin(msg.data);
else this._addSkin(msg.data);
}
);
Одна точка входа
Все четыре шима создаются с одним сокетом и публикуются как один объект. Плагины пользуются window.gamestate и не импортируют внутренние классы — поверхность маленькая, реализацию можно заменить, не трогая вызывающих.
export function init({ socket }) {
modeShim = new ModeShim(socket);
championShim = new ChampionShim(socket);
swiftShim = new SwiftShim(socket);
ownedShim = new OwnedShim(socket);
}
window.gamestate = {
getCurrentMode: () => modeShim?.getCurrentMode(),
getQueueId: () => modeShim?.getQueueId(),
onModeChange: (fn) => modeShim?.onModeChange(fn),
getChampion: () => championShim?.getChampion(),
onChampionChange: (fn) => championShim?.onChampionChange(fn),
getSwiftSelection:() => swiftShim?.getSwiftSelection(),
getOwnedSkins: () => ownedShim?.getOwnedSkins(),
isSkinOwned: (id) => ownedShim?.isSkinOwned(id)
};
Почему везде опциональная цепочка
Каждый метод написан как modeShim?.getCurrentMode(). На старте шимы уже существуют, но сокет мог ещё не ответить; вернуть undefined здесь правильно, а исключение сломало бы плагин из-за значения, которое придёт через секунду.