Dodawanie Skryptów

Czas zebrać to wszystko razem! Teraz, gdy stworzyłeś komponenty promienia i cząsteczek, dodasz trzy gotowe skrypty. Te skrypty zarządzają tutorialem, powiadamiając komponenty, kiedy zrobić coś. Na przykład, skrypty będą tworzyć promienie dla nowych graczy i emitować cząsteczki, gdy wchodzą w interakcję z celami.

Podczas gdy możesz podążać za wszystkimi tymi krokami, nawet jeśli nie kodowałeś wcześniej, posiadanie tej wiedzy może pomóc Ci dostosować te skrypty do własnego doświadczenia. Aby uzyskać więcej informacji, zobacz samouczek Podstawy kodowania.

Przechowywanie promienia i cząsteczek

Zanim dodasz skrypty, wiąz i cząsteczki muszą być przeniesione do miejsca, w którym będzie można kopiować je, jeśli to konieczne.

Jeśli używasz własnego projektu, możliwe, że będziesz musiał zastąpić wartości w niektórych zmiennej skrypt, aby dopasować swoje obiekty.

W ReplicatedStorage utwórz nowy katalog nazyający się PlayerTutorial . Przenieś TutorialBeam z TestPlayer i do nowego katalogu.
W ServerStorage, utwórz katalog nazyający się TutorialParticles. Przenieś Burst część do tego katalogu.
Gdy promień i emitter cząsteczek zostaną przeniesione, nie będziesz już potrzebować TestPlayer. Usuń TestPlayer, ponieważ skrypt będzie działać z prawdziwymi graczami, gdy skończy się.

Tworzenie wydarzeń

Za każdym razem, gdy gracze wchodzą w interakcję z bramą, ten samouczek musi wiedzieć, aby aktualizować postęp tego gracza i wydać efekt cząsteczek. Aby poinformować skrypty, sygnały można wysyłać używając wydarzeń .

W ReplicatedStorage > PlayerTutorial stwórz dwa obiekty RemoteEvent . Nazwij je NextGoal i TutorialEnd .

Poniżej znajdują się trzy skrypcity, które szukają obiektów emittera cząsteczek i promieni i zarządzają systemem tutorialowym.

W ReplicatedStorage > PlayerTutorial > utwórz nowy ModuleScript nazywający się TutorialManager .

Zastąp standardowy kod, skopiowując i wklejając cały kod poniżej.


local TutorialManager = {}

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local tutorialFolder = ReplicatedStorage:WaitForChild("PlayerTutorial")
local TutorialEndEvent = tutorialFolder:WaitForChild("TutorialEnd")
local NextGoalEvent = tutorialFolder:WaitForChild("NextGoal")

-- W częściach celu należy zamawiać poszczególne części, lub inaczej może być inny w grze
local goalParts = {
 workspace.TutorialGoals.GoalPart1,
 workspace.TutorialGoals.GoalPart2
}

local function checkTutorialEnd(player, goalParts)
 local currentIndex = player:WaitForChild("GoalProgress")
 return currentIndex.Value >= #goalParts
end

local function finishTutorial(player)
 local playerBeam = player.Character.HumanoidRootPart:FindFirstChildOfClass("Beam")
 playerBeam:Destroy()

 print(player.Name .. " finished the tutorial")

 -- Miejsce na kod. Na przykład, jeśli chcesz wysłać wiadomości na serwer, aby wykonać inne zadania

end

function TutorialManager.interactGoal(player)
 NextGoalEvent:FireServer()
end

function TutorialManager.getTutorialGoals()
 return goalParts
end

function TutorialManager.nextGoal(player, goalParts)
 if checkTutorialEnd(player, goalParts) then
   finishTutorial(player)
 else
   -- Zwiększ śledarkę celu gracza
   local currentGoalIndex = player:WaitForChild("GoalProgress")
   currentGoalIndex.Value += 1
 end
end

-- Tworzy wartość liczbową, aby lokalnie śledzić postępy gracza poprzez cele w grze
function TutorialManager.setupPlayerProgress(player)
 local currentGoalProgress = Instance.new("IntValue")
 currentGoalProgress.Name = "GoalProgress"
 currentGoalProgress.Value = 1
 currentGoalProgress.Parent = player
end

return TutorialManager

Ten skrypt wykonuje kod do zarządzania postępowaniem gracza w samouczku. Obejmuje to zadania, takie jak wykonanie kodu do wchodzenia w interakcję z celami lub to, co się dzieje, gdy samouczek zakończy się.

W ServerScriptService, utwórz nowy Skrypt o nazwie TutorialParticles.

Wklej kod poniżej.


local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")

local tutorialFolder = ReplicatedStorage:WaitForChild("PlayerTutorial")
local NextGoalEvent = tutorialFolder:WaitForChild("NextGoal")

local EMIT_RATE = 50

local function playParticleBurst(player)
  local character = player.Character or player.CharacterAdded:Wait()
  local humanoidRootPart = character:WaitForChild("HumanoidRootPart")
  local particleAttachment = humanoidRootPart:WaitForChild("ParticleAttachment")

  -- Przejdź przez cząsteczki na załączniku i graj zgodnie z rodzajem cząsteczki
  for _, particle in particleAttachment:GetChildren() do
    if particle:IsA("ParticleEmitter") then
      particle:Emit(EMIT_RATE)
    end
  end
end

