RU/Resource:Interiors: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
m (Reverted edits by Bonzo (talk) to last revision by Vincent)
 
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{RU/Resource page}}
{{RU/Resource page}}
The interiors resource provides a generic system for use of the single player's interiors system, which is included in the MTASA:DM DP2 server package onwards. This means placing warp points where when players hit the marker, they are set into the appropriate interior.
Ресурс interiors предоставляет общую ситему для использования интерьеров из одиночной игры, которая включена в поставку сервера MTASA, начиная с версии 1.0. Буквально это подразумевает расставление точек перехода в соответствующий интерьер, для активации которых требуется попадание игрока в маркер.


=Loading interiors from the resource=
=Подгрузка интерьеров из ресурса=
By default, the interiors resource offers over 200 of single player's own interior locationsCoupled with [[dimension|dimensions]], each and every warp point offers a unique location - with a total of over 450 locations.
По умолчанию в ресурс interiors включено свыше 200 собственных интерьерных локаций из одиночной игрыВкупе с [[dimension|измерениями]], все вцелом и каждая в отдельности из точек перехода являются уникальными локациями - вцелом более 450 мест.


Loading these interiors is easyStarting the ''interiors'' resource will auto load all these preset warp points and will be ready to use out of the box.
Подгрузить их легкоСтарт ресурса ''interiors'' автоматически загрузит все предустановленные точки перехода и сразу будет готов к использованию.


=Adding your own interiors=
=Добавление своих интерьеров=
The interiors resource supports a flexible .map based element system to add your own interiors. The syntax follows an ''entry'' and ''return'' systemAn ''interiorEntry'' element must have a unique id, and the ''interiorReturn'' element uses the "refid" attribute to link them together.
Ресурс interiors поддерживает гибкую систему элементов .map для добавления ваших собственных интерьеров. В синтаксисе указываются ''entry'' (вход) и ''return'' (выход)Элемент ''interiorEntry'' обязан иметь уникальный id, а элемент ''interiorReturn'' использует атрибут "refid" для связи с ним.
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<interiorEntry id=""  posX=""  posY=""  posZ=""  rotation=""  dimension=""  interior="" oneway=""  />
<interiorEntry id=""  posX=""  posY=""  posZ=""  rotation=""  dimension=""  interior="" oneway=""  />
<interiorReturn refid=""  posX=""  posY=""  posZ=""  rotation=""  dimension=""  interior=""  />
<interiorReturn refid=""  posX=""  posY=""  posZ=""  rotation=""  dimension=""  interior=""  />
</syntaxhighlight>
</syntaxhighlight>
==Required Arguments==
==Требуемые аргументы==
* '''posX''': A float representing the X position of the interior warp.
* '''posX''': Число с плавающей точкой, отвечающее за позицию по оси X точки входа в интерьер.
* '''posY''': A float representing the Y position of the interior warp.
* '''posY''': Число с плавающей точкой, отвечающее за позицию по оси Y точки входа в интерьер.
* '''posZ''': A float representing the Z position of the interior warp.
* '''posZ''': Число с плавающей точкой, отвечающее за позицию по оси Z точки входа в интерьер.
* '''rotation''': A float representing the rotation of the player when he '''reaches''' the marker in the specified element.
* '''rotation''': Число с плавающей точкой, отвечающее за угол вращения игрока, когда он '''достиг''' маркера указанного элемента.
* '''dimension''': An integer representing the dimension of the player when he '''reaches''' the interior warp in the specified elementIn other words, which dimension the warp point exists.
* '''dimension''': Целое число, отвечающее за измерение игрока, когда он '''достиг''' точки перехода указанного элементаДругими словами, в каком измерении расположена точка перехода.
* '''interior''': An integer representing the interior world of the player when he '''reaches''' the interior warp in the specified element. In other words, which interior the warp point exists.
* '''interior''': Целое число, отвечающее за интерьерный мир игрока, когда он '''достиг''' точки перехода указанного элемента. Другими словами, в каком интерьере расположена точка перехода.


==Optional Arguments==
==Опциональные аргументы==
* '''oneway''': If set to ''true'', a interiorReturn marker will not be created, and the warp point will be one-way - from the interiorEntry to the interiorReturn with no way back.
* '''oneway''': Если значение установлено на ''true'', маркер interiorReturn не будет создан, и точка перехода будет работать лишь в одну сторону - из interiorEntry к interiorReturn без обратного пути.


==Example==
==Образец==
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<interiorEntry id="AMMUN1" posX="1368.35" posY="-1279.06" posZ="12.55" rotation="-0.100006" dimension="0" interior="0" />
<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" />
<interiorReturn refid="AMMUN1" posX="286.15" posY="-41.54" posZ="1000.57" rotation="90" interior="1" dimension="0" />
</syntaxhighlight>
</syntaxhighlight>
The interiorEntry element here is located at 1368.35,-1279.06,12.55. When the player reaches this location, he will be warped to the attributes specified in the linked interiorReturn element - 286.15,-41.54,1000.57 with a rotation of 90 degrees, into the new interior world 1. When the player hits this marker again, the transverse will happen.
Элемент interiorEntry расположен в координатах 1368.35,-1279.06,12.55. Когда игрок попадает в данные координаты, его переносит в координаты, указанные в элементе interiorReturn - 286.15,-41.54,1000.57 со вращением 90 градусов, в новый интерьерный мир 1. Когда игрок снова встанет на маркер, все произойдет наоборот.


=Interfacing your script with the interiors resource=
=Взаимодействие вашего скрипта с ресурсом interiors=
The interiors resource offers a few events and functions which should allow customisability of
Ресурс interiors предоставляет несколько событий и функций с целью обеспечить его настраиваемость.
interiors.


