Inventory Checker Mod

Мод для Minecraft Fabric, который отслеживает наличие определённых предметов в инвентаре и отправляет уведомления через Telegram, когда предмет заканчивается.

A Minecraft Fabric mod that monitors specific items in your inventory and sends Telegram notifications when items run out.

🌟 Features / Особенности

🔔 Smart Notifications / Умные уведомления

• Telegram Integration - Get instant notifications in Telegram
• Smart Detection - Monitors main inventory, hotbar, and offhand

Интеграция с Telegram - Мгновенные уведомления в Telegram
Умное обнаружение - Отслеживает основной инвентарь, горячую панель и левую руку

⚙️ Easy Configuration / Простая настройка

• JSON Config - Easy-to-edit configuration file
• In-Game Commands - Full control without restarting
• Hot Reload - Reload configuration on the fly

JSON конфигурация - Простой для редактирования файл настроек
Команды в игре - Полный контроль без перезапуска игры
Горячая перезагрузка - Обновление конфигурации на лету

🛡️ Security & Stability / Безопасность и стабильность

• Data Protection - Sensitive information is masked in commands
• Input Validation - All configuration parameters are validated
• Error Handling - Comprehensive error handling and logging

Защита данных - Чувствительная информация маскируется в командах
Проверка входных данных - Все параметры конфигурации проверяются
Обработка ошибок - Комплексная обработка ошибок и логирование

📥 Installation / Установка

Requirements / Требования

• Minecraft 1.20+
• Fabric Loader
• Fabric API

Installation Steps / Шаги установки

1. Download the latest release from [Releases Page]
2. Place the mod file in your mods folder
3. Start Minecraft to generate configuration file
4. Configure your settings in config/inventorychecker.json

Шаги установки:

1. Скачайте последнюю версию со [страницы релизов]
2. Поместите файл мода в папку mods
3. Запустите Minecraft для генерации файла конфигурации
4. Настройте параметры в config/inventorychecker.json

⚙️ Configuration / Настройка

Configuration File / Файл конфигурации

The mod will create config/inventorychecker.json on first launch:

Мод создаст config/inventorychecker.json при первом запуске:

{
  "telegramBotToken": "YOUR_BOT_TOKEN_HERE",
  "telegramChatId": "1721979788",
  "targetItem": "minecraft:bone_meal",
  "enabledByDefault": false
}

Setting Up Telegram / Настройка Telegram

1. Create a bot with @BotFather
2. Get your bot token
3. Start a chat with your bot
4. Get your chat ID using @userinfobot
5. Replace the values in configuration file

Настройка Telegram:

1. Создайте бота через @BotFather
2. Получите токен бота
3. Начните чат с вашим ботом
4. Получите ваш chat ID через @userinfobot
5. Замените значения в файле конфигурации

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

Commands / Команды

All commands are available via /checker:

Все команды доступны через /checker:

Command / Команда	Description / Описание
/checker start	Start inventory monitoring Запустить мониторинг инвентаря
/checker stop	Stop inventory monitoring Остановить мониторинг инвентаря
/checker status	Show monitoring status Показать статус мониторинга
/checker reload	Reload configuration Перезагрузить конфигурацию
/checker config	Show current configuration Показать текущую конфигурацию

Example Usage / Пример использования

/checker start      # Start monitoring / Запустить мониторинг
/checker status     # Check status / Проверить статус
/checker reload     # Reload config / Перезагрузить настройки

🔧 Supported Items / Поддерживаемые предметы

The mod supports any item in Minecraft. Use the format namespace:item_id:

Мод поддерживает любые предметы в Minecraft. Используйте формат пространство_имён:идентификатор_предмета:

🛠️ Technical Details / Технические детали

Monitoring Scope / Область мониторинга

• Main inventory (27 slots) / Основной инвентарь (27 слотов)
• Hotbar (9 slots) / Горячая панель (9 слотов)
• Offhand (1 slot) / Левая рука (1 слот)

Security Features / Функции безопасности

• Token Masking - Bot tokens are masked in command output
• Input Validation - All inputs are validated and sanitized
• Rate Limiting - Notification cooldown prevents spam

Маскировка токенов - Токены ботов маскируются в выводе команд
Проверка входных данных - Все входные данные проверяются и очищаются
Ограничение частоты - Задержка уведомлений предотвращает спам

❓ Troubleshooting / Решение проблем

Common Issues / Частые проблемы

Notifications not working / Уведомления не работают:

• Check bot token and chat ID in configuration
• Ensure the bot is started with /start
• Verify internet connection

Проверьте токен бота и chat ID в конфигурации
Убедитесь, что бот запущен командой /start
Проверьте подключение к интернету

Configuration errors / Ошибки конфигурации:

• Use correct item format: minecraft:item_name
• Chat ID must contain only digits
• Bot token must be valid

Используйте правильный формат предметов: minecraft:название_предмета
Chat ID должен содержать только цифры
Токен бота должен быть действительным

Logs / Логи

Check Minecraft logs for detailed error information:

Проверьте логи Minecraft для детальной информации об ошибках:

logs/latest.log

🔗 Links / Ссылки

• Fabric MC
• Issue Tracker