SScript

SScript — язык скриптов для сервера Minecraft

SScript — это лёгкий язык программирования для автоматизации сервера Minecraft. Пиши скрипты в синтаксисе, похожем на Python/Lua, чтобы выполнять команды, автоматизировать задачи и управлять поведением сервера без правок Java-кода.

Что он умеет

Основное назначение: выполнять автоматические команды и логику на твоём сервере Minecraft.

• 🎯 Выполнение команд — запускай команды программно (/say, /give, /setblock и т.д.)
• ⚙️ Автоматизация задач — скрипты инициализации, задачи по расписанию, массовые операции
• 🔧 Логика сервера — реагируй на действия игроков (вход/выход, чат, ломание блоков, смерти, сон)
• 📝 Простой синтаксис — язык в стиле Python, который освоит любой
• ⚡ Без блокировок — задачи выполняются, не подвешивая сервер

Быстрый старт

1. Создай скрипт в sscripts/boom.ss:

log "BOOM SPAWN!"

func boom():
    run "fill 10 50 10 -10 90 -10 air destroy"
    # boom! >:3
end

boom()

2. Создай обработчик событий в sscripts/handlers.event.ss:

on player_join(player):
    run "say " + player.name + " joined"
    run "execute at " + player.name + " run fill ~10 50 ~10 ~-10 90 ~-10 air"
end

on player_chat(player, message):
    log player.name + ": " + message
end

3. Загрузи и запусти:

/sscript run boom.ss
/sscript debug on
/sscript debug off - no spam [Server]: ...

Готово! Скрипты выполняются без перезапуска.

Возможности языка

• Переменные и типы: строки, числа, булевы значения, списки, объекты
• Управляющие конструкции: if/elif/else, for, while, try/catch
• Функции: объявляй через func или def, вызывай синхронно или асинхронно
• События: реагируй на действия игроков и события сервера
• Встроенные функции: 60+ функций для игроков, блоков, математики, строк, файлов
• Асинхронность: фоновые задачи с ключевым словом wait

Команды

Запуск скриптов и управление выполнением:

/sscript run <file>                    # Выполнить скрипт
/sscript run <file> function <name>    # Вызвать конкретную функцию
/sscript monitor [all|<id>| ]            # Просмотр запущенных задач
/sscript stop [all|<id>|<file>]               # Остановить задачу
/sscript reload [all|<id>|<file>]             # Перезапустить задачу
/sscript debug [on|off]                # Вкл/выкл вывод отладки сервера

Документация

📖 Полная документация с примерами и справочником API:

• English: docs/en
• Русский: docs/ru

Что ещё?

Помимо выполнения команд, SScript умеет:

• 📊 Хранить данные — глобальные переменные сохраняются между перезапусками (globals.json)
• 📡 HTTP-запросы — получать данные из API или отправлять вебхуки
• 💾 Работа с файлами — чтение/запись файлов и JSON
• 🎮 Данные игроков — доступ к здоровью, игровому режиму, координатам, NBT-данным
• 🏷️ Система тегов — организуй игроков с помощью кастомных тегов
• 🔍 Селекторы — динамические запросы к игрокам (@a[tag=admin], @a[distance=..100])

Производительность

• ⚡ Безопасно для тиков — задачи автоматически распределяются по тикам сервера, чтобы избежать лагов
• 🔄 Без блокировок — обработчики событий выполняются асинхронно (не подвешивают игру)
• 💪 Лимиты — максимум 500 процессов, 20 запусков/тик, 50 инструкций/тик

Требования

• Java 21+
• Fabric Loader 0.14+
• Minecraft 1.21.11

Установка

1. Скачай JAR-файл мода
2. Положи в папку mods/
3. Запусти сервер
4. Помести скрипты в sscripts/

Пример: логирование чата

# sscripts/chat_logger.event.ss

func log_chat(player_name, message):
    file_mkdirs("sscripts/logs")
    line = "[" + player_name + "] " + message
    file_append("sscripts/logs/chat.log", line + "\n")
end

on player_chat(player, message):
    log_chat(player.name, message)
end

Ссылки

• Документация: docs
• Исходный код: GitHub AI generation Description D: