Selain mentransfer pemain antara server publik, TeleportService mendukung teleportasi ke server pribadi, yang merupakan server yang dibatasi untuk pemain tertentu. Ada dua jenis server pribadi yang dapat Anda teleportasikan:
- Server yang dipesan: Server yang dibuat oleh pengembang yang diakses melalui ID yang disediakan oleh pengembang. Berguna untuk pertandingan pribadi, sesi kooperatif, atau skenario di mana Anda mengontrol siapa yang bergabung.
- Server VIP: Server pribadi yang dibeli oleh pemain. Gunakan TeleportOptions.VipServerId untuk mengarahkan pemain ke server VIP yang telah mereka beli.
Teleport ke server yang dipesan
Server yang dipesan dibuat sesuai permintaan: teleportasi pertama menggunakan ReservedServerId baru akan membuat server, dan menggunakan ID yang sama akan mengarahkan teleportasi berikutnya ke server yang sama. Hasilkan ID dengan HttpService:GenerateGUID(false):
local HttpService = game:GetService("HttpService")
local TeleportService = game:GetService("TeleportService")
local Players = game:GetService("Players")
local TARGET_PLACE_ID = 12345678901234
-- Pengguna yang akan ditransfer (misalnya dari Players:GetPlayers() atau grup pencocokan)
local player1, player2 = Players:GetPlayers()[1], Players:GetPlayers()[2]
-- Hasilkan ID unik untuk server yang dipesan
local reservedServerId = HttpService:GenerateGUID(false)
local teleportOptions = Instance.new("TeleportOptions")
teleportOptions.ReservedServerId = reservedServerId
-- Teleportasi pertama membuat server
TeleportService:TeleportAsync(TARGET_PLACE_ID, {player1, player2}, teleportOptions)Menggunakan kembali ID server yang dipesan
Untuk memungkinkan pemain lain bergabung ke server yang dipesan yang sama nanti, simpan ID server yang dipesan dengan penyimpanan data DataStoreService sehingga dapat bertahan di antara sesi dan server.
Di server yang membuat server yang dipesan, hasilkan ID untuk teleportasi pertama, lalu simpan dengan kunci yang mengidentifikasi sesi (misalnya ID lobi atau ID pesta):
local DataStoreService = game:GetService("DataStoreService")
local HttpService = game:GetService("HttpService")
local TeleportService = game:GetService("TeleportService")
local reservedServersStore = DataStoreService:GetDataStore("ReservedServers")
-- Kunci yang mengidentifikasi sesi bersama di seluruh server
local sessionKey = "lobby-123"
-- ID baru membuat server yang dipesan saat tiba di tujuan
local reservedServerId = HttpService:GenerateGUID(false)
reservedServersStore:SetAsync(sessionKey, reservedServerId)
local teleportOptions = Instance.new("TeleportOptions")
teleportOptions.ReservedServerId = reservedServerId
TeleportService:TeleportAsync(TARGET_PLACE_ID, { player }, teleportOptions)Di server lain yang perlu mengirim pemain ke server yang dipesan yang sama, cari ID dengan kunci sesi yang sama dan atur sebagai TeleportOptions.ReservedServerId dari teleportasi:
local DataStoreService = game:GetService("DataStoreService")
local TeleportService = game:GetService("TeleportService")
local reservedServersStore = DataStoreService:GetDataStore("ReservedServers")
local sessionKey = "lobby-123"
local existingId = reservedServersStore:GetAsync(sessionKey)
if existingId then
local teleportOptions = Instance.new("TeleportOptions")
teleportOptions.ReservedServerId = existingId
TeleportService:TeleportAsync(TARGET_PLACE_ID, { player }, teleportOptions)
endDi server VIP, untuk membuat ID server VIP tersedia di server tujuan tanpa penyimpanan data, lampirkan ke setiap pemain dengan TeleportOptions:SetTeleportData():
local teleportOptions = Instance.new("TeleportOptions")
teleportOptions.VipServerId = game.PrivateServerId
teleportOptions:SetTeleportData({ vipServerId = game.PrivateServerId })
TeleportService:TeleportAsync(TARGET_PLACE_ID, {player}, teleportOptions)Saat tiba, baca kembali dari data bergabung pemain. Untuk informasi lebih lanjut, lihat Kirim data pengguna bersama dengan teleportasi.
Identifikasi server yang dipesan saat tiba
Di server tujuan, periksa apakah server saat ini adalah server yang dipesan:
local isReserved = game.PrivateServerId ~= "" and game.PrivateServerOwnerId == 0DataModel.PrivateServerId cocok dengan ReservedServerId yang Anda berikan dan tetap konstan di semua instance server untuk server yang dipesan tersebut. DataModel.JobId unik per instance yang berjalan dan berubah saat server di-restart.
Teleport ke server VIP
Server VIP adalah server pribadi yang dapat dibeli pemain dari halaman permainan. Untuk mentransfer pemain ke server VIP, atur TeleportOptions.VipServerId ke DataModel.PrivateServerId dari server VIP target.
local TeleportService = game:GetService("TeleportService")
local TARGET_PLACE_ID = 12345678901234
-- PrivateServerId dari server VIP tujuan, misalnya dibawa
-- dalam data teleport pemain atau dibaca dari penyimpanan data
local vipServerId = player:GetJoinData().TeleportData.vipServerId
local teleportOptions = Instance.new("TeleportOptions")
teleportOptions.VipServerId = vipServerId
TeleportService:TeleportAsync(TARGET_PLACE_ID, {player}, teleportOptions)TeleportOptions.VipServerId berbeda dari TeleportOptions.ReservedServerId. Gunakan ReservedServerId untuk server yang dipesan yang dibuat oleh pengembang dan VipServerId untuk server VIP yang dibeli pemain.
ID server VIP terbatas pada pengalaman yang memiliki server VIP: Anda dapat menggunakannya dengan ID tempat dari tempat mana pun dalam pengalaman itu, tetapi tidak dengan ID tempat dari pengalaman lain.
Ketika Anda membiarkan bidang routing tidak diatur, mesin memilih server tujuan. Teleportasi tanpa bidang routing server pribadi yang diatur dapat mendarat di server publik atau, jika pemain baru-baru ini bergabung dengan server VIP dari pengalaman itu, di server VIP tersebut.
Kasus penggunaan umum untuk pola ini adalah mengembalikan pemain dari server yang dipesan kembali ke server VIP dari tempat utama pengalaman. Karena game.PrivateServerId dari server yang dipesan adalah ID yang dipesan sendiri daripada server VIP asal, bawa ID server VIP ke dalam server yang dipesan, misalnya dengan mengirimkannya dalam teleportData pada teleportasi keluar atau menyimpannya dalam penyimpanan data seperti yang ditunjukkan di Gunakan kembali ID server yang dipesan, lalu atur sebagai TeleportOptions.VipServerId dari teleportasi kembali.
Atur TeleportOptions.VipServerId yang sama pada setiap teleportasi untuk menjaga pemain tetap di server VIP yang sama di seluruh tempat selama permainan.
Pemeriksaan akses server VIP
Seorang pemain dapat bergabung ke server VIP jika pengaturan Teman Diizinkan server, daftar izinnya, atau kode tautan memberinya akses pada saat teleportasi. Pemilik server VIP dapat mengubah pengaturan ini kapan saja, jadi seorang pemain yang sebelumnya memiliki akses mungkin kehilangan akses tersebut.
Jika seorang pemain tidak diizinkan untuk bergabung, TeleportService.TeleportInitFailed akan dipicu dan pemain akan melihat kesalahan yang mengatakan bahwa server dibatasi. Untuk mentransfer sekelompok pemain ke server VIP, kirim beberapa pemain dengan TeleportOptions.VipServerId yang sama. Mesin memeriksa setiap pemain secara independen pada saat koneksi, jadi pemain tanpa akses gagal secara individu sementara yang lainnya teleportasi secara normal. Selalu tangani TeleportService.TeleportInitFailed untuk teleportasi VIP, karena pemain mungkin juga telah menutup server VIP atau beralih ke server yang berbeda.
Simpan dan bagikan ID server
Objek TeleportAsyncResult yang dikembalikan oleh TeleportService:TeleportAsync() berisi informasi tentang tujuan:
- TeleportAsyncResult.PrivateServerId - ID server pribadi dari server tujuan. Cocok dengan DataModel.PrivateServerId di tujuan.
- TeleportAsyncResult.ReservedServerAccessCode - Hanya diisi untuk teleportasi kode akses warisan. Tidak diisi saat menggunakan ReservedServerId atau VipServerId.
local result = TeleportService:TeleportAsync(TARGET_PLACE_ID, {player}, teleportOptions)
if result then
print("PrivateServerId Tujuan:", result.PrivateServerId)
endMigrasi dari kode akses warisan
Jika permainan Anda menggunakan TeleportOptions.ReservedServerAccessCode atau TeleportOptions.ShouldReserveServer yang sudah tidak digunakan, migrasikan ke ReservedServerId dengan mengganti alur kode akses dengan alur berbasis GUID:
- Ganti ReserveServerAsync() dan ReservedServerAccessCode dengan HttpService:GenerateGUID(false) dan ReservedServerId.
- Simpan GUID yang dihasilkan sehingga Anda dapat menggunakannya kembali untuk teleportasi berikutnya ke server yang sama.
- Perbarui semua penggunaan TeleportOptions untuk mengatur ReservedServerId alih-alih ReservedServerAccessCode atau ShouldReserveServer.
Sebelum (tidak digunakan)
-- Tidak digunakan: ReserveServerAsync + ReservedServerAccessCode
local accessCode, privateServerId = TeleportService:ReserveServerAsync(TARGET_PLACE_ID)
local teleportOptions = Instance.new("TeleportOptions")
teleportOptions.ReservedServerAccessCode = accessCode
TeleportService:TeleportAsync(TARGET_PLACE_ID, {player}, teleportOptions)Setelah (sekarang)
local HttpService = game:GetService("HttpService")
local TeleportService = game:GetService("TeleportService")
-- Sekarang: GenerateGUID + ReservedServerId
local reservedServerId = HttpService:GenerateGUID(false)
local teleportOptions = Instance.new("TeleportOptions")
teleportOptions.ReservedServerId = reservedServerId
TeleportService:TeleportAsync(TARGET_PLACE_ID, {player}, teleportOptions)ReserveServerAsync() dan ReservedServerAccessCode yang lama tetap tersedia untuk kompatibilitas mundur, tetapi tidak disarankan untuk pekerjaan baru. ReserveServerAsync() sebenarnya tidak memesan server di muka, tetapi hanya menghasilkan GUID acak. Server yang dipesan yang ada yang dibuat dengan kode akses terus berfungsi.
Tangani teleportasi yang gagal
Teleportasi ke server pribadi dapat gagal seperti panggilan jaringan lainnya. Bungkus dalam pcall dan coba lagi sesuai kebutuhan. Ketika teleportasi dimulai tetapi gagal pada saat terakhir, TeleportService.TeleportInitFailed akan dipicu dengan TeleportOptions asli sehingga Anda dapat mencoba lagi dengan tujuan yang sama.
Untuk implementasi percobaan penuh, lihat Tangani teleportasi yang gagal dalam panduan teleportasi utama.
Ketika mesin itu sendiri mengarahkan teleportasi biasa ke server VIP, kegagalan bergabung yang spesifik untuk VIP seperti server penuh atau teraliri akan kembali ke bergabung publik alih-alih memicu TeleportService.TeleportInitFailed. Hanya teleportasi dengan TeleportOptions.VipServerId yang eksplisit yang mengungkapkan kegagalan ini kepada pengelola percobaan Anda.
Praktik terbaik
- Hasilkan ID di server. Selalu panggil HttpService:GenerateGUID(false) dari Script server untuk mencegah klien memprediksi atau mengontrol ID server yang dipesan.
- Simpan ID server yang dipesan. Simpan GUID dalam penyimpanan data jika pemain perlu bergabung kembali ke server yang dipesan yang sama di antara sesi.
- Gunakan bidang yang tepat. Gunakan ReservedServerId untuk server yang dipesan yang dibuat oleh pengembang, VipServerId untuk server VIP yang dibeli pemain. Jangan pernah mengatur keduanya pada instance TeleportOptions yang sama.
- Jangan campur bidang routing. Anda hanya dapat mengatur satu dari ReservedServerId, VipServerId, atau ServerInstanceId pada satu waktu. Mengatur lebih dari satu menyebabkan kesalahan.