ModGate

English Description

ModGate - Strict Mod Verification System

🔒 Enforce perfect mod synchronization between your server and clients!

ModGate is a powerful Fabric mod that provides strict mod verification for Minecraft servers. It ensures that all players connecting to your server have exactly the right mods with the correct versions and file integrity.

✨ Key Features

• 🔐 Strict Mod Verification: Uses SHA-256 hashing to verify mod integrity and versions
• 🚫 No Extra Mods Policy: Players cannot have additional mods not approved by the server
• ⚡ Mandatory Client Mod: Players without ModGate are automatically kicked after 10 seconds
• 🎨 Custom Disconnect Screen: Beautiful interface showing detailed mod status with checkmarks, crosses, and version information
• 📊 Version Tracking: Displays current vs required mod versions with detailed tooltips
• 🔄 Hot Reload: Server configuration can be reloaded without restart
• 📤 Easy Setup: Auto-generation and export/import commands for quick server setup

🛠️ How It Works

1. Client Connection: When a player joins, ModGate requests their mod list
2. Hash Verification: Client generates SHA-256 hashes of all mods and sends to server
3. Strict Checking: Server verifies each mod's hash and version against the configuration
4. Extra Mod Detection: Any mods not in the server's list are flagged as forbidden
5. Custom Screen: If verification fails, players see a detailed screen showing exactly what's wrong
6. Tooltip System: Hover over mods to see current vs required versions and status

📋 Commands

Server Commands (OP level 2+):

• /modgate reload - Reload configuration
• /modgate export - Export current mod list to config file
• /modgate import - Import mod list from config file
• /modgate list - Show current required mods

Client Commands:

• /modgate-client export - Export client mod list for server setup

⚙️ Configuration Format

ModGate uses a JSON configuration with version and hash tracking:

[
    {
        "fabric-api": {
            "version": "0.92.2+1.21.1",
            "hash": "sha256hash..."
        }
    },
    {
        "jei": {
            "version": "15.2.0.27", 
            "hash": "sha256hash..."
        }
    }
]

🚀 Quick Setup

1. Install ModGate on both server and all clients
2. Setup mods on a reference client with all desired mods
3. Run client - auto-generates modgate-cli/mod_list.json
4. Copy file to server as config/modgate_export.json
5. Import on server: /modgate import then /modgate reload
6. Done! All players will be verified against this mod list

💡 Perfect For

• Modded servers requiring exact mod synchronization
• Server administrators who want to prevent mod inconsistencies
• Competitive servers where mod fairness is crucial
• Whitelisted communities with specific mod requirements

🔧 Technical Details

• Dependencies: Fabric API
• Network timeout: 1 seconds
• Hash algorithm: SHA-256

ModGate eliminates the frustration of mod version mismatches and ensures a consistent experience for all players on your server!

Russian Description

ModGate - Система Строгой Проверки Модов

🔒 Обеспечьте идеальную синхронизацию модов между сервером и клиентами!

ModGate - это мощный мод для Fabric, который обеспечивает строгую проверку модов для серверов Minecraft. Он гарантирует, что все игроки, подключающиеся к вашему серверу, имеют точно правильные моды с корректными версиями и целостностью файлов.

✨ Ключевые Возможности

• 🔐 Строгая Проверка Модов: Использует SHA-256 хеширование для проверки целостности и версий модов
• 🚫 Запрет Лишних Модов: Игроки не могут иметь дополнительные моды, не одобренные сервером
• ⚡ Обязательный Мод на Клиенте: Игроки без ModGate автоматически кикаются через 10 секунд
• 🎨 Кастомный Экран Отключения: Красивый интерфейс с детальным статусом модов - галочки, крестики и информация о версиях
• 📊 Отслеживание Версий: Показывает текущие против требуемых версий модов с детальными подсказками
• 🔄 Горячая Перезагрузка: Конфигурация сервера может быть перезагружена без перезапуска
• 📤 Лёгкая Настройка: Автогенерация и команды экспорта/импорта для быстрой настройки сервера

🛠️ Как Работает

1. Подключение Клиента: Когда игрок заходит, ModGate запрашивает его список модов
2. Проверка Хешей: Клиент генерирует SHA-256 хеши всех модов и отправляет на сервер
3. Строгая Проверка: Сервер проверяет хеш и версию каждого мода против конфигурации
4. Обнаружение Лишних Модов: Любые моды не в списке сервера помечаются как запрещённые
5. Кастомный Экран: При ошибке проверки игроки видят детальный экран с точным описанием проблем
6. Система Подсказок: Наведите на мод чтобы увидеть текущую против требуемой версии и статус

📋 Команды

Серверные Команды (OP уровень 2+):

• /modgate reload - Перезагрузить конфигурацию
• /modgate export - Экспортировать текущий список модов в файл конфигурации
• /modgate import - Импортировать список модов из файла конфигурации
• /modgate list - Показать текущие требуемые моды

Клиентские Команды:

• /modgate-client export - Экспортировать список модов клиента для настройки сервера

⚙️ Формат Конфигурации

ModGate использует JSON конфигурацию с отслеживанием версий и хешей:

[
    {
        "fabric-api": {
            "version": "0.92.2+1.21.1",
            "hash": "sha256hash..."
        }
    },
    {
        "jei": {
            "version": "15.2.0.27", 
            "hash": "sha256hash..."
        }
    }
]

🚀 Быстрая Настройка

1. Установите ModGate на сервер и все клиенты
2. Настройте моды на эталонном клиенте со всеми нужными модами
3. Запустите клиент - автогенерируется modgate-cli/mod_list.json
4. Скопируйте файл на сервер как config/modgate_export.json
5. Импортируйте на сервере: /modgate import затем /modgate reload
6. Готово! Все игроки будут проверяться против этого списка модов

💡 Идеально Для

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

🔧 Технические Детали

• Зависимости: Fabric API
• Сетевой таймаут: 1 секунда
• Алгоритм хеширования: SHA-256

ModGate устраняет фрустрацию от несовпадений версий модов и обеспечивает консистентный опыт для всех игроков на вашем сервере!