kaiwyvern.notes
← Заметки

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 здесь правильно, а исключение сломало бы плагин из-за значения, которое придёт через секунду.