Ми раді представити одне з найбільших комплексних оновлень офіційного веб-сайту XMCL! За останні два коміти сайт отримав масштабний редизайн ключових компонентів, розширення мовної підтримки до 22 локалей, новий кіберпанк-центр документації та значні покращення стабільності й продуктивності.

Нижче детально розповідаємо про всі ключові нововведення, покращення архітектури та деталі реалізації.


1. Новий інтерактивний центр документації (Documentation Hub) ​

Розділ документації отримав повне візуальне та функціональне переосмислення у фірмовому технічному dark-стилі XMCL:

Новий центр документації XMCL

Основні покращення: ​

  • Кіберпанк-естетика технічної специфікації: Темна палітра з акцентними відтінками терміналу, тонкими лініями сітки та моноширинними бейджами створюють відчуття роботи зі справжнім системним пультом керування.
  • Термінальний пошуковий рядок query-docs: Зручне поле введення командного типу з підтримкою глобальної гарячої клавіші Ctrl + K.
  • Швидкі фільтри-прапорці (Quick Flags): Клік на прапорці на зразок --install, --modloaders, --together, --ai-models, --p2p-lan, --custom-skins чи --diagnostics миттєво фільтрує необхідні посібники.
  • Чітка модульна структура:
    • 01 / Getting Started — встановлення, оновлення, автономний режим, вхід Microsoft та перенесення накопичувачів.
    • 02 / Game Management & Mods — ізоляція інстансів, завантажувачі модів, налаштування теми й CSS, геймпади Big Picture та інтеграція штучного інтелекту.
    • 03 / Multiplayer & Diagnostics — XMCL Together, P2P LAN для гри без білих IP, криміналістика збоїв та аналіз логів.
  • Розширені посібники з інтеграції AI: Додано докладні інструкції з підключення вбудованого помічника Agnes AI, хмарних провайдерів (Google Gemini, OpenAI GPT) та локальних моделей через Ollama та LM Studio.

2. Глобальне мовне розширення: 22 локалі та повна локалізація Features ​

XMCL об'єднує гравців з усього світу. Ми значно розширили мовне покриття, додавши підтримку 6 нових популярних мов:

  • 🇹🇷 Турецька (tr) — повний переклад інтерфейсу, гайдів та каталогу можливостей.
  • 🇻🇳 В'єтнамська (vi) — повноцінна в'єтнамська локалізація.
  • 🇮🇳 Гінді (hi) — розширена підтримка для індійської спільноти.
  • 🇧🇩 Бенгалі (bn) — адаптація документації та налаштувань.
  • 🇮🇩 Яванська (jv) — автентичний переклад для індонезійського регіону.
  • 🐱 LOLCAT (lol) — фірмовий гумористичний котячий діалект для фанатів Minecraft (Mod Boss, World Map & Chunk Slicer, Built-in AI Robo-Cat!).

Повний переклад каталогу можливостей та локалізація

Повний переклад каталогу можливостей (Features): ​

Всі 22 картки можливостей, категорії, статус-бейджи та елементи інтерфейсу перекладено для кожної нової мови без заглушок чи пропусків.


3. Редизайн селектора мов та панелі навігації ​

Замість звичайного випадаючого списку реалізовано повноцінне модальне вікно вибору локалі:

Новий селектор мов із чистими векторними прапорами

Що змінилося: ​

  • Швидкий пошук мови: Поле пошуку миттєво фільтрує 22 мови за назвою (рідною або англійською) чи кодом країни.
  • Векторні прапори у форматі SVG: Замість операційних емодзі чи текстових плашок використано чіткі векторні прапори, що ідеально виглядають на екранах будь-якої роздільної здатності.
  • Збереження поточної сторінки: При перемиканні мови селектор зберігає поточний розділ і шлях, не скидаючи користувача на головну сторінку.
  • Клавіатурна навігація: Підтримка швидкого закриття через Escape та плавна фокусування.
  • Естетичні роздільники в меню: Роздільники верхнього меню вирівняно з математичною симетрією (висота 22px) із приємним неоновим підсвічуванням у темній темі.

4. Оновлення блогу та розумна маршрутизація мов ​

Спеціальний бічний віджет для української локалі

  • Єдиний глобальний доступ: Вкладка блогу тепер безперешкодно доступна з усіх 22 мовних версій сайту.
  • Пріоритет українських статей: Для відвідувачів української та російської версій сайту автоматично показуються українськомовні статті з прозорим переходом до оригіналу за потреби.
  • Бічне віконце для української версії: На сторінці українського блогу додано акуратне бічне віконце UA + GB ДВОМОВНІ МАТЕРІАЛИ, яке інформує читачів про те, що частина статей публікується українською мовою, а частина — в оригіналі англійською.
  • Локалізовані підказки рідною мовою: Для користувачів інших мов (німецької, французької, іспанської, китайської, турецької тощо) інформаційний банер виводиться саме їхньою рідною мовою.
  • Чистий інтерфейс на англійській: На англомовній версії зайві сповіщення автоматично приховано, оскільки всі матеріали доступні рідною для версії мовою.

5. Оптимізація швидкодії та усунення технічного боргу ​

  • Прискорення Largest Contentful Paint (LCP): Прибрано початкову анімацію непрозорості (opacity: 0) на головному банері та додано fetchpriority="high" до ключових зображень, що дозволило зменшити затримку завантаження сторінки до мінімуму.
  • Очищення консолі розробника: Вимкнено відправку телеметрії Application Insights на локальному середовищі (усунено помилки 400).
  • Виправлено попередження [intlify]: Всі виклики useI18n переведено на глобальний контекст { useScope: 'global' }.

Дякуємо всім за підтримку проекту! Якщо ви хочете допомогти з перекладом на інші мови або запропонувати покращення — долучайтеся до нашого репозиторію на GitHub.