Адаптеры серверов Lineage 2

Prizmo · 24 Мар 2025

Этот модуль предоставляет унифицированный интерфейс для взаимодействия с различными сборками серверов Lineage 2.

## Структура проекта

```
adapt/
├── acis/ # Адаптер для серверов ACIS
├── base/ # Базовая реализация адаптера и фабрики
├── lucera/ # Адаптер для серверов Lucera
├── pwsoft/ # Адаптер для серверов PWsoft
└── index.js # Основная точка входа
```

## Использование

```javascript
const { getAdapter } = require('./adapt');

// Получение адаптера для конкретного сервера
const adapter = await getAdapter(serverId);

// Получение списка персонажей
const characters = await adapter.getCharacters('pvp', 20, 0);

// Получение информации о клане
const clan = await adapter.getClanDetails(clanId);
```

## Основные возможности

- Унифицированный интерфейс для разных сборок серверов
- Кэширование адаптеров для оптимизации производительности
- Обработка ошибок и логирование
- Поддержка автоматического переподключения
- Определение типа сервера на основе конфигурации

## Поддерживаемые операции

### Работа с персонажами
- Получение списка персонажей с фильтрацией
- Поиск персонажей по имени
- Детальная информация о персонаже
- Управление инвентарем
- PvP/PK статистика

### Работа с кланами
- Получение списка кланов
- Поиск кланов по названию
- Детальная информация о клане
- Управление составом клана

### Мониторинг сервера
- Проверка статуса сервера
- Получение количества онлайн игроков
- Статистика активности
- Мониторинг системных ресурсов

## Примеры использования

### Получение статистики персонажа
```javascript
const pvpStats = await adapter.getCharacterPvPStats(charId);
console.log(`PvP убийства: ${pvpStats.pvp_kills}`);
console.log(`PK убийства: ${pvpStats.pk_kills}`);
```

### Работа с кланами
```javascript
// Получение списка кланов
const clans = await adapter.getClans('reputation', 10, 0);

// Получение членов клана
const members = await adapter.getClanMembers(clanId);
```

### Поиск персонажей
```javascript
// Поиск по имени
const results = await adapter.searchCharacters('Test');

// Получение детальной информации
const details = await adapter.getCharacterDetails(charId);
```

## Обработка ошибок

Все методы адаптера возвращают Promise и обрабатывают ошибки:

```javascript
try {
const adapter = await getAdapter(serverId);
const characters = await adapter.getCharacters();
} catch (error) {
console.error('Ошибка при получении персонажей:', error.message);
}
```

## Конфигурация

Настройки серверов находятся в файле `config/servers.js`:

- ID сервера
- Название
- IP адрес
- Порты (login, game)
- Настройки базы данных
- Тестовые аккаунты

## Расширение функционала

Для добавления поддержки новой сборки сервера:

1. Создайте новый каталог в `adapt/`
2. Реализуйте базовый интерфейс адаптера
3. Добавьте фабрику в `base/factory.js`
4. Обновите конфигурацию в `config/servers.js`

Занимаюсь реализацией tg webapp под la2.
Посмотрел как реализовано в большинстве web (обвязок) глаза вывалились.

Минусы реализации адаптеров в нынешних web:

Сильная связанность классов - система построена на наследовании вместо композиции, что снижает гибкость. Постоянно что-то наследуется, что создает жесткую зависимость между адаптерами разных серверов.
Избыточное дублирование кода - многие методы повторяются с минимальными изменениями в разных адаптерах, вместо повторного использования общей логики.
Отсутствие единого интерфейса - хотя существуют интерфейсы IProxy, разные адаптеры имеют несогласованные методы и сигнатуры.
Сложная иерархия наследования - трудно отследить, где реализована конкретная логика, из-за многоуровневого наследования и делегирования.
Нет централизованной обработки ошибок - каждый адаптер обрабатывает ошибки по-своему, что затрудняет поддержку и отладку.
Несогласованное именование - методы для одинаковых операций называются по-разному в разных адаптерах.
Жесткая привязка к конкретным таблицам БД - адаптеры тесно связаны с конкретными названиями таблиц и полей, что затрудняет поддержку новых версий серверов.

Преимущества подхода в Node.js:

Четкая иерархия - все адаптеры наследуются от BaseAdapter, который определяет общий интерфейс.
Фабричный метод - использование createAdapter в factory.js для динамического создания нужного адаптера.
Единообразная обработка ошибок - более последовательный подход к обработке ошибок.
Более чистый код - лучшая структура и меньше дублирования за счет наследования от базового класса.
Четкое разделение ответственности - каждый адаптер отвечает только за специфику конкретного типа сервера.

