RU/Resources - Revision history

Dmi7ry: /* Хранение файлов */

2018-04-02T07:27:49Z

Хранение файлов

← Older revision		Revision as of 07:27, 2 April 2018
Line 74:		Line 74:
	mods/deathmatch/resources/ (для выделенных серверов)		mods/deathmatch/resources/ (для выделенных серверов)

	Каждый ресурс может являться zip-архивом, директорией, или и тем, и другим. В последнем случае директория будет приорететней zip-архива, так как в нее можно будет поместить файлы, которые перезапишут старые, что позволит тестировать и ~~рарзратывать~~ карты/скрипты "на лету". Такое не было бы возможно при приоритетах, расставленных наоборот. А zip-архивы, в свою очередь, зачастую используются конечными пользователями.		Каждый ресурс может являться zip-архивом, директорией, или и тем, и другим. В последнем случае директория будет приорететней zip-архива, так как в нее можно будет поместить файлы, которые перезапишут старые, что позволит тестировать и рарзрабатывать карты/скрипты "на лету". Такое не было бы возможно при приоритетах, расставленных наоборот. А zip-архивы, в свою очередь, зачастую используются конечными пользователями.

	==Другие примечательные вещи==		==Другие примечательные вещи==

Ccw: Reverted edits by Bonzo (talk) to last revision by Cristiano Cardoso

2016-04-01T03:07:20Z

Reverted edits by Bonzo (talk) to last revision by Cristiano Cardoso

← Older revision	Revision as of 03:07, 1 April 2016
Line 1:	Line 1:
		Ресурсы - ключевая часть MTA. По существу, ресурс - папка или zip-врхив, который содержит набор файлов, включающий в себя скриптовые файлы, плюс файл ''meta'', который описывает серверу, как ресурс должен быть загружен. Ресурс можно рассматривать в качестве частичного эквивалента программе, работающей на операционной системе - он может быть запущен и остановлен, и множество ресурсов могут быть запущенными одновременно. Но тем не менее следует помнить, что в отличие от программ на ОС, между ресурсами нет многозадачности.

		==Терминология==
		* '''Resource''' - zip-архив или папка, содержащая файл meta.xml и некоторые другие составные части ресурсов. Они помещены в папке ''mods/deathmatch/resources'' в директории сервера.
		* '''Составная часть''' - Файл, содержащийся внутри ресурса, на данный момент это могут быть карты, скрипты, картинки и т.д.

		==Файл Meta==
		''Для подробностей читайте основную статью [[RU/Meta.xml\|Meta.xml]]''

		Файл Meta - ядро каждого ресурса. Он в точности описывает, какие файлы должны использоваться в ресурсе и как. Далее следует пример, который покрывает все имеющиеся опции, ваши meta файлы могут иметь этих тегов столько, сколько вам потребуется:

		<syntaxhighlight lang="xml">
		<meta>
		<info author="eAi" description="This is a basic CTF script" version="4"/>

		<include resource="radarblips"/>
		<include resource="markermanagement" />

		<script src="ctf.lua" />
		<script src="flag.lua" />
		<script src="ctf_client.lua" type="client" />

		<file src="model.dff" />
		<file src="quitbutton.png" />
		<file src="killed.png" />

		<html src="test.htm" default="true"/>
		<html src="logo.png" raw="true" />

		<export function="multiply" http="true" />
		<export function="getPlayerList" />
		<export function="getElementOwner" type="client"/>

		<config src="vehicle-list.xml" type="client" />
		<config src="markerconfig.xml" type="server" />

		<map src="somestuff.map" dimension="99" />
		</meta>
		</syntaxhighlight>
		В то же время карта CTF может обладать meta.xml, выглядящим примерно так:
		<syntaxhighlight lang="xml">
		<meta>
		<include resource="ctf" />
		<map src="myuberl33tctfmap.map" />

		<info author="Tom" instructions="this is uber l33t !!!!!1111111" type="map" />
		</meta>
		</syntaxhighlight>


		Атрибуты Script/type, Config/type и File/type указывают, может ли скрипт/ресурс быть загружен на компьютер клиента, и по умолачнию установлены на "server".

		Тэг include указывает на другие ресурсы, которые должны быть запущены перед запуском данного. Другими словами, если ваш ресурс зависит от другого, вы можете указать, чтобы этот другой запускался перед вашим,


		Каждый ресурс обладает своей виртуальной машиной (VM). Она содержит каждый скрипт ресурса. Это значит, что переменные не являются общими с другими ресурсами. Лучший способ сообщаться с другими ресурсами - использовать тэг ''export'' и экспортировать функцию. Это позволит другим ресурсам ее вызывать с использованием скриптинговой функции [[call]].


		Скрипты, отправляемые клиенту, стартуют сразу по завершении им закачки всех скриптов.


		Скрипты имеют права на чтение и запись внутрь папки своего ресурса через функции типа [[xmlCreateFile]] и [[fileCreate]]. Они также имеют права на чтение и запись внутри других ресурсов, но только если имеют на это [[RU/Access_Control_List\|ACL]]-доступ.


		Каждый ресурс может быть загружен только один раз, сервер это проконтролирует. Даже при указании ресурса в качестве include более одного раза, каждый раз будет использована одна и та же его копия.

		==Хранение файлов==
		Файлы ресурса могут храниться либо в zip-архиве, либо в директории. Они располагаются в:

		server/mods/deathmatch/resources/ (если ваш сервер установлен вместе с клиентом)

		или

		mods/deathmatch/resources/ (для выделенных серверов)

		Каждый ресурс может являться zip-архивом, директорией, или и тем, и другим. В последнем случае директория будет приорететней zip-архива, так как в нее можно будет поместить файлы, которые перезапишут старые, что позволит тестировать и рарзратывать карты/скрипты "на лету". Такое не было бы возможно при приоритетах, расставленных наоборот. А zip-архивы, в свою очередь, зачастую используются конечными пользователями.

		==Другие примечательные вещи==
		*Названия ресурсов не могут содержать точек.
		*Если ресурс сохраняет какие-нибудь файлы, используемые названия файлов не должны быть указаны в meta.xml
		*Файлы, указанные в meta.xml, должны рассматриваться скриптами только как файлы для чтения. Не редактируйте их через xmlSaveFile, FileSave и т.д.
		*При создании zip-архива вашего ресурса не включайте в него файлы, в которые будет вестись запись. Если ваш ресурс использует такие файлы, они должны быть созданы ресурсом по мере надобности.
		*При создании zip-архива вашего ресурса включайте только те файлы, что описаны в meta.xml. Не включайте 'образцы' файлов, в которые будет вестись запись, это чревато последствиями.
		*Мы рекомендуем избегать пробелов и экзотических символов в названиях ресурсов.

		==Функции скриптинга==
		Система ресурсов может управляться скриптово. Вследствие этого, предоставляются следующие серверные функции скриптинга:
		{{Resource functions}}

		Предоставляются также следующие события:
		{{Resource_events}}

		[[en:Resources]]
		[[it:Introduzione alle Risorse]]
		[[pt-br:Recursos]]

