RU/Resource:Interiors

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Ресурс interiors предоставляет общую ситему для использования интерьеров из одиночной игры, которая включена в поставку сервера MTASA, начиная с версии 1.0. Буквально это подразумевает расставление точек перехода в соответствующий интерьер, для активации которых требуется попадание игрока в маркер.

Подгрузка интерьеров из ресурса

По умолчанию в ресурс interiors включено свыше 200 собственных интерьерных локаций из одиночной игры. Вкупе с измерениями, все вцелом и каждая в отдельности из точек перехода являются уникальными локациями - вцелом более 450 мест.

Подгрузить их легко. Старт ресурса interiors автоматически загрузит все предустановленные точки перехода и сразу будет готов к использованию.

Добавление своих интерьеров

Ресурс interiors поддерживает гибкую систему элементов .map для добавления ваших собственных интерьеров. В синтаксисе указываются entry (вход) и return (выход). Элемент interiorEntry обязан иметь уникальный id, а элемент interiorReturn использует атрибут "refid" для связи с ним. 

<interiorEntry	id=""  posX=""  posY=""  posZ=""  rotation=""  dimension=""  interior="" oneway=""  />
<interiorReturn	 refid=""  posX=""  posY=""  posZ=""  rotation=""  dimension=""  interior=""  />

Требуемые аргументы

  • posX: Число с плавающей точкой, отвечающее за позицию по оси X точки входа в интерьер.
  • posY: Число с плавающей точкой, отвечающее за позицию по оси Y точки входа в интерьер.
  • posZ: Число с плавающей точкой, отвечающее за позицию по оси Z точки входа в интерьер.
  • rotation: Число с плавающей точкой, отвечающее за угол вращения игрока, когда он достиг маркера указанного элемента.
  • dimension: Целое число, отвечающее за измерение игрока, когда он достиг точки перехода указанного элемента. Другими словами, в каком измерении расположена точка перехода.
  • interior: Целое число, отвечающее за интерьерный мир игрока, когда он достиг точки перехода указанного элемента. Другими словами, в каком интерьере расположена точка перехода.

Опциональные аргументы

  • oneway: Если значение установлено на true, маркер interiorReturn не будет создан, и точка перехода будет работать лишь в одну сторону - из interiorEntry к interiorReturn без обратного пути.

Образец

<interiorEntry	id="AMMUN1"	posX="1368.35"	posY="-1279.06"	posZ="12.55"	rotation="-0.100006"	dimension="0"	interior="0"	/>
<interiorReturn	refid="AMMUN1"	posX="286.15"	posY="-41.54"	posZ="1000.57"	rotation="90"	interior="1"	dimension="0"	/>

Элемент interiorEntry расположен в координатах 1368.35,-1279.06,12.55. Когда игрок попадает в данные координаты, его переносит в координаты, указанные в элементе interiorReturn - 286.15,-41.54,1000.57 со вращением 90 градусов, в новый интерьерный мир 1. Когда игрок снова встанет на маркер, все произойдет наоборот.

Взаимодействие вашего скрипта с ресурсом interiors

Ресурс interiors предоставляет несколько событий и функций с целью обеспечить его настраиваемость.

Экспортируемые функции

Пожалуйста, не забывайте, что обязательно нужно использовать call с функциями других ресурсов.

getInteriorName

Эта функция извлекает the общее имя интерьера. Это значит, что оно либо id, либо общий refid.

Синтаксис

string getInteriorName ( element interiorEntry/InteriorReturn )

Требуемые артументы

  • interior: Интерьер, имя которого вы хотите получить. Это могут быть interiorEntry или interiorReturn.

Возвращает

Возвращает string с именем интерьера или false, если таковое не может быть получено.


getInteriorMarker

Эта функция извлекает элемент marker, связанный с интерьером. Это позволит вам регулировать видимость маркеров интерьеров через использование функции setElementVisibleTo.

Синтаксис

marker getInteriorMarker ( element interiorEntry/InteriorReturn )

Требуемые аргументы

  • interior: Интерьер, маркер связанного с которым вы хотите заполучить. Это могут быть interiorEntry или interiorReturn.

Возвращает

Возвращает элемент маркера, связанный с указанным интерьером или false, если таковой не может быть получен.

События

onInteriorHit

Это событие срабатывает, когда срабатывает точка перехода, перед тем, как игрок перемещается к пункту своего назначения.

Параметры

player hitPlayer
  • hitPlayer: Игрок, от которого сработала точка перехода.

Source

Source этого события - элемент интерьера, который сработал.

Эффект отмены

Если событие отменено, игрок не будет перемещен к пункту своего назначения.


onInteriorWarped

Это событие срабатывает, когда цель-интерьер была успешно достигнута.

Параметры

player warpedPlayer
  • warpedPlayer: Игрок, переместившийся к пункту своего назначения.

Source

Source этого события - элемент интерьера, к которому переместились.


onPlayerInteriorHit

Это событие срабатывает, когда игрок достигает точки перехода интерьера, перед тем, как он достиг пункта своего назначения

Параметры

element hitInterior
  • hitInterior: Элемент интерьера, который был достигнут.

Source

Source этого события - игрок, который достиг элемента интерьера.

Эффект отмены

Если событие отменено, игрок не будет перемещен к пункту своего назначения.


onPlayerInteriorWarped

Это событие срабатывает, когда цель-интерьер была успешно достигнута.

Параметры

element warpedInterior
  • warpedInterior: Интерьер, в который переместились.

Source

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


Примеры

Скоро будут

Retrieved from "https://wiki.multitheftauto.com/wiki/RU/Resource:Interiors?oldid=47184"