Zapisz i wyświetlaj dane gracza

Teraz, gdy możesz wykryć, gdy gracz zebrał monetę, ta sekcja tutorialu nauczy cię, jak policzyć, ile monet zebrało graczy, i uczynić tę kwotę widoczną na ranking.

Utwórz modułowy skrypt, aby zapisać kolekcję monet

Aby zarządzać danymi zbieranymi w każdej kolekcji monet gracza, musisz utworzyć obiekt ModuleScript, aby zawierać strukturę danych i funkcje, które uzyskują dane zbierane w każdej kolekcji monet dla każdego gracza. Skrypty modułowe są ponownymi kodami, które inne skrypty mogą wymagać. W tym przypadku

Aby utworzyć skrypt modułu:

W oknie Explorer, przełącz nawigację nad ServerStorage i kliknij przycisk 2> ⊕2>. Wyświetlony zostanie menu kontekstowe.
Z menu kontekstowego wybierz ModuleScript. Nowy skrypt modułu wyświetlony jest pod ServerStorage. Jesteś umieszczając nowy skrypt modułu w ServerStorage, ponieważ chcesz zarządzać logiką zbierania monet na serwerze.
Zmień nazwę modułu skryptu na PlayerData .

Zastąp standardowy kod następujązym kodem:


local PlayerData = {}
PlayerData.COIN_KEY_NAME = "Coins"

local playerData = {
  --[[
    [userId: string] = {
      ["Coins"] = coinAmount: number
    }
  ]]
}

local DEFAULT_PLAYER_DATA = {
  [PlayerData.COIN_KEY_NAME] = 0
}

local function getData(player)
  local data = playerData[tostring(player.UserId)] or DEFAULT_PLAYER_DATA
  playerData[tostring(player.UserId)] = data
  return data
end

function PlayerData.getValue(player, key)
  return getData(player)[key]
end

function PlayerData.updateValue(player, key, updateFunction)
  local data = getData(player)
  local oldValue = data[key]
  local newValue = updateFunction(oldValue)

  data[key] = newValue
  return newValue
end

return PlayerData

Wyja?nienie kodu

Skrypt modułu określają tabelę PlayerData, która zawiera zero lub wiele tabel playerData, które reprezentują dane o zbiórce monet dla gracza. Każdy skrypt, który wymaga tego modułu, otrzymuje tę samą kopię tablicy PlayerData, umożliwiając wiele skryptów do modyfikacji i udostępniania danych o zbiórce monet.

Oznaczanie struktur danych

Skrypt modułu zaczyna się od deklaracji pustej tabeli, PlayerData , która jest zwracana na końcu skryptu. Zawiera również metody dostępu, aby uzyskać i ustawić wartości w tabeli.

Tabela playerData zawiera komentarze opisujące strukturę tabeli, co ułatwia zrozumienie kodu. W tym przypadku tabela playerData zawiera userId i odpowiadającą imię pola nazyającym się 1> Coins1>, które reprezentuje ilość zebranych monet dla tego gracza.


local PlayerData = {}
PlayerData.COIN_KEY_NAME = "Coins"

local playerData = {
  --[[
    [userId: string] = {
        ["Coins"] = coinAmount: number
    }
  ]]
}

...

return PlayerData

Definiowanie lokalnego dostawcy danych

getData() jest lokalną funkcją, która odczytuje dane dla określonego playerData tabeli. Jeśli gracz nie zebrał monety, to zwraca tabelę DEFAULT_PLAYER_DATA, aby upewnić się, że każdy gracz ma kilka danych związanych z nim. Common Con약 jest stworzenie prostych, publicznych funkcji, które od


local DEFAULT_PLAYER_DATA = {
 [PlayerData.COIN_KEY_NAME] = 0
}

local function getData(player)
  local data = playerData[tostring(player.UserId)] or DEFAULT_PLAYER_DATA
  playerData[tostring(player.UserId)] = data
  return data
end

Definowanie dostępcników danych publicznych

getValue() Player() i updateValue() są funkcjami publicznie dostępnymi, które inne skrypty, które wymagają tego modułowego skryptu, mogą wezwywać. W naszym przypadku CoinService używa tych funkcji do aktualizacji danych o monetach gracza, gdy ten gracz dotyka monety.


function PlayerData.getValue(player, key)
 return getData(player)[key]
end

function PlayerData.updateValue(player, key, updateFunction)
  local data = getData(player)
  local oldValue = data[key]
  local newValue = updateFunction(oldValue)

  data[key] = newValue
  return newValue
end

Wdrożenie tabeli liderów

Możesz przedstawić wizualnie dane zbioru monet. Roblox wbudowuje system, który automatycznie generuje tabelę liderów, używając domyślnej interfejsu użytkownika.

Aby stworzyć tabelę ranking:

W oknie Explorer , utwórz ModuleScript w ServerStorage , a następnie zmień nazwę modułu skryptu na 1> Leaderboard1>.

Zastąp standardowy kod następujązym kodem:


local Leaderboard = {}

-- Tworzenie nowego ranking
local function setupLeaderboard(player)
  local leaderstats = Instance.new("Folder")
  -- „leaderstats” to rezerwowany nazwa Roblox uznana za nazwę ranking
  leaderstats.Name = "leaderstats"
  leaderstats.Parent = player
  return leaderstats
end

-- Tworzenie nowej wartości statystyki lidera
local function setupStat(leaderstats, statName)
  local stat = Instance.new("IntValue")
  stat.Name = statName
  stat.Value = 0
  stat.Parent = leaderstats
  return stat
end

-- Aktualizowanie wartości statystyki gracza
function Leaderboard.setStat(player, statName, value)
  local leaderstats = player:FindFirstChild("leaderstats")
  if not leaderstats then
    leaderstats = setupLeaderboard(player)
  end

  local stat = leaderstats:FindFirstChild(statName)
  if not stat then
    stat = setupStat(leaderstats, statName)
  end

  stat.Value = value
