Spawn Dengan Teman | Dokumentasi - Pusat Kreator Roblox

Mencari teman dalam permainan bisa menjadi tantangan. Modul SpawnWithFriends developer module secara otomatis memindahkan pemain yang muncul dekat salah satu teman mereka yang hadir dalam permainan. Modul ini juga dapat dikonfigurasi untuk mentransfer pemain atas perintah daripada secara otomatis.

Sebelum pemunculan terjadi, untuk menghindari pemunculan karakter di dalam geometri peta, sistem memastikan bahwa ada cukup ruang. Oleh karena itu, modul ini mungkin bekerja lebih baik di permainan dengan ruang terbuka yang besar.

Penggunaan Modul

Instalasi

Untuk menggunakan modul SpawnWithFriends dalam permainan:

Dari menu Window Studio atau toolbar tab Home, buka Toolbox dan pilih tab Creator Store.
Pastikan pengurutan Models dipilih, lalu klik tombol See All untuk Categories.
Temukan dan klik ubin Packages.
Temukan modul Spawn With Friends dan klik, atau seret dan jatuhkan ke dalam tampilan 3D.
Di jendela Explorer, pindahkan seluruh model SpawnWithFriends ke dalam ReplicatedStorage. Setelah menjalankan permainan, modul akan mulai berjalan.

Area Pemunculan Terbatas

Modul ini dapat mengakibatkan pemain muncul di area terbatas seperti ruang VIP, ruang akses terbatas, dll. Untuk mencegah pemain teleportasi ke area ini:

Isi area terbatas dengan blok Anchored yang tidak terlihat. Pastikan CanCollide, CanTouch, dan CanQuery dinonaktifkan untuk semua blok.

Blok yang mengisi seluruh ruang penjara untuk mencegah pemain muncul di dalamnya
Menggunakan bagian Tags dari properti setiap blok, terapkan tag RestrictedSpawnArea agar CollectionService dapat mendeteksinya.

Tempelkan kode berikut ke dalam Script di dalam ServerScriptService.

Script

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

local SpawnWithFriends = require(ReplicatedStorage.SpawnWithFriends)

local function validator(playerToTeleport, destinationPlayer, teleportationPoint)
	-- Iterasi melalui semua bagian yang ditandai
	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  -- Tujuan pemunculan berada di dalam area terbatas; batalkan teleportasi
		end
	end
	return true  -- Tujuan pemunculan tidak tumpang tindih dengan area terbatas; lanjutkan dengan teleportasi
end

SpawnWithFriends.setTeleportationValidator(validator)

Referensi API

Fungsi

configure

configure(config: table)

Mengganti opsi konfigurasi default melalui kunci/nilai berikut dalam tabel config. Fungsi ini hanya dapat dipanggil dari Script.

Kunci	Deskripsi	Default
teleportToFriendOnRespawn	Jika diatur ke false, teleportasi ke teman hanya akan terjadi secara manual melalui teleportToRandomFriend.	true
teleportDistance	Seberapa jauh pemain harus muncul dari satu sama lain, diukur dalam stud.	5
maxCharacterVelocity	Karakter yang bergerak lebih cepat dari nilai ini tidak akan dipilih sebagai kandidat teleportasi, misalnya yang berada di kendaraan yang bergerak.	48
bypassFriendshipCheck	Jika diatur ke true, semua pemain akan menjadi kandidat untuk teleportasi, bukan hanya teman.	false
showLogs	Apakah akan menampilkan pesan log di output atau tidak.	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

Secara manual memicu teleportasi seorang pemain ke salah satu temannya dalam permainan. Mengembalikan boolean yang menunjukkan apakah teleportasi berhasil atau tidak; kegagalan untuk teleportasi dapat disebabkan oleh tidak adanya teman di server atau ketidakmampuan untuk menemukan titik teleportasi yang tidak terhalang. Fungsi ini hanya dapat dipanggil dari Script.

setTeleportationValidator

setTeleportationValidator(validator: function)

Memungkinkan Anda untuk melakukan pemeriksaan pra-teleportasi kustom dengan menghubungkan fungsi callback validator. Callback menerima tiga parameter:

Parameter	Deskripsi
playerToTeleport	Referensi ke Player yang sedang ditransfer.
destinationPlayer	Referensi ke Player target yang playerToTeleport sedang ditransfer ke.
teleportationPoint	CFrame di mana playerToTeleport sedang ditransfer.

Fungsi ini dan callback-nya hanya dapat digunakan dalam Script dan callback mengembalikan boolean yang menunjukkan apakah teleportasi harus dilanjutkan. Misalnya, logika return dalam fungsi validator berikut memastikan bahwa pemain yang muncul dan pemain tujuan berada di tim yang sama.

Script

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SpawnWithFriends = require(ReplicatedStorage.SpawnWithFriends)

-- Mentransfer pemain hanya jika mereka berada di tim yang sama
local function validator(playerToTeleport, destinationPlayer, teleportationPoint)
	return playerToTeleport.Team == destinationPlayer.Team
end

SpawnWithFriends.setTeleportationValidator(validator)