Bonzo: Blanked the page

2016-03-31T15:43:56Z

Blanked the page

← Older revision		Revision as of 15:43, 31 March 2016
Line 1:		Line 1:
	Ресурсы - ключевая часть MTA. По существу, ресурс - папка или zip-врхив, который содержит набор файлов, включающий в себя скриптовые файлы, плюс файл ''meta'', который описывает серверу, как ресурс должен быть загружен. Ресурс можно рассматривать в качестве частичного эквивалента программе, работающей на операционной системе - он может быть запущен и остановлен, и множество ресурсов могут быть запущенными одновременно. Но тем не менее следует помнить, что в отличие от программ на ОС, между ресурсами нет многозадачности.

	~~==Терминология==~~
	* '''Resource''' - zip-архив или папка, содержащая файл meta.xml и некоторые другие составные части ресурсов. Они помещены в папке ''mods/deathmatch/resources'' в директории сервера.
	* '''Составная часть''' - Файл, содержащийся внутри ресурса, на данный момент это могут быть карты, скрипты, картинки и т.д.

	~~==Файл Meta==~~
	~~''Для подробностей читайте основную статью [[RU/Meta.xml\|Meta.xml]]''~~

	Файл Meta - ядро каждого ресурса. Он в точности описывает, какие файлы должны использоваться в ресурсе и как. Далее следует пример, который покрывает все имеющиеся опции, ваши meta файлы могут иметь этих тегов столько, сколько вам потребуется:

	~~<syntaxhighlight lang="xml">~~
	~~<meta>~~
	~~<info author="eAi" description="This is a basic CTF script" version="4"/>~~

	~~<include resource="radarblips"/>~~
	~~<include resource="markermanagement" />~~

	~~<script src="ctf.lua" />~~
	~~<script src="flag.lua" />~~
	~~<script src="ctf_client.lua" type="client" />~~

	~~<file src="model.dff" />~~
	~~<file src="quitbutton.png" />~~
	~~<file src="killed.png" />~~

	~~<html src="test.htm" default="true"/>~~
	~~<html src="logo.png" raw="true" />~~

	~~<export function="multiply" http="true" />~~
	~~<export function="getPlayerList" />~~
	~~<export function="getElementOwner" type="client"/>~~

	~~<config src="vehicle-list.xml" type="client" />~~
	~~<config src="markerconfig.xml" type="server" />~~

	~~<map src="somestuff.map" dimension="99" />~~
	~~</meta>~~
	~~</syntaxhighlight>~~
	~~В то же время карта CTF может обладать meta.xml, выглядящим примерно так:~~
	~~<syntaxhighlight lang="xml">~~
	~~<meta>~~
	~~<include resource="ctf" />~~
	~~<map src="myuberl33tctfmap.map" />~~

	~~<info author="Tom" instructions="this is uber l33t !!!!!1111111" type="map" />~~
	~~</meta>~~
	~~</syntaxhighlight>~~


	Атрибуты Script/type, Config/type и File/type указывают, может ли скрипт/ресурс быть загружен на компьютер клиента, и по умолачнию установлены на "server".

	Тэг include указывает на другие ресурсы, которые должны быть запущены перед запуском данного. Другими словами, если ваш ресурс зависит от другого, вы можете указать, чтобы этот другой запускался перед вашим,


	Каждый ресурс обладает своей виртуальной машиной (VM). Она содержит каждый скрипт ресурса. Это значит, что переменные не являются общими с другими ресурсами. Лучший способ сообщаться с другими ресурсами - использовать тэг ''export'' и экспортировать функцию. Это позволит другим ресурсам ее вызывать с использованием скриптинговой функции [[call]].


	~~Скрипты, отправляемые клиенту, стартуют сразу по завершении им закачки всех скриптов.~~


	Скрипты имеют права на чтение и запись внутрь папки своего ресурса через функции типа [[xmlCreateFile]] и [[fileCreate]]. Они также имеют права на чтение и запись внутри других ресурсов, но только если имеют на это [[RU/Access_Control_List\|ACL]]-доступ.


	Каждый ресурс может быть загружен только один раз, сервер это проконтролирует. Даже при указании ресурса в качестве include более одного раза, каждый раз будет использована одна и та же его копия.

	~~==Хранение файлов==~~
	~~Файлы ресурса могут храниться либо в zip-архиве, либо в директории. Они располагаются в:~~

	~~server/mods/deathmatch/resources/ (если ваш сервер установлен вместе с клиентом)~~

	~~или~~

	~~mods/deathmatch/resources/ (для выделенных серверов)~~

	Каждый ресурс может являться zip-архивом, директорией, или и тем, и другим. В последнем случае директория будет приорететней zip-архива, так как в нее можно будет поместить файлы, которые перезапишут старые, что позволит тестировать и рарзратывать карты/скрипты "на лету". Такое не было бы возможно при приоритетах, расставленных наоборот. А zip-архивы, в свою очередь, зачастую используются конечными пользователями.

	~~==Другие примечательные вещи==~~
	*Названия ресурсов не могут содержать точек.
	*Если ресурс сохраняет какие-нибудь файлы, используемые названия файлов не должны быть указаны в meta.xml
	*Файлы, указанные в meta.xml, должны рассматриваться скриптами только как файлы для чтения. Не редактируйте их через xmlSaveFile, FileSave и т.д.
	*При создании zip-архива вашего ресурса не включайте в него файлы, в которые будет вестись запись. Если ваш ресурс использует такие файлы, они должны быть созданы ресурсом по мере надобности.
	*При создании zip-архива вашего ресурса включайте только те файлы, что описаны в meta.xml. Не включайте 'образцы' файлов, в которые будет вестись запись, это чревато последствиями.
	*Мы рекомендуем избегать пробелов и экзотических символов в названиях ресурсов.

	~~==Функции скриптинга==~~
	Система ресурсов может управляться скриптово. Вследствие этого, предоставляются следующие серверные функции скриптинга:
	~~{{Resource functions}}~~

	~~Предоставляются также следующие события:~~
	~~{{Resource_events}}~~

	~~[[en:Resources]]~~
	~~[[it:Introduzione alle Risorse]]~~
	~~[[pt-br:Recursos]]~~

