GTA V- en FiveM-bestandsformaten in gewone taal

GTA V draait op RAGE, Rockstar Advanced Game Engine. FiveM behoudt dat asset-systeem en streamt extra assets en metadata naar de game.

De meeste serverbestanden zijn gekoppeld aan een ander bestand. Een .ytd levert textures voor een model. Een .ytyp vertelt de game wat een prop is. Een .meta-bestand vertelt de game hoe een voertuig, wapen, handlingregel of ander systeem zich moet gedragen. Zodra je die koppelingen kent, worden kapotte resources makkelijker te repareren.

Snel overzicht van formaten

Hoe de bestanden samenwerken

.ydr plus .ytd plus .ytyp

Een prop begint meestal als een .ydr. De .ydr bevat de mesh- en materiaalreferenties. De .ytd bevat de textuurnamen waar die materialen om vragen. De .ytyp definieert de prop als een archetype, zodat mapplaatsingen weten wat het is.

Als het model wit, grijs of onzichtbaar wordt weergegeven, controleer dan eerst de texture dictionary. De textuurnaam in de .ytd moet overeenkomen met de naam die het model verwacht. Als de prop bestaat maar niet goed in een map kan worden geplaatst, controleer dan de .ytyp.

.yft plus voertuigmetadata

Een .yft is meestal het voertuigmodel in een FiveM-resource. Veel voertuigen hebben ook een _hi.yft-versie voor meer detail van dichtbij. Texturen staan in een .ytd en het gedrag komt uit metabestanden.

• vehicles.meta koppelt de modelnaam, voertuigklasse, layout, audio en andere voertuiginstellingen.
• handling.meta bepaalt het rijgedrag.
• carvariations.meta koppelt livery's, kleuren, extra's en variatiegegevens.
• carcols.meta bevat vaak extra gegevens over kleuren en modkits.

.ydd plus .ytd

Een .ydd is een dictionary van drawables. In de meeste gesprekken tussen servereigenaren betekent dat kleding. De geometrie staat in de .ydd en de bijbehorende texturen staan in de .ytd. Als een kledingitem laadt met de verkeerde stof of een leeg materiaal, controleer dan de textuurnamen en componentnamen voordat je de hele resource opnieuw opbouwt.

.xml is meestal de bewerkbare kopie

Tools zoals CodeWalker exporteren .ydr, .yft en andere gamebestanden vaak als .xml. Die XML is makkelijker te controleren en bewerken, maar de game streamt de geëxporteerde .xml niet als uiteindelijke asset. Compileer of importeer het na het bewerken terug naar het gameformaat.

.ybn / .ybd-collision

Collision is het deel dat opvalt wanneer de art er goed uitziet maar de wereld niet goed aanvoelt. Een .ybn of .ybd kan de fysieke vorm rond een prop, gebouw, weg of ander wereldasset definiëren. Als spelers door een vloer vallen, tegen een onzichtbare muur botsen of door een zichtbaar object rijden, controleer dan de collision voordat je het model opnieuw opbouwt.

.ycd-animatiedictionaries

Animatiegegevens staan meestal in .ycd-bestanden. Veel FiveM-scripts roepen bestaande game-animatiedictionaries aan, maar custom assets kunnen eigen animatieclips bevatten. Als een animatieverzoek niets doet, controleer dan de dictionarynaam, clipnaam, het resourcepad en of het bestand wordt gestreamd.

Waar het manifest past

FiveM-resources gebruiken fxmanifest.lua om scripts, databestanden, UI-pagina's, afhankelijkheden en bestanden te beschrijven die clients moeten downloaden. Gebruik voor exacte manifestregels de officiële documentatie voor resource manifests.

fx_version 'cerulean'
game 'gta5'

files {
  'stream/props.ytyp',
  'data/vehicles.meta',
  'data/carvariations.meta',
  'data/handling.meta'
}

data_file 'DLC_ITYP_REQUEST' 'stream/props.ytyp'
data_file 'VEHICLE_METADATA_FILE' 'data/vehicles.meta'
data_file 'VEHICLE_VARIATION_FILE' 'data/carvariations.meta'
data_file 'HANDLING_FILE' 'data/handling.meta'

Het manifest lost slechte namen in een model niet op. Het vertelt FiveM alleen welke resourcebestanden en metadata moeten worden geladen. Als de .ydr om een textuur met de naam sign_1 vraagt en de .ytd alleen sign1 bevat, kan het manifest perfect zijn en faalt de textuur alsnog.

Bronbestanden versus gamebestanden

Makers werken ook met bestanden die geen uiteindelijke gestreamde assets zijn. Een .png, .jpg, .psd, .glb, .fbx of .obj kan de bron zijn die je gebruikt om de resource te maken, maar GTA V heeft meestal het resultaat nodig in de bovenstaande formaten.

Kies de juiste tool voor het bestand

Snelle checklist voor debugging

• Model is onzichtbaar: controleer de bestandsnaam, de map stream, de modelnaam en of een .ytyp- of metadatabestand ontbreekt.
• Model is wit of grijs: controleer de .ytd en de Textuurnamen die het model verwacht.
• Voertuig spawnt maar heeft geen liveries: controleer carvariations.meta en de namen van de livery-Texturen in de .ytd.
• Kleding verschijnt met de verkeerde Textuur: controleer de naamgeving van componenten en of de bijbehorende .ytd texture dictionary aanwezig is.
• Map-prop bestaat maar wordt niet correct geplaatst: controleer het .ytyp-archetype en de .ymap-verwijzingen.
• Bestand werkt in OpenIV of CodeWalker maar niet op de server: controleer de fxmanifest.lua-vermeldingen voor data_file en de structuur van de resourcemap.

Gerelateerde Handleidingen