🗺️ l2-ultimate-database

Интерактивная база знаний для Game Master'ов и игроков Lineage 2

🖥️ Демо

Живая демонстрация: https://iso-hallow.github.io/l2-ultimate-database

📌 О проекте

L2 Ultimate Database — это веб-приложение-шпаргалка для администраторов и игроков серверов Lineage 2. Инструмент помогает быстро находить GM команды, горячие клавиши, ID предметов и координаты.

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

Функция	Описание
🤖 Генератор команд	Интерактивные поля ввода для команд с аргументами
⭐ Избранное	Сохранение часто используемых команд с экспортом/импортом
🔍 Быстрый поиск	Фильтрация по названию, команде или описанию
🌓 Темы оформления	Тёмная и светлая тема на выбор
🌐 Локализация	Русский и английский языки
📱 Адаптив	Работает на ПК, планшетах и смартфонах

📱 Особенности работы на планшетах и смартфонах

Проект изначально разрабатывался с учётом мобильного использования. Почему это важно:

Ситуация	Как помогает
Вы не за компьютером, а сервер "летит"	Открыли телефон → нашли команду → скопировали → отправили в чат/коллеге
Администрируете с планшета	Кнопки крупные, не мажете мимо, текст читается без зума
Быстро нужно подсмотреть ID предмета	Правый сайдбар всегда под рукой, копируется в один клик
Поделиться командой в чате	Скопировали готовую команду с аргументами — вставили в Telegram/Discord

Что адаптировано:

• ✅ Сетка команд превращается в одну колонку на узких экранах
• ✅ Кнопки копирования достаточно крупные для пальцев
• ✅ Панель категорий скроллится горизонтально (не ломает верстку)
• ✅ Шрифты не меньше 14px на мобилках
• ✅ Нет элементов, требующих точного наведения мышью

На телефоне: просто промотайте вниз до конца — там будут вкладки Items, Skills, Locs, Classes.

На планшете: если очень нужно — переверните в горизонтальный режим или откройте на десктопе.

Совет: Добавьте сайт на главный экран телефона (Chrome → "Установить приложение") — будет выглядеть как нативное приложение без адресной строки.

📱 Как это выглядит на разных устройствах:

• 🖥️ Десктоп: (1024px+) | Три колонки: категории | команды | быстрые данные
• 📟 Планшет: (768-1024px) | Две колонки: категории | команды (панель скрыта но можно паменять)
• 📱 Телефон: (до 768px) | Одна колонка: быстрые данные внизу

📚 Что внутри

• 50+ GM команд с генератором синтаксиса
• SQL-запросы | 9 | Для администрирования базы данных (с ⚠️ предупреждениями)
• Голосовые команды (.cfg) | 6 | Панель настроек, ремонт персонажа, привязка аккаунта
• 15+ горячих клавиш для игроков и администраторов
• 8+ координат ключевых локаций
• ID предметов (Адена, свитки, GM вещи)
• ID скиллов (Haste, Might, Empower и др.)
• ID классов (все профессии до Maestro)
• Шпаргалки (уровни GM, формулы заточки)

⚠️ Статус проекта: НЕЗАВЕРШЁННЫЙ (BETA)

Проект находится в активной разработке. Многие функции и данные ещё не добавлены, добавлено только то, что нужно было лично мне. Вы можете использовать то, что уже есть, но будьте готовы к:

• Отсутствию некоторых команд (особенно для хроник High Five и Classic)
• Неполной базе ID предметов и NPC
• Возможным ошибкам в синтаксисе команд

Чего нет	Почему
Команды для High Five	Изначально работал с Interlude
Команды для Classic / Essence	Требуют отдельного исследования
Полная база ID всех NPC	Слишком много, добавляйте сами под свои нужды
Готовые макросы для тестов	В планах, но не срочно
Фильтр по хроникам	Хочу сделать, но пока не приоритет
Тёмная тема	✅ Уже есть
Подтверждение опасных команд	TODO, чтобы случайно не забанить весь сервер