end

return Leaderboard

Wyja?nienie kodu

Poniższe sekcje opisują, jak tablica liderów działa bardziej szczegółowo.

Utworzenie listy liderów

Funkcja setupLeaderboard() tworzy nową instancję leaderstats i ustawia ją jako dziecko określonego gracza. Roblox automatycznie rozpozna


-- Tworzenie nowego ranking
local function setupLeaderboard(player)
  local leaderstats = Instance.new("Folder")
  -- „leaderstats” to rezerwowany nazwa Roblox uznana za nazwę ranking
  leaderstats.Name = "leaderstats"
  leaderstats.Parent = player
  return leaderstats
end

-- Tworzenie nowej wartości statystyki lidera
local function setupStat(leaderstats, statName)
  local stat = Instance.new("IntValue")
  stat.Name = statName
  stat.Value = 0
  stat.Parent = leaderstats
  return stat
end

Aktualizowanie statystyk gracza

setStat() jest jedyną publiczną funkcją w modułach Leaderboard . tworzy wartości statystyk dla określonego gracza lub dla tablicy liderów, jeśli nie istnieje jeszcze.

FindFirstChild() wziął nazwę obiektu i zwraca obiekt, jeśli istnieje, lub nil jeśli nie. Jest to powszechny, bezpieczny sposób znalezienia, czy obiekt istnieje przed użyciem go.


-- Aktualizowanie wartości statystyki gracza
function Leaderboard.setStat(player, statName, value)
  local leaderstats = player:FindFirstChild("leaderstats")
  if not leaderstats then
    leaderstats = setupLeaderboard(player)
  end

  local stat = leaderstats:FindFirstChild(statName)
  if not stat then
    stat = setupStat(leaderstats, statName)
  end

  stat.Value = value
end

Zintegrować Skrypcje Modułowe

Zarówno PlayerData i Leaderboard skrypty modułowe są ukończone, wymagają one w CoinService skrypcie, aby zarządzać i wyświetlać dane monety gracza. Aby aktualizować 2>CoinService2>:

W oknie Explorer otwórz skrypt CoinService .

Zastąp obecny kod kodem następującym:


-- Początkowa inicjalizacja usług i zmienne
local Workspace = game:GetService("Workspace")
local Players = game:GetService("Players")
local ServerStorage = game:GetService("ServerStorage")

-- Moduły
local Leaderboard = require(ServerStorage.Leaderboard)
local PlayerData = require(ServerStorage.PlayerData)

local coinsFolder = Workspace.World.Coins
local coins = coinsFolder:GetChildren()

local COIN_KEY_NAME = PlayerData.COIN_KEY_NAME
local COOLDOWN = 10
local COIN_AMOUNT_TO_ADD = 1

local function updatePlayerCoins(player, updateFunction)
  -- Aktualizuj tabelę monet
  local newCoinAmount = PlayerData.updateValue(player, COIN_KEY_NAME, updateFunction)

  -- Aktualizuj rankingmonet
  Leaderboard.setStat(player, COIN_KEY_NAME, newCoinAmount)
end

-- Definiowanie identyfikatora wydarzenia
local function onCoinTouched(otherPart, coin)
  if coin:GetAttribute("Enabled") then
    local character = otherPart.Parent
    local player = Players:GetPlayerFromCharacter(character)
    if player then
      -- Gracz dotknął monety
      coin.Transparency = 1
      coin:SetAttribute("Enabled", false)
      updatePlayerCoins(player, function(oldCoinAmount)
        oldCoinAmount = oldCoinAmount or 0
        return oldCoinAmount + COIN_AMOUNT_TO_ADD
      end)

      task.wait(COOLDOWN)
      coin.Transparency = 0
      coin:SetAttribute("Enabled", true)
    end
  end
end

-- Ustawienie słuchaczy wydarzeń
for _, coin in coins do
  coin:SetAttribute("Enabled", true)
  coin.Touched:Connect(function(otherPart)
    onCoinTouched(otherPart, coin)
  end)
end

Wyja?nienie kodu

Zmiany w oryginalnym CoinService skrypcie obejmują:

Importowanie modułów PlayerData i Leaderboard z funkcją require().
Oświadczenie COIN_AMOUNT_TO_ADD jako liczbę monet do dodania, gdy gracz zbiera monetę, i COIN_KEY_NAME jako imię klucza zdefiniowane w PlayerData .
Utworzenie funkcji pomocniczej updatePlayerCoins() do aktualizacji liczby monet gracza i statystyk tablicy liderów.
Zastąpienie znacznika print() stwierdzenie w onCoinTouched() z wezwanie do updatePlayerCoins() .

Playtest

Nadszedł czas, aby zobaczyć, czy zbiór monet działa tak, jak zaplanowano. Gdy dotykasz i zbierasz monety w gra, powinieneś być w stanie zobaczyć ilość monet, które zebrałeś na pasku lidera. Aby przetestować swoją własną doświadczenie:

W menu Kliknij przycisk Graj. Studio wchodzi w tryb testu.
Przenieś swojego postaci, aby dotknąć monety. Jeśli twoje skrypty działają poprawnie, interfejs lidera wyświetla się i zwiększa liczbę monet, jak zbierasz więcej monet.

Utwórz modułowy skrypt, aby zapisać kolekcję monet

Oznaczanie struktur danych

Definiowanie lokalnego dostawcy danych

Definowanie dostępcników danych publicznych

Wdrożenie tabeli liderów

Utworzenie listy liderów

Aktualizowanie statystyk gracza

Zintegrować Skrypcje Modułowe

Playtest

Na tej stronie