Проба пера

Не под ребро

После того как вы установили плагин на свой сервер, внутри папки /plugins/ будет создана папка /Skript/. В ней находятся ваши собственные скрипты, сохраненные переменные и настройки самого плагина. Сейчас нас не совсем интересуют настройки и переменные, хранящиеся в таблице .csv, поэтому попробуем перейти сразу к написанию чего-либо (а зачем медлить?)

Шаг №1

Выберем текстовый редактор. Чтобы начать создавать код своими умелыми ручками нам необходим текстовый редактор. Если у вас уже есть любимый - используйте его (Microsoft Word не подойдёт), но если нет - возьмите любой из списка ниже:

Шаг №2

Создадим файл, где мы будем воплощать IT-художества. Заходим в директорию /plugins/Skript/scripts/, создаем внутри файл (название не важно, но постарайтесь использовать только латиницу и цифры) с расширением .sk - Например myfirstscript.sk Теперь откройте файл в текстовом редакторе.

Шаг №3

Перейдём к воплощению IT-художеств. Skript – это событийно-ориентированный язык, то есть, чтобы что-то выполнилось, должно произойти какое-то событие. Под событием имеется ввиду действие пользователя или самого сервера, так вот начало нашего блока кода должно начинаться с необходимого нам события. Структура блока кода в Skript:

%название события или описание функции%:
  <- #Обязательный отступ после ':', из-за него интерпретатор 
     #понимает внутри какого блока мы работаем
  ваш код...

Отступом может быть 2 пробела, 4 пробела или 1 нажатие клавиши TAB. В одном файле не могут быть использованы разные виды отступов. Выберите тот, который удобен именно вам. Отступы используются не только при объявлении функций или использования события, но вам пока что об этом знать рано, поймете в процессе чтения данной документации В данном примере мы возьмем простое и понятное событие ‘on load’, которое происходит при загрузке файла скрипта, в котором находится данное событие.

on load:
  здесь будет наш код...

Теперь мы можем добавить выражение для вывода текста для всех, это выражение broadcast
Синтакс этого выражения: broadcast %objects% [(to|in) %worlds%] Немного разберем как в документации пишется синтакс:

Все что заключено в проценты % % обозначает тип данных который может использоваться в выражении (в нашем случае это тип Object, что обозначает абсолютно любой тип данных

Внутри % % так же может присутствовать символ /, он используется для перечисления определенных типов внутри выражения, которые могут быть к нему применены

Все что заключено в квадратные скобки [ ] означает, что это не обязательная часть выражения, она может быть, а может не быть (на усмотрение разработчика) (в нашем случае, можно дополнительно указать в каких мирах конкретно нужно выводить сообщение)

Скобки ( ) используются для изменения приоритета (объединения в один блок), словно в математике, сначала будет считываться то, что внутри, а только потом все, что вне

Знак | означает ИЛИ (в нашем случае “(to|in)” в скобки взяты два слова to и in, между ними |, следовательно при написании можно использовать как broadcast %objects% in %worlds% или broadcast %objects% to %worlds%, оба варианта будут рабочими в коде)

Теперь мы можем попробовать вывести какой-то текст на сервере:

on load:
  broadcast "Hello World!"

Так же, в Skript, можно писать комментарии - те участки кода, которые будут пропускаться при запуске файла скрипта. Обычно их используют для пояснений, что делает та или иная часть программы, для заметок и другого. Комментарий обозначается решеткой в начале строки '#' Например:

#Код ниже передает привет миру при запуске этого скрипта
on load:
  broadcast "Hello World!"

Шаг №4

Теперь изучим основные команды плагина Skript. Главная команда: /skript или просто /sk Подкоманды: /skript reload (путь до скрипта|config|all) – перезагружает определенный файл, конфиг или все сразу /skript enable (путь до скрипта|all) – включает определенный скрипт или все сразу /skript disable (путь до скрипта|all) – отключает определенный скрипт или все сразу /skript info – выводит информацию о плагине и текущих установленных дополнениях /skript update – проверяет наличие новых версий плагина /skript help – пишет то, что было описано выше

Кроме этого вы можете включать и выключать целые директории со скриптами. Например у нас есть есть некая папка /main/, в которой находятся файлы скрипта, мы можем быстро включить, выключить или перезагрузить их просто указав директорию: /sk reload main/

Шаг №5

Теперь перезагрузим созданный нами файл: /sk reload НазваниеСкрипта
Если вы выполнили все шаги верно – в чат напишется ‘Hello World!’