Cristiano Cardoso: Added PT-BR page

2014-07-02T13:42:37Z

Added PT-BR page

← Older revision		Revision as of 13:42, 2 July 2014
Line 93:		Line 93:
	[[en:Resources]]		[[en:Resources]]
	[[it:Introduzione alle Risorse]]		[[it:Introduzione alle Risorse]]
			[[pt-br:Recursos]]

Vincent at 14:34, 2 July 2012

2012-07-02T14:34:48Z

← Older revision		Revision as of 14:34, 2 July 2012
Line 6:		Line 6:

	==Файл Meta==		==Файл Meta==
	''Для подробностей читайте основную статью [[Meta.xml]]''		''Для подробностей читайте основную статью [[RU/Meta.xml\|Meta.xml]]''

	Файл Meta - ядро каждого ресурса. Он в точности описывает, какие файлы должны использоваться в ресурсе и как. Далее следует пример, который покрывает все имеющиеся опции, ваши meta файлы могут иметь этих тегов столько, сколько вам потребуется:		Файл Meta - ядро каждого ресурса. Он в точности описывает, какие файлы должны использоваться в ресурсе и как. Далее следует пример, который покрывает все имеющиеся опции, ваши meta файлы могут иметь этих тегов столько, сколько вам потребуется:
Line 60:		Line 60:


	Скрипты имеют права на чтение и запись внутрь папки своего ресурса через функции типа [[xmlCreateFile]] и [[fileCreate]]. Они также имеют права на чтение и запись внутри других ресурсов, но только если имеют на это [[Access_Control_List\|ACL]]-доступ.		Скрипты имеют права на чтение и запись внутрь папки своего ресурса через функции типа [[xmlCreateFile]] и [[fileCreate]]. Они также имеют права на чтение и запись внутри других ресурсов, но только если имеют на это [[RU/Access_Control_List\|ACL]]-доступ.

