Freundesfinder

Es kann herausfordernd sein, Freunde im Erlebnis zu finden.Das Freundesfinder-Modul lässt Spieler leicht ihre Freunde innerhalb eines Ortes finden und teleportieren.

Modul-Verwendung

Installationen

Um das FriendsLocator -Modul in einem Erlebnis zu verwenden:

1. Von der Ansicht-Registerkarte öffne die Toolbox und wähle die Creator-Store -Registerkarte aus.

   

2. Stellen Sie sicher, dass die Sortierung der Modelle ausgewählt ist, dann klicken Sie auf die Schaltfläche Alle sehen für Kategorien .

   

3. Suchen und klicken Sie auf die Entwickler-Module -Kachel.

   

4. Suchen Sie das Modul Freundessuche und klicken Sie darauf oder ziehen Sie es in die 3D-Ansicht.

   

5. In dem Explorer Fenster verschiebe das gesamte FriendsLocator Modell in ServerScriptService .Wenn das Erlebnis ausgeführt wird, verteilt sich das Modul auf verschiedene Dienste und beginnt zu laufen.

   

Test im Studio

Um das Modul in Studio zu testen, muss das FriendsLocator -Modul in einer Mehrklientensimulation ausgeführt werden, da keine Freunde in einem Solo-Test vorhanden sein werden.

1. In StarterPlayerScripts erstelle ein neues LocalScript und benenne es um in Konfigurieren von Freundesfinder .

   

2. Füge den folgenden Code in das neue ConfigureFriendsLocator Skript, das. PL: die Skriptsein.Die showAllPlayers Einstellung innerhalb der configure Funktion stellt sicher, dass Lokalisierungen für alle Benutzer während des Tests im Studio angezeigt werden, aber nicht an einem veröffentlichten Ort.

   LocalScript - Konfigurieren von FriendsLocator
   local RunService = game:GetService("RunService")
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local FriendsLocator = require(ReplicatedStorage:WaitForChild("FriendsLocator"))
   
   FriendsLocator.configure({
   	showAllPlayers = RunService:IsStudio(), -- Ermöglicht die Fehlersuche im Studio
   })

3. Von der Test-Registerkarte der Toolbar wählen Sie die folgende Kombination für Clients und Server aus und klicken dann auf die Schaltfläche Start.Drei neue Instanzen von Studio öffnen sich; ein simulierter Server und zwei simulierte Clients.

   

4. Gehe in eine der Client- -Studio-Instanzen, bewege eine Entfernung von 100 Stollen von dem anderen Charakter entfernt und du solltest ein Lokalisierungs-Symbol über seinem Kopf erscheinen sehen.

   

   Da die Benutzer-IDs in Studio verwaltet werden, werden Avatarbilder während des Tests nicht auf den Lokalisierungsymbolen angezeigt.

   Standardmäßig wird das Klicken/Tippen auf das Symbol eines Freund:indeinen Charakter an die Position dieses Charakters teleportieren.Wenn Sie dieses Standardverhalten beibehalten und feststellen, dass die Streaming-Pause unter der Instanz-Streaming-Architektur stattfindet, möchten Sie vielleicht Anfragebereichsstreaming rund um den Teleportstandort anfordern, wie in der angeklickten Event-Code-Probe gezeigt.

Verbinden mit Ereignissen

Das Modul FriendsLocator zeigt Ereignisse an, so dass Sie benutzerdefinierte Verhaltensweisen einführen können, wenn Benutzer mit einem Symbolinteragieren.

1. Stellen Sie sicher, dass Sie das Konfigurieren von Freundeslocator Skript erstellt haben, das in Test im Studio beschrieben ist.

