Introduction

BeyondSurvival est un framework FiveM pour serveurs de survie zombie avec progression RPG. Je l’ai écrit de zéro. Ce n’est pas ESX, ni QBCore, ni vRP. La seule chose externe dont il a besoin est oxmysql, et c’est un pilote de base de données, pas un framework.

Si tu as des scripts ESX dont tu ne peux pas te passer, il y a bs_esx_bridge, un shim qui répond à getSharedObject() via BeyondSurvival. Il couvre l’essentiel, pas tout. Teste ton script avant de le promettre aux joueurs.

Ce que tu obtiens

Tout se trouve dans resources/[beyond]/. Un dossier par système, tous préfixés bs_ :

• bs_core - joueurs, personnages, argent, XP, besoins, migrations de la base de données. Tout le reste repose dessus.
• bs_zombies - les rôdeurs. Registre serveur, secteurs, simulation de zombies individuels, hordes et, depuis octobre, un mode en réseau où chaque rôdeur est un vrai ped OneSync.
• bs_inventory - inventaire en grille, conteneurs, craft, barre rapide, loadouts.
• bs_medical - tomber au lieu de mourir, saigner, réanimer, porter, cadavres qu’on peut fouiller.
• bs_weapons / bs_skills - accessoires comme items, chargeurs, recul, arbres de compétences et perks.
• bs_factions / bs_faction_bases - factions, escouades, trésorerie, grades, sanctions, prison, drapeaux et bases, niveaux de faction.
• bs_boosters / bs_gadgets - buffs personnels et objets déployables (drone, tourelle, balise médicale, leurre).
• bs_drugs - drogues, cigarettes, addiction et sevrage.
• bs_events - largages, caches de ravitaillement, convois militaires, vagues de hordes planifiées.
• bs_vip - paliers VIP cosmétiques. Aucun avantage en jeu, volontairement.
• bs_config - la console F1. Règle environ 300 valeurs en direct, enregistre des profils, vois qui a changé quoi.
• bs_guard - détection anti-cheat. Elle journalise et prévient le staff, ne kicke ni ne bannit jamais toute seule.
• bs_admin - le menu staff F10.

Plus les petits : marchands, véhicules, construction, stashes, recycleur, minage, zones d’extraction, emotes, chat, menu radial, tableau des scores, écran de chargement, sélection de personnage. La référence de l’API a une page pour chacun.

À qui s’adressent ces docs

• Propriétaires (cette section) - tu veux l’installer, le configurer et le garder en marche. Pas besoin de Lua pour la plupart, la console F1 couvre beaucoup.
• Développeurs - tu veux écrire ta propre resource par-dessus bs_core ou modifier les nôtres. Commence par l’Architecture.

À savoir avant de commencer

• Il est conçu pour OneSync et le build de jeu 3095. Ne le fais pas tourner sans OneSync.
• La population ambiante est désactivée côté serveur (onesync_population false). Le monde est vide volontairement, les zombies sont la population.
• La map est une conversion post-apocalyptique de toute la carte ([the_apocalypse_project]). Elle est lourde, voir Performances.
• La plupart des fichiers de config ont de longs commentaires qui expliquent pourquoi une valeur est ce qu’elle est. Lis-les avant de changer quoi que ce soit, beaucoup ont été appris à la dure.