Multi Theft Auto: Wiki - User contributions [en]

Page d'accueil

2012-05-19T16:54:04Z

Myk3L: /* Programmer */

<div style="background: #FFEEAA; padding: 5px; float:right; width: 30%;">Dernière version stable de '''Multi Theft Auto: San Andreas''' est '''{{Current Version|full}}'''. Rendez-vous sur la [http://mtasa.com/ page principale] pour la télécharger.
<p>
Vous pouvez aussi télécharger une [http://nightly.mtasa.com/ beta] pour avoir la dernière version ( non stable ).
</p>
</div>
__NOTOC__
Bienvenue sur le wiki de Multi Theft Auto. Sur ce wiki, vous trouverez toutes les informations sur Multi Theft Auto.

Il y a [[How you can help|différents moyens de nous aider]]: créer une map, un gamemode, rediger des articles sur des fonctions, écrire un exemple, écrire un tutorial ou juste jouer à MTA et nous rapportez les bugs trouvés.

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Pour commencer====

* [[FR/Manuel_Client|Manuel Client]] ( Traduction: [http://wiki.multitheftauto.com/wiki/User:DrawKiie DrawKiie] )
* [[FR/Manuel_Serveur|Manuel Serveur]] ( Traduction: [http://wiki.multitheftauto.com/wiki/User:Rouche Rouche] )
* [[FR/Problemes_connus|Problèmes connus]] ( Traduction: [http://wiki.multitheftauto.com/wiki/User:Rouche Rouche] )
* [[FR/Migrer_de_MTARace_a_MTASA_1.0.x|Migrer de MTA:Race à MTA:SA 1.0.x]] ( Traduction: [http://wiki.multitheftauto.com/wiki/User:Rouche Rouche] )
* [[FR/A propos des Map|A propos des Map]] ( Traduction: [http://wiki.multitheftauto.com/wiki/User:Rouche Rouche] )

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Programmer====

* [[FR/Introduction_Programmation|Introduction: La programmation]] ( Traduction: [http://wiki.multitheftauto.com/wiki/User:Citizen Citizen] )
* [[FR/Introduction_GUI|Introduction: Le GUI]] ( Traduction: [http://wiki.multitheftauto.com/wiki/User:FatalTeror FatalTerror] )
* [[FR/Debugage|Tutoriel: Le débugage]] - Comment trouver les erreurs dans son script (Traduction:[http://wiki.multitheftauto.com/wiki/User:Vincenzo Vincenzo] alias Vincentdu90)
* [[FR/Ressources|Introduction: Les ressources]] (Traduction : [http://wiki.multitheftauto.com/wiki/User:Myk3L Myk3L])
** [[FR/Ressource_Acces_Internet|Introduction: L'accès depuis internet]] - Comment créer un site à partir d'une ressource (Traduction : [http://wiki.multitheftauto.com/wiki/User:Myk3L Myk3L])
** [[:Category:Resource|Catalogue des ressources]]
** [[FR/Meta.xml|Meta.xml]] - Derière chaque ressource ce trouve une meta pour la définir
** [[FR/ACL|ACL]] - Access Control List, pour définir les autorisations
* [[FR/Ecrire_Gamemode|Créer un gamemode]]
* [[FR/Fonctions_Utiles|Fonctions Utiles]]

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Bases de données====
Cette section décrit toutes les capacités fournies par le LUA/MTA ou par les ressources.
* [[:Category:Resource|Catalogue des ressources]] - Vous devriez le lire pour réaliser un script approprié.
* [[FR/Les_scripts_clients| Les scripts clients]]
</div>
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Aide générale du LUA====
Des pages conçues pour aider votre compréhension du Lua
*[http://www.lua.org/pil/index.html "Programming in Lua"]
**[http://www.lua.org/manual/5.1/#index Les fonctions Lua]
*[http://lua-users.org/wiki/TutorialDirectory wiki Lua]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Un guide général au Lua de Nixstaller]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Map Editor====
*[[Resource:Editor|Manuel]]
*[[Resource:Editor/EDF|Editor Definition Format]]
*[[Resource:Editor/Plugins|Plugins]]
*[[Resource:Editor#FAQ|Questions Fréquentes]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Développer Multi Theft Auto====
* [[FR/Compiler_MTASA|Compiler MTASA sur Windows]]
* [[FR/Compiler_MTASA_Server_sur_Mac_OS_X|Compiler MTASA sur Mac OS X]]
* [[FR/Compiler_MTASA_Server_sur_GNU_Linux|Compiler MTASA sur GNU/Linux]]
* [[FR/Directives_de_codage|Directives de codage]]
* [http://code.google.com/p/mtasa-blue Google Code SVN]
* [[FR/Roadmap|Roadmap]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Références====
* [[FR/Fonctions_Clients|Fonctions Clients]]
* [[FR/Events_Clients|Events Clients]]
* [[FR/Fonctions_Serveurs|Fonctions Clients]]
* [[FR/Events_Serveurs|Events Clients]]

* [[FR/MTA Classes|MTA Classes]] - Les descriptions détaillées de tous les types personnalisés MTA
** [[FR/Element|MTA Elements]] / [[Element tree]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====[[Id|ID Listes]]====
*[[FR/Animations|Animations]]
*[[FR/Skins_Personnages|Skins Personnages]]
*[[FR/Vetements_CJ|Vêtements CJ]]
*[[FR/Garage|Garage IDs]]
*[[FR/Interieurs_IDs|Intérieurs IDs]]
*[[FR/Materiel_IDs|Matériel IDs]]
*[[FR/Projectiles|Projectiles]]
*[[FR/Radar Blips|Radar Blips]]
*[[FR/Sons|Sons]]
*[[FR/Vehicule_IDs|ID des véhicules]]
*[[FR/Vehicule_Couleurs|Couleurs véhicules]]
*[[FR/Vehicule_Upgrades|Tuning IDs]]
*[[FR/Armes|Armes]]
*[[FR/Meteos|Météos]]
</div>

|-
| colspan="2" |
|}
{{Languages list|fr}}

FR/Ressource Acces Internet

2012-05-19T16:52:43Z

Myk3L: Created page with "Le serveur Multi Theft Auto dispose d'une interface web que les ressources peuvent utiliser pour un tas de choses. Ce document va vous expliquer quelques les différentes manièr..."

Le serveur Multi Theft Auto dispose d'une interface web que les ressources peuvent utiliser pour un tas de choses. Ce document va vous expliquer quelques les différentes manières et comment se servir de cette interface.

==Introduction==
Il y a deux choses primordiales à avoir. La première : un serveur web qui autorise les navigateurs internent à demander des pages et les fichiers que vous avez dans votre ressource. La seconde est un système qui autorise le navigateur à appeler des fonctions exportées depuis votre ressource.

==Pages==
===Spécification de fichiers dans le meta.xml===
Vous pouvez spécifier dans votre fichier meta.xml certaines ressources qui pourront être accessible depuis le serveur wev. Pour se faire, ajoutez les lignes suivantes :
<syntaxhighlight lang="lua" lang="xml">
<html src="filename.ext" />
</syntaxhighlight>
En vous rendant sur : http://host:port/resourcename/filename.ext<br/>
vous pouvez y accèder.
Par exemple, sur un serveur local utilisant le port http par défaut, l'adresse sera : http://127.0.0.1:22005/webmap/map.htm

===Les fichiers binaires===
Malgré ce nom, les fichiers utilisent le HTML (de n'importe quel type). S'il y a des fichiers binaires (comme les images, archive zip...) vous devez le spécifier dans le meta.xml en ajoutant ''raw="true"'' dans la noeud ''html''. Cela signifie que les fichiers ne sont pas modifiés avant d'êtres envoyés au navugateur.

Par exemple :
<syntaxhighlight lang="lua" lang="xml">
<html src="image.gif" raw="true" />
</syntaxhighlight>

===Fichiers parsés===
Si un fichier n'est pas spécifié en tant que "rax" dans le meta.xml, il est passé par un pré-processeur avant d'être retourné au client. Ce pré-processeur marche mieux avec PHP ou ASP mais est utilisable en LUA. Vous pouvez intégrer des pages HTML dans des scripts MTA tout en controllant la sortie. Presque toutes les fonctions standards de MTA fonctionnent, ainsi que les [[Template:HTTP functions|Fonctions HTTP]], comme [[httpWrite]].

Par exemple :
<syntaxhighlight lang="lua" lang="html">
<html>
<body>
Cette ressource est appelée <* httpWrite( getResourceName(getThisResource()) ) *>
</body>
<html>
</syntaxhighlight>

Note : é est un caractère spécial ("é").

Le ternaire fonctionne aussi (comme en PHP ou en ASP) pour ce code. Vous pouvez donc faire :

<syntaxhighlight lang="lua" lang="html">
<html>
<body>
Cette ressource est appelée <* = getResourceName(getThisResource()) *>
</body>
<html>
</syntaxhighlight>

Toutes les fonctions HTTP intégrées au LUA ont accès aux variables d'environnement suivantes, qui contiennent les informations de la façon dont la page est demandée :

* table '''requestHeaders''': Tableau contenant tous les "headers HTTP" demandés avec la page. Vous pouvez modifier les "headers HTTP" retournés avec [[httpSetResponseHeader]].
* table '''form''': Tableau contenant toutes les données envoyées par un formulaire (méthode POST) ainsi que les variable passées dans la requête (méthode GET).
* table '''cookies''': Tableau contenant tous les cookies, modifiable via la fonction [[httpSetResponseCookie]].
* string '''hostname''': Chaîne de caractères contenant l'adresse IP ou le nom d'hôte (hostname) de la page.
* string '''url''': Chaîne de caractères contenant l'url de la page.
* account '''user''': C'est le compte de l'utilisateur.

Il est important de noter que les fichiers parsés tournent dans une machine virtuelle différente à celle de la ressource. Par conséquent, si vous voulez appeler une fonction dans votre ressource, vous devez exporter la fonction et utilisé la fonction [[call]] depuis le fichier parsé.

==Calls==
Vous pouvez autoriser certaines fonctions exportées dans votre ressource à être appeller depuis l'interface HTTP. Tous les SDKs (listes ci-dessous) vous autorise à appeler ces fonctions depuis un emplacement distant.

Pour spécifier une fonction exportée accessible depuis HTTP, ajoutez les lignes suivantes dans votre meta.xml :

<syntaxhighlight lang="lua" lang="xml">
<export function='nomDeFonction' http='true' />
</syntaxhighlight>

Vous pouvez coder votre fonction comme si c'était une fonction "normal", elle peut retourner plusieurs valeurs (ainsi que des tableaux, ressources, "elements"). Vous ne pouvez jamais retourner d'autres 'userdata' comme [[xmlnode|xmlnodes] ou des fonctions.

===Protocole===
{{note_box|Vous n'êtes pas obliger de savoir ça, vous pouvez utiliser l'un des [[#SDK SDK] ci-dessous.}}

Les appels sont fait avec cette requête HTTP POST : ''<nowiki>http://<your IP>:<your port>/<resource_name>/call/<exported_function_name></nowiki>''. Le corps de cette requête peut être un tableau JSON avec les arguments pour la fonction.

La requête va retourner un tableau JSON avec la(les) value(s) retourné depuis la fonction comme une réponse HTTP.

Le serveur supporte l'authentification HTTP basique, et vous pouvez configurer l'accès via l'ACL et le système de compte de base.

===Appels depuis une interface HTTP===
Utiliser les appels est probablement la façon la plus simple et peut être fait de façon presque transparente.

D'abord, ajoutez ces lignes dans votre meta.xml :
<syntaxhighlight lang="lua" lang="xml">
<include resource="ajax" />
</syntaxhighlight>

Après, ajouté les lignes suivantes entre les balises <head> de votre page :
<syntaxhighlight lang="lua" lang="lua">
<* = exports.ajax:start(getResourceName(getThisResource())) *>
</syntaxhighlight>

Finalement, vous pouvez créer un bloc javascript dans votre page et appeler vos fonctions quasiment comme si elles étaient locales.
La seule différence est que l'appel des fonctions est asynchrone - vous devez spécifier une "callback" comme dernier arguement pour votre appel. Elle est appelé quand la fonction est retournée.

Voici un simple exemple d'utilisation :

'''meta.xml'''
<syntaxhighlight lang="lua" lang="xml">
<meta>
<include resource="ajax" />
<script src='code.lua' />
<html src='page.htm' default='true' />
<export function='showChatMessage' http='true' />
</meta>
</syntaxhighlight>

'''code.lua'''
<syntaxhighlight lang="lua" lang="lua">
function showChatMessage ( message )
outputChatBox ( message )
return 5;
end
</syntaxhighlight>

'''page.htm'''
<syntaxhighlight lang="lua" lang="html">
<html>
<head>
<* = exports.ajax:start(getResourceName(getThisResource())) *>
<script type='text/javascript'>
function say() {
var message = document.getElementById('message')
showChatMessage ( message.value,
function ( number ) {
// the function has been called and returned something
message.value = "The function returned " + number;
}
);
}
</script>
</head>
<body>
<input type='text' id='message' /><input type='button' value='say' onclick='say();' />
</body>
</html>
</syntaxhighlight>

Vous pouvez voir les exemples de comment cela peut être fait dans les ressources : ''resourcebrowser'', ''resourcemanager'' et ''webadmin''.

==Sécurisé l'interface web==
L'[[ACL]] a un nombre de droits qui peuvent qui peuvent dire quels fichiers peuvent accèder à quels fichiers.

* general.http: S'il est désactivé, aucuns des fichiers http peuvent être accèdés (sauf par le client)
* resource.'''ResourceName''': S'il est désactivé, aucun des fichiers de la ressource ne peuvent être accèdés.
* resource.'''ResourceName'''.file.'''FileName''': S'il est désactivé, le fichier nommé ne peut être accèdé.
* resource.'''ResourceName'''.function.'''FunctionName''': S'il est désactivé, la fonction ne peut être appelée.

Ils peuvent également marcher avec les autres droits ACL - vous pouvez désactiver ceci pour les utilisateurs normaux et juste activés pour les Admins, ou un autre groupe ou utilisateur.

==SDK==
Il y a un grand nombre de soi-disant 'SDKs' disponible qui vous permet d'accèder à votre interface depuis d'autres langages de programmation. Avec, vous pouvez (en théorie) écrire un gamemode. Dans la pratique, c'est probablement une mauvaise idée, mais c'est utile pour les statistiques et l'administration. Le PHP SDK est la version la plus développée. Vous pouvez faire votre propre SDK - si vous le faites, envoyez-nous une copie (^^).

* [[Java SDK]]
* [[Javascript SDK]]
* [[Perl SDK]]
* [[PHP SDK]]
* [[CSharp SDK|C# SDK]]

==Voir aussi==
[[callRemote]] - Autoriser le serveur à appeler des foncions dans des pages PHP (avec le PHP SDK) et sur d'autres serveurs.
[[Category:Scripting Concepts]]

User:Myk3L

2012-05-19T12:46:47Z

Myk3L: Created page with "French software & web developer."

French software & web developer.

Page d'accueil

2012-05-19T12:45:52Z

Myk3L: /* Programmer */

<div style="background: #FFEEAA; padding: 5px; float:right; width: 30%;">Dernière version stable de '''Multi Theft Auto: San Andreas''' est '''{{Current Version|full}}'''. Rendez-vous sur la [http://mtasa.com/ page principale] pour la télécharger.
<p>
Vous pouvez aussi télécharger une [http://nightly.mtasa.com/ beta] pour avoir la dernière version ( non stable ).
</p>
</div>
__NOTOC__
Bienvenue sur le wiki de Multi Theft Auto. Sur ce wiki, vous trouverez toutes les informations sur Multi Theft Auto.

Il y a [[How you can help|différents moyens de nous aider]]: créer une map, un gamemode, rediger des articles sur des fonctions, écrire un exemple, écrire un tutorial ou juste jouer à MTA et nous rapportez les bugs trouvés.

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Pour commencer====

* [[FR/Manuel_Client|Manuel Client]] ( Traduction: [http://wiki.multitheftauto.com/wiki/User:DrawKiie DrawKiie] )
* [[FR/Manuel_Serveur|Manuel Serveur]] ( Traduction: [http://wiki.multitheftauto.com/wiki/User:Rouche Rouche] )
* [[FR/Problemes_connus|Problèmes connus]] ( Traduction: [http://wiki.multitheftauto.com/wiki/User:Rouche Rouche] )
* [[FR/Migrer_de_MTARace_a_MTASA_1.0.x|Migrer de MTA:Race à MTA:SA 1.0.x]] ( Traduction: [http://wiki.multitheftauto.com/wiki/User:Rouche Rouche] )
* [[FR/A propos des Map|A propos des Map]] ( Traduction: [http://wiki.multitheftauto.com/wiki/User:Rouche Rouche] )

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Programmer====

* [[FR/Introduction_Programmation|Introduction: La programmation]] ( Traduction: [http://wiki.multitheftauto.com/wiki/User:Citizen Citizen] )
* [[FR/Introduction_GUI|Introduction: Le GUI]] ( Traduction: [http://wiki.multitheftauto.com/wiki/User:FatalTeror FatalTerror] )
* [[FR/Debugage|Tutoriel: Le débugage]] - Comment trouver les erreurs dans son script (Traduction:[http://wiki.multitheftauto.com/wiki/User:Vincenzo Vincenzo] alias Vincentdu90)
* [[FR/Ressources|Introduction: Les ressources]] (Traduction : [http://wiki.multitheftauto.com/wiki/User:Myk3L Myk3L])
** [[FR/Ressource_Acces_Internet|Introduction: L'accès internet]] - Comment créer un site à partir d'une ressource
** [[:Category:Resource|Catalogue des ressources]]
** [[FR/Meta.xml|Meta.xml]] - Derière chaque ressource ce trouve une meta pour la définir
** [[FR/ACL|ACL]] - Access Control List, pour définir les autorisations
* [[FR/Ecrire_Gamemode|Créer un gamemode]]
* [[FR/Fonctions_Utiles|Fonctions Utiles]]

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Bases de données====
Cette section décrit toutes les capacités fournies par le LUA/MTA ou par les ressources.
* [[:Category:Resource|Catalogue des ressources]] - Vous devriez le lire pour réaliser un script approprié.
* [[FR/Les_scripts_clients| Les scripts clients]]
</div>
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Aide générale du LUA====
Des pages conçues pour aider votre compréhension du Lua
*[http://www.lua.org/pil/index.html "Programming in Lua"]
**[http://www.lua.org/manual/5.1/#index Les fonctions Lua]
*[http://lua-users.org/wiki/TutorialDirectory wiki Lua]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Un guide général au Lua de Nixstaller]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Map Editor====
*[[Resource:Editor|Manuel]]
*[[Resource:Editor/EDF|Editor Definition Format]]
*[[Resource:Editor/Plugins|Plugins]]
*[[Resource:Editor#FAQ|Questions Fréquentes]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Développer Multi Theft Auto====
* [[FR/Compiler_MTASA|Compiler MTASA sur Windows]]
* [[FR/Compiler_MTASA_Server_sur_Mac_OS_X|Compiler MTASA sur Mac OS X]]
* [[FR/Compiler_MTASA_Server_sur_GNU_Linux|Compiler MTASA sur GNU/Linux]]
* [[FR/Directives_de_codage|Directives de codage]]
* [http://code.google.com/p/mtasa-blue Google Code SVN]
* [[FR/Roadmap|Roadmap]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Références====
* [[FR/Fonctions_Clients|Fonctions Clients]]
* [[FR/Events_Clients|Events Clients]]
* [[FR/Fonctions_Serveurs|Fonctions Clients]]
* [[FR/Events_Serveurs|Events Clients]]

* [[FR/MTA Classes|MTA Classes]] - Les descriptions détaillées de tous les types personnalisés MTA
** [[FR/Element|MTA Elements]] / [[Element tree]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====[[Id|ID Listes]]====
*[[FR/Animations|Animations]]
*[[FR/Skins_Personnages|Skins Personnages]]
*[[FR/Vetements_CJ|Vêtements CJ]]
*[[FR/Garage|Garage IDs]]
*[[FR/Interieurs_IDs|Intérieurs IDs]]
*[[FR/Materiel_IDs|Matériel IDs]]
*[[FR/Projectiles|Projectiles]]
*[[FR/Radar Blips|Radar Blips]]
*[[FR/Sons|Sons]]
*[[FR/Vehicule_IDs|ID des véhicules]]
*[[FR/Vehicule_Couleurs|Couleurs véhicules]]
*[[FR/Vehicule_Upgrades|Tuning IDs]]
*[[FR/Armes|Armes]]
*[[FR/Meteos|Météos]]
</div>

|-
| colspan="2" |
|}
{{Languages list|fr}}

FR/Ressources

2012-05-19T12:44:07Z

Myk3L:

Les ressources sont une grande partie de MTA. Une ressource est un dossier ou une archive zip qui contient une multitude de fichiers - contenant des scripts et le fichier meta ''meta'' qui décrit comment la ressource doit se charger. Une ressource peut être comparée à un logiciel exécutez dans un système d'exploitation - il peut être démarré, arrêté et plusieurs logiciels peuvent démarrer ensemble. Chose à se rappeler : il n'y a pas de multi-tâches entre les ressources (à l'instar des logiciels)

==Définitions==
* '''Resource''' - Une archive zip ou un dossier contenant un fichier meta.xml et des fichiers ("resource item"). Elles sont placées dans le dossier ''mods/deathmatch/resources'' du serveur.
* '''Resource item''' - Un fichier contenu dans une ressource, qui peut être un script, une image, une map...

==Le fichier meta==
''Voir l'article [[Meta.xml]] pour plus de détails''

Le fichier meta est le coeur de chaque ressource. Il décris exactement quels fichiers dans quelles ressources doivent être utilisé, et comment. Le fichier suivant montre toutes les options possibles de vos fichiers meta qui peut, suivant vos besoins, être toutes utilisé, ou partiellement... :

<syntaxhighlight lang="xml">
<meta>
<info author="eAi" description="Simple script de CTF (Capture de drapeau)" 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>
Tandis que le fichier meta d'une map pour le script ci-dessus ressemble à ça :
<syntaxhighlight lang="xml">
<meta>
<include resource="ctf" />
<map src="myuberl33tctfmap.map" />

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

Les attributs Script/type, Config/type et File/type spécifient si le/la script/resource doit être envoyé au client ou par défaut au "server".

La balise include spécifie les autres ressources qui doivent être chargées avant que la ressource se lance. En d'autres termes, si votre ressource dépend d'une (ou plusieurs) autre ressource, vous pouvez l'inclure, et elle se chargera avant votre ressource.

Chaque ressource a sa propre machine virtuelle (VM, comme Virtual Machine en anglais). Elle contient tous les scripts dans la ressource. Ce qui signifie que les variables ne sont pas partagées avec les autres ressources. La meilleur chose à faire pour communiquer avec les autres ressources est d'utiliser la balise ''export'' et les fonctions d'export. Cela autorisera à utiliser cette fonction en utilisant la fonction [[call]].

Les scripts envoyés au client démarre lorsque tous ont été téléchargés.

Les scripts peuvent lire et écrire dans leur dossier avec les fonctions comme [[xmlCreateFile]] et [[fileCreate]]. Elle peut aussi lire et écrire dans d'autres ressources mais doivent avoir un accès spécial (voir [[Access_Control_List|ACL]])

Chaque ressource ne peut être chargée qu'une seule et unique fois, le serveur vérifie si c'est le cas. Si elle est chargée plusieurs fois, la même instance va être utilisée par chaque ressource qui l'utilise.

==Stockage des fichiers==
Les ressources sont stockée soit dans un dossier, soit dans une archive zip situé(e) dans :

server/mods/deathmatch/resources/ (si vous avez installé le serveur avec le client)

ou

mods/deathmatch/resources/ (pour les installations dédiées)

Chaque ressource peut contenir une archive zip, un dossier (ou les deux). Dans le cas où les deux existent, le dossier à "la priorité" sur l'archive zip. Les fichiers peuvent être placer tels quels dans le dossier pour "écraser" l'archive zip.
Les dossiers sont donc la plupart du temps utilisés pour faire des tests ou développer des maps/scripts et les archives zip sont utilisées lorsque la ressource est terminée et mise sur le serveur.

==Notes==
*Les noms de ressouces ne peuvent contenir des points (".").
*Si la ressource sauvegarde des fichiers, les noms de ces fichiers ne doivent pas être mis dans le meta.xml
*Les fichiers listés dans le meta.xml doient être considéré comme "lisable seulement (read-only)" par votre script. Ne pas les modifier avec les fonctions xmlSaveFile, FileSave etc.
*Quand vous faites une archive zip de votre ressource, ne mettez pas les fichiers à sauvegarder dedans. Si votre ressource utilise des fichiers à sauvegarder, ils doivent être créés par votre ressource quand elle en a besoin.
*Quand vous faites une archive zip de votre ressource, mettez seulement les fichiers listés dans le meta.xml. Ne mettez pas les fichiers à sauvegarder sinon des choses étranges vont se passer.
*Nous vous recommandons d'éviter les espaces et les caractères spéciaux de vos noms de ressources.

==Fonctions==
Le système de ressources peut être manipuler par le script. Voici des fonctions utiles (server-side, côté serveur) :
{{Resource functions}}

Ainsi que les évenements suivant :
{{Resource_events}}

[[it:Introduzione alle Risorse]]
[[ru:Resources]]
[[fr:Ressources]]

FR/Ressources

2012-05-19T12:42:40Z

Myk3L: Created page with "Les ressources sont une grande partie de MTA. Une ressource est un dossier ou une archive zip qui contient une multitude de fichiers - contenant des scripts et le fichier meta ''..."