Главная

PowerShell

Разработка плагинов с использованием PowerShell.

Следуйте инструкции

1. Создайте папку с названием в виде имени будущего плагина

2. В данной папке (далее в гайде просто main_folder)

{main_folder} = main_folder. Все переменные в гайде обозначаются в фигурных скобках.

3. Создайте следующую структуру файлов:

{main_folder}\main.manifest
{main_folder}\main.ps1

4. В файл main.manifest (текстовый файл манифеста плагина с надстройками) вставьте следующий текст:

chat_action_type = 1
message_type = 1
arguments_count = 0
plugin_type = 0

Описание

chat_action_type - тип действия, которое будет написано в чате во время работы файла

Значения

  • 0 - ничего не писать

  • 1 - "Бот набирает сообщение..".

message_type - тип возвращаемого сообщения в Telegram бота

Значения

  • 0 - Текстовое сообщение

  • 1 - Текстовое сообщение с поддержкой HTML форматирования

  • 2 - Ничего не возвращать

arguments_count - количество обязательных принимаемых аргументов плагина от пользователя

Значения

  • От 0 до 4

plugin_type - тип плагина, для PowerShell это "0"

5. Основной код необходимо написать в файле main.ps1 (файл кода написанный для PowerShell). Можно создать и редактировать с помощью Windows PowerShell ISE, который встроен в Windows.

Если Вы хотите использовать русский язык в каких-то фрагментах кода, то редактируйте файл в Notepad++ в кодировке UTF-8. Также, можно редактировать файла в Windows PowerShell ISE, а после сохранения изменить кодировку в Notepad++.

6. Вставьте в файл main.ps1 следующий код:

#app {plugin_name}, Version="{plugin_version}", Author={author}, Command={call_command}

function MainFunc($arg1, $arg2, $arg3, $arg4) {
	"Привет Мир! 3+4 = " + 3+4
}

7. Заполните данные (всё без пробелов):

  • {plugin_name} - название плагина, такое же как для {main_folder}

  • {plugin_version} - версия в формате x.x.x.x, где x - число (например: 1.0.0.4)

  • {author} - автор плагина

  • {call_command} - команда для вызова плагина (обязательно начинается с /), например: /hello

Должно получиться что-то похожее: #app HelloWorld, Version="1.0.0.0", Author=developer, Command=/hello

Данная строка является обязательной для файла плагина!

8. Создайте zip архив с папкой {main_folder} (рекомендую воспользоваться архиватором 7-Zip со сжатием Нормальное)

Нужно заархивировать не саму папку, а её содержимое!

9. Переименуйте файл в {main_folder} и измените расширение архива на srp

10. Установите файл через Shark Remote

11. Тестируйте!

PreviousРазработка плагиновNextLua

Last updated