# 🎮 ИНСТРУКЦИЯ ДЛЯ ДЕТЕЙ И РОДИТЕЛЕЙ

## 📱 ДЛЯ ДЕТЕЙ (простыми словами)

### **ШАГ 1: Скачай архив** 📦
1. Открой сайт: **steam-craft.ru/download**
2. Нажми большую кнопку **"СКАЧАТЬ КЛИЕНТ"**
3. Сохрани файл `steamcraft-client.zip` на Рабочий стол

### **ШАГ 2: Распакуй** 📂
1. Найди файл `steamcraft-client.zip` на Рабочем столе
2. **Windows:** Нажми правой кнопкой → "Извлечь всё..."
3. **Mac:** Просто двойной клик
4. Появится папка `steamcraft-client`

### **ШАГ 3: Запусти игру** 🚀
1. Открой папку `steamcraft-client`
2. **Windows:** Двойной клик на `START.bat`
3. **Mac:** Двойной клик на `START.command`
4. Подожди 1-2 минуты (первый запуск дольше)

### **ШАГ 4: Подключись к серверу** 🌍
1. В главном меню нажми **"Сетевая игра"**
2. Нажми **"Добавить сервер"**
3. Впиши:
   - **Название:** SteamCraft
   - **Адрес:** `steam-craft.ru`
4. Нажми **"Готово"**
5. Выбери сервер и нажми **"Подключиться"**

### **Готово!** 🎉
Ты на сервере! Найди NPC и начни квесты!

---

## 👨‍👩‍👧 ДЛЯ РОДИТЕЛЕЙ

### **Системные требования**
- **Windows 10/11** или **macOS 10.15+**
- **4 GB RAM** (лучше 8 GB)
- **2 GB свободного места**
- **Стабильный интернет** (10+ Мбит/с)

### **Безопасность**
- ✅ Все моды проверены на вирусы
- ✅ Сервер модерируется
- ✅ Нет встроенных покупок
- ✅ Закрытое сообщество

### **Первый запуск может быть долгим**
- Первый запуск: **2-5 минут**
- Загрузка мира: **30-60 секунд**
- Последующие запуски: **быстрее**

### **Если что-то не работает:**
1. Проверьте антивирус (добавьте в исключения)
2. Проверьте брандмауэр (разрешите Java)
3. Перезапустите компьютер
4. Напишите в поддержку: sul@steam-craft.ru

---

## 🖥️ СПОСОБ 2: TLAUNCHER

### **Если у вас уже установлен TLauncher:**

#### **ШАГ 1: Установи Fabric**
1. Открой TLauncher
2. Выбери версию **1.20.1**
3. Нажми на иконку **"Установить Forge/Fabric"**
4. Выбери **Fabric Loader 0.16.10**
5. Нажми **"Установить"**

#### **ШАГ 2: Скопируй моды**
1. Скачай **только папку mods**: `steamcraft-mods.zip`
2. Найди папку `.minecraft` (в TLauncher есть кнопка)
3. Открой папку `mods` внутри
4. Скопируй все файлы из архива в эту папку

#### **ШАГ 3: Запусти игру**
1. В TLauncher выбери версию **1.20.1-fabric**
2. Нажми **"Войти в игру"**
3. Готово!

---

## 🎨 НАСТРОЙКА ПРОИЗВОДИТЕЛЬНОСТИ

### **Компьютер слабый? (Лагает)**

1. **В игре нажми ESC → Настройки → Настройки видео**
2. Измени:
   - **Дальность прорисовки:** 8 чанков
   - **Плавное освещение:** Выкл
   - **Частицы:** Минимум
   - **Графика:** Быстрая
   - **Облака:** Выкл
   - **VSync:** Выкл

