There is still a mod - option mods download system

TISAM — There Is Still A Mod

TISAM помогает авторам модпаков напоминать игрокам об опциональных модах только через официальные каналы загрузки. Извините! Дальнейшая версия заблокирована, потому что необходимая библиотека, которая сейчас разрабатывается, ожидает прохождения модерации на Modrinth.

✨ Введение

TISAM — это лёгкий, дружелюбный к правилам мод-рекомендатель для модпаков на NeoForge 1.21.1. При каждом запуске он сканирует папку mods игрока, сравнивает установленные jar-файлы с настроенным списком опциональных модов и — если чего-то не хватает — открывает небольшое, ненавязчивое окно на экране заголовка, указывающее игроку на официальную страницу загрузки. TISAM ссылается на оригинальные страницы релизов авторов модов на Modrinth, CurseForge или GitHub. Игрок может просмотреть список отсутствующих модов, ознакомиться с инструкциями по установке для каждого мода или навсегда отклонить напоминание с 5-секундной задержкой подтверждения. Создан для авторов модпаков, которым нужен слой обнаруживаемости, уважающий как лицензирование, так и свободу выбора игрока.

📖 Подробности о моде

🎯 Что он делает

При каждом запуске игры TISAM:

1. Сканирует .minecraft/mods/ и сопоставляет имена jar-файлов со списком id из вашего modules.json.
2. Вычисляет недостающий набор — рекомендуемые моды, которые игрок ещё не установил.

3. Решает, показывать ли напоминание, используя трёхуровневый фильтр:

   • Все рекомендуемые моды уже установлены? → молчание.
   • Игрок подтвердил «Больше не напоминать»? → молчание.
   • Пришло время таймера затухания напоминания? → молчание.
   • Иначе → показать небольшую карточку первого напоминания на экране заголовка.

4. Отрисовывает интерфейс напоминания с тремя кнопками:

   • Просмотреть моды — открывает прокручиваемый, сортируемый список с бейджами.
   • Напомнить позже — закрывает; увеличивает счётчик затухания.
   • Больше не напоминать — открывает предупреждение (5 с задержки) перед подтверждением.

🛠️ Возможности

• 🔍 Определение по имени файла — без парсинга манифеста, без загрузки классов; лёгкий и устойчивый к версиям (sodium-0.5.0.jar, Sodium-0.6.0-mc1.21.1.jar и т. д. — все совпадают с id: "sodium").
• 📋 Трёхшаговый внутриигровой процесс — краткое напоминание → прокручиваемый список → сворачиваемое руководство по установке с пользовательскими инструкциями.
• ⏱️ Частота напоминаний на основе затухания — reminder_frequency: [1, 1, 3, 3, 3, 7, 7, 7, 7, 15] (каждый запуск → каждый 3-й запуск → каждый 7-й → каждый 15-й), настраивается для каждого модпака.
• 🏷️ Теги приоритета — featured ★, critical ⚠, normal, optional ↓ с порядком сортировки, цветными рамками и метками.
• 🛡️ 5-секундная задержка подтверждения для предупреждения «Больше не напоминать» — предотвращает случайные нажатия.
• 🔌 Публичный API — com.tisam.api.TisamApi для интеграции других модов с TISAM.
• ⌨️ Клиентская команда — /tisam show | preview | reset для кнопок FancyMenu и отладки.
• 🧪 Режим предпросмотра — "preview": true принудительно показывает напоминание при каждом запуске для предпросмотра автором модпака, с обработкой нажатий только в памяти (ничего не записывается на диск, пока автор модпака тестирует).
• 💾 Данные только локально — всё хранится в config/tisam/preferences.json; никаких сетевых вызовов.

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

config/tisam/modules.json:

{
  "modules": [
    {
      "id": "sodium",
      "name": "Sodium",
      "description": "Современный движок рендеринга, значительно лучший FPS.",
      "license": "LGPL-3.0",
      "url": "https://modrinth.com/mod/sodium",
      "can_ignore": true,
      "priority": "critical"
    }
  ],
  "reminder_frequency": [1, 1, 3, 3, 3, 7, 7, 7, 7, 15],
  "install_guide_text": "...",
  "disclaimer_text": "...",
  "preview": false
}

config/tisam/preferences.json (управляется TISAM автоматически):

{
  "permanently_skipped": false,
  "reminder_count": 0,
  "last_reminder_date": ""
}

🚀 Быстрый старт

Игрокам:

1. Поместите There-Is-Still-A-Mod-1.0.0.jar в .minecraft/mods/.
2. Запустите игру один раз — TISAM автоматически создаст файлы конфигурации в .minecraft/config/tisam/.
3. Перезапустите. Напоминание появится, если автор вашего модпака настроил рекомендуемые моды. Авторам модпаков:
4. Включите jar-файл TISAM в ваш модпак.
5. Приложите заранее заполненный config/tisam/modules.json со списком рекомендуемых опциональных модов.
6. Установите "preview": true во время разработки, затем переключите на false для релиза.
7. (Опционально) Добавьте заявление о соответствии в описание вашего модпака.

🔐 Заявление о соответствии

TISAM распространяется под лицензией Apache-2.0. Он поставляет только свой собственный байт-код; все файлы рекомендуемых модов остаются у их оригинальных авторов. Каждая внешняя ссылка в интерфейсе напоминания ведёт на официальную страницу релиза автора мода. Авторам модпаков, включающим TISAM, следует добавить это в описание своего модпака (в любых местах): Этот модпак использует TISAM (или There Is Still A Mod) для загрузки опциональных модов.

📋 Требования

нет, кроме самой игры и NeoForge Вы можете включить этот мод в модпак