В целом, реализация адаптеров в Node.js выглядит более современной и поддерживаемой, с лучшими практиками проектирования, чем те, что используются в нынешних (обвязках).

Bankir · 24 Мар 2025

Нету Мобиуса, L2J - грусть, печаль (Бразилы бы, монумент бы построили за такое))).

А в целом, из шары, такое мало кто сразу в продакшн вкинет такое.

Zion [🌿] · 24 Мар 2025

Я даже не понимают что это и для чего нужно

Prizmo · Вторник в 04:11

Bankir написал(а):
Нету Мобиуса, L2J - грусть, печаль (Бразилы бы, монумент бы построили за такое))).

А в целом, из шары, такое мало кто сразу в продакшн вкинет такое.

Это всего лишь пример моей реализации и не более.
Если есть кодеры которым интересно, они допилят под себя.
Могу добавить и l2j была бы структура БД... Если есть желание помочь, дам доступы - залей интересующие тебя БД. Я сделаю и прд них.

Zion [🌿] написал(а):
Я даже не понимают что это и для чего нужно

Давайте объясню простыми словами, что делают адаптеры:

Адаптеры - это "переводчики" между приложениями и разными серверами игры:
- Каждый сервер (Acis, PWsoft, Lucera) хранит данные по-своему
- Адаптер знает, как "говорить" с конкретным сервером

Пример:

JavaScript:

// Хотим получить информацию об игроке
const player = await adapter.getCharacterDetails(123);

// Адаптер сам разберется как получить эти данные:
// - У Acis они в одной таблице
// - У PWsoft в другой
// - У Lucera в третьей

Главное преимущество:
- Пишем код один раз
- Работает со всеми серверами
- Если сервер недоступен - адаптер использует кэш
Представьте что это как универсальная зарядка:
- Один провод
- Работает с разными телефонами
- Не нужно думать о различиях

Теперь где бы мы ни использовали адаптер, он сам разберется как получить нужные данные с конкретного сервера.

Zion [🌿] · Вторник в 11:35

Prizmo написал(а):
Это всего лишь пример моей реализации и не более.
Если есть кодеры которым интересно, они допилят под себя.
Могу добавить и l2j была бы структура БД... Если есть желание помочь, дам доступы - залей интересующие тебя БД. Я сделаю и прд них.

Давайте объясню простыми словами, что делают адаптеры:

Адаптеры - это "переводчики" между приложениями и разными серверами игры:

Каждый сервер (Acis, PWsoft, Lucera) хранит данные по-своему

Адаптер знает, как "говорить" с конкретным сервером

Пример:

JavaScript:

// Хотим получить информацию об игроке const player = await adapter.getCharacterDetails(123); // Адаптер сам разберется как получить эти данные: // - У Acis они в одной таблице // - У PWsoft в другой // - У Lucera в третьей

Главное преимущество:

Пишем код один раз

Работает со всеми серверами

Если сервер недоступен - адаптер использует кэш

Представьте что это как универсальная зарядка:

Один провод

Работает с разными телефонами

Не нужно думать о различиях

Теперь где бы мы ни использовали адаптер, он сам разберется как получить нужные данные с конкретного сервера.

Вроде бы полезная штука, но в то же время, если всю информацию можно получить и без неё, получается, что это просто костыль для костыля. Не представляю, зачем это использовать, но за шару лайк.

Prizmo · Вторник в 11:48

Zion [🌿] написал(а):
Вроде бы полезная штука, но в то же время, если всю информацию можно получить и без неё, получается, что это просто костыль для костыля. Не представляю, зачем это использовать, но за шару лайк.

Костыль?
Вот то, что используют сейчас, это костыли...
Быстрее, безопаснее, более гибкая система и т.д. и т.п.
Это как раз таки решение кучи костылей... Которые дают лишнюю нагрузку и кучу SQL иньекций...

Prizmo · Вторник в 13:09

Спасибо участникам за помощ с BD La2j mobius
Немного доработал. Добавил поддержку всех версий mobius и прикрепил документацию.

Адаптеры серверов Lineage 2

Дополнительные настройки

Prizmo

Путник

Вложения

Oleksandr Volodymyrovych

Bankir

Знающий

Zion [🌿]

Постоялец

Prizmo

Путник

Zion [🌿]

Постоялец

Prizmo

Путник

Prizmo

Путник

Вложения

Похожие темы