3. **Установи Sodium (опционально):**
   - Мод для оптимизации
   - Скачай с [Modrinth](https://modrinth.com/mod/sodium)
   - Положи в папку `mods`

### **Компьютер мощный? (Хочу красиво)**

1. **В игре нажми ESC → Настройки → Настройки видео**
2. Измени:
   - **Дальность прорисовки:** 16-32 чанка
   - **Графика:** Красивая
   - **Плавное освещение:** Макс
   - **VSync:** Вкл (если есть разрывы картинки)

3. **Установи шейдеры (опционально):**
   - Скачай [Iris Shaders](https://modrinth.com/mod/iris)
   - Скачай шейдерпак (BSL, ComplementaryShaders)
   - Положи в папку `shaderpacks`

---

## ⚙️ НАСТРОЙКА ПАМЯТИ (ВАЖНО!)

### **Если игра вылетает с ошибкой памяти:**

#### **Вариант 1: Через файл START.bat (Простой)**
1. Найди файл `START.bat` в папке клиента
2. Нажми правой кнопкой → "Изменить"
3. Найди строку: `java -Xmx4G`
4. Измени цифру:
   - **4 GB RAM:** `-Xmx2G`
   - **8 GB RAM:** `-Xmx4G`
   - **16 GB RAM:** `-Xmx6G`
5. Сохрани и закрой

#### **Вариант 2: Через TLauncher**
1. Открой TLauncher
2. Настройки → Настройки Java
3. Найди "Выделение памяти"
4. Установи:
   - **Min:** 512 MB
   - **Max:** 4096 MB (или 6144 MB)
5. Сохрани

---

## 🎮 УПРАВЛЕНИЕ В ИГРЕ

### **Основные клавиши:**
- **W/A/S/D** - движение
- **Пробел** - прыжок
- **Shift** - присесть
- **E** - инвентарь
- **Q** - выбросить предмет
- **F5** - вид от третьего лица
- **F3** - отладочная информация

### **Специальные клавиши Create:**
- **Alt** - открыть меню очков (goggle overlay)
- **Shift + ПКМ** - настройка механизмов

### **Система квестов:**
- **L** - открыть книгу квестов
- **Правый клик по NPC** - получить квест

### **Карта:**
- **M** - большая карта
- **Y** - точка назначения
- **U** - убрать миникарту

---

## 🔄 ОБНОВЛЕНИЕ КЛИЕНТА

### **Когда выходит обновление:**
1. Скачай новую версию `steamcraft-client-vX.X.zip`
2. **Сохрани настройки** (необязательно):
   - Скопируй папку `config` из старого клиента
   - Скопируй папку `options.txt`
3. Удали старую папку клиента
4. Распакуй новую версию
5. Вставь сохранённые настройки (если копировал)

### **Как узнать о обновлениях:**
- На сайте: **steam-craft.ru**
- В Discord сервера
- Уведомление при входе на сервер

---

## ❗ ЧАСТЫЕ ОШИБКИ

### **"Java not found" или "Не найдена Java"**
**Решение:**
1. Скачай Java 21: https://adoptium.net/temurin/releases/?version=21
2. Установи (Next → Next → Install)
3. Перезапусти компьютер
4. Попробуй снова

### **"Connection refused" или "Не удалось подключиться"**
**Решение:**
1. Проверь адрес: должно быть `steam-craft.ru`
2. Проверь интернет
3. Проверь версию (должна быть 1.20.1)
4. Сервер может быть на обслуживании (зайди на сайт)

### **"Outdated client" или "Устаревшая версия"**
**Решение:**
1. Ты используешь неправильную версию Minecraft
2. Должна быть **1.20.1**
3. Переустанови клиент

### **"Mod mismatch" или "Несовпадение модов"**
**Решение:**
1. На сервере обновились моды
2. Скачай новую версию клиента
3. Не добавляй свои моды!

### **Чёрный экран при запуске**
**Решение:**
1. Подожди 2-3 минуты
2. Если не помогло - закрой и запусти снова
3. Обнови драйверы видеокарты

### **Игра лагает / низкий FPS**
**Решение:**
1. Уменьши дальность прорисовки
2. Выключи VSync
3. Закрой другие программы
4. Смотри раздел "Настройка производительности" выше

---

## 📞 КОНТАКТЫ ПОДДЕРЖКИ

**Техническая поддержка:**
- Email: sul@steam-craft.ru
- Discord: [ссылка на Discord]
- Сайт: steam-craft.ru

**Вопросы по игре:**
- Спроси игроков на сервере
- Прочитай `/help` в чате
- Найди NPC с вопросительным знаком

---

## 📜 ПРАВИЛА СЕРВЕРА

1. ❌ Не читить
2. ❌ Не гриферить чужие постройки
3. ❌ Не оскорблять других игроков
4. ❌ Не спамить в чат
5. ✅ Помогай новичкам
6. ✅ Будь вежливым
7. ✅ Получай удовольствие!

**За нарушения:**
- 1-е нарушение: предупреждение
- 2-е нарушение: мут/кик
- 3-е нарушение: бан

---

## 🎓 ПОЛЕЗНЫЕ СОВЕТЫ

### **Для новичков:**
1. Прочитай книгу квестов (клавиша `L`)
2. Поговори со всеми NPC на спавне
3. Используй JEI для просмотра рецептов
4. Не стройся далеко от спавна (первое время)
5. Попроси помощи в чате

### **Для продвинутых:**
1. Изучи Create механизмы в Creative режиме
2. Используй чертежи (Schematics) для копирования
3. Автоматизируй фермы
4. Создавай сложные производственные цепочки
5. Помогай новичкам на спавне

---

🎮 **Приятной игры!** ⚙️

**Если что-то непонятно - пиши в поддержку!**  
Мы всегда рады помочь! 😊