local function setupPlayerParticles(player)
  player.CharacterAdded:Connect(function(character)
    local humanoidRootPart = character:WaitForChild("HumanoidRootPart")
    local playerParticleAttachment = Instance.new("Attachment")
    playerParticleAttachment.Name = "ParticleAttachment"
    playerParticleAttachment.Parent = humanoidRootPart

    -- Kopiuj cząsteczki w katalogu, nawet jeśli jest ich więcej niż jedna i przywiąż do gracza
    for _, emitter in ServerStorage.TutorialParticles:GetChildren() do
      emitter:Clone().Parent = playerParticleAttachment
    end
  end)
end

Players.PlayerAdded:Connect(setupPlayerParticles)
NextGoalEvent.OnServerEvent:Connect(playParticleBurst)

Ten skrypt odtwarza częstotliwość rozszczepienia, gdy gracze wchodzą w interakcję z celami. Jest również zmienne EMIT_RATE, które określa liczbę pęknięć generowanych podczas interakcji.

W StarterPlayer > StarterPlayerScripts utwórz nowy LokalnySkrypt nazywający się TutorialScript.

Następnie wklej skrypt poniżej. Ten skrypt tworzy i zarządza promieniem używany do prowadzenia graczy.


local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local tutorialFolder = ReplicatedStorage:WaitForChild("PlayerTutorial")
local TutorialManager = require(tutorialFolder:WaitForChild("TutorialManager"))
local TutorialEndEvent = tutorialFolder:WaitForChild("TutorialEnd")

local player = Players.LocalPlayer
local goalParts = TutorialManager.getTutorialGoals()
local playerBeam = nil
local goalIndex = nil

local function getTargetAttachment()
  local currentTarget = goalParts[goalIndex.Value]
  local interactionPart = currentTarget:FindFirstChild("InteractionPart")
  local attachment = interactionPart and interactionPart:FindFirstChildOfClass("Attachment")

  if not attachment then
    attachment = Instance.new("Attachment")
    attachment.Name = "BeamAttachment"
    attachment.Parent = currentTarget
  end

  return attachment
end

local function updateBeamTarget()
  playerBeam = player.Character.HumanoidRootPart:FindFirstChildOfClass("Beam")

  local targetBeamAttachment = getTargetAttachment()

  if targetBeamAttachment then
    playerBeam.Attachment1 = targetBeamAttachment
  else
    warn("Attachment not found in a goal. Check that goals have attachments or they're included under the InteractionPart")
  end
end

local function setupGoals()
  for _, part in goalParts do
    local interactionPart = part:FindFirstChild("InteractionPart")
    local proximityPrompt = interactionPart and interactionPart:FindFirstChild("ProximityPrompt")

    if proximityPrompt then
      proximityPrompt.Triggered:Connect(function(player)
        proximityPrompt.Enabled = false
        TutorialManager.nextGoal(player, goalParts)
        TutorialManager.interactGoal(player)
      end)
    else
      warn("Proximity prompt not included in goal. Add one to each goal part under the InteractionPart")
    end
  end
end

local function createBeamForCharacter(character)
  local humanoidRootPart = character:WaitForChild("HumanoidRootPart")
  local playerBeamAttachment = Instance.new("Attachment")
  local beamTemplate = tutorialFolder:WaitForChild("TutorialBeam")

  if not beamTemplate then
    warn("Tutorial Beam not found in ReplicatedStorage")
  end

  playerBeamAttachment.Name = "BeamAttachment"
  playerBeamAttachment.Parent = humanoidRootPart

  local targetBeamAttachment = getTargetAttachment()

  playerBeam = beamTemplate:Clone()
  playerBeam.Attachment0 = playerBeamAttachment
  playerBeam.Attachment1 = targetBeamAttachment
  playerBeam.Parent = humanoidRootPart
  playerBeam.Enabled = true
end

local function setupPlayer()
  setupGoals()
  TutorialManager.setupPlayerProgress(player)
  goalIndex = player:WaitForChild("GoalProgress")

  player.CharacterAdded:Connect(createBeamForCharacter)
  if player.Character then
    createBeamForCharacter(player.Character)
  end
end

setupPlayer()
goalIndex.Changed:Connect(updateBeamTarget)

Zagraj projekt, aby testować skrypcje. Przejdź z kabiny na kabinę, używając funkcji interakcji, aby zobaczyć, czy kod działa.

Wskazówki dotyczące rozwiązywania problemów

Zagadka : cząsteczki grają, gdy gra się uruchamia.

Idź do ServerStorage > Części tutaj > Burst. Sprawdź, czy Włączone, aby być wyłączone. Problem : Ostrzeżenia w kompilatorze, takie jak "nieskończony plon".
Ponieważ skrypt szuka określonych obiektów w pewnych lokalizacjach, możliwe jest, że część jest nazywana nieprawidłowo. Ponownie sprawdź, że nazwa i lokalizacja każdej części w grze odpowiada temu samouczkowi.

Korzyści i ograniczenia skryptu

Jeśli używasz tego systemu tutorialowego w swoim doświadczeniu, pamiętaj o obserwujekwestiach: Korzyści

Wydarzenia takie jak TutorialEnd można używać do uruchomienia innych skryptów. Na instancjamożesz nagrodzić graczy specjalnym przedmiotem, gdy to wydarzenie się uruchomi.
Skrypt TutorialParticles może grać wiele cząsteczek na raz. Możesz dodać więcej cząsteczek w ServerStorage/TutorialParticles dla bardziej złożonych efektów. Ograniczenia
Postęp gracza w samouczniku nie jest trwały, co oznacza, że będziesz musiał kodować pewien sposób zapisu tego postępu. Dla kierunku, zobacz artykuł: Zapisywanie danych.