SimpleScripting Server-Side JavaScript для Hytale

Присоединяйтесь к нашим разногласиям, если вам нужна какая-либо проблема или помощь: раздор

Исходный код: HostTale-Project/SimpleScripting

Раскройте весь потенциал вашего сервера Hytale с помощью скриптов JavaScript!

SimpleScripting - это мощный плагин, который приносит серверные скрипты JavaScript на серверы Hytale. Создавайте пользовательские команды, обрабатывайте события плеера, создайте сложные функции и расширяйте функциональность вашего сервера, и все это без написания одной строки кода Java.

Зачем просто писать?

Java не требуется Пишите сценарии на JavaScript, одном из самых популярных языков программирования в мире. Если вы знаете базовый JavaScript, вы можете создавать функции сервера.

Hot Reload Измените свои скрипты и немедленно перезагрузите их, не перезагружая сервер. Идеально подходит для быстрой разработки и тестирования.

Аккумуляторы включены - поставляется с полным набором образцов скриптов для общих функций сервера, таких как дома, деформации, запросы на телепортацию и многое другое!

Полностью расширяемый - Комплексный API дает вам доступ к игрокам, мирам, событиям, командам, разрешениям, базам данных и планировщикам.

Ключевые особенности

Пользовательские команды

Создавайте свои собственные команды с легкостью! Поддержка:

• Необходимые и необязательные аргументы (струны, целые числа, дублеры)
• Командные псевдонимы
• Завершение вкладки
• Требования к разрешению
• Богатый формат с цветами

Система событий

Реагируйте на все, что происходит на вашем сервере:

• Игрок присоединяется / уходит - Приветственные сообщения, награды за вход
• Игровой автомат Death/Respawn - Сообщения о смерти, перезапуск
• Игровой чат - форматирование чата, фильтры, пользовательские функции чата
• Движение игроков Обнаружение региона, пограничное правоприменение
• Мировые перемены Трек игроков по измерениям
• Командное исполнение - Регистрация команд, блокировка
• Серверный тик Периодические задачи, автоматизация

Телепортационный API

Безопасная и надежная телепортация:

• Async chunk preloading (без аварий)
• Таймеры разогрева телепорта
• Поддержка положения и ротации
• Кросс-мировая телепортация

База данных API

Простое, но мощное хранилище ключей:

• Автоматически сохраняется в файлах JSON
• Хранение данных для каждого игрока
• Хранение данных по всему серверу
• Внешняя база данных не требуется

Планировщик API

Выполняйте задания на своих условиях:

• Задержка исполнения (тиксы или миллисекунды)
• Повторяющиеся задачи
• Отмена задания
• Идеально подходит для охлаждения, разминки и периодических событий

Разрешение API

Интеграция с родной системой разрешений Hytale:

• Проверьте разрешения игроков
• Требуют разрешения для команд
• Обнаружение администратора
• Узлы пользовательских разрешений для ваших сценариев

Включая образцы сценариев

SimpleScript поставляется с 8 готовых к использованию сценариев Вы можете сразу же включить:

Система домов ()Homes.js)

Позвольте игрокам установить и телепортироваться в личные места.

• /sethome [имя] - Установите местоположение дома
• /home [имя] Телепорт в дом
• /delhome <name> - Удалить дом
• /дома Перечислить все дома
• Настраиваемые домашние лимиты на ранг!

Система Варпсаwarps.js)

Серверные точки деформации для простой навигации.

• /setwarp <name> - Создать варп сервера (admin)
• /warp <name> - Телепортировать в варп
• /delwarp <name> - Удалить варп (админ)
• варп Список доступных варпов

Система Spawnspawn.js)

Центральное управление точками нереста.

• /setspawn - Установить нерест сервера (admin)
• испанец Телепорт на нерест

Телепортные запросы ()tpa.js)

Безопасная телепортация между игроками.

• /tpa <player> Запрос на телепортацию к кому-либо
• /tpahere <player> Попросите кого-нибудь телепортироваться к вам
• /paccept - Принимать поступающий запрос
• /tpdeny Отклонить входящую просьбу
• /pcancel Отмените ваш исходящий запрос
• Настраиваемый тайм-аут и охлаждение!

Обратная командаback.js)

Вернуться в предыдущие места.

• назад Вернуться в свое последнее место
• Сохраните место смерти, чтобы никогда не потерять свои вещи!
• Конфигурируемый размер истории

Случайный телепортrtp.js)

Исследуйте мир безопасно.