🤔 "Если на сервере другие команды?"

Стандартный синтаксис L2J — один для всех. Но если у вас кастом:

1. Откройте index.html в блокноте
2. Найдите массив db (там где команды)
3. Добавьте свою команду или измените существующую

// Пример добавления кастомной команды
{ 
  id: "my_cmd", 
  cat: "admin_base", 
  type: "admin", 
  cmd: "//mycommand", 
  args: [{n:"arg", v:"value"}], 
  ru: "Моя команда", 
  en: "My command" 
}

🔧 Расширяемость

Проект спроектирован так, чтобы легко дополнять его под свои нужды. Всё, что нужно знать — находится в одном файле index.html.

Как добавить свою команду

// Найдите массив db в коде и добавьте объект:
{ 
  id: "my_cmd", 
  cat: "admin_base",           // категория
  type: "admin",               // admin / player / voice / hotkey / info
  cmd: "//mycommand",          // сама команда
  args: [{n:"arg1", v:"value"}], // аргументы (можно пустой массив)
  ru: "Описание на русском", 
  en: "Description in English" 
}

Как добавить ID предмета / скилл

// Найдите массив dbItems:
{ id: "12345", ru: "Название", en: "Name" }

// Чтобы добавить предмет:
dbItems.push({ id: "99999", ru: "Название", en: "Name" });

// Чтобы добавить скилл:
dbSkills.push({ id: "9999", ru: "Название", en: "Name" });

🖥️ Демо

// Найдите массив dbLocs:
{ id: "x y z", ru: "Название", en: "Name" }

// Чтобы добавить координаты:
dbLocs.push({ id: "x y z", ru: "Название", en: "Name" });

Как добавить категорию

1. Добавьте новую категорию в массив cats в функции renderCategories
2. Добавьте перевод в объект i18n для обоих языков

// В i18n.ru и i18n.en:
cat_mycategory: "📁 Моя категория"

🚀 Быстрый старт для локальной разработки

Клонируйте репозиторий

git clone https://github.com/ваш-username/l2-ultimate-database.git

# Перейдите в папку проекта
cd l2-ultimate-database

# Откройте index.html в браузере
# Или используйте live-server:
npx live-server

📁 Структура данных

db              // Основная база команд
├── admin_base      // Базовые GM команды
├── admin_spawn     // Спавн и предметы
├── admin_player    // Управление игроками
├── admin_clan      // Кланы и сервер
├── voice           // Голосовые команды (.cfg)
├── sql             // SQL-запросы для БД
├── player_social   // Чаты и общение
├── player_actions  // Действия и макросы
├── hotkeys         // Горячие клавиши
└── info            // Шпаргалки

dbItems         // ID предметов
dbSkills        // ID скиллов (с уровнями)
dbLocs          // Координаты
dbClasses       // ID классов

🤔 "Как это работает без интернета?"

Скачайте index.html на телефон/планшет и откройте в браузере. Всё будет работать локально. Данные (команды, ID) зашиты прямо в файл.

📝 Возможные планы по развитию (TODO)

Добавить все команды для хроники High Five

Расширить базу ID NPC и боссов

Добавить раздел "Готовые макросы" для быстрых тестов

Сделать фильтрацию по хроникам (Interlude/High Five/Classic)

Добавить горячие клавиши GM панели (Alt+G и др.)

Расширить раздел "Координаты" всеми городами и данжами

Добавить подтверждение опасных команд (//shutdown и т.п.)

---

📜 Источники данных

Все команды и ID собраны из открытых источников:

Документация L2J

Форумы MMO-dev и L2J.ru

Опыт реальной администрации серверов

⚠️ Важно: Проект не нарушает авторские права. Все данные являются общедоступной информацией о стандартном синтаксисе команд.

📄 Лицензия MIT — свободно для использования и модификации.

⭐ Поставьте звезду, если проект оказался полезным!