Kundenbereich
FiveM•6. Februar 2026• 42 Aufrufe

Wie man ein Mapping auf Ihrem FiveM-Server hinzufügt: der vollständige Leitfaden

Wie man ein Mapping auf Ihrem FiveM-Server hinzufügt: der vollständige Leitfaden

So fügen Sie ein Mapping auf Ihrem FiveM-Server hinzu: der vollständige Leitfaden

Die Anpassung der Karte Ihres FiveM-Servers ist das, was den Unterschied zwischen einem generischen Server und einem wirklich immersiven Universum ausmacht. Mappings ermöglichen es Ihnen, Gebäude, Innenräume, Dekorationen und ganze Bereiche hinzuzufügen, die im Basis-GTA V nicht existieren.

In diesem Leitfaden werden wir sehen, was genau ein Mapping ist, wie es strukturiert ist, wie man es korrekt auf Ihrem Server installiert und wie man klassische Fehler vermeidet. Egal, ob Sie eine benutzerdefinierte Polizeistation, ein Krankenhaus oder einen kompletten MLO-Innenraum hinzufügen, Sie haben alle Schlüssel in der Hand.

Was ist genau ein Mapping?

Ein Mapping (oder Map) ist eine Modifikation der Umgebung von GTA V, die es ermöglicht, Elemente zur Spielwelt hinzuzufügen. Konkret kann das Folgendes sein:

  • Gebäude und Außenstrukturen
  • Zugängliche Innenräume (MLO)
  • Möbel und Dekorationsobjekte
  • Geländeveränderungen
  • Völlig neue Bereiche

Mappings funktionieren wie jede andere FiveM-Ressource: Sie platzieren sie in Ihrem Ressourcenordner, erklären sie in der server.cfg und der Server lädt sie beim Start.

Struktur eines Mappings

Ein gut organisiertes Mapping folgt immer der gleichen Ordnerstruktur. So sieht es aus:

name-des-mappings/
├── fxmanifest.lua
├── stream/
│   ├── datei1.ymap
│   ├── datei2.ytyp
│   └── datei3.ybn
└── data/ (optional)
    └── datei.meta

Die Hauptdateien

fxmanifest.lua — Die obligatorische Konfigurationsdatei, die FiveM anweist, wie die Ressource geladen werden soll.

Ordner stream/ — Enthält die Dateien des eigentlichen Mappings:

  • .ymap : Positionen und Platzierungen der Objekte
  • .ytyp : Definitionen der Objekttypen
  • .ybn : Kollisionen (damit die Spieler nicht hindurchgehen)
  • .ytd : Texturen (wenn das Mapping benutzerdefinierte verwendet)

Ordner data/ (optional) — Enthält .meta-Dateien für zusätzliche Konfigurationen.

Erstellen eines fxmanifest.lua, wenn das Mapping keinen hat

Einige heruntergeladene Mappings haben keine Manifestdatei. Ohne diese kann FiveM die Ressource nicht laden. So erstellen Sie eine.

Einfaches Manifest (einfaches Mapping)

Wenn Ihr Mapping nur einen Ordner stream/ mit .ymap, .ytyp und .ybn Dateien enthält, verwenden Sie dieses Manifest:

fx_version 'cerulean'
game 'gta5'

author 'IhrName'
description 'Beschreibung des Mappings'
version '1.0.0'

this_is_a_map 'yes'

Die Zeile this_is_a_map 'yes' ist entscheidend: Sie weist FiveM an, dass diese Ressource ein Mapping ist und dass die Dateien im Ordner stream/ automatisch geladen werden sollen.

Manifest mit Daten-Dateien

Wenn Ihr Mapping auch einen Ordner data/ mit .meta oder .ytyp Dateien enthält, fügen Sie die entsprechenden Erklärungen hinzu:

fx_version 'cerulean'
game 'gta5'

author 'IhrName'
description 'Beschreibung des Mappings'
version '1.0.0'

this_is_a_map 'yes'

files {
    'data/*.meta'
}

data_file 'DLC_ITYP_REQUEST' 'data/*.ytyp'

Manifest für ein MLO (Innenraum)

MLOs sind komplexere Innenraum-Mappings. Ihre Struktur sieht so aus:

mlo-innenraum/
├── fxmanifest.lua
└── stream/
    ├── innenraum.ymap
    ├── innenraum.ytyp
    ├── innenraum_shell.ybn
    └── texturen.ytd

Und das entsprechende Manifest:

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

files {
    'stream/*.ytyp'
}

data_file 'DLC_ITYP_REQUEST' 'stream/*.ytyp'

Hinweis: Einige MLOs benötigen zusätzliche Skripte, um die Eingangs- und Ausgangspunkte zu definieren. Überprüfen Sie die Dokumentation des Mappings, das Sie installieren.

Das Mapping auf Ihrem Server installieren

Sobald Ihr Mapping mit seiner fxmanifest.lua bereit ist, ist die Installation einfach.

Schritt 1: Den Ordner hochladen

Loggen Sie sich in den Dateimanager Ihres Servers OuiHeberg / OuiPanel ein und navigieren Sie zum Ordner resources. Erstellen Sie einen Unterordner, um Ihre Mappings zu organisieren, wenn Sie mehrere haben, zum Beispiel [mappings].

