English version
# Passport Mod v1.0.3
## ChangeLog 0.1

**Private Responses:** All responses during passport creation are visible only to you

**Cancel Anytime:** Command `/отмена` or `/cancel` cancels the creation process

## ⏳ **Cooldown System (Key Feature)**
- **Individual Timers:** Each field has its own separate 20-minute cooldown
- **First Change Free:** After creation, each field can be changed once without cooldown
- **Optimized Cache:** Caching system to reduce server load
- **Change Tracking:** System remembers the last change time for each field

## 💾 **Saving System**
- **Auto-Save:** Data is saved to `passports.dat` file every 5 minutes
- **Safe Saving:** Uses temporary files to prevent data loss
- **Load on Login:** Passports are automatically loaded when joining the server
- **Cross-Platform:** Works in both singleplayer and multiplayer servers

Player Commands

/паспорт - 

show your passport (2s cache)

/паспорт создать - 

start passport creation

/паспорт изменить <field> <value> - 

change passport data

/паспорт показать - 

show to nearby players

/паспорт показать <player> - 

show to specific player

/паспорт инфо - 

passport information (5s cache)

/паспорт кулдауны - 

show change timers (5s cache)

/паспорт отменить - 

cancel creation

/паспорт помощь - 

command help

🔧 Admin commands ()

/апаспорт- clear system cache
/апаспорт статус - system status
/apassport посмотреть <player> - view another player's passport
/apassport удалить <player> - delete player's passport
/apassport создать <player> <name> - create template passport
/apassport изменить <player> <field> <value> - change player's passport
/apassport resetcooldown <player> <field/all> - reset cooldown
/apassport восстановить - repair your passport
/apassport директория - save directory information

## 🎮 **Gameplay Features**
- **Welcome Message:** Each player receives a message about their passport status upon joining
- **Reminder System:** If no passport exists, reminder appears after 30 seconds
- **Public Announcements:** Passport creation is announced in chat for all players
- **Visual Display:** Passports are displayed in beautifully formatted text

## 🛡️ **Anti-Abuse Protection**
- **Command Caching:** Protection against command spam (2-5 seconds between uses)
- **Data Validation:** Verification of input data correctness
- **Automatic Cleanup:** Caches cleared when player leaves
- **Integrity Check:** Automatic data integrity verification on load

## ⚙️ **Technical Features**
- **Full Fabric API Integration:** Uses standard Fabric hooks
- **Multithreading:** Periodic saving in separate thread
- **NBT Storage:** Data stored in Minecraft NBT format
- **Detailed Logging:** Comprehensive logging for debugging
- **Memory Management:** Automatic cache and resource cleanup

## 🌍 **Language Support**
- **Russian Interface:** All commands and messages in Russian
- **English Equivalents:** Support for English commands (/cancel instead of /отмена)

## 🏆 **Purpose of this Mod**
1. **Roleplaying (RP):** Creating unique characters with backstories
2. **Server Economy:** Passport as required document for accessing features
3. **Social Interaction:** Ability to share character information
4. **Long-Term Progression:** Gradual character evolution with cooldowns

## 📊 **System Statistics**
The mod provides administrators with complete statistics:
- Number of created passports
- Data saving status
- Save directory information
- Cached data

Русская версия
Passport Mod v1.0.1

ChangeLog 0.1

• Приватные ответы: Все ответы во время создания видны только вам

• Отмена в любой момент: Команда /отмена или /cancel прерывает создание

⏳ Система кулдаунов (ключевая особенность)

• Индивидуальные таймеры: Каждое поле имеет свой отдельный кулдаун 20 минут

• Первое изменение бесплатно: После создания можно один раз изменить каждое поле без кулдауна

• Оптимизированный кэш: Система кэширования для снижения нагрузки

• Отслеживание изменений: Система запоминает время последнего изменения каждого поля

💾 Система сохранения

• Автосохранение: Данные сохраняются в файл passports.dat каждые 5 минут

• Безопасное сохранение: Используется временный файл для предотвращения потери данных

• Загрузка при входе: Паспорта автоматически загружаются при входе на сервер

• Кроссплатформенность: Работает как на одиночной игре, так и на сервере

👤 Команды для игроков

/паспорт - показать свой паспорт (кэш 2с)
/паспорт создать - начать создание паспорта
/паспорт изменить <поле> <значение> - изменить данные
/паспорт показать - показать nearby игрокам
/паспорт показать <игрок> - показать конкретному игроку
/паспорт инфо - информация о паспорте (кэш 5с)
/паспорт кулдауны - показать таймеры изменений (кэш 5с)
/паспорт отменить - отменить создание
/паспорт помощь - справка по командам

🔧 Административные команды (требуют уровень 2)

/апаспорт очиститькэш - очистить кэш системы
/апаспорт статус - статус системы паспортов
/апаспорт посмотреть <игрок> - посмотреть чужой паспорт
/апаспорт удалить <игрок> - удалить паспорт игрока
/апаспорт создать <игрок> <имя> - создать шаблонный паспорт
/апаспорт изменить <игрок> <поле> <значение> - изменить паспорт игрока
/апаспорт сброситькулдаун <игрок> <поле/all> - сбросить кулдаун
/апаспорт восстановить - восстановить свой паспорт
/апаспорт директория - информация о директории сохранения

🎮 Игровой процесс

• Приветствие при входе: Каждому игроку показывается сообщение о статусе паспорта

• Напоминание: Если паспорт не создан, через 30 секунд появляется напоминание

• Публичные уведомления: Создание паспорта анонсируется в чате для всех игроков

• Визуальное отображение: Паспорт отображается в красивом форматированном виде

🛡️ Защита от злоупотреблений

• Кэширование команд: Защита от спама командами (2-5 секунд между вызовами)

• Валидация данных: Проверка корректности вводимых данных

• Автоматическая очистка: Кэши очищаются при выходе игрока

• Проверка целостности: Автоматическая проверка целостности данных при загрузке

⚙️ Технические особенности

• Полная интеграция с Fabric API: Использует стандартные хуки Fabric

• Многопоточность: Периодическое сохранение в отдельном потоке

• NBT-сохранение: Данные хранятся в Minecraft NBT-формате

• Логирование: Детальное логирование для отладки

• Управление памятью: Автоматическая очистка кэшей и ресурсов

🌍 Поддержка языков

• Русский интерфейс: Все команды и сообщения на русском языке

• Английские аналоги: Поддержка английских команд (/cancel вместо /отмена)

🏆 Для чего этот мод?

1. Ролевая игра (RP): Создание уникальных персонажей с историей

2. Экономика сервера: Паспорт как обязательный документ для доступа к возможностям

3. Социальное взаимодействие: Возможность делиться информацией о персонаже

4. Долгосрочный прогресс: Постепенное изменение персонажа с кулдаунами

📊 Статистика системы

Мод предоставляет администраторам полную статистику:

• Количество созданных паспортов

• Статус сохранения данных

• Информация о директории сохранения

• Кэшированные данные