Introduzione

BeyondSurvival è un framework FiveM per server di sopravvivenza zombie con progressione RPG. L’ho scritto da zero. Non è ESX, non è QBCore, non è vRP. L’unica cosa esterna di cui ha bisogno è oxmysql, e quello è un driver di database, non un framework.

Se hai script ESX di cui non puoi fare a meno, c’è bs_esx_bridge, uno shim che risponde a getSharedObject() tramite BeyondSurvival. Copre le cose comuni, non tutto. Testa il tuo script prima di prometterlo ai giocatori.

Cosa ottieni

Tutto vive in resources/[beyond]/. Una cartella per sistema, tutte con il prefisso bs_:

• bs_core - giocatori, personaggi, denaro, XP, bisogni, migrazioni del database. Tutto il resto poggia su questo.
• bs_zombies - i vaganti. Registro sul server, settori, una simulazione di singoli zombie, orde e, da ottobre, una modalità in rete in cui ogni vagante è un vero ped OneSync.
• bs_inventory - inventario a griglia, contenitori, crafting, hotbar, loadout.
• bs_medical - cadere invece di morire, dissanguarsi, rianimare, trasportare, cadaveri da saccheggiare.
• bs_weapons / bs_skills - accessori come oggetti, caricatori, rinculo, alberi di skill e perk.
• bs_factions / bs_faction_bases - fazioni, squadre, tesoreria, gradi, sanzioni, prigione, bandiere e basi, livelli di fazione.
• bs_boosters / bs_gadgets - potenziamenti personali e oggetti schierabili (drone, torretta, segnale medico, esca).
• bs_drugs - droghe, sigarette, dipendenza e astinenza.
• bs_events - lanci di rifornimenti, nascondigli di scorte, convogli militari, ondate di orde programmate.
• bs_vip - livelli VIP cosmetici. Nessun vantaggio di gioco, di proposito.
• bs_config - la console F1. Regola circa 300 valori in diretta, salva profili, vedi chi ha cambiato cosa.
• bs_guard - rilevamento anti-cheat. Registra e avvisa lo staff, non kicka né banna mai da solo.
• bs_admin - il menu staff F10.

Più quelli più piccoli: mercanti, veicoli, costruzione, stash, riciclatore, estrazione mineraria, zone di estrazione, emote, chat, menu radiale, scoreboard, schermata di caricamento, selezione del personaggio. Il riferimento API ha una pagina per ciascuno.

A chi sono rivolte queste docs

• Proprietari di server (questa sezione) - vuoi installarlo, configurarlo e tenerlo in funzione. Per la maggior parte non serve Lua, la console F1 copre molto.
• Sviluppatori - vuoi scrivere una tua resource sopra bs_core o modificare le nostre. Parti dall’Architettura.

Cose da sapere prima di iniziare

• È costruito per OneSync e la build di gioco 3095. Non usarlo senza OneSync.
• La popolazione ambientale è disattivata sul server (onesync_population false). Il mondo è vuoto di proposito, gli zombie sono la popolazione.
• La mappa è una conversione post-apocalittica dell’intera mappa ([the_apocalypse_project]). È pesante, vedi Prestazioni.
• La maggior parte dei file di config ha lunghi commenti che spiegano perché un valore è com’è. Leggili prima di cambiare qualcosa, molti sono frutto di lezioni imparate a caro prezzo.