Multi Theft Auto: Wiki - User contributions [en]

GetElementVelocity

2011-06-18T16:00:26Z

Mickdermack: Replaced deprecated function getPlayerFromNick with getPlayerFromName

{{Server client function}}
__NOTOC__
This function returns three floats containing the velocity (movement speeds) along the X, Y, and Z axis respectively. This means that velocity values can be positive and negative for each axis.

==Syntax==
<syntaxhighlight lang="lua">float float float getElementVelocity ( element theElement )</syntaxhighlight>

===Required Arguments===
*'''theElement''': The [[element]] you wish to retrieve the velocity of.

===Returns===
If succesful, returns three ''float''s that represent the element's current velocity along the ''x'', ''y'', and ''z'' axis respectively. This function can fail if the element is a player in a car. Use the vehicle element in this case. It will also fail if the element specified does not have a velocity, or does not exist. In case of failure, the first return value will be ''false''.

The returned values are expressed in GTA units per 1/50th of a second[http://forum.mtasa.com/viewtopic.php?f=91&t=31225]. A GTA Unit is equal to one metre[http://gta.wikia.com/Unit#GTA3.2C_GTAVC_.26_GTASA].

==Example==
<section name="Server" class="server" show="true">
This example retrieves, calculates, and displays the speed of a player named ''someguy''.
<syntaxhighlight lang="lua">
-- find a player named "someguy" and get his velocity.
speedx, speedy, speedz = getElementVelocity ( getPlayerFromName ( "someguy" ) )

-- use pythagorean theorem to get actual velocity
-- raising something to the exponent of 0.5 is the same thing as taking a square root.
actualspeed = (speedx^2 + speedy^2 + speedz^2)^(0.5)

-- multiply by 50 to obtain the speed in metres per second
mps = actualspeed * 50

-- other useful conversions
-- kilometres per hour
kmh = actualspeed * 180
-- miles per hour
mph = actualspeed * 111.847

-- report the results.
outputChatBox ( "Someguy's current velocity: " .. mps .. " metres per second." )
</syntaxhighlight>
</section>

==See Also==
{{element functions}}

DE/Resource:Editor

2011-01-30T12:30:03Z

Mickdermack: Diverse Tipp- und Rechtschreibfehler korrigiert /* Elemente verschieben */ Einen unübersetzten Satz übersetzt.

{{Resource page}}
Der MTA:SA Map Editor erlaubt es dir Maps für Gamemodes zu erstellen.

==Starten==
Um den Map Editor zu starten, musst du nur auf den "Map Editor" Menüpunkt im MTA Hauptmenü klicken.

==Menüs==
Sobald der Map Editor gestartet wurde, solltet ihr 2 Menüleisten sehen können: das Hauptmenü am oberen und das Element-Menü am unteren linken Rand des Bildschirms.

===Hauptmenü===
Die sind die Buttons im Hauptmenü:
* [[Image:Editor_New.png]] Eine neue Map erstellen.
* [[Image:Editor_Open.png]] Eine bereits existierende Map öffnen.
* [[Image:Editor_Save.png]] Map speichern.
* [[Image:Editor_Save_as.png]] Map unter einem anderen Namen speichern.
* [[Image:Editor_Options.png]] Allgemeine Einstellungen des Map Editors verändern.
* [[Image:Editor_Undo.png]] Die letzte Aktion rückgängig machen.
* [[Image:Editor_Redo.png]] Die letzte Aktion wiederherstellen.
* [[Image:Editor_Locations.png]] Liste von gespeicherten Orten und Interiors (Innenräume) anzeigen, zudem kannst du auch eigene Orte und Interiors abspeichern.
* [[Image:Editor_Current_elements.png]] Liste, mit allen Elementen deiner Map, anzeigen. (Objekte, Fahrzeuge, Markierungen, Pickups etc.)
* [[Image:Editor_Map_settings.png]] Map spezifische Einstellungen, wie z.B. Wetter, Tageszeit oder Schwerkraft, ändern. Hier kannst du zudem einstellen mit welchen Gamemodes deine Map kompatibel ist.
* [[Image:Editor_Definitions.png]] Lade eine [[Resource:Editor/EDF|editor definition file (EDF)]] die du benutzen möchtest.
* [[Image:Editor_Test.png]] In den Test-Modus wechseln um deine Map zu testen. Hast du zudem in den Map Einstellungen einen Gamemode angegeben kannst du deine Map sofort mit diesem testen.

===Element Menü===
Das Element Menü dient zum Hinzufügen neuer Elemente zu deiner Map.
* [[Image:Editor_Vehicle.png]] Erstelle ein neues Fahrzeug
* [[Image:Editor_Object.png]] Erstelle ein neues Objekt (Gebäude, Straßen, Bäume etc.).
* [[Image:Editor_Pickup.png]] Erstelle ein neues Pickup (Gesundheit, Rüstung, Waffen etc.).
* [[Image:Editor_Marker.png]] Erstelle eine neue Makierung.

Zusätzlich kannst du, wenn du eine [[Resource:Editor/EDF|EDF geladen]] hast, mit der Maus über das Element Menü fahren und durch scrollen des Mausrades benutzerdefinierte Elemente anzeigen.

==Benutzung des Editors==
Dieser Abschnitt erklärt wie man Maps erstellt und bearbeitet.

===Auf der Map bewegen===
Direkt nach dem Starten des Editors, befindest du dich im ''Kamera-Modus''. Mit Hilfe der '''WASD''' Tasten kannst du die Kamera bewegen, mit der Maus kannst du die Kamera schwenken. Hältst du während du die Kamera bewegst '''ALT''' gedrückt bewegt sich die Kamera langsamer, hältst du '''SHIFT''' gedrückt bewegt sich diese schneller.

Um auf das Interface (Menüs) des Map Editors zugreifen zu können, musst du in den ''Mauszeiger-Modus'' wechseln, dies erreichst du durch drücken der '''F''' Taste, drückst du diese erneut gelangst du wieder zurück in den ''Kamera-Modus''.
Während du im ''Mauszeiger-Modus'' bist, ist die Kamera fixiert und du kannst mit Hilfe des Mauszeigers Elemente bearbeiten oder auf die Menüs zugreifen.

Das du gerade im ''Kamera-Modus'' bist erkennst du daran, dass in der Mitte des Bildschirms ein Fadenkreuz zu sehen ist, mit diesem kannst du genau wie im ''Mauszeiger-Modus'' Elemente auswählen und bewegen.

[[Image:Editor_Crosshair.png|center]]

===Eine neue Map beginnen===
* Starte den Editor und drücke im oberen Menü auf den ''New'' Button.
* Drücke nun den ''Map Settings'' Button und wechsle in den ''Meta'' Tab, trage in das ''Name'' Feld den Namen deiner Map ein und in das ''Author'' Feld deinen eigenen Namen. Öffne zudem den ''Gamemodes'' Tab und füge nun dort die Gamemodes für die deine Map gedacht ist hinzu, dies erreichst du entweder durch einen Doppel-Klick auf den Namen des Gamemodes oder durch das Drücken des ''Add'' Buttons (die Gamemodes sollten sich dann im rechten Feld mit dem Namen ''Added gamemodes'' befinden). Klicke ''OK'' wenn du fertig bist.
[[Image:Editor_Mapsettings.png|center]]
*Klicke jetzt im oberen Menü auf den ''Definitions'' Button und füge, ähnlich wie du es gerade mit den Gamemodes getan hast, Ressourcen deren benutzerdefinierte Elemente du nutzen möchtest zur Liste auf der rechten seite des Fensters hinzu. Klicke ''OK'' wenn du fertig bist.
Für mehr Informationen zu den EDFs solltest du dir [[Resource:Editor/EDF|diesen Artikel durchlesen]]

===Neue Elemente erstellen===
Das Hinzufügen von Elementen, wie Vehikeln oder Objekten, ist sehr einfach.
* Wechsel zunächst, durch drücken der '''F''' Taste in den Mauszeiger-Modus, falls du dich im Kamera-Modus befindest.
* Klicke im Element Menü auf den Button des Elements welches du hinzufügen möchtest, klicke z.B. auf den Button auf dem ein Auto abgebildet ist um neue Vehikel zu erstellen.
* Das entsprechende Element wird erstellt und an den Mauszeiger "geheftet". Bewege es nun an einen Ort deiner Wahl und drücke die '''linke Maustaste''' um das Objekt zu platzieren.

[[Image:Editor_Addelem.png|center]]

Um benutzerdefinierte Elemente einer Ressource zu erstellen, fahre mit dem Mauszeiger über das Element Menü und scrolle solange mit dem Mausrad bis die gewünschte Ressource und deren Elemente erscheinen.
Beachte das du jedoch zunächst die zur Ressource gehörende [[Resource:Editor/EDF|EDF]] im ''Definitions'' Fenster hinzugefügt haben musst.

[[Image:Editor_Selectedf.png|center]]

===Elemente auswählen===
* '''Linksklick''' auf ein Element um es im ''Tastaturmodus'' auszuwählen.
* '''Rechtsklick''' auf ein Element um es im ''Mausmodus'' auszuwählen.
* '''Leertaste''' drücken oder in einen leeren Bereich klicken um die Auswahl aufzuheben.

Das ausgewählte Element wird durch eine gelbe konische Markierung hervorgehoben. Elemente (vor allem Objekte) mit mangelhaften Kollisionen können leichter ausgewählt werden, wenn man durch Drücken von '''E''' den ''"High sensitivity mode"'' aktiviert, der die Erkennung verbessert, aber die Genauigkeit senkt.

Der ''"Current elements"'' Dialog kann auch verwendet werden um Elemente auszuwählen. Doppelklick auf ein Element wählt es im ''Tastaturmodus'' aus.

===Elemente verschieben===
Elemente können über verschiedene Wege verschoben werden.

'''Mit der Maus'''
* Elemente können über Drag & Drop mit '''Linksklick''' verschoben werden.
Oder:
* Wähle das Element im Mausmodus mit ('''Rechtsklick'''), bewege es dort hin, wo du es haben willst, und Klicke um es zu platzieren.

Du kannst auch die ''Distanz'' von einem Element zur Kamera ändern durch wählen des '''Kameramodus''', '''Rechtsklick''' auf das Element, und rollen des '''Mausrad'''.

'''Mit der Tastatur'''
* Wähle das Element im Tastaturmodus ('''Linksklick''').
* Benutze die '''Pfeiltasten''' um das Element horizontal zu bewegen, und '''Bild hoch'''/'''Bild runter''' um es vertikal zu bewegen. Halte '''ALT''' um die Bewegungsgeschwindigkeit zu verringern, oder '''SHIFT''' um die Bewegungsgeschwindigkeit zu erhöhen.

Standardmäßig werden Elemente relativ zur Kamera bewegt, die Bewegungen sind nicht auf Achsen limitiert. Dieses Verhalten kann im ''Options'' Menü geändert werden.

===Elemente drehen===
'''Mit der Maus'''

Du kannst die ausgewählten Elemente um die Z Achse mit dem '''Mausrad''' drehen.
* Wähle das Element im Tastaturmodus ('''Linksklick''') und rolle das Mausrad, während du '''STRG-Links''' gedrückt hältst.
Oder:
* Wähle das Element im Mausmodus ('''Rechtsklick'''), halte '''STRG''', und rolle das Mausrad.

'''Mit der Tastatur'''
* Wähle das Element im Tastaturmodus ('''Linksklick''').
* Während du '''STRG''' hältst (der Auswahl Marker wird grün), benutze die '''Pfeiltasten''' and '''Bild hoch'''/'''Bild runter''' um das Element um die verschiedenen Achsen zu bewegen.

Bei beiden Methoden kannst du '''ALT''' gedrückt halten um die Drehgeschwindigkeit zu verringern oder '''SHIFT''' um die Drehgeschwindigkeit zu erhöhen.

[[Image:Editor_Rotateelem.png|center]]

===Model ändern und andere Einstellungen===
Die meisten Elemente haben eine Vielfalt von Optionen die verändert werden können um das Aussehen und Verhalten der Elemente zu verändern. z.B. Model, Farbe und Tuning von einem Auto.

* Öffne das Einstellungsfenster von einem Element indem du es Doppelklickst oder es wählst und '''F3''' drückst.
* Mach die Veränderungen, die du willst. z.B. um das Model von einem Auto oder Objekt zu ändern, klicke den '''Browse''' Button neben '''model''' um den Modellbrowser zu öffnen.
* Klicke OK wenn du fertig bist.

[[Image:Editor_Props.png|center]]

===Klonen===
Du kannst ein Element klonen indem du es auswählst und '''C''' drückst.

* Im Mausmodus wird das Model an den Cursor "gehängt". '''Linksklick''' um es auf der Karte zu platzieren.
* Im Tastaturmodus wird das geklonte Element in der identischen Position geklont.

Wenn du '''STRG''' drückst, während du auf das Element klickst, wird das Element wieder geklont und an den Cursor "gehängt". Mit diesem Weg kannst du ganz einfach große Mengen von etwas Platzieren.

Alternativ kannst du auch den ''>'' Button unten-rechts in der Einstellungsbox benutzen um ein Element zu klonen.

===Löschen===
Wähle das Element und drücke '''Entf''' ''(Entfernen)''.

Alternativ kannst du auch den ''>'' Button unten-rechts in der Einstellungsbox benutzen, um ein Element zu löschen.

==Maps erstellen für bestimmte Gamemodes==
Um eine Map für einen bestimmten Gamemode zu erstellen, hast du zwei Dinge zu tun:
* Klicke den '''Map Settings''' Button in dem oberen Menü, gehe zu dem '''Gamemodes''' Tab und füge alle Gamemodes hinzu die diese Map benutzen sollen.
* Wahrscheinlich wirst du brauchen eine oder mehrere [[Resource:Editor/EDF|Editor Definition Files]] hinzuzufügen. Diese erlauben es dir in deiner Map Gamemode bestimmte Elemente zu platzieren, wie Spawnpoints, Race Checkpoints, oder CTF Flaggen. Du kannst EDF's hinzufügen, indem du den '''Definitions''' Menü Button klickst und die entsprechenden Gamemodes hinzufügst.

==Controls==
Hier ist eine Liste von allen Standart Steuerungen. Um sie zu ändern gehe zu den MTA Einstellungen während der Map Editor gestartet ist.

===Kamera===
{|
|-
| camera_move_forwards
| '''w'''
|-
| camera_move_backwards
| '''s'''
|-
| camera_move_left
| '''a'''
|-
| camera_move_right
| '''d'''
|-
| high_sensitivity_mode
| '''e'''
|}

===Klonen===
{|
|-
| clone_selected_element
| '''c'''
|-
| clone_drop_modifier
| '''lctrl''' || ''(Left CTRL)''
|}

===Element manipulation===
{|
|-
| element_move_forward
| '''arrow_u''' || ''(Arrow key Up)''
|-
| element_move_backward
| '''arrow_d''' || ''(Arrow key Down)''
|-
| element_move_left
| '''arrow_l''' || ''(Arrow key Left)''
|-
| element_move_right
| '''arrow_r''' || ''(Arrow key Right)''
|-
| element_move_downwards
| '''pgdn''' || ''(Page Down)''
|-
| element_move_upwards
| '''pgup''' || ''(Page Up)''
|-
| zoom_in
| '''mouse_wheel_down'''
|-
| zoom_out
| '''mouse_wheel_up'''
|-
| quick_rotate_increase
| '''mod_rotate''' + '''mouse_wheel_up''' || ''(Left CTRL + Mouse wheel Up)''
|-
| quick_rotate_decrease
| '''mod_rotate''' + '''mouse_wheel_down''' || ''(Left CTRL + Mouse wheel Down)''
|-
| mod_rotate
| '''lctrl''' || ''(Left CTRL)''
|-
| mod_slow_speed
| '''lalt''' || ''(Left ALT)''
|-
| mod_fast_speed
| '''lshift''' || ''(Left SHIFT)''
|-
| destroy_selected_element
| '''delete'''
|-
| drop_selected_element
| '''space'''
|-
| pickup_selected_element
| '''F2'''
|-
| reset_rotation
| '''mod_rotate''' + '''r''' || ''(Left CTRL + R)''
|}

===GUI===
{|
| toggle_gui_display
| '''F4'''
|-
| toggle_cursor
| '''f'''
|-
| select_target_keyboard
| '''mouse1''' || ''(Left Mouse button)''
|-
| select_target_mouse
| '''mouse2''' || ''(Right Mouse button)''
|-
| edf_next
| '''mouse_wheel_up'''
|-
| edf_prev
| '''mouse_wheel_down'''
|-
| undo
| '''Ctrl''' + '''z'''
|-
| redo
| '''Ctrl''' + '''y'''
|-
| properties_toggle
| '''F3'''
|-
| browser_up
| '''arrow_u''' || ''(Arrow key Up)''
|-
| browser_down
| '''arrow_d''' || ''(Arrow key Down)''
|-
| browser_zoom_in
| '''mouse_wheel_up'''
|-
| browser_zoom_out
| '''mouse_wheel_down'''
|-
| browser_confirm
| '''enter'''
|-
| currentelements_up
| '''num_8''' || ''(Numpad key 8)''
|-
| currentelements_down
| '''num_2''' || ''(Numpad key 2)''
|-
| toggle_test
| '''F5'''
|}

==Multiplayer==
Der Editor ist "gebaut" mit Server- und Clientseitigen Komponenten, und unterstüzt Multiplayer.
Um den Editor im Multliplayer-Modus zu benutzen, kopiere die Map-Editpr Ressourcen in deinen Server, starte die '''editor''' Ressource und erlaube Spielern beizutreten.

Vergesse nicht, dass jeder Spieler Zugriff auf jede Funktion des Map-Editors hat!

==Plugins & Externe Ressourcen==
{{Main|Resource:Editor/Plugins}}

Der Editor erlaubt importieren von Elementen von Externen Ressourcen. Diese Funktion ist nützlich für Ressourcen die ein Element verändern müssen, wie es in dem Map-Editor nicht möglich ist. Zum Beispiel, für eine Map-Ressource, welche das Modell ändern muss.

Beim Benutzen des '''import <resourceName>''' command in der Konsole können die Ressource-Elemente in den Editor importiert werden.

==FAQ==
==== Ich bekomme einen schwarzen Bildschirm beim Ausführen des Map-Editors ====

Meistens passiert der Fehler durch inkorrekte Installation der Map-Editor-Ressourcen. Wenn du einen stabilen MTASA Client benutzt, installiere ihn erneut und sei dir dabei sicher, dass du die "Server und Client Option" auswählst.

Wenn du die Nightly Build Version von MTASA benutzt, lade dir die neueste Version [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 hier], entpacke das Archiv und verschiebe seinen Inhalt nach:
''MTA San Andreas\server\mods\deathmatch\resources'' , wo ''MTA San Andreas'' der Ordner ist wohin du MTASA installiert hast. (Standart Ort: C:\Programme\MTA San Andreas).

In diesen Pfad verschieben: MTA San Andreas\mods\deathmatch\resources '''ist ein häufiger Fehler''' - es funktioniert nicht wenn du es dort hin verschiebst.
Sei dir sicher, dass du die Dateien in den oben genannten Pfad gelegt hast.

Wenn der Fehler trotzdem erscheint, kann es sein, dass du eine veraltete '''acl.xml''' hast.
Du kannst die Standard '''acl.xml''' [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/acl.xml hier] runterladen. Es sollte in '''server/mods/deathmatch/''' in deinem MTASA Ordner platziert werden.

==== Ich bekomme einen "Could not start the local server. See console for details" Fehler, wenn ich den "Map Editor" Button benutze ====
Dieser Fehler entsteht, wenn du keine gültige editor.conf installiert hast. Du kannst die Standard editor.conf [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/editor.conf hier] runterladen.
Die Datei sollte in dem '''server/mods/deathmatch/''' Ordner in deinem MTASA Verzeichnis platziert werden.

==== Ich habe eine Map erstellt, kann sie aber nicht finden, aber im Map-Editor öffnen ====
Das ist dadurch, dass nicht-Admin Prozesse keine Schreibrechte in dem MTASA Verzeichnis haben. Dateien werden in das "VirtualStore" Verzeichnis geschrieben. Du solltest deine Map in diesem Verzeichnis finden:
C:\Users\<USERNAME>\AppData\Local\VirtualStore\Program Files\MTA San Andreas\server\mods\deathmatch\resources\

Den MTA Server als Administrator auszuführen erlaubt die Dateien direkt in dem Verzeichnis zu speichern.

==== Ich habe einen Bug gefunden oder habe Anregungen/Feedback für den Map Editor ====
Bitte benutze den offiziellen [http://bugs.mtasa.com Bugtracker] um Bugs zu melden. Du kannst auch den [http://www.multitheftauto.com/irc.html IRC Channel] benutzen.

[[ru:Resource:Editor]]

DE/Resource:Editor

2010-08-24T15:10:56Z

Mickdermack: Abschnitt Selecting/Elemente auswählen übersetzt

{{Resource page}}
Der MTA:SA Map Editor erlaubt es dir Maps für Gamemodes zu erstellen.

==Starten==
Um den Map Editor zu starten, musst du nur auf den "Map Editor" Menüpunkt im MTA Hauptmenü klicken.

==Menüs==
Sobald der Map Editor gestartet wurde, solltet ihr 2 Menüleisten sehen können: das Hauptmenü am oberen und das Element-Menü am unteren linken Rand des Bildschirms.

===Hauptmenü===
Die sind die Buttons im Hauptmenü:
* [[Image:Editor_New.png]] Eine neue Map erstellen.
* [[Image:Editor_Open.png]] Eine bereits exestierende Map öffnen.
* [[Image:Editor_Save.png]] Map speichern.
* [[Image:Editor_Save_as.png]] Map unter einem anderen Namen speichern.
* [[Image:Editor_Options.png]] Allgmeine Einstellungen des Map Editors verändern.
* [[Image:Editor_Undo.png]] Die letzte Aktion rückgängig machen.
* [[Image:Editor_Redo.png]] Die letzte Aktion wiederherstellen.
* [[Image:Editor_Locations.png]] Liste von gespeicherten Orten und Interriors (Innenräume) anzeigen, zudem kannst du auch eigene Orte und Interriors abspeichern.
* [[Image:Editor_Current_elements.png]] Liste, mit allen Elementen deiner Map, anzeigen. (Objekte, Fahrzeuge, Markierungen, Pickups etc.)
* [[Image:Editor_Map_settings.png]] Map spezifische Einstellungen, wie z.B. Wetter, Tageszeit oder Schwerkraft, ändern. Hier kannst du zudem einstellen mit welchen Gamemodes deine Map kompatibel ist.
* [[Image:Editor_Definitions.png]] Lade eine [[Resource:Editor/EDF|editor definition file (EDF)]] die du benutzen möchtest.
* [[Image:Editor_Test.png]] In den Test-Modus wechseln um deine Map zu testen. Hast du zudem in den Map Einstellungen einen Gamemode angegeben kannst du deine Map sofort mit diesem testen.

===Element Menü===
Das Element Menü dient zum Hinzufügen neuer Elementer zu deiner Map.
* [[Image:Editor_Vehicle.png]] Erstelle ein neues Fahrzeug
* [[Image:Editor_Object.png]] Erstelle ein neues Objekt (Gebäude, Straßen, Bäume etc.).
* [[Image:Editor_Pickup.png]] Erstelle ein neues Pickup (Gesundheit, Rüstung, Waffen etc.).
* [[Image:Editor_Marker.png]] Erstelle eine neue Makierung.

Zusätzlich kannst du, wenn du eine [[Resource:Editor/EDF|EDF geladen]] hast, mit der Maus über das Element Menü fahren und durch scrollen des Mausrades benutzerdefinierte Elemente anzeigen.

==Benutzung des Editors==
Dieser Abschnitt erklärt wie man Maps erstellt und bearbeitet.

===Auf der Map bewegen===
Direkt nach dem Starten des Editors, befindest du dich im ''Kamera-Modus''. Mit Hilfe der '''WASD''' Tasten kannst du die Kamera bewegen, mit der Maus kannst du die Kamera schwenken. Hälst du wärend du die Kamera bewegst '''ALT''' gedrückt bewegt sich die Kamera langsamer, hälst du '''SHIFT''' gedrückt bewegt sich diese schneller.

Um auf das Interface (Menüs) des Map Editors zugreifen zu können, musst du in den ''Mauszeiger-Modus'' wechseln, dies erreichst du durch drücken der '''F''' Taste, drückst du diese erneut gelangst du wieder zurück in den ''Kamera-Modus''.
Wärend du im ''Mauszeiger-Modus'' bist, ist die Kamera fixiert und du kannst mit Hilfe des Mauszeigers Elemente bearbeiten oder auf die Menüs zugreifen.

Das du gerade im ''Kamera-Modus'' bist erkennst du daran, dass in der Mitte des Bildschirms ein Fadenkreuz zu sehen ist, mit diesem kannst du genau wie im ''Mauszeiger-Modus'' Elemente auswählen und bewegen.

[[Image:Editor_Crosshair.png|center]]

===Eine neue Map beginnen===
* Starte den Editor und drücke im oberen Menü auf den ''New'' Button.
* Drücke nun den ''Map Settings'' Button und wechsel in den ''Meta'' Tab, trage in das ''Name'' Feld den Namen deiner Map ein und in das ''Author'' Feld deinen eigenen Namen. Öffne zudem den ''Gamemodes'' Tab und füge nun dort die Gamemodes für die deine Map gedacht ist hinzu, dies erreichst du entwerde durch einen Doppel-Klick auf den Namen des Gamemodes oder durch das Drücken des ''Add'' Buttons (die Gamemodes sollten sich dann im rechten Feld mit dem Namen ''Added gamemodes'' befinden). Klicke ''OK'' wenn du fertig bist.
[[Image:Editor_Mapsettings.png|center]]
*Klicke jetzt im oberen Menü auf den ''Definitions'' Button und füge, ähnlich wie du es gerade mit den Gamemodes getan hast, Ressourcen deren benutzerdifnierte Elemente du nutzen möchtest zur Liste auf der rechten seite des Fensters hinzu. Klicke ''OK'' wenn du fertig bist.
Für mehr Informationen zu den EDFs solltest du dir [[Resource:Editor/EDF|diesen Artikel durchlesen]]

===Neue Elemente erstellen===
Das Hinzufügen von Elementen, wie Vehikeln oder Objekten, ist sehr einfach.
* Wechsel zunächst, durch drücken der '''F''' Taste in den Mauszeiger-Modus, falls du dich im Kamera-Modus befindest.
* Klicke im Elemnt Menü auf den Button des Elements welches du hinzufügen möchtest, klicke z.B. auf den Button auf dem ein Auto abgebildet ist um neue Vehikel zu erstellen.
* Das entsprechende Element wird erstellt und an den Mauszeiger "gehäftet". Bewege es nun an einen Ort deiner Wahl und drücke die '''linke Maustaste''' um das Objekt zu platzieren.

[[Image:Editor_Addelem.png|center]]

Um benutzerdfinierte Elemente einer Ressource zu erstellen, fahre mit dem Mauszeiger über das Element Menü und scrolle solange mit dem Mausrad bis die gewünschte Ressource und deren Elemente erscheinen.
Beachte das du jedoch zunächst die zur Ressource gehörende [[Resource:Editor/EDF|EDF]] im ''Definitions'' Fenster hinzugefügt haben musst.

[[Image:Editor_Selectedf.png|center]]

===Elemente auswählen===
* '''Linksklick''' auf ein Element um es im ''Tastaturmodus'' auszuwählen.
* '''Rechtsklick''' auf ein Element um es im ''Mausmodus'' auszuwählen.
* '''Leertaste''' drücken oder in einen leeren Bereich klicken um die Auswahl aufzuheben.

Das ausgewählte Element wird durch eine gelbe konische Markierung hervorgehoben. Elemente (vor allem Objekte) mit mangelhaften Kollisionen können leichter ausgewählt werden, wenn man durch Drücken von '''E''' den ''"High sensitivity mode"'' aktiviert, der die Erkennung verbessert, aber die Genauigkeit senkt.

Der ''"Current elements"'' Dialog kann auch verwendet werden um Elemente auszuwählen. Doppelklick auf ein Element wählt es im ''Tastaturmodus'' aus.

===Moving===
Moving elements can be done in several ways.

'''With the mouse'''
* Simply drag and drop with the '''left mouse button'''.
Or:
* Select the element in mouse mode ('''right click'''), move it to where you want it, and click to drop it off.

You can also adjust the ''Hold distance'' of an element toward and away from the camera by switching to camera mode, '''right clicking''' the element, and rolling the '''mouse wheel'''.

'''With the keyboard'''
* Select the element in keyboard mode ('''left click''').
* Use the '''arrow keys''' to move the element in the horizontal plane, and '''PgUp'''/'''PgDn''' to move it vertically. Hold '''ALT''' to decrease the movement speed, or '''SHIFT''' to increase it.

By default, elements move relative to the camera and are not locked to any axes. This can be disabled in the ''Options'' menu.

===Rotating===
'''With the mouse'''

You can rotate selected elements around the Z axis with the mouse wheel.
* Select the element in keyboard mode ('''left click''') and roll the mouse wheel while holding '''Left CTRL'''.
Or:
* Select the element in mouse mode ('''right click'''), hold '''CTRL''', and roll the mouse wheel.

'''With the keyboard'''
* Select the element in keyboard mode ('''left click''').
* While holding '''CTRL''' (the selection marker will turn green), use the '''arrow keys''' and '''PgUp'''/'''PgDn''' to rotate the element around the different axes.

With both methods you can additionally hold '''ALT''' to decrease the rotation speed or '''SHIFT''' to increase it.

[[Image:Editor_Rotateelem.png|center]]

===Changing model and other properties===
Most elements have a variety of options that can be altered to change their appearance and behaviour. Examples are the model, color and visual upgrades of a car.

* Open the properties window of an element by either double clicking it or by selecting it and pressing '''F3'''.
* Make any alterations that you want. For example, to change the model of a car or object, click the '''Browse''' button next to "model" to open the model browser.
* Click OK when you're done.

[[Image:Editor_Props.png|center]]

===Cloning===
You can clone an element by selecting it and pressing '''C'''.

* In mouse mode the cloned element will be attached to your cursor. '''Left click''' to place it in the map.
* In keyboard mode the cloned element will be cloned in the identical position.

If you hold '''CTRL''' while clicking, the element will be cloned again and will again be attached to the cursor. This way you can easily place large quantities of something.

Alternatively you can use the ''Pullout'' button located in the bottom-right corner of the properties box to clone an element.

===Deleting===
Simply select the element and press '''DEL''' ''(Delete)''.

Alternatively you can use the ''Pullout'' button located in the bottom-right corner of the properties box to delete an element.

==Creating maps for specific gamemodes==
To make a map for a specific gamemode, you have to do two things:
* Click the '''Map Settings''' button in the top menu, go to the '''Gamemodes''' tab and add any gamemodes that your map is to be used with.
* You will likely also need to add one or more [[Resource:Editor/EDF|Editor Definition Files]]. These will allow you to place gamemode specific elements in the map, like spawnpoints, race checkpoints, or CTF flags. You can add EDF's by clicking the '''Definitions''' menu button and adding the relevant gamemodes.

==Controls==
Here is a list of all default controls. To change them please go to the MTA Settings menu while the Editor is started.

===Camera===
{|
|-
| camera_move_forwards
| '''w'''
|-
| camera_move_backwards
| '''s'''
|-
| camera_move_left
| '''a'''
|-
| camera_move_right
| '''d'''
|-
| high_sensitivity_mode
| '''e'''
|}

===Cloning===
{|
|-
| clone_selected_element
| '''c'''
|-
| clone_drop_modifier
| '''lctrl''' || ''(Left CTRL)''
|}

===Element manipulation===
{|
|-
| element_move_forward
| '''arrow_u''' || ''(Arrow key Up)''
|-
| element_move_backward
| '''arrow_d''' || ''(Arrow key Down)''
|-
| element_move_left
| '''arrow_l''' || ''(Arrow key Left)''
|-
| element_move_right
| '''arrow_r''' || ''(Arrow key Right)''
|-
| element_move_downwards
| '''pgdn''' || ''(Page Down)''
|-
| element_move_upwards
| '''pgup''' || ''(Page Up)''
|-
| zoom_in
| '''mouse_wheel_down'''
|-
| zoom_out
| '''mouse_wheel_up'''
|-
| quick_rotate_increase
| '''mod_rotate''' + '''mouse_wheel_up''' || ''(Left CTRL + Mouse wheel Up)''
|-
| quick_rotate_decrease
| '''mod_rotate''' + '''mouse_wheel_down''' || ''(Left CTRL + Mouse wheel Down)''
|-
| mod_rotate
| '''lctrl''' || ''(Left CTRL)''
|-
| mod_slow_speed
| '''lalt''' || ''(Left ALT)''
|-
| mod_fast_speed
| '''lshift''' || ''(Left SHIFT)''
|-
| destroy_selected_element
| '''delete'''
|-
| drop_selected_element
| '''space'''
|-
| pickup_selected_element
| '''F2'''
|-
| reset_rotation
| '''mod_rotate''' + '''r''' || ''(Left CTRL + R)''
|}

===GUI===
{|
| toggle_gui_display
| '''F4'''
|-
| toggle_cursor
| '''f'''
|-
| select_target_keyboard
| '''mouse1''' || ''(Left Mouse button)''
|-
| select_target_mouse
| '''mouse2''' || ''(Right Mouse button)''
|-
| edf_next
| '''mouse_wheel_up'''
|-
| edf_prev
| '''mouse_wheel_down'''
|-
| undo
| '''Ctrl''' + '''z'''
|-
| redo
| '''Ctrl''' + '''y'''
|-
| properties_toggle
| '''F3'''
|-
| browser_up
| '''arrow_u''' || ''(Arrow key Up)''
|-
| browser_down
| '''arrow_d''' || ''(Arrow key Down)''
|-
| browser_zoom_in
| '''mouse_wheel_up'''
|-
| browser_zoom_out
| '''mouse_wheel_down'''
|-
| browser_confirm
| '''enter'''
|-
| currentelements_up
| '''num_8''' || ''(Numpad key 8)''
|-
| currentelements_down
| '''num_2''' || ''(Numpad key 2)''
|-
| toggle_test
| '''F5'''
|}

==Multiplayer==
The editor is built with both serverside and clientside components, and therefore supports multiplayer out of the box. To use the editor in multiplayer with other players, simply copy all of the editor's resources into your server, start the '''editor''' resource and allow other players to join.

Please note that currently the editor lacks any permissions system, ao all users have access to every function.

==Plugins & External resources==
{{Main|Resource:Editor/Plugins}}

The editor allows basic importing of elements from external resources. This is useful for resources that may have to manipulate an element in a specific way that cannot be performed by the editor. For example, a map resource which uses custom models (and has a script to import these models) cannot be manipulated by default within the editor.

By using the '''import <resourceName>''' command in console the resource's elements can be imported within the editor.

==FAQ==
==== I get a black screen when launching the Map Editor ====

Usually this is caused due to incorrect installation of Map Editor resources. If you are using a stable MTASA client, please install it again and make sure that you use Client and Server install option.

If you are using a nightly build, to get it working right you need to download latest [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 resources (step 3)], unpack the archive and put its contents in:
''MTA San Andreas\server\mods\deathmatch\resources'' , where ''MTA San Andreas'' is a folder where you've installed MTA San Andreas (default location: C:\Program Files\MTA San Andreas).

Putting them in this path: MTA San Andreas\mods\deathmatch\resources '''is a common mistake''' - it won't work if you put them there. So make sure to put them in the ''italic'' path above.

If this issue still occurs, even when you've checked the note above and verified that you've installed it correctly, it might be because you've got an outdated '''acl.xml''' file. You can download the default one [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/acl.xml here]. It should be placed in '''server/mods/deathmatch/''' in your MTA: San Andreas installation directory.

==== I get an "Could not start the local server. See console for details" when using the "Map Editor" button ====
This is because you do not have a valid editor.conf installed. You can download the default one [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/editor.conf here]. It should be placed in '''server/mods/deathmatch/''' in your MTA: San Andreas installation directory.

==== I have saved a map but cannot find it in my server's resources directory, despite the Editor itself being able to see it ====
This is due to the fact that Vista/7 limits write-access for non-admin processes in Program Files directory. Files get written in the "VirtualStore" directory instead of real Program Files folder. You should be able to locate your map resource in a similar directory to:
C:\Users\<USERNAME>\AppData\Local\VirtualStore\Program Files\MTA San Andreas\server\mods\deathmatch\resources\

Running the Server/MTA San Andreas with Administrative rights will allow the map to be saved to the proper location.

==== I have found a bug or have a suggestion/feedback for the map editor ====
Please use the official [http://bugs.mtasa.com bugtracker] for reporting bugs. Feel free to also join us on [http://www.multitheftauto.com/irc.html IRC].

[[ru:Resource:Editor]]