RU/Resource:Interiors

From Multi Theft Auto: Wiki
Jump to navigation Jump to search

Ресурс 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 этого события - игрок, переместившийся к пункту своего назначения.



Примеры

Скоро будут