XSF / Гайды / Как добавить оружие в Roblox Studio
Как добавить оружие в Roblox Studio
Не нужно писать оружие с нуля. Один раз поставь систему оружия, и дальше каждый ствол это одна строка. В этом гайде используется XSF, он бесплатный, и в нём 110 стволов. Это около трёх минут.
Установи систему оружия
- Скачай XSF. Создай бесплатный аккаунт на xsfshooter.com и скачай модель. Лицензионный ключ уже внутри. XSF публикуется только там, никогда в Toolbox.
- Перетащи в Studio. Открой свой плейс в Roblox Studio и перетащи скачанный файл во вьюпорт. Появится папка XSF_Release.
- Перенеси три папки. Внутри XSF_Release перетащи папку XSF из-под ReplicatedStorage в ReplicatedStorage, папку из-под ServerScriptService в ServerScriptService, а XSF_Boot в StarterPlayer > StarterPlayerScripts.
- Включи HTTP-запросы. Home > Game Settings > Security, включи Allow HTTP Requests и сохрани. XSF так проверяет лицензию.
- Нажми 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?
Нет. Панель на сайте отвечает за снаряжение и статы оружия. Код на этой странице нужен только для вещей вроде магазинов и подбираемых предметов.
XSF