RU/MTASE

From Multi Theft Auto: Wiki
MTASElogo wiki.png
[[{{{image}}}|link=]] Примечание: Этот инструмент больше не поддерживается.


Введение

MTA Script Editor - это инструмент для Lua-скриптеров, или интегрированная среда разработки (IDE). Мы стремимся к ускорению процесса разработки ресурсов. Мы думали, что процесс создания новых ресурсов и тестирования их, будем честными, боль в заднице. Иногда даже управление ресурсами может быть немного раздражающим. Например, если Вы хотите добавить новый скрипт на Ваш ресурс, сначала надо создать файл, а затем добавить путь к файлу в meta.xml. Хуже всего, если Вы когда-нибудь забыли о добавлении файла в meta.xml, в конечном итоге ударились головой об стену, задаваясь вопросом: "Почему скрипт не работает?!". Мы хотели сделать что-то, что ускорит этот процесс, чтобы Вы могли так много сделать за такое короткое время. Предварительный просмотр таких ресурсов, как изображения и звуки, никогда не был таким простым. Мы стремимся к чему-то в соответствии с IDE Visual Studio.

Наши предложения

Мы работаем над этим инструментом довольно долгое время, но у нас был долгий перерыв из-за нехватки времени, и теперь я единственный, кто работает над этим, потому что образование важнее, чем "приятное время". Несмотря на то, что я работаю один, мы плавно продвигаемся в развитии.

Мы реализовали следующие функции:

  • Загрузка ресурсов
  • Простое управление ресурсами
  • Просмотр ресурсов, таких как звуковые и графические файлы
  • Подсветка синтаксиса Lua и XML
  • Проверка синтаксиса Lua "на лету" (в процессе написания)
  • New Resource Wizard - позволяет создавать новый ресурс несколькими щелчками мыши
  • Переключение между ресурсами
  • Вкладки для скриптов
  • C#-подобный код - полезен при работе в командах и для сохранения кода
  • Старт/стоп сервера и клиента
  • Присоединение к локальному серверу с помощью одного щелчка мыши
  • Переключение между игрой и редактором скриптов с помощью только одной клавиши на клавиатуре
  • ResourceZipper

Скриншоты

  • Main window - общий вид приложения. Справа вы можете увидеть список функций MTA. Вы можете выбрать, какие функции Вы хотите отобразить, изменив элемент над полем со списком. Вы спросите: "Что делает эта "глупая таблица" в нижней части окна?". Это проверка синтаксиса. По мере того как Вы пишите скрипт, синтаксис проверяется и выводит любые ошибки, которые Вы произвели в скрипте. Это ускоряет прогресс написания скрипта, потому что Вам не нужно входить в игру и перезапускать ресурс, чтобы проверить, исправлена ​​ли ошибка синтаксиса. Я сделал небольшую ошибку в строке 1, чтобы показать Вам, как она выглядит:

MTASEmainwnd.png


  • New Resource Wizard - окно, с помощью которого Вы можете создать ресурс с помощью 5 простых этапов (3 этапа являются необязательными):

MTASEnewreswizard.png


  • Sound player - предварительный просмотр звуков, дважды щелкнув на звуковой файл в проводнике ресурсов:

MTASEsoundplayer.png


  • Image viewer - просмотр изображений путем наведения курсора на файлы в проводнике ресурсов:

MTASEimageviewer.png


  • Suggested functions - это "окно", аналогичное тому, которое находится в Visual Studio, показывающее список функций. Оно также показывает подсказку, рассказывающую Вам, что делает функция и её параметры. Оно также содержит все экспортируемые функции из каждого ресурса. Вы можете добавить 3 новых атрибута к экспортированному тегу функции в meta.xml, чтобы позволить Script Editor отображать описательную всплывающую подсказку, например, на скриншоте:
    • retval: возвращает тип (bool, marker, int и т.д.)
    • params: список параметров
    • description: краткое описание функции

MTSEsuggestedfuncs.png

Скриншот показывает пример экспортируемой функции, которая в meta.xml выглядит следующим образом:
<export function="getBankMarkers" retval="table" params="void" description="Returns a table containing all bank markers." />


  • Function tooltip (доступна с 0.3) - всплывающая подсказка, показывающая описание функции. Работает только при наведении мыши на имя функции в списке, а не на название категории функций. Скриншот подсказки:

MTASE func desc.png


  • MTA Server Configuration - окно, в котором Вы можете изменить настройки сервера. Вам не нужно будет открывать mtaserver.conf и изменять настройки сервера, ресурсы запуска, добавлять модули и т.д. Скриншот окна:

MTASEserverconfig.png


  • Customize syntax highlighter - окно, в котором Вы можете настроить многие свойства яркости синтаксиса. Скриншот окна:

MTASEcustomizesyntax.png


  • Exported functions - окно, с помощью которого Вы можете просмотреть все экспортированные функции из каждого ресурса