Vincent at 16:06, 10 June 2012

2012-06-10T16:06:01Z

Show changes

D0lph1n: Translation fineshed

2009-06-23T11:32:21Z

Translation fineshed

← Older revision		Revision as of 11:32, 23 June 2009
Line 1:		Line 1:
	~~{{translate}}~~
	Ресурсы - ключевая часть MTA. Ресурс представляет из себя каталог или zip архив, содержащий набор файлов, таких как скрипты, плю ''meta'' файл, описывающий то, как ресурс должен загружаться. Отчасти, ресурс можно рассматривать как эквивалент программе, работающей под управлением операционной системы - он может быть запущен, остановлен, и множество ресурсов может работать одновременно. Несмотря на это важно помнить, что, в отличии от программ, между ресурсами нет многозадачности.		Ресурсы - ключевая часть MTA. Ресурс представляет из себя каталог или zip архив, содержащий набор файлов, таких как скрипты, плю ''meta'' файл, описывающий то, как ресурс должен загружаться. Отчасти, ресурс можно рассматривать как эквивалент программе, работающей под управлением операционной системы - он может быть запущен, остановлен, и множество ресурсов может работать одновременно. Несмотря на это важно помнить, что, в отличии от программ, между ресурсами нет многозадачности.

Line 67:		Line 66:

	==Файловые хранилища==		==Файловые хранилища==
	~~Resource files can either be stored in a~~ zip ~~or a directory~~. ~~This is located in~~:		Файлы ресурсов могут храниться в zip-архивах или каталогах. Они размещаются в:

	server/mods/deathmatch/resources/ (~~for~~ MTASA ~~clients~~)		server/mods/deathmatch/resources/ (для клиентов MTASA)

	or		или

	mods/deathmatch/resources/ (~~for dedicated server installations~~)		mods/deathmatch/resources/ (для выделенных серверов)

	~~Each resource can have a~~ zip ~~file~~, ~~a directory or both~~. ~~In the case of both existing~~, ~~the directory has precedence over the zip file~~, ~~as such files can be placed in the directory to over-ride the files in the zip file~~. ~~This allows directories to be used for testing and developing of maps~~/~~scripts while zip files used by end-users~~.		Каждый ресурс может быть zip-архивом, каталогом, либо объединять оба варианта. Приоритет каталога выше, чем у архива, таким образом файлы могут быть помещены в каталог, чтобы заменить файлы из архива. Это позволяет использовать каталоги для разработки и тестирования карт/скриптов, в то время, как архивы используются конечными пользователями.

	==~~Script functions~~==		==Скриптовые функции==
	~~The resource system can be manipulated by script~~. ~~As such, the following Serverside scripting functions are provided~~:		Системой ресурсов можно управлять из скриптов. Для этого существуют следующие серверные функции:
	{{Resource functions}}		{{Resource functions}}

	~~The following events are also provided~~:		Также генерируются следующие события:
	{{Resource_events}}		{{Resource_events}}

	[[en:Resources]]		[[en:Resources]]
	[[it:Introduzione alle Risorse]]		[[it:Introduzione alle Risorse]]

