XSF / Гайды / Как добавить оружие в Roblox Studio

Как добавить оружие в Roblox Studio

Не нужно писать оружие с нуля. Один раз поставь систему оружия, и дальше каждый ствол это одна строка. В этом гайде используется XSF, он бесплатный, и в нём 110 стволов. Это около трёх минут.

Установи систему оружия

  1. Скачай XSF. Создай бесплатный аккаунт на xsfshooter.com и скачай модель. Лицензионный ключ уже внутри. XSF публикуется только там, никогда в Toolbox.
  2. Перетащи в Studio. Открой свой плейс в Roblox Studio и перетащи скачанный файл во вьюпорт. Появится папка XSF_Release.
  3. Перенеси три папки. Внутри XSF_Release перетащи папку XSF из-под ReplicatedStorage в ReplicatedStorage, папку из-под ServerScriptService в ServerScriptService, а XSF_Boot в StarterPlayer > StarterPlayerScripts.
  4. Включи HTTP-запросы. Home > Game Settings > Security, включи Allow HTTP Requests и сохрани. XSF так проверяет лицензию.
  5. Нажми Play. Ты появишься со стандартным оружием. ЛКМ стреляет, ПКМ целится, R перезаряжает. Если ничего не происходит, прочитай оранжевую строку [XSF] в окне Output, там точно сказано, что не так.

Есть ещё минутное видео всей установки на YouTube.

Выбери, какое оружие получают игроки

Открой ReplicatedStorage.XSF.GameConfig и измени Loadout. Первые пять встают на цифровые клавиши. Имена это названия папок в XSF.Weapons, полный список на странице оружия.

Loadout = { "M4A1", "MP5", "G17", "KaBar", "M67" },

Не хочешь трогать код? В панели на сайте та же настройка, плюс урон, скорострельность, патроны и отдача каждого ствола.

Выдача оружия скриптом

Для команд, классов, магазинов или наград выдавай оружие из серверного скрипта:

local XSF = require(game.ServerScriptService.XSF.Server)

-- swap the whole loadout
XSF.SetLoadout(player, { "HK416", "USP", "M67" })

-- or add one gun
XSF.Give(player, "AWM")

Если всё оружие раздают скрипты, добавь GiveLoadout = false в GameConfig, чтобы игроки не появлялись ещё и со стандартным снаряжением.

Сделай площадку магазина оружия

Деталь, которая при касании выдаёт дробовик один раз за жизнь:

local XSF = require(game.ServerScriptService.XSF.Server)
local given = {}
script.Parent.Touched:Connect(function(hit)
	local player = game.Players:GetPlayerFromCharacter(hit.Parent)
	if player and not given[player] then
		given[player] = true
		XSF.Give(player, "M870")
		player.CharacterAdded:Once(function() given[player] = nil end)
	end
end)

Спавн оружия и патронов на карте

Подбираемые предметы это основа лута в батл-рояле. Игроки жмут F, чтобы подобрать, и X, чтобы выбросить то, что держат.

XSF.SpawnPickup("AK47", spot.CFrame, { mag = 30, reserve = 60, atts = { Sight = "Acog" } })
XSF.SpawnPickup("Ammo", crate.CFrame, { Mags = 3, Uses = 4 })

Дай оружие NPC

Задай атрибут с именем XSF_Weapon у любой модели с Humanoid, указав название оружия, например "AK47". Он нормально держит оружие, получает урон по частям тела и падает рэгдоллом.

Что дальше

Как сделать FPS-игру в Roblox превращает это в командный дезматч. Документация описывает каждую опцию.

Вопросы

Как добавить оружие в Roblox Studio?

Быстрее всего через систему оружия вроде XSF: ставишь один раз, и каждый ствол это одна строка в списке Loadout или один вызов XSF.Give(player, "AK47") из скрипта.

Безопасно ли оружие из бесплатных моделей?

Многие стволы из Toolbox доверяют клиенту, чем пользуются эксплойтеры, а в некоторых есть скрытые скрипты. Используй систему, которая проверяет попадания на сервере и берётся из официального источника.

Почему я появляюсь без оружия?

Имена в Loadout должны точно совпадать с названиями папок оружия в ReplicatedStorage.XSF.Weapons, включая регистр. Ещё проверь, включён ли Allow HTTP Requests.

Можно сделать своё оружие?

Да. Каждый ствол это папка с моделью и коротким Config, где перечислено только то, что отличается от значений по умолчанию. Оружие ACS можно импортировать встроенным импортёром.

Нужно ли знать Lua?

Нет. Панель на сайте отвечает за снаряжение и статы оружия. Код на этой странице нужен только для вещей вроде магазинов и подбираемых предметов.