MTASEfuncs.png

Обзор

Как Вы можете видеть, мы хотим упростить разработку ресурсов, и, похоже, это выглядит неплохо, но мы всё ещё находимся в на стадии разработки. Есть некоторые хорошие ключевые функции, которые привлекут вас как скриптера. Пока мы все ещё находимся в разработке, мы хотели спросить у Вас: "Что Вы думаете об этом инструменте, и что Вы хотели бы видеть включенным в релиз? Какие-либо предложения?". Вы можете предложить некоторые функции, и, если возможно, мы сделаем всё возможное для реализации. Просто посетите нашу тему на форуме MTA и опубликуйте свои предложения.


Загрузка

Чтобы загрузить этот инструмент, перейдите на нашу тему на форуме MTA. Эта тема часто обновляется.

Требования

  • Для запуска этого приложения Вам необходимо установить .NET 2.0 Framework.
  • Вы должны иметь возможность запускать его в Windows XP и Vista. Работает также и на Windows 7.
  • У вас должен быть установлен как клиент MTA, так и сервер.


Часто задаваемые впоросы

Ошибки и предупреждения при запуске

Loading irrKlang.NET2.0 library failed to load! This means you will not be able to preview sound files.

Это сообщение появляется, скорее всего, для пользователей Windows XP/Vista 64bit. Это может произойти на 32-битной ОС, если на Вашем компьютере не установлен .NET Framework 2.0 Service Pack 1.

Существует только один известный способ решить проблему - убедиться, что установлен .NET Framework 2.0 Service Pack 1, если у Вас его нет, Вы можете загрузить его из Microsoft Download Center.

Error parsing meta.xml

Причина появления этой ошибки должна быть объяснена в сообщении. Скорее всего, ваш meta.xml имеет следующие XML-объявления:

<?xml version="1.0" encoding="UTF-8" ?>
<?xml version="1.0" encoding="UTF-16" ?>

Чтобы решить проблему, просто откройте файл в WordPad или Notepad (Notepad++ может не решить проблему), удалите эту строку и сохраните изменения.

.NET Framework 2.0 XML Parser не любит "хорошо сформированные" XML-файлы, поэтому Вы можете получать разные сообщения с разными файлами meta.xml.

Эта ошибка была исправлена в 0.3

Не удалось сохранить файл

Если Вы не можете сохранить файл, то это значит, что Вы создали новый файл, и он не был добавлен ни к одному ресурсу. Эта ошибка и будет исправлена.


Проблема с горизонтальной полосой прокрутки

Если у Вас слишком длинная строка, и вы вставляете в нее какой-то код, может возникнуть проблема с невозможностью прокрутки влево (начало строки). Это проблема возникает с 3-ей партией библиотеки MTA:SE. Её автор не собирается исправлять (он неактивен уже более 2 лет), и нам трудно найти причину этого. Фактически, мне также была предоставлена ​​ссылка на другую красивую синтаксическую библиотеку, которую я могу использовать в будущем. Надеюсь, у этой библиотеки такой проблемы нет. Если Вы столкнулись с этой проблемой, есть несколько способов добраться до начала строки.

  • начните выделение этой строки, чтобы каретка перемещалась влево
  • нажмите клавишу "Home" на клавиатуре, чтобы переместить курсор на первый символ в строке


Проблемы с загрузкой некоторых ресурсов (meta.xml)

Если у Вас есть проблемы с загрузкой некоторых ресурсов, и Вы получите сообщение, что Ваш ресурс не будет показан в проводнике ресурсов, то, чтобы это исправить, Вы можете сделать несколько действий:

  • убедитесь, что Ваши файлы не закодированы в Юникоде. В противном случае откройте их в стандартном блокноте, сохраните в meta.xml с кодировкой ANSI. Не используйте Notepad++ для этой задачи, так как он вообще не может изменять кодировку файлов
  • убедитесь, что у Вас нет знака «&» (амперсанд) в любом месте файла, так как это может привести к неправильному анализу meta.xml. В противном случае Вы должны заменить амперсанды на &, так как это правильный способ представления амперсанда в XML

Вероятно, оба из них могут быть исправлены путем изменения/добавления небольшого фрагмента кода, но, к сожалению, я не смог понять, какого именно. Если Вы знаете, что может вызвать эту Parcer-ошибку в C# .NET Framework XML Parser, то не стесняйтесь делиться этими знаниями со мной, чтобы я мог исправить эту проблему.

Эта ошибка была исправлена в 0.3


Связь

Вы можете связаться с нами на нашей теме форума MTA.


Отдельное спасибо

  • 50p - программист и GUI-дизайнер.
  • Fenix1042 - программист.
  • Cazomino05 - работа с XML-файлами, функциями и событиями MTA.
  • Разработчики MTA - поставка потрясающего GTA:SA Multiplayer MOD, который имеет почти неограниченные возможности...