Einführung

BeyondSurvival ist ein FiveM-Framework für Zombie-Survival-Server mit RPG-Fortschritt. Ich habe es von Grund auf geschrieben. Es ist nicht ESX, nicht QBCore, nicht vRP. Das Einzige, was es von außen braucht, ist oxmysql, und das ist ein Datenbanktreiber, kein Framework.

Wenn du ESX-Scripts hast, auf die du nicht verzichten kannst, gibt es bs_esx_bridge, einen Shim, der getSharedObject() gegen BeyondSurvival beantwortet. Er deckt das Übliche ab, nicht alles. Teste dein Script, bevor du es den Spielern versprichst.

Was du bekommst

Alles liegt in resources/[beyond]/. Ein Ordner pro System, alle mit dem Präfix bs_:

• bs_core - Spieler, Charaktere, Geld, XP, Bedürfnisse, Datenbank-Migrationen. Alles andere baut darauf auf.
• bs_zombies - die Walker. Server-Registry, Sektoren, eine Simulation einzelner Zombies, Horden und seit Oktober ein vernetzter Modus, in dem jeder Walker ein echter OneSync-Ped ist.
• bs_inventory - Raster-Inventar, Container, Crafting, Hotbar, Loadouts.
• bs_medical - niedergehen statt sterben, verbluten, wiederbeleben, tragen, Leichen, die man looten kann.
• bs_weapons / bs_skills - Aufsätze als Items, Magazine, Rückstoß, Skillbäume und Perks.
• bs_factions / bs_faction_bases - Fraktionen, Trupps, Kasse, Ränge, Sanktionen, Gefängnis, Flaggen und Basen, Fraktionslevel.
• bs_boosters / bs_gadgets - persönliche Buffs und aufstellbare Geräte (Drohne, Geschützturm, Sanitäts-Leuchtfeuer, Köder).
• bs_drugs - Drogen, Zigaretten, Sucht und Entzug.
• bs_events - Airdrops, Versorgungsdepots, Militärkonvois, Horden-Wellen nach Zeitplan.
• bs_vip - kosmetische VIP-Stufen. Bewusst ohne Spielvorteil.
• bs_config - die F1-Konsole. Rund 300 Werte live einstellen, Profile speichern, sehen, wer was geändert hat.
• bs_guard - Anti-Cheat-Erkennung. Sie protokolliert und informiert das Team, kickt oder bannt aber nie von selbst.
• bs_admin - das Staff-Menü auf F10.

Dazu die kleineren: Händler, Fahrzeuge, Bauen, Stashes, Recycler, Bergbau, Extraktionszonen, Emotes, Chat, Radialmenü, Scoreboard, Ladebildschirm, Charakterauswahl. Die API-Referenz hat für jedes eine Seite.

Für wen diese Docs sind

• Betreiber (dieser Abschnitt) - du willst es installieren, konfigurieren und am Laufen halten. Für das meiste brauchst du kein Lua, die F1-Konsole deckt viel ab.
• Entwickler - du willst eine eigene Resource auf bs_core schreiben oder unsere ändern. Fang mit der Architektur an.

Das solltest du vorher wissen

• Es ist für OneSync und Game-Build 3095 gebaut. Betreibe es nicht ohne OneSync.
• Die Umgebungsbevölkerung ist am Server aus (onesync_population false). Die Welt ist absichtlich leer, die Zombies sind die Bevölkerung.
• Die Map ist eine Post-Apokalypse-Umwandlung der ganzen Karte ([the_apocalypse_project]). Sie ist schwer, siehe Performance.
• Die meisten Config-Dateien haben lange Kommentare, die erklären, warum ein Wert so ist. Lies sie, bevor du etwas änderst, vieles davon wurde auf die harte Tour gelernt.