API Kepercayaan Perangkat memberi tahu Anda seberapa banyak Anda dapat mempercayai perangkat setiap pemain yang bergabung dengan permainan Anda. Saat seorang pemain bergabung, Roblox memeriksa apakah perangkat mereka dapat dipercaya, dan memberikan hasilnya sebagai tingkat kepercayaan perangkat. Pemeriksaan ini adalah lapisan perlindungan opsional di atas anti-cheat bawaan Roblox, yang mendeteksi eksploitasi setelah seorang pemain bergabung.
Roblox tidak mengambil tindakan berdasarkan tingkat kepercayaan perangkat. Anda yang memutuskan apa artinya untuk permainan Anda. Misalnya, Anda dapat mencocokkan pemain dengan tingkat kepercayaan yang serupa, membatasi fitur sensitif seperti perdagangan hanya untuk perangkat yang dipercaya, atau menolak pemain yang perangkatnya gagal dalam pemeriksaan.
API Kepercayaan Perangkat terdiri dari callback IntegrityService.EvaluatePlayerDeviceTrust dan properti Player.DeviceTrustLevel. Untuk mulai menggunakannya dalam skrip Anda, lihat baca tingkat kepercayaan.
Kepercayaan perangkat melengkapi taktik dalam taktik keamanan dan mitigasi cheat daripada menggantikannya.
Tingkat kepercayaan perangkat
Tingkat kepercayaan perangkat seorang pemain adalah salah satu nilai Enum.PlayerDeviceTrustLevel berikut:
| Level | Arti |
|---|---|
| Pending | Roblox masih memeriksa perangkat. Setiap pemain mulai pada level ini. |
| Unknown | Pemain berada di platform yang tidak didukung, atau terjadi kesalahan di sisi Roblox. Roblox tidak dapat memberitahu apakah perangkat tersebut dapat dipercaya, jadi mungkin atau mungkin tidak dapat dipercaya. |
| None | Perangkat gagal dalam pemeriksaan, atau pemain berada di platform yang tidak dapat diverifikasi dan sering digunakan untuk kecurangan. Pemain pada level ini biasanya harus beralih ke perangkat lain untuk mencapai level yang lebih tinggi, meskipun beberapa dapat memperbaiki perangkat mereka saat ini. |
| Standard | Perangkat melewati beberapa pemeriksaan, tetapi tidak semuanya. Perangkat ini sebagian besar aman, dan pemain biasanya dapat mencapai Full dengan memperbarui atau memperbaiki perangkat mereka. Beberapa perangkat tidak dapat melampaui Standard. |
| Full | Perangkat melewati setiap pemeriksaan dan sepenuhnya aman. |
Platform yang didukung
Roblox memeriksa kepercayaan perangkat di platform berikut:
| Platform | Status | Tingkat kepercayaan yang dilaporkan |
|---|---|---|
| Android | Didukung | None, Standard, atau Full |
| Chromebook | Didukung | None, Standard, atau Full |
| Meta Quest | Didukung | None, Standard, atau Full |
| Web browser | Tidak dapat diverifikasi | None |
| iOS | Segera hadir | Unknown |
| macOS | Segera hadir | Unknown |
| Windows | Segera hadir | Unknown |
| Xbox | Segera hadir | Unknown |
| PlayStation | Segera hadir | Unknown |
Sampai Roblox mendukung sebuah platform, pemain di platform tersebut melaporkan Unknown.
Di platform yang didukung, tingkat kepercayaan yang dapat dicapai oleh perangkat juga tergantung pada perangkat kerasnya. Misalnya, tidak setiap perangkat Android mendukung pemeriksaan yang digunakan Roblox, jadi beberapa perangkat tidak dapat mencapai Standard atau Full meskipun mereka belum dimanipulasi. Untuk daftar perangkat yang diketahui didukung, lihat Pusat Bantuan.
Cara kerjanya
Ketika seorang pemain bergabung dengan permainan Anda, Roblox menggunakan sinyal perangkat keras dari perangkat mereka untuk mengonfirmasi hal-hal berikut:
- Perangkat adalah perangkat fisik dan bukan emulator.
- Sistem operasi tidak telah dimanipulasi, misalnya dengan melakukan rooting pada perangkat.
- Aplikasi Roblox tidak telah dimodifikasi.
Dari pemeriksaan ini, Roblox menghitung tingkat kepercayaan perangkat untuk pemain. Untuk menjaga efektivitas sistem, Roblox tidak menerbitkan sinyal spesifik yang dievaluasi.
Pemeriksaan berjalan di latar belakang saat pemain bergabung, sehingga tidak menunda pemuatan. Pemain dapat mulai bermain sebelum tingkat kepercayaan mereka tersedia, jadi perlakukan pemain sebagai tidak dapat dipercaya sampai itu tersedia. Untuk detail lebih lanjut, lihat baca tingkat kepercayaan.
Tingkat kepercayaan perangkat menggambarkan perangkat, bukan pemain atau akun mereka. Ini tidak memberi tahu Anda apakah seorang pemain sedang curang. Ini memberi tahu Anda seberapa sulit kecurangan dilakukan di perangkat mereka. Untuk memeriksa akun sebagai gantinya, gunakan Player:IsVerified().
Dampak pada pemain yang sah
Tidak ada pemeriksaan perangkat yang sempurna. Beberapa pemain yang tidak berniat curang masih mencapai tingkat kepercayaan yang rendah. Pemain ini terbagi menjadi dua kelompok.
Pemain yang dapat memperbaiki perangkat mereka
Beberapa perangkat mampu melewati pemeriksaan tetapi tidak disiapkan untuk melakukannya, seperti perangkat dengan sistem operasi yang usang, perangkat yang telah di-root, atau perangkat yang menjalankan versi modifikasi dari aplikasi Roblox. Pemain ini biasanya dapat meningkatkan tingkat kepercayaan mereka dengan memperbarui perangkat mereka, menginstal ulang Roblox dari toko aplikasi resmi, atau mengembalikan perangkat mereka ke keadaan semula. Anda dapat mengarahkan pemain yang terkena dampak ke langkah pemecahan masalah di Pusat Bantuan.
Pemain yang tidak dapat memperbaiki perangkat mereka
Pemain lain menggunakan perangkat lama yang tidak mendukung perangkat keras yang menjadi dasar pemeriksaan ini. Pemain ini tidak dapat meningkatkan tingkat kepercayaan mereka di perangkat tersebut, dan hanya dapat mencapai tingkat yang lebih tinggi dengan beralih ke perangkat baru yang didukung. Untuk informasi lebih lanjut, lihat platform yang didukung.
Apa yang dilihat pemain yang ditolak
Jika permainan Anda menolak seorang pemain berdasarkan tingkat kepercayaan mereka, pemain tersebut akan terputus dan melihat pesan. Anda dapat menulis pesan ini sendiri, misalnya untuk mengarahkan pemain ke mode yang masih dapat mereka mainkan. Jika tidak, Roblox akan menampilkan pesan default yang menjelaskan mengapa mereka tidak dapat bergabung dan bagaimana mereka mungkin memperbaiki perangkat mereka.
Implementasi
Perkirakan dampaknya
Sebelum Anda bertindak berdasarkan kepercayaan perangkat, periksa berapa banyak pemain Anda yang dicakup oleh setiap tingkat kepercayaan. Halaman Anti-cheat di Creator Hub memperkirakan bagaimana pengguna aktif harian Anda, waktu bermain, dan pendapatan di platform yang didukung terpecah berdasarkan tingkat kepercayaan perangkat. Untuk melihatnya, Anda harus menjadi pemilik permainan atau memiliki izin melihat analitik untuk pengalaman.
- Navigasikan ke halaman Kreasi Anda di Creator Hub dan pilih permainan Anda.
- Di menu sebelah kiri, pilih Keamanan, lalu pilih Anti-cheat.
Pilih kebijakan
Kebijakan Anda adalah bagaimana permainan Anda merespons setiap tingkat kepercayaan perangkat. Untuk memilih satu:
- Tentukan apa arti Unknown untuk permainan Anda. Terserah Anda untuk memperlakukan pemain di Unknown seperti pemain di perangkat yang dipercaya, seperti pemain di None, atau berbeda di berbagai bagian permainan Anda.
- Periksa dampaknya. Tinjau halaman Anti-cheat di Creator Hub untuk melihat bagaimana pemain Anda terpecah berdasarkan tingkat kepercayaan. Untuk informasi lebih lanjut, lihat perkirakan dampaknya.
- Pilih bagaimana merespons setiap level. Respons berikut ini dari yang paling sedikit hingga yang paling mengganggu, dan Anda dapat menggabungkannya:
- Arahkan pemain berdasarkan tingkat kepercayaan. Kirim pemain ke tempat atau server yang sesuai dengan tingkat kepercayaan mereka, seperti tempat santai untuk semua orang dan tempat peringkat untuk perangkat yang dipercaya. Setiap pemain masih dapat memainkan permainan Anda. Untuk contoh, lihat arah pemain berdasarkan tingkat kepercayaan.
- Batasi fitur sensitif. Minta tingkat kepercayaan yang lebih tinggi untuk fitur tertentu, seperti perdagangan, dan biarkan semua orang memainkan sisa permainan Anda. Untuk contoh, lihat batasi fitur berdasarkan tingkat kepercayaan.
- Tolak pemain. Tolak pemain dari seluruh permainan Anda. Hanya tolak pemain di None sebagai upaya terakhir. Untuk contoh, lihat tolak pemain saat bergabung.
Kebijakan yang direkomendasikan berdasarkan genre
Tabel berikut menyarankan kebijakan awal untuk genre umum di Roblox. Sesuaikan dengan cara kerja permainan Anda.
| Genre | Pending | Unknown | None | Standard | Full |
|---|---|---|---|---|---|
| FPS Kompetitif | Tunggu hingga hasil dihitung | Hanya santai | Hanya santai | Santai dan peringkat | Santai dan peringkat |
| Pertempuran atau bertarung | Tunggu hingga hasil dihitung | Server terpisah | Server terpisah | Server terpercaya | Server terpercaya |
| Balapan, dengan papan peringkat | Tunggu hingga hasil dihitung | Di luar papan peringkat | Di luar papan peringkat | Di papan peringkat | Di papan peringkat |
| Tempat perdagangan | Tunggu hingga hasil dihitung | Dapat berdagang | Tidak dapat berdagang | Dapat berdagang | Dapat berdagang |
| Idle, AFK, atau tycoon | Tunggu hingga hasil dihitung | Mendapatkan hadiah AFK | Tidak ada hadiah AFK | Mendapatkan hadiah AFK | Mendapatkan hadiah AFK |
| Peran atau tempat sosial | Tunggu hingga hasil dihitung | Akses penuh | Akses penuh | Akses penuh | Akses penuh |
Baca tingkat kepercayaan
Setiap penggunaan API Kepercayaan Perangkat dimulai dengan Player.DeviceTrustLevel, yang berisi tingkat kepercayaan seorang pemain. Bacalah di server ketika permainan Anda perlu membuat keputusan, seperti ketika seorang pemain meminta untuk bergabung dengan pertandingan peringkat atau memulai perdagangan.
Perhatikan hal-hal berikut saat Anda membaca properti:
- Setiap pemain mulai di Pending, dan properti berubah sekali, ketika tingkat kepercayaan tersedia. Jika Roblox tidak dapat menyelesaikan pemeriksaan perangkat, properti mungkin tetap di Pending selama sesi tersebut. Selalu perlakukan Pending sebagai tidak cukup dipercaya untuk fitur sensitif.
- Bacalah tingkat kepercayaan di server, dan biarkan server memberi tahu setiap klien fitur mana yang harus diaktifkan atau dinonaktifkan, misalnya dengan memicu RemoteEvent kepada pemain tersebut. Hindari membaca properti di klien. Hanya klien pemain sendiri yang dapat membaca tingkat kepercayaan mereka, setiap klien lain melihat Pending, dan penipu dapat mengubah apa yang dilakukan klien mereka dengan itu.
- Di Studio, tingkat kepercayaan selalu Pending. Untuk detail lebih lanjut, lihat uji logika Anda.
Tunggu tingkat kepercayaan
Beberapa bagian permainan Anda mungkin memerlukan tingkat kepercayaan sebelum seorang pemain mulai, seperti pencocokan yang mengirim pemain ke lobi berdasarkan tingkat kepercayaan mereka. Dalam hal ini, Anda dapat menahan pemain di Players.PlayerAdded sampai callback berjalan, dan kemudian melanjutkan dengan tingkat kepercayaan mereka.
Hanya gunakan pola ini untuk menerima pemain dan menyesuaikan pengalaman mereka, misalnya dengan mengarahkan mereka atau membatasi fitur. Untuk menolak pemain, kembalikan Reject dari callback IntegrityService.EvaluatePlayerDeviceTrust dan simpan logika itu di callback, seperti yang dijelaskan dalam tolak pemain saat bergabung.
Skrip berikut menyimpan thread yang dijalankan PlayerAdded, menunggu dengan coroutine.yield(), dan melanjutkannya dari callback dengan task.defer(). Jika pemain meninggalkan, atau tingkat kepercayaan tidak tersedia setelah MAX_WAIT_SECONDS, skrip melanjutkan thread sehingga tidak ada pemain yang menunggu selamanya:
local IntegrityService = game:GetService("IntegrityService")
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
-- Berapa lama menahan pemain sebelum Anda berhenti menunggu tingkat kepercayaan mereka
local MAX_WAIT_SECONDS = 10
-- Thread yang menunggu tingkat kepercayaan setiap pemain
local waitingThreads: { [Player]: thread } = {}
-- Melanjutkan thread yang menunggu pemain, jika ada
local function release(player: Player, trustLevel: Enum.PlayerDeviceTrustLevel?)
local thread = waitingThreads[player]
if thread then
waitingThreads[player] = nil
task.defer(thread, trustLevel)
end
end
-- Menunggu hingga tingkat kepercayaan pemain tersedia. Mengembalikan Pending jika
-- waktu tunggu habis, dan nil jika pemain meninggalkan terlebih dahulu.
local function waitForTrustLevel(player: Player): Enum.PlayerDeviceTrustLevel?
-- Roblox tidak memeriksa perangkat di Studio, jadi jangan tahan pemain selama uji coba
if player.DeviceTrustLevel ~= Enum.PlayerDeviceTrustLevel.Pending or RunService:IsStudio() then
return player.DeviceTrustLevel
end
waitingThreads[player] = coroutine.running()
task.delay(MAX_WAIT_SECONDS, release, player, Enum.PlayerDeviceTrustLevel.Pending)
return coroutine.yield()
end
IntegrityService.EvaluatePlayerDeviceTrust = function(player, measures)
release(player, player.DeviceTrustLevel)
return { Action = Enum.PlayerDeviceTrustDecision.Accept }
end
Players.PlayerRemoving:Connect(function(player)
release(player, nil)
end)
Players.PlayerAdded:Connect(function(player)
local trustLevel = waitForTrustLevel(player)
if trustLevel == nil then
return
end
-- Mulai sesi pemain di sini, misalnya dengan mengirim mereka ke lobi
-- yang sesuai dengan tingkat kepercayaan mereka. Perlakukan Pending sebagai tidak dipercaya.
print(player.Name, "bergabung dengan tingkat kepercayaan", trustLevel.Name)
end)Arahkan pemain berdasarkan tingkat kepercayaan
Alih-alih menolak pemain, Anda dapat mengirim mereka ke tempat yang sesuai dengan tingkat kepercayaan mereka. Misalnya, permainan kompetitif dapat menerima semua orang di tempat awal santai, dan hanya mengirim pemain yang tingkat kepercayaannya memenuhi persyaratan Anda ke tempat peringkat terpisah.
Di tempat santai, periksa tingkat kepercayaan sebelum Anda teleport pemain ke tempat peringkat dengan TeleportService:TeleportAsync(). Skrip ini mengasumsikan bahwa UI klien Anda memicu RemoteEvent bernama JoinRanked di ReplicatedStorage ketika seorang pemain meminta untuk bermain peringkat:
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local TeleportService = game:GetService("TeleportService")
local RANKED_PLACE_ID = 12345678901234 -- Ganti dengan ID tempat peringkat Anda
local RANKED_TRUST_LEVELS = {
[Enum.PlayerDeviceTrustLevel.Standard] = true,
[Enum.PlayerDeviceTrustLevel.Full] = true,
}
local joinRankedEvent = ReplicatedStorage:WaitForChild("JoinRanked")
joinRankedEvent.OnServerEvent:Connect(function(player)
if not RANKED_TRUST_LEVELS[player.DeviceTrustLevel] then
-- Beri tahu pemain bahwa permainan peringkat tidak tersedia di perangkat mereka
return
end
local success, result = pcall(function()
return TeleportService:TeleportAsync(RANKED_PLACE_ID, { player })
end)
if not success then
warn("Teleport ke tempat peringkat gagal:", result)
end
end)Pemain dapat mencapai tempat peringkat dengan cara lain, seperti dengan bergabung dengan teman. Untuk menegakkan kebijakan yang sama di sana, tetapkan callback IntegrityService.EvaluatePlayerDeviceTrust di tempat peringkat, seperti yang dijelaskan dalam tolak pemain saat bergabung, dan tolak pemain yang tidak memenuhi syarat:
local IntegrityService = game:GetService("IntegrityService")
local RANKED_TRUST_LEVELS = {
[Enum.PlayerDeviceTrustLevel.Standard] = true,
[Enum.PlayerDeviceTrustLevel.Full] = true,
}
IntegrityService.EvaluatePlayerDeviceTrust = function(player, measures)
if RANKED_TRUST_LEVELS[player.DeviceTrustLevel] then
return { Action = Enum.PlayerDeviceTrustDecision.Accept }
end
return {
Action = Enum.PlayerDeviceTrustDecision.Reject,
Message = "Permainan peringkat tidak tersedia di perangkat ini. Anda masih dapat bermain di mode santai.",
}
endPemain dapat mulai bermain sebelum callback berjalan, jadi jangan mulai pertandingan peringkat untuk pemain sementara tingkat kepercayaan mereka adalah Pending. Untuk mengontrol tempat mana yang dapat dimasuki pemain secara langsung, lihat konfigurasi teleportasi yang aman.
Contoh-contoh ini menjaga pemain di Pending, Unknown, dan None keluar dari permainan peringkat. Jika Anda memutuskan untuk memberi pemain di Unknown manfaat dari keraguan, tambahkan Unknown ke kedua tabel.
Batasi fitur berdasarkan tingkat kepercayaan
Untuk membiarkan semua orang bermain tetapi membatasi fitur sensitif, seperti perdagangan, periksa tingkat kepercayaan di server ketika seorang pemain mencoba menggunakan fitur tersebut. Skrip berikut hanya mengizinkan perdagangan ketika kedua pemain memiliki tingkat kepercayaan yang diizinkan. Mencantumkan tingkat yang diizinkan dalam tabel menjaga kebijakan Anda di satu tempat:
local TRADE_TRUST_LEVELS = {
[Enum.PlayerDeviceTrustLevel.Unknown] = true,
[Enum.PlayerDeviceTrustLevel.Standard] = true,
[Enum.PlayerDeviceTrustLevel.Full] = true,
}
local function canTrade(player: Player): boolean
return TRADE_TRUST_LEVELS[player.DeviceTrustLevel] == true
end
local function tradeItem(sender: Player, receiver: Player, itemId: string): boolean
if not (canTrade(sender) and canTrade(receiver)) then
return false
end
-- Validasi dan transfer item di server di sini
return true
endContoh ini memblokir perdagangan untuk pemain di Pending dan None, dan membiarkan pemain di Unknown berdagang. Untuk juga memblokir perdagangan untuk pemain di Unknown, hapus Unknown dari tabel.
Untuk juga memeriksa akun sebelum tindakan sensitif, gabungkan tingkat kepercayaan dengan Player:IsVerified().
Tolak pemain saat bergabung
Jika mengarahkan pemain atau membatasi fitur tidak cukup, Anda dapat menolak pemain dari permainan Anda. Tetapkan fungsi ke callback IntegrityService.EvaluatePlayerDeviceTrust dalam Script di ServerScriptService. Roblox memanggil fungsi ini sekali untuk setiap pemain, segera setelah tingkat kepercayaan perangkat mereka tersedia.
Misalnya, skrip berikut menolak pemain yang perangkatnya gagal dalam pemeriksaan dan menerima semua orang lainnya, termasuk pemain di Unknown:
local IntegrityService = game:GetService("IntegrityService")
IntegrityService.EvaluatePlayerDeviceTrust = function(player, measures)
if player.DeviceTrustLevel == Enum.PlayerDeviceTrustLevel.None then
return {
Action = Enum.PlayerDeviceTrustDecision.Reject,
Message = "Permainan ini tidak dapat memverifikasi perangkat Anda.",
}
end
return { Action = Enum.PlayerDeviceTrustDecision.Accept }
endPerhatikan hal-hal berikut saat Anda menetapkan callback:
- Callback hanya berjalan di server. Anda tidak dapat menetapkannya dari LocalScript.
- Setiap tempat memiliki satu callback. Jika Anda menetapkannya lebih dari sekali, penetapan terakhir menggantikan yang sebelumnya, jadi tetapkan dalam satu skrip. Tempat yang berbeda dalam permainan Anda dapat menetapkan callback yang berbeda.
- Callback berjalan setelah Players.PlayerAdded dipicu, karena memeriksa perangkat memerlukan waktu. Ketika callback berjalan, Player.DeviceTrustLevel sudah berisi tingkat kepercayaan pemain.
- Callback dapat menunggu, misalnya untuk memuat data sebelum membuat keputusan. Pemain terus bermain sementara callback berjalan.
- Callback waktu habis setelah sekitar 10 detik. Jika memerlukan waktu lebih lama dari itu untuk mengembalikan keputusan, Roblox menerima pemain.
- Jika pemain meninggalkan, atau skrip Anda menghapus mereka, sebelum tingkat kepercayaan mereka tersedia, Roblox tidak memanggil callback untuk pemain tersebut.
Kembalikan keputusan
Kembalikan tabel dengan bidang berikut:
| Bidang | Tipe | Deskripsi |
|---|---|---|
| Action | Enum.PlayerDeviceTrustDecision | Wajib. Accept membiarkan pemain tetap di permainan. Reject memutuskan pemain. |
| Message | string | Opsional. Pesan yang dilihat pemain yang ditolak. Jika Anda mengabaikannya, Roblox menampilkan pesan default yang menjelaskan bagaimana pemain mungkin memperbaiki perangkat mereka, berdasarkan langkah-langkah yang gagal pada perangkat mereka. Roblox menyaring pesan ini, menggantinya dengan pesan default jika gagal disaring, dan mempersingkat pesan yang terlalu panjang. |
Agar kesalahan dalam kode Anda tidak pernah mengunci pemain, Roblox menerima pemain dalam setiap kasus berikut:
- Tidak ada skrip yang menetapkan callback.
- Callback mengembalikan nil, nilai yang bukan tabel, atau tabel tanpa Action yang valid.
- Callback melemparkan kesalahan. Roblox melaporkan kesalahan seperti kesalahan skrip lainnya.
Respon terhadap langkah-langkah individu
Argumen kedua dari callback, measures, adalah tabel boolean yang menjelaskan tingkat kepercayaan pemain. Nilai false berarti bahwa perangkat gagal dalam langkah tersebut. Pada perangkat yang tidak mendukung langkah, nilainya secara default adalah true, jadi nilai true tidak membuktikan bahwa perangkat tersebut berhasil. Ketika Anda membatasi pemain atau fitur berdasarkan langkah, hanya periksa apakah nilainya false.
| Langkah | Lulus ketika |
|---|---|
| IsPlatformVersionSecure | Sistem operasi berada di atau di atas versi minimum yang dianggap aman oleh Roblox. |
| IsPlatformBootSecure | Sistem operasi dimulai dalam keadaan aman. |
| IsAppSecure | Aplikasi Roblox tidak telah dimanipulasi. |
Gunakan langkah-langkah ini untuk memperhalus kebijakan Anda. Skrip berikut menolak pemain di None, juga menolak pemain di Standard yang sistem operasinya tidak dimulai dalam keadaan aman, dan menerima semua orang lainnya:
local IntegrityService = game:GetService("IntegrityService")
IntegrityService.EvaluatePlayerDeviceTrust = function(player, measures)
local trustLevel = player.DeviceTrustLevel
local isRejected = trustLevel == Enum.PlayerDeviceTrustLevel.None
or (trustLevel == Enum.PlayerDeviceTrustLevel.Standard and not measures.IsPlatformBootSecure)
if isRejected then
return { Action = Enum.PlayerDeviceTrustDecision.Reject }
end
return { Action = Enum.PlayerDeviceTrustDecision.Accept }
endKesalahan umum
Hindari pola berikut saat Anda menggunakan API Kepercayaan Perangkat:
- Membandingkan tingkat kepercayaan sebagai angka. Setiap tingkat kepercayaan memiliki Value, tetapi urutan nilai tidak mencerminkan seberapa banyak Anda dapat mempercayai perangkat. Unknown datang sebelum None, jadi pemeriksaan bahwa tingkat pemain lebih besar dari None juga mengecualikan setiap pemain di Unknown. Sebagai gantinya, cantumkan tingkat yang Anda izinkan, seperti yang dilakukan contoh di halaman ini. Jika Anda ingin menerima pemain di Unknown, sertakan Unknown secara eksplisit.
- Menolak pemain dari Players.PlayerAdded. Ketika PlayerAdded dipicu, tingkat kepercayaan pemain biasanya belum tersedia, jadi pemeriksaan pada saat itu dapat menolak pemain yang perangkatnya dipercaya. Sebagai gantinya, kembalikan Reject dari callback IntegrityService.EvaluatePlayerDeviceTrust, yang dipanggil Roblox segera setelah tingkat kepercayaan tersedia. Jika Anda memerlukan tingkat kepercayaan di PlayerAdded untuk alasan lain, seperti pencocokan, lihat tunggu tingkat kepercayaan.
- Menjalankan operasi lambat dalam callback. Callback dapat menunggu, tetapi waktu habis setelah sekitar 10 detik, dan Roblox kemudian menerima pemain. Beberapa pembacaan data penyimpanan atau permintaan HTTP dapat memakan waktu cukup lama untuk mencapai batas ini, jadi jaga agar operasi yang menunggu dalam callback tetap minimal.
- Membaca tingkat kepercayaan di klien. Klien pemain sendiri dapat membaca tingkat kepercayaan mereka, jadi Anda mungkin memutuskan dalam LocalScript apakah akan menampilkan fitur atau memicu acara jarak jauh. Penipu mengendalikan klien mereka dan dapat melewati pemeriksaan ini. Sebagai gantinya, baca tingkat kepercayaan di server dan beri tahu klien fitur mana yang harus diaktifkan. Dasar perubahan sisi klien, seperti menyembunyikan tombol perdagangan, pada apa yang diberitahu server kepada klien, dan selalu periksa tingkat kepercayaan lagi di server sebelum tindakan terjadi.
- Menggunakan langkah-langkah daripada tingkat kepercayaan. Sebuah langkah adalah true ketika tidak tersedia di perangkat, jadi sebuah perangkat dapat melewati setiap langkah tanpa sepenuhnya dipercaya. Jangan perlakukan perangkat yang melewati setiap langkah sebagai Full. Periksa tingkat kepercayaan terlebih dahulu, dan hanya gunakan langkah-langkah untuk mencari pemeriksaan yang gagal.
Uji logika Anda
Roblox tidak memeriksa perangkat di Studio, jadi selama uji coba tingkat kepercayaan perangkat tetap di Pending dan callback tidak berjalan. Karena skrip Anda memperlakukan Pending sebagai tidak dipercaya, fitur yang Anda batasi berdasarkan tingkat kepercayaan juga tidak tersedia selama uji coba.
Untuk menguji fitur ini dan tetap menguji kebijakan Anda, simpan kebijakan Anda dalam fungsi yang mengambil tingkat kepercayaan. Ketika RunService:IsStudio() mengembalikan true, lewati pemeriksaan kepercayaan, dan panggil kebijakan Anda dengan setiap tingkat kepercayaan sebagai gantinya. Skrip berikut melakukan ini untuk contoh perdagangan di batasi fitur berdasarkan tingkat kepercayaan:
local RunService = game:GetService("RunService")
local IS_STUDIO = RunService:IsStudio()
local TRADE_TRUST_LEVELS = {
[Enum.PlayerDeviceTrustLevel.Unknown] = true,
[Enum.PlayerDeviceTrustLevel.Standard] = true,
[Enum.PlayerDeviceTrustLevel.Full] = true,
}
local function isTradeAllowed(trustLevel: Enum.PlayerDeviceTrustLevel): boolean
return TRADE_TRUST_LEVELS[trustLevel] == true
end
-- Periksa ini di server sebelum setiap perdagangan
local function canTrade(player: Player): boolean
-- Roblox tidak memeriksa perangkat di Studio, jadi izinkan perdagangan selama uji coba
if IS_STUDIO then
return true
end
return isTradeAllowed(player.DeviceTrustLevel)
end
-- Di Studio, cetak bagaimana kebijakan Anda menangani setiap tingkat kepercayaan
if IS_STUDIO then
for _, trustLevel in Enum.PlayerDeviceTrustLevel:GetEnumItems() do
print(trustLevel.Name, isTradeAllowed(trustLevel))
end
endBatasan
Kepercayaan perangkat meningkatkan biaya kecurangan, tetapi ini bukan solusi lengkap:
- Ini tidak menggantikan desain permainan yang aman. Eksploitasi yang bergantung pada validasi sisi server yang lemah, seperti mempercayai posisi, skor, atau mata uang yang dilaporkan oleh klien, masih berfungsi di perangkat yang dipercaya. Validasi tindakan penting di server, seperti yang dijelaskan dalam mengamankan batas klien-server.
- Ini mengurangi kecurangan, tetapi tidak menghilangkannya. Pengembang cheat beradaptasi seiring waktu, jadi perlakukan kepercayaan perangkat sebagai satu lapisan pertahanan Anda di samping deteksi sisi server.
- Tidak setiap platform didukung. Untuk detail, lihat platform yang didukung.