Introdução

BeyondSurvival é uma framework de FiveM para servidores de sobrevivência zombie com progressão RPG. Escrevi-a do zero. Não é ESX, nem QBCore, nem vRP. A única coisa externa de que precisa é o oxmysql, e isso é um driver de base de dados, não uma framework.

Se tens scripts ESX de que não consegues abdicar, existe o bs_esx_bridge, um shim que responde ao getSharedObject() com o BeyondSurvival. Cobre o essencial, não tudo. Testa o teu script antes de o prometeres aos jogadores.

O que recebes

Tudo vive em resources/[beyond]/. Uma pasta por sistema, todas com o prefixo bs_:

• bs_core - jogadores, personagens, dinheiro, XP, necessidades, migrações da base de dados. Tudo o resto assenta nisto.
• bs_zombies - os caminhantes. Registo no servidor, setores, uma simulação de zombies individuais, hordas e, desde outubro, um modo em rede onde cada caminhante é um ped OneSync real.
• bs_inventory - inventário em grelha, contentores, crafting, hotbar, loadouts.
• bs_medical - cair em vez de morrer, sangrar, reanimar, carregar, cadáveres que podes saquear.
• bs_weapons / bs_skills - acessórios como itens, carregadores, recuo, árvores de skills e perks.
• bs_factions / bs_faction_bases - fações, esquadrões, tesouraria, patentes, sanções, prisão, bandeiras e bases, níveis de fação.
• bs_boosters / bs_gadgets - buffs pessoais e itens instaláveis (drone, torreta, baliza médica, isco).
• bs_drugs - drogas, cigarros, vício e abstinência.
• bs_events - airdrops, esconderijos de mantimentos, comboios militares, ondas de hordas com horário.
• bs_vip - níveis VIP cosméticos. Sem vantagem de jogo, de propósito.
• bs_config - a consola F1. Ajusta cerca de 300 valores em direto, guarda perfis, vê quem mudou o quê.
• bs_guard - deteção de anti-cheat. Regista e avisa o staff, nunca expulsa nem bane sozinho.
• bs_admin - o menu de staff F10.

Mais os mais pequenos: vendedores, veículos, construção, stashes, reciclador, mineração, zonas de extração, emotes, chat, menu radial, scoreboard, ecrã de loading, seleção de personagem. A referência da API tem uma página para cada um.

Para quem são estas docs

• Donos de servidor (esta secção) - queres instalá-lo, configurá-lo e mantê-lo a funcionar. Não precisas de Lua para a maior parte, a consola F1 cobre muito.
• Programadores - queres escrever o teu próprio resource por cima do bs_core ou alterar os nossos. Começa pela Arquitetura.

O que saber antes de começar

• Foi feito para OneSync e a build de jogo 3095. Não o corras sem OneSync.
• A população ambiente está desligada no servidor (onesync_population false). O mundo está vazio de propósito, os zombies são a população.
• O mapa é uma conversão pós-apocalíptica do mapa inteiro ([the_apocalypse_project]). É pesado, vê Desempenho.
• A maioria dos ficheiros de config tem comentários longos a explicar porque um valor é o que é. Lê-os antes de mudares coisas, muitos foram aprendidos à força.