• rtp Телепортируйте в безопасное место
• дикий, /рандомп - Алиасы
• Конфигурируемое расстояние min/max
• Автоматическое безопасное обнаружение местоположения

Система ранжированияranks.js)

Базовое управление рангом.

• /rank set <player> <rank> - Назначьте ранг
• /rank get <player> - Проверьте ранг игрока
• Список рангов - Перечислите все ранги
• Майк - Проверьте свой ранг

Инструменты администратора (admin.js)

Основные административные команды.

• /Простая перезагрузка Горячая перезагрузка всех сценариев
• /simplescripting info - Информация о плагинах
• /tp <player> Телепортация к игроку
• /tphere <player> Телепортируйте игрока к себе
• /playerinfo <player> Просмотр деталей игрока
• / Игроки Список онлайн игроков

конфигурация

Все настройки легко настраиваются в lib/config.js:

var DEFAULTS = {
дома: {
maxHomes: 3,
охлаждать Секунды: 5,
разминка вторая: 3
?
Варпс: {
охлаждать Секунды: 5,
разминка вторая: 3
?
tpa: {
второй тайм-аут: 60,
охлаждать Секунды: 10,
разминка вторая: 3
?
rtp: {
Расстояние: 100,
Расстояние: 5000,
охлаждать Секунды: 300
?
//... и многое другое!
}

Ранговая конфигурация

Определите различные ограничения для разных рангов игроков:

var RANKS = {
По умолчанию: {
// Использует настройки по умолчанию
?
vip: {
дома: {maxHomes: 5, прохлада Секунды: 3 }
?
администратор: {
дома: {maxHomes: 10, прохлада Секунды: 0 }
?
}

Для разработчиков

Комплексный API

SimpleScripting предоставляет доступ к:

Оригинальное название: Create a Custom Command

Commands.register()
.setName ("привет")
.setDescription («Приветствую игрока»)
.addRequiredStringArg («игрок», «Игрок поприветствовать»)
.setHandler(функция(ctx) {
var target = Players.getByNameFuzzy(ctx.getArgAsString('player'));
Если (цель)
MessageHelper.send (цель, Colors.GOLD + 'Hello from' + Players.getUsername (ctx.getPlayer()) + '!');
ctx.sendMessage (Colors.GREEN + «Приветствую!»)
Другое дело {
ctx.sendMessage (Colors.RED + «Игрок не найден!»);
?
}

Пример: Слушайте события

Events.on('playerJoin', function(event))
var player = Players.getByUuid (event.playerUuid);
MessageHelper.broadcast (Colors.YELLOW + Players.getUsername (player) + "присоединился к серверу!");
}

Events.on('playerDeath', function(event))
var player = Players.getByUuid (event.playerUuid);
var loc = Players.getFullLocation (игрок);
// Сохранить место смерти для команды /back
DB.save('death_locations', event.playerUuid, JSON.stringify(loc));
}

Полезная библиотека

Включая lib/utils. js Обеспечивает полезные функции:

• Utils.getPlayer FromContext(ctx) Получить игрока из команды
• Utils.formatTime(секунды) - Формат продолжительности времени
• Utils.formatPosition(x, y, z) - Формат координат
• Utils.createCooldownTracker() Легкое управление прохладой
• Utils.teleportWithWarmup() Телепорт с обратным отсчетом

Структура каталога

Вселенная / Простое письмо
─ ─ Моды/ #Файлы JavaScript
│ │ ─ ─ lib/# Общие библиотеки (загружены первыми)
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ js #Общие утилиты
│ │ ─── config.js #конфигурация
Homes.js # Home System - Домашняя система
?????????????????????
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
─ ─ db/# Файлы базы данных (автосозданные)
─ ─ Активы / # Пакет активов (WIP - еще не доступен)
─ ─ config / # Config файлы
Языковые файлы / # Language Files
  ─ ─ ui / # UI определения

установка

1. Скачать плагин JAR
2. Поместите его на свой сервер плагины папка
3. Начните свой сервер
4. Плагин автоматически создает Universe/SimpleScripting/mods справочник
5. Образцы сценариев копируются автоматически
6. Настраивайте сценарии по своему вкусу!

Обновление сценариев

Просто отредактируйте свой .js Файлы и запустить /Простая перезагрузка - Перезагрузка сервера не требуется!

Поддержка и сообщество

Нашёл жучок? Есть запрос на функцию? Хотите поделиться своими сценариями?

• Вопросы отчета на нашем трекере проблем
• Публичное хранилище будет доступно в ближайшее время, поэтому вы можете внести свой вклад в отправку запросов Pull.