Markdown · 203 lines · 6.5 KB
# Установка ScriptsLab
## Быстрая установка
1. **Остановите сервер**
```bash
stop
```
2. **Замените JAR файл**
- Удалите старый `plugins/ScriptsLab-1.0.0.jar` (если есть)
- Скопируйте новый `target/ScriptsLab-1.0.0.jar` в папку `plugins/`
3. **Запустите сервер**
```bash
start
```
## Проверка установки
После запуска сервера вы должны увидеть в логах:
```
[ScriptsLab] ╔═══════════════════════════════════════╗
[ScriptsLab] ║ ScriptsLab v1.0.0 ║
[ScriptsLab] ║ Your Minecraft Scripting Lab ║
[ScriptsLab] ╚═══════════════════════════════════════╝
[ScriptsLab] ✓ Core services initialized
[ScriptsLab] ✓ Commands registered
[ScriptsLab] ╔═══════════════════════════════════════╗
[ScriptsLab] ║ ScriptsLab - Ready! ║
[ScriptsLab] ╚═══════════════════════════════════════╝
```
## Тестирование
### 1. Проверьте команды
В игре или консоли выполните:
```
/scriptslab info
```
Вы должны увидеть информацию о плагине.
### 2. Проверьте список модулей
```
/module list
```
### 3. Проверьте список скриптов
```
/script list
```
## Структура папок
После первого запуска ScriptsLab создаст следующую структуру:
```
plugins/
└── ScriptsLab/
├── config.yml # Основная конфигурация
├── messages.yml # Сообщения плагина
├── scripts/ # Ваши JavaScript скрипты
│ └── examples/ # Примеры скриптов
├── modules/ # Модули плагина
│ └── demo/ # Демо-модуль
└── data/ # Хранилище данных
```
## Создание первого скрипта
1. Создайте файл `plugins/ScriptsLab/scripts/hello.js`:
```javascript
// Регистрируем команду
plugin.registerCommand('hello', function(sender, args) {
sender.sendMessage('§aПривет, ' + sender.getName() + '!');
});
Console.log('Скрипт hello.js загружен!');
```
2. Перезагрузите скрипты:
```
/script reload
```
3. Используйте команду:
```
/hello
```
## Исправление ошибок
### Ошибка: "Console.log is not defined"
**Решение**: Обновите плагин до последней версии. В новой версии `Console.log()` работает корректно.
### Ошибка: "Script engine not initialized"
**Решение**:
1. Проверьте, что используете Java 17+
2. Убедитесь, что в `config.yml` параметр `scripts.enabled: true`
3. Перезапустите сервер
### Предупреждение: "JVMCI is not enabled"
**Это нормально!** GraalVM работает в режиме интерпретатора. Для лучшей производительности можно:
1. Установить GraalVM JDK
2. Добавить флаг JVM: `-XX:+EnableJVMCI`
Но это не обязательно для работы плагина.
## Конфигурация
### config.yml
Основные настройки:
```yaml
scripts:
enabled: true # Включить скриптовый движок
auto-reload: true # Автоматическая перезагрузка при изменении
timeout: 5000 # Таймаут выполнения скрипта (мс)
max-memory: 128 # Максимальная память на скрипт (МБ)
modules:
auto-load: true # Автозагрузка модулей
enabled-modules: # Список включённых модулей
- demo
storage:
provider: yaml # Провайдер хранилища (yaml/json/sqlite)
cache-enabled: true # Включить кэширование
```
## Обновление
Для обновления плагина:
1. Остановите сервер
2. Сделайте резервную копию папки `plugins/ScriptsLab/`
3. Замените JAR файл
4. Запустите сервер
5. Проверьте логи на наличие ошибок
## Удаление
Для полного удаления плагина:
1. Остановите сервер
2. Удалите `plugins/ScriptsLab-1.0.0.jar`
3. Удалите папку `plugins/ScriptsLab/` (если хотите удалить все данные)
4. Запустите сервер
## Поддержка
- **Документация**: [README.md](README.md)
- **Сборка**: [BUILD.md](BUILD.md)
- **Архитектура**: [ARCHITECTURE.md](ARCHITECTURE.md)
## Требования
- **Сервер**: Paper 1.20.4+ (или Purpur/Pufferfish)
- **Java**: 17 или выше
- **RAM**: Минимум 2GB рекомендуется
- **Диск**: ~50MB для плагина + зависимостей
## Совместимость
✅ **Совместимо с:**
- Paper 1.20.4+
- Purpur 1.20.4+
- Pufferfish 1.20.4+
❌ **Не совместимо с:**
- Spigot (используйте Paper)
- CraftBukkit (используйте Paper)
- Bukkit (используйте Paper)
## Производительность
ScriptsLab оптимизирован для производительности:
- Асинхронная загрузка скриптов
- Кэширование данных
- Ленивая загрузка модулей
- Потокобезопасные операции
**Типичное использование ресурсов:**
- Загрузка: ~3-5 секунд
- Память: ~100-200MB (зависит от количества скриптов)
- CPU: Минимальное влияние
---
**Готово! Теперь вы можете использовать ScriptsLab! 🚀**