Laden Sie den gesamten Ordner Ihres Mappings in resources/[mappings]/ hoch.

[BILD: Screenshot des Dateimanagers, der die Ressourcenstruktur mit einem Ordner mappings zeigt, der mehrere Karten enthält]

Schritt 2: In server.cfg deklarieren

Öffnen Sie Ihre Datei server.cfg und fügen Sie eine ensure-Zeile hinzu, um das Mapping zu laden:

ensure name-des-mappings

Wenn Sie mehrere Mappings haben, fügen Sie eine Zeile pro Mapping hinzu:

# Mappings
ensure mapping-polizeistation
ensure mapping-krankenhaus
ensure mapping-garage

Wichtig: Verwenden Sie für Mappings immer ensure anstelle von start. Der Befehl ensure ist zuverlässiger für diese Art von Ressource.

Schritt 3: Die Ladeordnung beachten

Die Reihenfolge der Ressourcen in server.cfg kann wichtig sein. Im Allgemeinen laden Sie Ihre Mappings nach dem Framework, aber vor den Skripten, die sie verwenden:

# Framework
ensure es_extended
ensure esx_skin

# Mappings
ensure mapping-polizeistation
ensure mapping-krankenhaus

# Berufsskripte
ensure esx_policejob
ensure esx_ambulancejob

Schritt 4: Den Server neu starten

Starten Sie Ihren Server neu, damit die Mappings geladen werden. Überprüfen Sie die Protokolle beim Start: Wenn alles gut ist, sollten Sie keine Fehler im Zusammenhang mit Ihren Mappings sehen.

Überprüfen, ob das Mapping funktioniert

Sobald der Server neu gestartet ist, loggen Sie sich ins Spiel ein und gehen Sie zu den Koordinaten des Mappings. Die meisten Ersteller geben die Koordinaten in der Beschreibung oder in einer Readme-Datei an.

Wenn Sie die Koordinaten nicht kennen, können Sie sie in den .ymap Dateien des Mappings suchen oder einen Teleportationsbefehl verwenden, wenn Sie ein Admin-Menü haben.

Häufige Probleme lösen

Das Mapping wird nicht angezeigt

  • Überprüfen Sie, ob die fxmanifest.lua existiert und this_is_a_map 'yes' enthält
  • Überprüfen Sie, ob die ensure-Zeile in server.cfg vorhanden ist
  • Überprüfen Sie die Serverprotokolle auf Ladefehler
  • Stellen Sie sicher, dass Sie sich an den richtigen Koordinaten im Spiel befinden

Die Kollisionen funktionieren nicht (man geht hindurch)

  • Die .ybn Datei fehlt wahrscheinlich oder ist falsch benannt
  • Überprüfen Sie, ob die Kollisionsdatei zum Mapping passt

Fehler beim Starten des Servers

  • Lesen Sie die Fehlermeldung in den Protokollen sorgfältig durch
  • Überprüfen Sie die Syntax der fxmanifest.lua
  • Stellen Sie sicher, dass alle referenzierten Dateien vorhanden sind

Das Mapping verursacht Lags

Einige sehr detaillierte Mappings können die Leistung beeinträchtigen. Hier einige Ansätze:

  • Reduzieren Sie die Sichtweite in den Mappings-Einstellungen, wenn dies konfigurierbar ist
  • Vermeiden Sie es, zu viele Mappings in einem Bereich zu stapeln
  • Bevorzugen Sie optimierte und von der Community getestete Mappings

Best Practices

Organisieren Sie Ihre Mappings

Erstellen Sie einen Ordner [mappings] in Ihren Ressourcen, um alle Ihre Mappings zu gruppieren. Das erleichtert die Verwaltung und Wartung:

resources/
├── [mappings]/
│   ├── mapping-polizeistation/
│   ├── mapping-krankenhaus/
│   └── mapping-garage/
├── [esx]/
└── ...

Testen, bevor Sie bereitstellen

Testen Sie immer ein neues Mapping auf einem Testserver, bevor Sie es zu Ihrem Hauptserver hinzufügen. Das vermeidet unangenehme Überraschungen in der Produktion.

Regelmäßig sichern

Bevor Sie Mappings hinzufügen oder ändern, erstellen Sie ein Backup Ihres Servers. Bei OuiHeberg können Sie Backups direkt über das Panel erstellen.

Zusammenfassung

Das Hinzufügen von Mappings auf Ihrem FiveM-Server ist ziemlich einfach, sobald man die Logik verstanden hat: ein Ordner mit den Dateien des Mappings, eine gut konfigurierte fxmanifest.lua und eine ensure-Zeile in der server.cfg. MLOs (Innenräume) erfordern manchmal etwas mehr Konfiguration, aber das Prinzip bleibt dasselbe.

Haben Sie Lust, Ihren FiveM-Server mit benutzerdefinierten Mappings anzupassen? OuiHeberg bietet FiveM-Hosting-Angebote mit einfachem Zugriff auf Ihre Dateien, um Ihre Ressourcen problemlos zu installieren und zu verwalten.

Zurück zur Dokumentation