D0lph1n at 10:09, 23 June 2009

2009-06-23T10:09:33Z

← Older revision		Revision as of 10:09, 23 June 2009
Line 52:		Line 52:
	Атрибуты Script/type, Config/type и File/type определяют, должен ли скрипт/ресурс отправляться клиенту, и по умолчанию равны "server".		Атрибуты Script/type, Config/type и File/type определяют, должен ли скрипт/ресурс отправляться клиенту, и по умолчанию равны "server".

	~~The~~ include ~~tag specifies other resources that should be started before this resoucre is started~~. ~~In other words~~, ~~if your resource is dependent on another~~, ~~you can include it so that the other resource is started first~~,		Тэг include указывает какие ресурсы должны быть запущены перед запуском данного ресурса. Другими словами, если ваш ресурс зависит от других, вы можете подключить их так, чтобы они стартовали первыми.


	~~Each resource has its own virtual machine~~ (VM). ~~This contains every script in the resource~~. ~~This means that variables are not shared with other resources~~. ~~The best way to communictate with other resources is by using the~~ ''export'' ~~tag and exporting a function~~. ~~This will enable other resources to fire this function using the~~ [[call]] ~~scripting function~~.		Каждый ресурс работает в собственной виртуальной машине (VM). В ней работает каждый скрипт ресурса. Это значит, что переменные не разделяются с другими ресурсами. Наилучший способ взаимодействовать с другими ресурсами - использовать тэг ''export'' для экспортирования функции. Это позволит другим ресурсам выполнять функцию используя вызов функции [[call]].


	~~Scripts sent to clients are started as soon as all the scripts have been downloaded~~.		Скрипты, отправляемые клиенту, запускаются сразу по завершении скачивания.


	~~Scripts are able to read and write to their own resource folder with functions such as~~ [[xmlCreateFile]] ~~and~~ [[fileCreate]]. ~~They can also read and write to other resources~~, ~~but must have~~ [[Access_Control_List\|ACL]] ~~access~~.		У скриптов есть достум на чтение и запись в каталог ресурса через такие функции, как [[xmlCreateFile]] и [[fileCreate]]. Так же они могут читать/писать в другие ресурсы, но для этого нужны разрешения [[RU/Access_Control_List\|ACL]].


	~~Each resource can only be loaded once~~, ~~the server will ensure this~~. ~~If a resource is included more than once~~, ~~the same instance will be used by each resource that includes it~~.		Каждый ресурс может быть запущен только 1 раз, за этим следит сервер. Если ресурс подключен более одного раза, для всех ресурсов, подключивших его, будет использоваться одна копия.

	==~~File storage~~==		==Файловые хранилища==
	Resource files can either be stored in a zip or a directory. This is located in:		Resource files can either be stored in a zip or a directory. This is located in:

Divine at 14:14, 22 June 2009

2009-06-22T14:14:40Z

← Older revision		Revision as of 14:14, 22 June 2009
Line 85:		Line 85:

	[[en:Resources]]		[[en:Resources]]
			[[it:Introduzione alle Risorse]]

Divine: /* File storage */

2009-06-22T14:11:03Z

File storage

← Older revision		Revision as of 14:11, 22 June 2009
Line 69:		Line 69:
	Resource files can either be stored in a zip or a directory. This is located in:		Resource files can either be stored in a zip or a directory. This is located in:

	mods/deathmatch/resources/		server/mods/deathmatch/resources/ (for MTASA clients)

			or

			mods/deathmatch/resources/ (for dedicated server installations)

	Each resource can have a zip file, a directory or both. In the case of both existing, the directory has precedence over the zip file, as such files can be placed in the directory to over-ride the files in the zip file. This allows directories to be used for testing and developing of maps/scripts while zip files used by end-users.		Each resource can have a zip file, a directory or both. In the case of both existing, the directory has precedence over the zip file, as such files can be placed in the directory to over-ride the files in the zip file. This allows directories to be used for testing and developing of maps/scripts while zip files used by end-users.