Name History

💜 Name History

---

Внимание: этот мод в основном сгенерирован с помощью ИИ, так как мне было лень, но я хочу сообщить об этом своим пользователям.

Красивый современный мод для Minecraft для просмотра истории ников игроков

---

✨ Возможности

🎨 Красивый интерфейс

• Современная фиолетовая цветовая схема, приятная для глаз
• Полностью настраиваемые цвета — меняйте любой аспект темы под свой стиль
• Предпросмотр цветов в реальном времени в меню настроек с сеточной раскладкой

🔍 Мощный поиск

• Команды в чате — быстрый поиск через /namehistory <username|uuid>
• Автодополнение игроков — автодополнение по Tab для ников игроков онлайн
• Кэшированные результаты — быстрые повторные запросы с настраиваемым временем кэширования
• Умное определение — автоматически определяет, ищете вы по нику или UUID

⚙️ Гибкая настройка

• Интеграция с ModMenu — простая настройка через ModMenu
• API-эндпоинт — подключение к любому совместимому API истории ников
• Необязательная аутентификация — поддержка API-ключа для приватных серверов
• Настраиваемые таймауты — регулировка таймаута запроса и времени кэширования
• Сеточная раскладка — упорядоченная настройка цветов в 2 колонки

🚀 Начало работы

Установка

1. Установите Fabric Loader
2. Скачайте и установите Fabric API
3. Скачайте и установите Fabric Language Kotlin
4. Скачайте последнюю версию Name History
5. Поместите файл .jar в папку .minecraft/mods
6. Запустите Minecraft!

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

Команды:

/namehistory <username|uuid>  # Посмотреть историю ников игрока (с автодополнением по Tab)
/namehistory update <query>   # Принудительно обновить кэшированные данные
/namehistory delete <query>   # Удалить запись из кэша

Примеры:

/namehistory Notch
/namehistory 069a79f4-44e9-4726-a5be-fca90e38aaf5
/namehistory update jeb_

Совет: нажмите Tab после /namehistory , чтобы автодополнить ник из игроков онлайн!

⚙️ Настройка

При первом запуске мод создаёт файл конфигурации по пути config/namehistory-client.json.

Конфигурация по умолчанию

{
  "baseUrl": "https://liforra.de/api/namehistory",
  "requestTimeoutMs": 8000,
  "cacheTtlMinutes": 10,
  "apiKey": "",
  "apiKeyHeader": "X-API-Key",
  "primaryColor": "#9b59d0",
  "secondaryColor": "#b388ff",
  "specialColor": "#ce93d8",
  "errorColor": "#ff6090",
  "disabledColor": "#9e9e9e"
}

Параметры конфигурации

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

Если у вас установлен ModMenu:

1. Нажмите "Mods" в главном меню
2. Найдите "Name History" в списке
3. Нажмите кнопку настроек
4. Настройте цвета, нажимая на цветные квадратики предпросмотра!

🔧 Сборка из исходников

Требования

• Java 21 или выше
• Git

Шаги сборки

git clone https://github.com/liforra/namehistory-minecraft.git
cd namehistory-minecraft
./gradlew build

Скомпилированный мод будет в build/libs/name-history-0.1.0.jar.

🌐 Совместимость с API

Этот мод работает с любым API, реализующим следующие эндпоинты:

📄 Полная документация API

• Спецификация OpenAPI: openapi.yaml
• Подробная документация: API.md

Формат ответа

{
  "uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
  "query": "Notch",
  "history": [
    { "id": 1, "name": "Notch", "changedAt": null, "censored": false }
  ]
}

💡 Совет: используйте спецификацию OpenAPI для генерации клиентских библиотек или серверных заглушек.

📸 Скриншоты

🎨 Графика и атрибуция

• Фиолетовая иконка, используемая в этом проекте, является изменённой производной от icon.png из проекта "fabric-name-history-lookup" от Woolyenough
  (Copyright © 2022 Woolyenough), лицензированного под MIT License.
• Оригинальный репозиторий: https://github.com/Woolyenough/fabric-name-history-lookup
• Изменения: перекраска в фиолетовый, удаление стебля, центрирование глифа, и незначительные пиксельные правки под тему.

Этот проект включает текст лицензии MIT и уведомление об авторских правах для этого ресурса в ICON_NOTICE.txt.

Одобрение оригинального автора не подразумевается.

📝 Лицензия

Этот проект лицензирован под GNU Affero General Public License v3.0 (AGPL-3.0).
Подробности см. в LICENSE.

Сторонние компоненты:

• Производная иконки: работа под MIT от Woolyenough (см. ICON_NOTICE.txt).

🤝 Участие

Вклад приветствуется! Не стесняйтесь:

• Сообщать об ошибках
• Предлагать новые функции
• Отправлять пул-реквесты
• Улучшать документацию

💖 Благодарности

• Создано с помощью Fabric
• Написано на Kotlin
• Вдохновлено потребностью в красивом, современном просмотрщике истории имён

Сделано с 💜 от liforra