Mit Freunden erscheinen | Dokumentation

Es kann eine Herausforderung sein, Freunde im Spiel zu finden. Das SpawnWithFriends Entwicklermodul bewegt automatisch erscheinende Spieler in die Nähe eines ihrer Freunde, der im Spiel anwesend ist. Dieses Modul kann auch so konfiguriert werden, dass ein Spieler auf Befehl teleportiert wird, anstatt automatisch.

Vor dem Erscheinen wird das System bestätigen, dass genügend Platz vorhanden ist, um zu vermeiden, dass ein Charakter innerhalb der Geometrie der Karte erscheint. Daher könnte dieses Modul in Erlebnissen mit großen, offenen Flächen besser funktionieren.

Modulnutzung

Installation

Um das SpawnWithFriends Modul in einem Erlebnis zu verwenden:

Öffnen Sie im Studio-Menü Fenster oder in der Symbolleiste der Startseite den Toolbox und wählen Sie die Registerkarte Creator Store.
Stellen Sie sicher, dass die Modelle-Sortierung ausgewählt ist, und klicken Sie dann auf die Schaltfläche Alle anzeigen für Kategorien.
Finden Sie die Kachel Pakete und klicken Sie darauf.
Suchen Sie das Modul Mit Freunden erscheinen und klicken Sie darauf oder ziehen Sie es in die 3D-Ansicht.
Verschieben Sie im Explorer Fenster das gesamte SpawnWithFriends Modell in ReplicatedStorage. Nach dem Ausführen des Erlebnisses beginnt das Modul mit der Ausführung.

Eingeschränkte Spawn-Bereiche

Dieses Modul kann dazu führen, dass Spieler in eingeschränkten Bereichen wie VIP-Räumen, zugangsbeschränkten Bereichen usw. erscheinen. Um zu verhindern, dass Spieler in diese Bereiche teleportiert werden:

Füllen Sie den eingeschränkten Bereich mit unsichtbaren Anchored Blöcken. Stellen Sie sicher, dass CanCollide, CanTouch und CanQuery für alle Blöcke deaktiviert sind.

Block, der den gesamten Gefängnissraum ausfüllt, um zu verhindern, dass Spieler innen erscheinen
Verwenden Sie den Tags Abschnitt der Eigenschaften jedes Blocks, um das Tag RestrictedSpawnArea zuzuweisen, damit CollectionService sie erkennt.

Fügen Sie den folgenden Code in ein Script innerhalb von ServerScriptService ein.

Script
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local CollectionService = game:GetService("CollectionService")

local SpawnWithFriends = require(ReplicatedStorage.SpawnWithFriends)

local function validator(playerToTeleport, destinationPlayer, teleportationPoint)
	-- Iteriere durch alle markierten Teile
	for _, area in CollectionService:GetTagged("RestrictedSpawnArea") do
		local relativePosition = area.CFrame:PointToObjectSpace(teleportationPoint.Position)
		local size = area.Size
		local inXBounds = relativePosition.X < size.X / 2 and relativePosition.X > -size.X / 2
		local inZBounds = relativePosition.Z < size.Z / 2 and relativePosition.Z > -size.Z / 2
		if inXBounds and inZBounds then
			return false  -- Spawn-Ziel befindet sich im eingeschränkten Bereich; Teleportation abbrechen
		end
	end
	return true  -- Spawn-Ziel überschneidet sich nicht mit einem eingeschränkten Bereich; Teleportation fortsetzen
end

SpawnWithFriends.setTeleportationValidator(validator)

API-Referenz

Funktionen

configure

configure(config: table)

Überschreibt die Standardkonfigurationsoptionen über die folgenden Schlüssel/Werte im config Tabell. Diese Funktion kann nur von einem Script aufgerufen werden.

Schlüssel	Beschreibung	Standard
teleportToFriendOnRespawn	Wenn auf false gesetzt, erfolgt die Teleportation zu einem Freund nur manuell über teleportToRandomFriend.	true
teleportDistance	Wie weit Spieler voneinander erscheinen sollen, gemessen in Stüden.	5
maxCharacterVelocity	Charaktere, die schneller als dieser Wert bewegen, werden nicht als Teleportationskandidaten ausgewählt, z. B. diejenigen in beweglichen Fahrzeugen.	48
bypassFriendshipCheck	Wenn auf true gesetzt, werden alle Spieler als Kandidaten für die Teleportation betrachtet, nicht nur Freunde.	false
showLogs	Ob Lognachrichten in der Ausgabe angezeigt werden sollen oder nicht.	false

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

local SpawnWithFriends = require(ReplicatedStorage.SpawnWithFriends)

SpawnWithFriends.configure({
	teleportToFriendOnRespawn = true,
	teleportDistance = 5,
	maxCharacterVelocity = 48,
	bypassFriendshipCheck = false,
	showLogs = false
})

teleportToRandomFriend

teleportToRandomFriend(playerToTeleport: Player): boolean

Manuell löst die Teleportation eines Spielers zu einem seiner Freunde im Erlebnis aus. Gibt einen booleschen Wert zurück, der angibt, ob die Teleportation erfolgreich war oder nicht; das Fehlen von Freunden im Server oder die Unfähigkeit, einen ungehinderten Teleportationspunkt zu finden, kann zu einem Teleportationsfehler führen. Diese Funktion kann nur von einem Script aufgerufen werden.

setTeleportationValidator

setTeleportationValidator(validator: function)

Ermöglicht es Ihnen, benutzerdefinierte Vorab-Teleportationsprüfungen durch das Anschließen einer Validator-Callback-Funktion durchzuführen. Der Callback erhält drei Parameter:

Parameter	Beschreibung
playerToTeleport	Referenz auf den Player, der teleportiert wird.
destinationPlayer	Referenz auf den Ziel-Player, zu dem playerToTeleport teleportiert wird.
teleportationPoint	CFrame, zu dem playerToTeleport teleportiert wird.

Diese Funktion und ihr Callback können nur in einem Script verwendet werden, und der Callback gibt einen booleschen Wert zurück, der angibt, ob die Teleportation fortgesetzt werden soll. Beispielsweise stellt die return-Logik in der folgenden Validatorfunktion sicher, dass der erscheinende Spieler und der Zielspieler im selben Team sind.

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

local SpawnWithFriends = require(ReplicatedStorage.SpawnWithFriends)

-- Teleportiert Spieler nur, wenn sie im gleichen Team sind
local function validator(playerToTeleport, destinationPlayer, teleportationPoint)
	return playerToTeleport.Team == destinationPlayer.Team
end

SpawnWithFriends.setTeleportationValidator(validator)