2. Füge die Zeilen 8 und 11-13 zum Skript, das. PL: die Skriptshinzu:

   LocalScript - Konfigurieren von FriendsLocator
   local RunService = game:GetService("RunService")
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local FriendsLocator = require(ReplicatedStorage:WaitForChild("FriendsLocator"))
   
   FriendsLocator.configure({
   	showAllPlayers = RunService:IsStudio(), -- Ermöglicht die Fehlersuche im Studio
   	teleportToFriend = false, -- Verhindern Sie Teleport beim Klicken/Tippen auf das Symbol
   })
   
   FriendsLocator.clicked:Connect(function(player, playerCFrame)
   	print("You clicked on locator icon for", player.DisplayName)
   end)

3. Führen Sie einen Multi-Client-Test durch und klicken Sie auf das Symboleines anderen Charakters.Beachten Sie, dass sich Ihr Charakter nicht an diesen Ort teleportiert und das Ereignis ausgelöst wird, um eine benutzerdefinierte Handhabung von Icon-Klicks zu ermöglichen.

Benutzerdefinierte Lokalisierungs-UI

Wenn der Standard-Stil nicht zu deiner Erlebnispasst, kannst du die Standard-Avatar-Portal-Benutzeroberfläche durch deine eigene Benutzeroberfläche ersetzen.

Um die Standard-UI zu ersetzen:

1. Erstellen Sie eine neue ScreenGui Instanz innerhalb des StarterGui Containers.

   

2. Erstelle eine Instanz namens FriendLocator als Kind des neuen >, füge dann Elemente wie oder hinzu, um deine benutzerdefinierte UI zu gestalten.

   

3. Wenn du fertig bist, deaktiviere den Eltern ScreenGui, damit das Modul die benutzerdefinierte Lokalisierungs-UI nicht anzeigt, bis es benötigt wird.

   

4. (Optional) Wenn du das Avatarporträt des Freund:inund DisplayName anzeigen möchtest, erscheint es irgendwo in der benutzerdefinierten UI, kannst du die folgenden Instanzen innerhalb des FriendLocator -Rahmens platzieren.

   • Ein ImageLabel des Namens Porträt .
   • Ein TextLabel des Namens DisplayName .

   

   Das Modul sucht nach diesen Elementen und zeigt das Avatarporträt und/oder den Display-Namen des Freund:inan.

API-Referenz

Funktionen

konfigurieren

Übernimmt Standard-Konfigurationsoptionen durch die folgenden Schlüssel-/Werte in der config Tabelle.

LocalScript - Konfigurieren von FriendsLocator
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local FriendsLocator = require(ReplicatedStorage:WaitForChild("FriendsLocator"))

FriendsLocator.configure({
	alwaysOnTop = true,
	showAllPlayers = false,
	teleportToFriend = true,
	thresholdDistance = 100,
	maxLocators = 10
})

Ereignisse

angeklickt

Feuert, wenn ein Lokalisierungsicon vom lokalen Spieler:ingeklickt/aktiviert wird. Dieses Ereignis kann nur in einem LocalScript verbunden werden.

Lokales Skript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local Players = game:GetService("Players")
local Workspace = game:GetService("Workspace")

local FriendsLocator = require(ReplicatedStorage:WaitForChild("FriendsLocator"))

local localPlayer = Players.LocalPlayer

FriendsLocator.clicked:Connect(function(player, playerCFrame)
	-- Anfordern von Streaming rund um den Zielstandort
	if Workspace.StreamingEnabled then
		local success, errorMessage = pcall(function()
			localPlayer:RequestStreamAroundAsync(playerCFrame.Position)
		end)
		if not success then
			print(errorMessage)
		end
	end

	print("You clicked on locator icon for", player.DisplayName, "at position", playerCFrame.Position)
end)

Sichtbarkeit geändert

Feuert, wenn ein Lokalisierungsicon auf dem Bildschirm des lokalen Spieler:inangezeigt/ausgeblendet wird. Dieses Ereignis kann nur in einem LocalScript verbunden werden.

Lokales Skript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local FriendsLocator = require(ReplicatedStorage:WaitForChild("FriendsLocator"))

FriendsLocator.visibilityChanged:Connect(function(player, playerCFrame, isVisible)
	print("Visibility of locator icon for", player.DisplayName, ":", isVisible)
end)