Введение

BeyondSurvival это фреймворк для FiveM для серверов зомби-выживания с RPG-прогрессией. Я написал его с нуля. Это не ESX, не QBCore и не vRP. Единственное внешнее, что ему нужно, это oxmysql, а это драйвер базы данных, а не фреймворк.

Если у тебя есть ESX-скрипты, без которых не обойтись, есть bs_esx_bridge, прослойка, которая отвечает на getSharedObject() через BeyondSurvival. Она покрывает типичное, но не всё. Проверь свой скрипт, прежде чем обещать его игрокам.

Что внутри

Всё лежит в resources/[beyond]/. Одна папка на систему, у всех префикс bs_:

• bs_core - игроки, персонажи, деньги, опыт, потребности, миграции базы данных. Всё остальное стоит на этом.
• bs_zombies - ходячие. Серверный реестр, секторы, симуляция отдельных зомби, орды и, с октября, сетевой режим, где каждый ходячий это настоящий пед OneSync.
• bs_inventory - сеточный инвентарь, контейнеры, крафт, хотбар, наборы экипировки.
• bs_medical - падение вместо смерти, кровотечение, реанимация, перенос, трупы, которые можно обыскать.
• bs_weapons / bs_skills - обвесы как предметы, магазины, отдача, деревья навыков и перки.
• bs_factions / bs_faction_bases - фракции, отряды, казна, звания, санкции, тюрьма, флаги и базы, уровни фракций.
• bs_boosters / bs_gadgets - личные баффы и устанавливаемые устройства (дрон, турель, медицинский маяк, приманка).
• bs_drugs - наркотики, сигареты, зависимость и ломка.
• bs_events - аирдропы, тайники с припасами, военные конвои, волны орд по расписанию.
• bs_vip - косметические VIP-уровни. Никаких игровых преимуществ, специально.
• bs_config - консоль F1. Около 300 значений настраиваются вживую, профили сохраняются, видно, кто что менял.
• bs_guard - обнаружение читов. Он пишет логи и сообщает персоналу, но сам никогда не кикает и не банит.
• bs_admin - меню персонала на F10.

Плюс мелкие: торговцы, транспорт, строительство, тайники, переработчик, добыча, зоны эвакуации, эмоции, чат, радиальное меню, таблица очков, экран загрузки, выбор персонажа. В справочнике API на каждый есть страница.

Для кого эта документация

• Владельцы серверов (этот раздел) - ты хочешь установить, настроить и поддерживать работу. Для большей части Lua не нужен, консоль F1 покрывает многое.
• Разработчики - ты хочешь написать свой ресурс поверх bs_core или изменить наши. Начни с Архитектуры.

Что нужно знать перед началом

• Он сделан под OneSync и игровой билд 3095. Не запускай без OneSync.
• Фоновое население отключено на сервере (onesync_population false). Мир пуст специально, население это зомби.
• Карта это постапокалиптическая конверсия всей карты ([the_apocalypse_project]). Она тяжёлая, см. Производительность.
• В большинстве конфиг-файлов длинные комментарии объясняют, почему значение именно такое. Читай их, прежде чем что-то менять, многое далось нелёгким путём.