cubenet_mod_core/QUICKSTART_RU.md
2025-11-22 16:49:58 +03:00

72 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 📄 Бумажный Предмет - Быстрый Старт
## Что было добавлено?
Новая система размещаемых предметов, основанная на `Paper1.bbmodel`:
### 🎮 Как использовать:
1. **Получить предмет**: Откройте Creative Tab "CubeNet" → найдите "Paper Item"
2. **Разместить блок**: Нажмите ПКМ на земле с предметом в руке
3. **Открыть меню**: Зажмите **Shift + ПКМ** на разместённый блок
4. **Настроить параметры**:
- Левые 3 ползунка → **Ротация** (-180 до +180°)
- Правые 3 ползунка → **Масштаб** (0.1x до 5.0x)
- Нижние 3 ползунка → **Смещение** (-1.0 до +1.0)
5. **Закрыть**: Нажмите **ESC**
### 🎨 Управление ползунками:
- **Левая кнопка мыши + перетаскивание** = изменение значения
- **Колесо мыши (при наведении)** = быстрое изменение
- **Ползунки обновляют блок в реальном времени**
### 💾 Сохранение:
Все параметры автоматически сохраняются в мировые данные блока!
---
## 📁 Что было создано:
### Java классы (486 строк кода):
- `PaperBlock` - основной блок
- `PaperBlockEntity` - данные и логика
- `PaperItem` - предмет
- `PaperBlockScreen` - меню конфигурации
- `FloatSlider` - ползунок для чисел
- `ClientEvents` - клиентские события
- `CubeNetCore` - обновлён для регистрации
### Ресурсы:
- Текстуры (block + item)
- JSON модели
- Локализация (EN + RU)
- Конфиги блока
### Сборка:
**BUILD SUCCESSFUL** - проект готов к использованию!
---
## 🔧 Технические детали:
| Параметр | Диапазон | Назначение |
|----------|----------|-----------|
| Rotation X/Y/Z | -180 to +180 | Поворот по осям |
| Scale X/Y/Z | 0.1 to 5.0 | Размер блока |
| Offset X/Y/Z | -1.0 to +1.0 | Смещение позиции |
**Версия**: Minecraft 1.21.1 + NeoForge 21.1+
---
## 📖 Локализация:
✅ English (en_us.json)
✅ Русский (ru_ru.json)
---
**Система готова! 🚀**