View source for RU/MTASE

{| style="float: right; border-collapse: collapse; width: 270px"
|[[Image:MTASElogo_wiki.png]]
|}
{{TOClimit|1}}
{{RU/Note|Этот инструмент больше не поддерживается.}}



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

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

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

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


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


*'''Sound player''' - предварительный просмотр звуков, дважды щелкнув на звуковой файл в проводнике ресурсов:
[[Image:MTASEsoundplayer.png]]


*'''Image viewer''' - просмотр изображений путем наведения курсора на файлы в проводнике ресурсов:
[[Image:MTASEimageviewer.png]]


*'''Suggested functions''' - это "окно", аналогичное тому, которое находится в Visual Studio, показывающее список функций. Оно также показывает подсказку, рассказывающую Вам, что делает функция и её параметры. Оно также содержит все экспортируемые функции из каждого ресурса. Вы можете добавить 3 новых атрибута к экспортированному тегу функции в meta.xml, чтобы позволить Script Editor отображать описательную всплывающую подсказку, например, на скриншоте:
**'''retval:''' возвращает тип (bool, marker, int и т.д.)
**'''params:''' список параметров
**'''description:''' краткое описание функции
[[Image:MTSEsuggestedfuncs.png]]
:Скриншот показывает пример экспортируемой функции, которая в meta.xml выглядит следующим образом:
<syntaxhighlight lang="xml"><export function="getBankMarkers" retval="table" params="void" description="Returns a table containing all bank markers." /></syntaxhighlight>


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


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


*'''Customize syntax highlighter''' - окно, в котором Вы можете настроить многие свойства яркости синтаксиса. Скриншот окна:
[[Image:MTASEcustomizesyntax.png]]


*'''Exported functions''' - окно, с помощью которого Вы можете просмотреть все экспортированные функции из каждого ресурса
[[Image:MTASEfuncs.png]]

==Обзор==
Как Вы можете видеть, мы хотим упростить разработку ресурсов, и, похоже, это выглядит неплохо, но мы всё ещё находимся в на стадии разработки. Есть некоторые хорошие ключевые функции, которые привлекут вас как скриптера. Пока мы все ещё находимся в разработке, мы хотели спросить у Вас: "Что Вы думаете об этом инструменте, и что Вы хотели бы видеть включенным в релиз? Какие-либо предложения?". Вы можете предложить некоторые функции, и, если возможно, мы сделаем всё возможное для реализации. Просто посетите [http://forum.multitheftauto.com/viewtopic.php?f=91&t=24834 нашу тему] на форуме MTA и опубликуйте свои предложения.


==Загрузка==
Чтобы загрузить этот инструмент, перейдите на [http://forum.multitheftauto.com/viewtopic.php?f=91&t=24834 нашу тему] на форуме MTA.
Эта тема часто обновляется.

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


==FAQ==


===Error/Warning messages at startup===

===Loading irrKlang.NET2.0 library failed to load! This means you will not be able to preview sound files.===
This message appears most likely for Windows XP/Vista '''64bit''' users. It may occur on 32bit OS if that machine doesn't have .NET 2.0 SP1 installed.

There is only 1 known way to solve the problem...: Make sure you have .NET 2.0 SP1 installed, if you don't have it you can download it from [http://www.microsoft.com/Downloads/details.aspx?familyid=79BC3B77-E02C-4AD3-AACF-A7633F706BA5&displaylang=en Microsoft Download Center].

===Error parsing meta.xml===
The reason why this window comes up should be explained in the message. It's most likely that your meta.xml has the following XML declarations:
<syntaxhighlight lang="xml"><?xml version="1.0" encoding="UTF-8" ?>
<?xml version="1.0" encoding="UTF-16" ?></syntaxhighlight>
To solve the problem, simply open the file in WordPad or Notepad (Notepad++ may not solve the problem so use the Windows one), remove that line and save the changes.

.NET 2.0 XML parser doesn't like not "well-formed" XML files, so you may get different messages with different meta.xml files.

'''(THIS HAS BEEN FIXED IN 0.3)'''

===Not able to save file===
If you can't seem to be able to save a file that's probably because you created a new file and the file wasn't added to any resource. This is a bug and will be fixed.


===Problem with horizontal scrollbar===
If you have too long line and you paste some code on it, you may get a problem of not being able to scroll to the left (beginning of the line). This is problem with 3rd party library MTA:SE is using. It is not going to be fixed by its author (he's inactive for over 2 years now) and it's hard for us to find what is causing it. In fact, I was also given a link to another nice syntax highlighter library which I may use in the future. I hope this one doesn't have that problem.
If you encounter this problem there are a few ways to get to the beginning of the line.
* start highlighting this line so that caret moves to the left
* press Home key on your keyboard to move caret to the first character on a line


===Problems with loading some resources (meta.xml)===
If you have problems with some resources not being loaded and you get message your resource will not be shown in Resource Explorer, there are few things you can do to fix it:
- Make sure your files in not encoded in Unicode (you can open it in Windows' Notepad and save the meta.xml with ANSI encoding, don't use Notepad++ for this task since it may not change file encoding at all).
- Make sure you don't have "&" (ampersand) sign anywhere in the file since it may cause meta.xml not being parsed correctly. You should replace ampersands with '''&amp;amp;''' as this is the correct way to represent an ampersand in XML.

Probably both of these can be fixed by changing/adding little piece of code but unfortunately I wasn't able to figure out what. If you know what can cause this parser error in C# .NET XML parser than don't hesitate and share this knowledge with me so I can fix this problem.

'''(THIS HAS BEEN FIXED IN 0.3)'''


==Contact==
You can find us on [http://forum.multitheftauto.com/viewtopic.php?f=91&t=24834 MTA forum]


==Credits==
* [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=19953 50p] - Programmer & GUI designer.
* [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=30686 Fenix1042] - Programmer.
* [http://forum.mtasa.com/memberlist.php?mode=viewprofile&u=22437 Cazomino05] - XML files with MTA functions and events.
* MTA Developers - Delivering the amazing GTA:SA Multiplayer MOD that has almost unlimited possibilities...

[[en:MTASE]]
[[es:MTASE]]