==Exported functions==
==Экспортируемые функции==
Please remember that [[call]] must be used to call functions of another resource.
Пожалуйста, не забывайте, что обязательно нужно использовать [[call]] с функциями других ресурсов.
----
----
===getInteriorName===
===getInteriorName===
This function retrieves the overall name of an interior. This means it is the id or the overall refid.
Эта функция извлекает the общее имя интерьера. Это значит, что оно либо id, либо общий refid.
====Syntax====
====Синтаксис====
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
string getInteriorName ( element interiorEntry/InteriorReturn )
string getInteriorName ( element interiorEntry/InteriorReturn )
</syntaxhighlight>
</syntaxhighlight>


====Required Arguments====
====Требуемые артументы====
*'''interior:''' The interior you wish to get the name ofCan be of type ''interiorEntry'' or ''interiorReturn''.
*'''interior:''' Интерьер, имя которого вы хотите получитьЭто могут быть ''interiorEntry'' или ''interiorReturn''.


====Returns====
====Возвращает====
Returns a string of the interior name, or false if it could not be retrieved.
Возвращает string с именем интерьера или false, если таковое не может быть получено.
----
----




===getInteriorMarker===
===getInteriorMarker===
This function retrieves the [[marker]] element associated to the interior. This will allow you to modify the visibility of interior markers using the [[setElementVisibleTo]] function.
Эта функция извлекает элемент [[marker]], связанный с интерьером. Это позволит вам регулировать видимость маркеров интерьеров через использование функции [[setElementVisibleTo]].
====Syntax====
====Синтаксис====
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
marker getInteriorName ( element interiorEntry/InteriorReturn )
marker getInteriorMarker ( element interiorEntry/InteriorReturn )
</syntaxhighlight>
</syntaxhighlight>


====Required Arguments====
====Требуемые аргументы====
*'''interior:''' The interior you wish to retrieve the associated marker of. Can be of type ''interiorEntry'' or ''interiorReturn''.
*'''interior:''' Интерьер, маркер связанного с которым вы хотите заполучить. Это могут быть ''interiorEntry'' или ''interiorReturn''.


====Returns====
====Возвращает====
Returns a marker element associated to the specified interior, or false if it could not be retrieved.
Возвращает элемент маркера, связанный с указанным интерьером или false, если таковой не может быть получен.


==Events==
==События==
===onInteriorHit===
===onInteriorHit===
This event is triggered when an interior warp point is hit, prior to when a player is warped to his/her destination.
Это событие срабатывает, когда срабатывает точка перехода, перед тем, как игрок перемещается к пункту своего назначения.
====Parameters====
====Параметры====
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
player hitPlayer
player hitPlayer
</syntaxhighlight>  
</syntaxhighlight>  


*'''hitPlayer''': The player that hit the interior warp point.
*'''hitPlayer''': Игрок, от которого сработала точка перехода.


====Source====
====Source====
The [[event system#Event source|source]] of this event is the interior element which was hit.
[[event system#Event source|Source]] этого события - элемент интерьера, который сработал.


====Cancel effect====
====Эффект отмены====
If this event is [[Event system#Canceling|canceled]], the player will not be warped to his destination point.
Если событие [[Event system#Canceling|отменено]], игрок не будет перемещен к пункту своего назначения.
----
----




===onInteriorWarped===
===onInteriorWarped===
This event is triggered when an interior destination has successfully been warped to.
Это событие срабатывает, когда цель-интерьер была успешно достигнута.


====Parameters====
====Параметры====
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
player warpedPlayer
player warpedPlayer
</syntaxhighlight>  
</syntaxhighlight>  


*'''warpedPlayer''': The player that has warped to the destination interior.
*'''warpedPlayer''': Игрок, переместившийся к пункту своего назначения.


====Source====
====Source====
The [[event system#Event source|source]] of this event is the interior element which was warped '''to'''.
[[event system#Event source|Source]] этого события - элемент интерьера, '''к''' которому переместились.
----
----




===onPlayerInteriorHit===
===onPlayerInteriorHit===
This event is triggered when a player hits an interior warp point, prior to him reaching his destination
Это событие срабатывает, когда игрок достигает точки перехода интерьера, перед тем, как он достиг пункта своего назначения
====Parameters====
====Параметры====
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
player hitInterior
element hitInterior
</syntaxhighlight>  
</syntaxhighlight>  


*'''hitInterior''': The interior element that was hit.
*'''hitInterior''': Элемент интерьера, который был достигнут.


====Source====
====Source====
The [[event system#Event source|source]] of this event is the player who hit the interior element.
[[event system#Event source|Source]] этого события - игрок, который достиг элемента интерьера.


====Cancel effect====
====Эффект отмены====
If this event is [[Event system#Canceling|canceled]], the player will not be warped to his destination point.
Если событие [[Event system#Canceling|отменено]], игрок не будет перемещен к пункту своего назначения.
----
----




===onPlayerInteriorWarped===
===onPlayerInteriorWarped===
This event is triggered when a player successfully warps to his destination interior.
Это событие срабатывает, когда цель-интерьер была успешно достигнута.


====Parameters====
====Параметры====
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
player warpedInterior
element warpedInterior
</syntaxhighlight>  
</syntaxhighlight>  


*'''warpedInterior''': The interior that has been warped '''to'''.
*'''warpedInterior''': Интерьер, '''в''' который переместились.


====Source====
====Source====
The [[event system#Event source|source]] of this event is the player who was warped to his destination point.
[[event system#Event source|Source]] этого события - игрок, переместившийся к пункту своего назначения.




----
----
===Examples===
===Примеры===
'''Coming soon'''
'''Скоро будут'''
 
[[en:Resource:Interiors]]

Latest revision as of 03:05, 1 April 2016

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



Примеры

Скоро будут