Туториал [VarScript 0.5] Использование команд

-----------------------------------------------------
Разработка плагина
Плагин на dev.bukkit.org
-----------------------------------------------------

Приступим!

Исполнение команд

Основная команда для запуска скриптов выглядит так:
/> <набор команд>
На данный момент существует более 600 команд (точное количество можно узнать по команде />c )
К примеру рассмотрим команду TELEPORT.
Справку по этой команде можно получить с помощью />c TELEPORT

тут:
alias - другие формы записи команды. т.е. мы можем использовать просто TP вместо TELEPORT
tags - к каким тегам относится команда. О тегах - ниже.
input - входящие параметры. Что нужно указать для исполнения команды
output - что мы получим в результате исполнения этой команды
Последняя строка - описание команды. Да, она всего лишь телепортирует любой объект из одного места в другое.

команда TELEPORT требует указать два агрумента:
1 - Entity (кого телепортируем)
2 - Location (куда телепортируем)
Агрументы указываются строго в указанном порядке и перед командой.
Например:

эта команда телепортирует игрока Notch к игроку frоmgаtе.

а эта - телепортирует вас на 10 блоков вверх.


Стековая система команд

Итак, представим себе массив, в котором лежат некоторые объекты.
[A,B,C]
Мы можем либо добавить объект в конец массива:
[A,B,C] + D -> [A,B,C,D]
либо забрать последний элемент из него:
[A,B,C] -> [A,B] + C
другие операции с этим массивом недопустимы.
Такой массив далее будет называться стеком.

Рассмотрим эту запись:

Она состоит из трех команд, которые исполняются последовательно.
ME - кладет в стек игрока, который исполняет команду.
[] + Player -> [ Player ]
0:10:0 - кладет в стек вектор (смещение) на 10 блоков вверх.
[ Player ] + 0:10:0 -> [ Player, 0:10:0 ]
TELEPORT - берет из стека два объект телепортации и пункт назначения, а затем кладет обратно в стек результат.
[ Player, 0:10:0 ] -> [] + Player + 0:10:0 ## команда читает 2 элемента
## происходит телепортация первого ко второму, т.е. игрока на 10 блоков вверх
[] + Player -> [ Player ] ## команда возвращает в стек игрока
Больше команд нет - на этом исполнение завершается.

Таким образом получается, что эти две команды эквивалентны:


Только во втором случае в стеке будут лежать лишние неиспользуемые строки "foo" и "bar"

Конвертирование типов

Опять же рассмотрим справку по команде TELEPORT

типы входных значений команды - это Entity и Location.

Когда мы вызываем команду

при исполнении команды TELEPORT у нас в стеке лежат объекты типа String (строка)
[ String, String]
которые команда преобразует к желаемому типу.
Преобразования (String->Entity) и (String->Location) происходят автоматически по заранее установленным правилам:
String("Notch")->Entity : Найти игрока с именем Notch.
String("frоmgаtе")->Location : Найти игрока с именем frоmgаtе и узнать его координаты

Для второго примера:

при телепортации в стеке лежат Player и Vector
[ Player, Vector]
Player->Entity : нет необходимости, т.к. Player и так является Entity
Vector->Location : посчитать смещение от позиции игрока, который вызвал команду.

Правил для конвертирования очень много, вплоть до таких:
Block->ItemStack - взять предмет из материала, из которого состоит блок
Player->ItemStack - взять предмет, который в руках у игрока
Entity->Integer - взять идентификатор моба (EntityID)
String->World - взять мир по названию
Player->String - берет имя игрока
Entity->String - берет тип моба
И одгомная туча других.
Integer->Entity - найти моба по указанному идентификатору

Просмотр значений

для просмотра значений в стеке используется команда PRINT

Отсюда видно, что команда берет из стека объект совершенно любого типа, и ничего не кладет обратно. В результате она просто печатает объект на экране.
Попробуем выполнить команду /> ME PRINT и получим что-то вроде этого:


Команда полезна, когда нужно узнать, что осталось в стеке или же вывести на экран значение переменной.

Список всех команд

Ввиду того, что команд слишком много, они все имеют теги для поиска.
Например, команда PRINT имеет теги stack, string, print.
Чтобы посмотреть список всех тегов, нужно ввести команду
/>t

Тут мы видим перечисление всех возможных тегов.
Далее, чтобы найти все команды, относящиеся к выбранному тегу, нужно ввести
/>t тег

Теперь на экране список всех команд, относящихся к тегу.
И наконец, для получения справки команда
/>c команда

Узнаем, что эта команда изменяет размер слизня на любой указанный.
PS: да, я заметил опечатку на скрине выше, и уже пофиксил.

На этом всё. Если будут какие-то замечания или дополнения - я их внесу в данный туториал.

В теме были рассмотрены некоторые команды плагина VarScript 0.5, устройство стековой обработки команд, конвертер типов а также навигация по командам и способ получения справки.

Далее:
-----------------------------------------------------
Туториал: Переменные. Чтение скрипта из файла
-----------------------------------------------------

 

В чём смысл плагина?

 

Это essentials 2000

 

Я нечего не понял Но лайк дам

 

Я не ради лайков туторы пишу, а в надежде, что кто-то разберется с плагином.

 

Что-то интересное. Не слышал о таком плагине, спасибо!

 

Хммм...интересненько! Как приеду, то подробнее просмотрю плагин!

 

Я кааапельку разбираюсь в программировании(хорошо изучил(и продолжаю) "основы" программирования парадигмы и прочее, учу Java, начинаю учить php), и я скажу:
Плагин невероятно, офигезно, опупительно МЕГАТУРБООХРЕНЕННЫЙ!! Спасибо автору.

 

О, новенькая версия.

 

Наоборот, сам Нотч почтил тебя своим визитом

 

fromgate,
ОПН заключается в том, что название функции (действие или операнд) пишется после параметров. Сами параметры не меняются местами. Т.е. "5 3 -" будет как "minus(5,3)" в прямой нотации, или же "5-3" в привычном виде.

------------------------------------------

Не знаю, стоит ли расширять синтаксис с выходом 1.7
С одной стороны, появится большая куча новых классов, методов, всего прочего - было бы неплохо добавить соответствующие варскриптовые команды. Не пользоваться же ::рефлексиями
А с другой - есть груви. Как бы я ни старался - любое решение на груви выйдет проще и изящнее. Не говоря уже о быстродействии. Даже Nashorn (менее гибкий движок) - тоже неплох.

 

Естественно расширяй.

 

VarScript уже на данной стадии требует Wiki, имхо.
Разобраться в плагине без хорошего систематизированного источника информации сложно, а в условиях форума вообще нереально.

 

Тут ты прав.
Но количество пользователей варскрипта пока что не покрывает затраты на создание вики.