Pass memungkinkan Anda mengenakan biaya Robux satu kali kepada pengguna untuk mengakses hak istimewa khusus di dalam game Anda, seperti masuk ke area terbatas, item avatar dalam game, atau peningkatan permanen.
Buat pass
Untuk membuat pass:
- Pergi ke Kreasi dan pilih sebuah game.
- Pergi ke Monetisasi ⟩ Pass.
- Klik Buat pass.
- Unggah gambar untuk ditampilkan sebagai ikon pass. Pastikan gambar tidak melebihi 512x512 piksel, tidak menyertakan detail penting di luar batas lingkarannya, dan dalam format .jpg, .png, atau .bmp.
- Masukkan nama dan deskripsi untuk pass.
- Pilih kategori untuk pass. Kategori digunakan untuk mengorganisir item di Toko dalam game Anda.
- Klik Buat pass.


Dapatkan ID pass
Untuk menggunakan skrip, Anda memerlukan ID pass. Untuk mendapatkan ID pass:
Pergi ke Monetisasi ⟩ Pass.
Arahkan kursor ke thumbnail pass, klik tombol ⋯ dan pilih Salin ID Aset dari menu konteks.

Jual pass
Anda dapat menjual pass dengan dua cara:
Di dalam game Anda
Untuk menerapkan dan menjual pass di dalam game, panggil fungsi MarketplaceService.
Gunakan GetProductInfo() untuk mengambil informasi tentang pass, seperti nama dan harga, dan kemudian menampilkan pass tersebut kepada pengguna. Anda dapat menjual pass di dalam pasar game Anda, misalnya. Untuk pass, parameter kedua harus Enum.InfoType.GamePass.
local MarketplaceService = game:GetService("MarketplaceService")
-- Ganti ID placeholder dengan ID pass Anda
local productId = 000000
local success, productInfo = pcall(function()
return MarketplaceService:GetProductInfo(productId, Enum.InfoType.GamePass)
end)
if success and productInfo then
-- Periksa apakah produk dijual
if productInfo.IsForSale then
-- Tampilkan informasi produk
-- Ganti pernyataan print dengan kode UI untuk menampilkan pass
print("Nama Pass: " .. productInfo.Name)
print("Harga dalam Robux: " .. productInfo.PriceInRobux)
print("Deskripsi: " .. productInfo.Description)
else
print("Produk ini tidak dijual")
end
endGunakan PromptGamePassPurchase() untuk meminta pembelian pass jika pengguna belum memiliki pass di inventaris mereka. Anda dapat memanggil fungsi ini ketika pengguna melakukan tindakan seperti menekan tombol atau berbicara dengan NPC vendor.
local MarketplaceService = game:GetService("MarketplaceService")
local Players = game:GetService("Players")
-- Ganti ID placeholder dengan ID pass Anda
local passID = 0000000
-- Minta pembelian pass
local function promptPurchase()
local player = Players.LocalPlayer
local hasPass = false
local success, message = pcall(function()
hasPass = MarketplaceService:UserOwnsGamePassAsync(player.UserId, passID)
end)
if not success then
warn("Kesalahan saat memeriksa apakah pemain memiliki pass: " .. tostring(message))
return
end
if hasPass then
-- Tampilkan pesan yang memberi tahu pengguna bahwa mereka sudah memiliki pass
else
-- Minta pembelian pass
MarketplaceService:PromptGamePassPurchase(player, passID)
end
endGunakan PromptGamePassPurchaseFinished untuk menangani prompt dan pembelian pass yang selesai dan memberikan pengguna hak istimewa yang terkait dengan pass.
Tempatkan skrip di dalam ServerScriptService sehingga server menangani hak istimewa pass pengguna.
local MarketplaceService = game:GetService("MarketplaceService")
-- Ganti ID placeholder dengan ID pass Anda
local passID = 0000000 -- Ganti ini dengan ID Pass Anda
-- Tangani prompt dan pembelian yang selesai
local function onPromptPurchaseFinished(player, purchasedPassID, purchaseSuccess)
if purchaseSuccess and purchasedPassID == passID then
print(player.Name .. " membeli Pass dengan ID " .. passID)
-- Berikan pengguna kemampuan atau bonus terkait dengan pass
end
end
-- Hubungkan acara PromptGamePassPurchaseFinished ke fungsi
MarketplaceService.PromptGamePassPurchaseFinished:Connect(onPromptPurchaseFinished)Di luar game Anda
Roblox menampilkan pass Terdaftar Anda di luar game Anda, termasuk di halaman utama Roblox, dalam hasil pencarian, dan di halaman pasca-pembelian setelah pemain membeli Robux. Seorang pemain dapat membeli pass Anda dan kemudian bergabung dengan game Anda dengan pass tersebut sudah diberikan.
Untuk membuat pass memenuhi syarat untuk penjualan eksternal:
- Di Pusat Kreator, pergi ke Monetisasi ⟩ Toko.
- Tandai pass sebagai Terdaftar.
Pass tidak memerlukan perbaikan ProcessReceipt, tetapi mereka harus Terdaftar untuk muncul di luar game Anda. Kami sarankan untuk menambahkan ikon khusus ke setiap pass sehingga pemain dapat mengenalinya di permukaan eksternal; jika Anda tidak menambahkannya, Roblox akan menampilkan ikon default.
Tetapkan hak istimewa pass
Anda harus secara manual menetapkan hak istimewa pass kepada pengguna yang membeli pass Anda. Untuk melakukan ini, gunakan PlayerAdded ketika seorang pengguna bergabung dengan game Anda untuk memeriksa apakah mereka sudah memiliki pass dan untuk memberikan hak istimewa pass kepada mereka.
Tempatkan skrip di dalam ServerScriptService sehingga server menangani hak istimewa pass pengguna.
local MarketplaceService = game:GetService("MarketplaceService")
local Players = game:GetService("Players")
-- Ganti ID placeholder dengan ID pass Anda
local passID = 0000000
local function onPlayerAdded(player)
local hasPass = false
-- Periksa apakah pengguna sudah memiliki pass
local success, message = pcall(function()
hasPass = MarketplaceService:UserOwnsGamePassAsync(player.UserId, passID)
end)
if not success then
-- Berikan peringatan dan keluar dari fungsi
warn("Kesalahan saat memeriksa apakah pemain memiliki pass: " .. tostring(message))
return
end
if hasPass then
-- Berikan pengguna kemampuan atau bonus terkait dengan pass
print(player.Name .. " memiliki Pass dengan ID " .. passID)
end
end
-- Hubungkan acara PlayerAdded ke fungsi
Players.PlayerAdded:Connect(onPlayerAdded)Uji coba gratis
Uji coba gratis memberikan pemain semua manfaat dari pass untuk satu sesi game sebelum mereka membelinya. Setiap pemain dapat memulai satu uji coba gratis per pass, dan hanya satu uji coba gratis yang dapat aktif pada satu waktu.
Mulai 2 Desember 2026, uji coba gratis tersedia untuk pemain untuk pass mana pun yang telah diaktifkan. Pass baru memiliki uji coba gratis dinonaktifkan secara default.
Anda juga dapat mengonfigurasi uji coba gratis dengan API pass game Open Cloud.
Aktifkan uji coba gratis
Untuk mengaktifkan uji coba gratis untuk satu atau lebih pass:
- Pergi ke Kreasi dan pilih sebuah game.
- Pergi ke Monetisasi ⟩ Toko ⟩ Uji Coba Gratis.
- Aktifkan uji coba gratis untuk setiap pass yang ingin Anda coba.
Anda juga dapat memilih pass dari Monetisasi ⟩ Pass, membuka pengaturan penjualannya, dan mengaktifkan uji coba gratis di sana. Untuk menonaktifkan uji coba gratis, matikan pengaturan untuk setiap pass di halaman yang sama.
Cara kerja uji coba gratis
Ketika uji coba gratis diaktifkan untuk sebuah pass, pemain yang belum memilikinya melihat tombol Coba di Toko. Setelah seorang pemain memulai uji coba:
- Uji coba berlangsung selama satu sesi game.
- Sebuah tombol di sudut kanan atas layar menunjukkan bahwa uji coba aktif. Sebelum sesi berakhir, tombol berubah menjadi Beli sehingga pemain dapat membeli pass selama uji coba.
- Jika pemain membeli pass selama uji coba, mereka akan menyimpannya. Jika sesi berakhir tanpa pembelian, akses dicabut.
Jika sesi berakhir secara tidak terduga karena kesalahan sistem dan pemain bergabung kembali dalam waktu satu jam, uji coba gratis berlanjut.
Pemain yang sudah memiliki pass tidak memenuhi syarat untuk uji coba gratis dan tidak melihat tawaran uji coba.
Perbarui kode Anda untuk uji coba gratis
Pemeriksaan akses terus berfungsi selama uji coba, tetapi Anda harus memperbarui kode apa pun yang memberikan item permanen, mata uang, atau data yang disimpan ketika kepemilikan menjadi true.
| Acara | Perilaku | Tindakan yang Disarankan |
|---|---|---|
| Pemain memulai uji coba | PromptGamePassPurchaseFinished dipicu di klien dan server dengan purchaseSuccess diatur ke true | Panggil GetPassOwnershipAsync dan konfirmasi Owned adalah true sebelum memberikan hadiah permanen |
| Uji coba aktif | UserOwnsGamePassAsync mengembalikan true | Gunakan pemeriksaan akses sementara yang ada seperti biasa |
| Uji coba berakhir | Tidak ada acara yang dipicu. Pemeriksaan kepemilikan mengembalikan false | Periksa kembali kepemilikan ketika akses penting daripada menyimpan kepemilikan untuk sesi |
Gunakan GetPassOwnershipAsync untuk membedakan pass yang dibeli dari uji coba aktif. Di klien, metode ini hanya dapat menanyakan pemain lokal. Di server, dapat menanyakan pemain mana pun.
| Field | Deskripsi |
|---|---|
| Owned | Apakah pemain membeli pass tersebut. |
| Active | Apakah pemain saat ini memiliki akses melalui pembelian atau uji coba aktif. Cocok dengan UserOwnsGamePassAsync. |
| StartTime dan EndTime | Disertakan saat uji coba aktif. |
local MarketplaceService = game:GetService("MarketplaceService")
-- Ganti ID placeholder dengan ID pass Anda
local passID = 0000000
local function grantPermanentRewardIfOwned(player)
local success, ownership = pcall(function()
return MarketplaceService:GetPassOwnershipAsync(player, passID)
end)
if not success then
warn("Kesalahan saat memeriksa kepemilikan pass: " .. tostring(ownership))
return
end
-- Hanya berikan hadiah permanen untuk pass yang dibeli, bukan uji coba gratis
if ownership.Owned then
-- Berikan item permanen, mata uang, atau data yang disimpan di sini
elseif ownership.Active then
-- Pemain sedang dalam uji coba gratis; berikan akses sementara saja
end
end
MarketplaceService.PromptGamePassPurchaseFinished:Connect(function(player, purchasedPassID, purchaseSuccess)
if purchaseSuccess and purchasedPassID == passID then
grantPermanentRewardIfOwned(player)
end
end)Dalam pengujian playtest Studio, uji coba gratis berlangsung satu jam sehingga Anda dapat menguji alur mulai, aktif, dan kedaluwarsa sebelum Anda menerbitkan.
Pola umum untuk diperbarui
Sebagian besar kode pass mengasumsikan bahwa setelah pemain memiliki pass, mereka memilikinya selamanya. Uji coba gratis memberikan pass untuk waktu terbatas, jadi pola umum berikut dapat memungkinkan pemain mempertahankan manfaatnya setelah uji coba berakhir. Seorang pemain dalam uji coba harus mendapatkan apa yang didapat pembeli, dan kepemilikan juga dapat berakhir untuk pembeli, misalnya setelah pengembalian dana. Perbaikan untuk semuanya sama: terapkan manfaat pass dari pemeriksaan kepemilikan langsung, dan jangan simpan mereka.
Menyimpan atau menyimpan kepemilikan
Pola paling umum menyimpan "memiliki pass" saat pertama kali UserOwnsGamePassAsync mengembalikan true, dalam data yang disimpan atau dalam tabel untuk sesi, dan membaca nilai itu daripada memanggil API lagi. Setelah uji coba berakhir, nilai yang disimpan masih true.
if data.Passes[passID] or MarketplaceService:UserOwnsGamePassAsync(player.UserId, passID) then
data.Passes[passID] = true
grantPassBenefits(player)
endPanggil UserOwnsGamePassAsync setiap kali akses penting, seperti saat bergabung, saat muncul, dan ketika manfaat digunakan. Roblox menyimpan hasilnya secara internal, jadi panggilan berulang tidak mahal, dan hasilnya berubah menjadi false ketika uji coba berakhir. Jika panggilan gagal, tolak akses dan coba lagi pada pemeriksaan berikutnya.
local function ownsPass(player)
local success, hasPass = pcall(function()
return MarketplaceService:UserOwnsGamePassAsync(player.UserId, passID)
end)
return success and hasPass
end
local function onCharacterAdded(player)
if ownsPass(player) then
giveTool(player, "Dark Blade")
setSpeed(player, MAX_SPEED)
end
endMenyimpan apa yang diberikan pass
Beberapa pass menulis manfaat mereka ke dalam data yang disimpan, seperti item dalam inventaris, peningkatan maksimum, pembukaan, atau mata uang. Bahkan dengan pemeriksaan langsung pada setiap bergabung, manfaat yang disimpan tetap ada setelah uji coba berakhir. Menghapus tanda kepemilikan tidak membantu jika manfaat itu sendiri disimpan di tempat lain.
if ownsPass(player) then
data.Inventory["Dark Blade"] = true
data.Upgrades.Speed = MAX_SPEED
data.Coins += BONUS_COINS
endTerapkan manfaat pada runtime dari ownsPass, seperti dalam contoh sebelumnya, sehingga dibangun kembali setiap sesi dan berakhir ketika kepemilikan berakhir. Jika pass memberikan sesuatu yang pemain simpan dan gunakan, seperti mata uang, jual sebagai produk pengembang sebagai gantinya.
Jika game Anda sudah menyimpan manfaat pass, berhenti menyimpan yang baru dan hanya menghapus item yang Anda catat sebagai diberikan oleh pass, seperti item yang ditandai dengan ID pass. Jangan menghapus item dari setiap pemain yang tidak memiliki pass, karena mereka mungkin telah memperoleh atau memperdagangkannya.
Memberikan dari sinyal pembelian
PromptGamePassPurchaseFinished juga dipicu dengan purchaseSuccess diatur ke true ketika uji coba dimulai. Dari sinyal ini, terapkan manfaat runtime yang sama yang Anda terapkan saat bergabung, dan jangan simpan apa pun.
Memberi hadiah dan perdagangan
- Memberi hadiah. Seorang pemain dalam uji coba terlihat seperti pemilik, karena UserOwnsGamePassAsync mengembalikan true. Jika alur hadiah Anda menolak hadiah ketika penerima sudah memiliki pass, periksa Owned penerima dari GetPassOwnershipAsync sebagai gantinya, sehingga pemain dalam uji coba masih dapat menerima pass sebagai hadiah.
- Perdagangan. Sebuah perdagangan biasanya menyimpan item ke inventaris pemain lain, di mana item tersebut tidak lagi bergantung pada pass. Kepemilikan pass dapat berakhir kapan saja, seperti ketika uji coba berakhir, pembelian dikembalikan, atau pemain menghapus pass dari inventaris mereka, dan item yang diperdagangkan tetap dengan akun lain. Jika Anda ingin pemain memperdagangkan item, jual sebagai produk pengembang daripada memberikannya melalui pass.
Daftar Periksa
Sebelum Anda mengaktifkan uji coba gratis untuk sebuah pass, periksa bahwa:
- Kepemilikan berasal dari panggilan UserOwnsGamePassAsync setiap kali akses penting, tidak pernah dari nilai yang disimpan atau disimpan.
- Manfaat pass diterapkan pada runtime dan tidak pernah disimpan, sehingga berakhir ketika kepemilikan berakhir.
- PromptGamePassPurchaseFinished menerapkan manfaat yang sama seperti saat bergabung.
- Alur hadiah memeriksa Owned penerima, dan Anda menjual item yang dapat diperdagangkan sebagai produk pengembang, bukan melalui pass.
Metrik uji coba gratis
Untuk melihat metrik uji coba gratis:
- Pergi ke Kreasi dan pilih sebuah game.
- Pergi ke Monetisasi ⟩ Toko ⟩ Uji Coba Gratis.
Halaman ini menunjukkan pendapatan uji coba gratis, seberapa sering uji coba ditampilkan dan dimulai, dan seberapa sering mereka dikonversi menjadi pembelian, baik secara keseluruhan maupun per pass. Pembelian selama atau setelah uji coba menggunakan pendapatan pass biasa Anda.
Personalisasi toko dalam game Anda
Anda dapat menggunakan API intelijen produk untuk mengurutkan dan merekomendasikan pass kepada pengguna. Memperpersonalisasi toko dalam game Anda membantu menampilkan item yang paling relevan kepada setiap pengguna, meningkatkan keterlibatan dan pendapatan. Dengan menyesuaikan pass dengan preferensi pengguna, Anda dapat meningkatkan penemuan mereka, meningkatkan tingkat konversi, dan membuka peluang monetisasi baru.
Peringkat pass untuk dijual
RankProductsAsync menerima daftar ID produk dan mengembalikan daftar terurut yang dipersonalisasi dari produk tersebut. Anda dapat menggunakan metode ini untuk memberikan rekomendasi item yang dipersonalisasi kepada pengguna di toko dalam game Anda.

local MarketplaceService = game:GetService("MarketplaceService")
-- Buat array produk yang ingin Anda peringkatkan
local productIdentifiers = {
{InfoType = Enum.InfoType.GamePass, Id = 123},
{InfoType = Enum.InfoType.Product, Id = 456},
{InfoType = Enum.InfoType.Product, Id = 789}
}
-- Opsional: Bungkus panggilan dalam tugas asinkron sehingga jika permintaan lambat,
-- itu tidak membekukan UI / game
task.spawn(function()
-- Gunakan pcall untuk menangani kesalahan dengan baik
local success, result = pcall(function()
return MarketplaceService:RankProductsAsync(productIdentifiers)
end)
if not success then
-- Jika gagal, 'result' adalah pesan kesalahan.
warn("Gagal untuk meranking produk:", result)
end
-- Muat item yang dikembalikan ke dalam toko.
for i, rankedItem in ipairs(rankedProducts) do
local productIdentifier = rankedItem.ProductIdentifier
local productInfo = rankedItem.ProductInfo
-- ...
-- Logika untuk menambahkan productInfo ke dalam toko
end
end)Tampilkan pass teratas Anda
RecommendTopProductsAsync menerima array nilai InfoType dan mengembalikan hingga 50 item yang paling mungkin untuk terlibat dan dibeli oleh pengguna. Anda dapat menggunakan metode ini untuk membuat bagian "Pilihan Teratas" di toko dalam game Anda.
Jika tidak ada rekomendasi yang dapat ditentukan, RecommendTopProductsAsync mengembalikan 0 item. Setiap pass yang sudah dimiliki pengguna juga tidak dikembalikan.
Dalam kasus yang jarang terjadi, panggilan ke model peringkat bisa lambat. Untuk membantu mencegah penambahan yang terlambat bagi pengguna, kami sarankan menggunakan task.spawn untuk membuat panggilan ke RecommendTopProducts tidak memblokir.

local MarketplaceService = game:GetService("MarketplaceService")
-- Buat array jenis produk untuk disertakan. Dalam hal ini baik pass game maupun produk pengembang
local productTypes = {Enum.InfoType.GamePass, Enum.InfoType.Product}
-- Opsional: Bungkus panggilan dalam tugas asinkron sehingga jika permintaan lambat,
-- itu tidak membekukan UI / game
task.spawn(function()
-- Gunakan pcall untuk menangani kesalahan dengan baik
local success, result = pcall(function()
return MarketplaceService:RecommendTopProductsAsync(productTypes)
end)
if not success then
-- Jika gagal, 'result' adalah pesan kesalahan.
warn("Gagal untuk meranking produk:", result)
end
-- Muat item yang dikembalikan ke dalam toko. Pastikan untuk menyaring item yang tidak memenuhi syarat dari topRankedItems seperti produk pengembang yang
-- tidak dapat lagi dibeli oleh pengguna
for i, rankedItem in ipairs(rankedProducts) do
local productIdentifier = rankedItem.ProductIdentifier
local productInfo = rankedItem.ProductInfo
-- ...
-- Logika untuk menambahkan productInfo ke dalam toko
end
end)Promosikan pass
Untuk membantu lebih banyak pengguna menemukan game Anda, Anda dapat memilih untuk menampilkan pass Anda di halaman Beli Robux Roblox. Memilih untuk mempromosikan pass Anda dapat membantu meningkatkan waktu dan Robux yang dihabiskan pengguna di game Anda. Tidak ada batasan jumlah pass yang dapat Anda promosikan.
Pengguna ditampilkan pass yang relevan dengan riwayat permainan dan keterlibatan mereka di platform. Mereka tidak ditampilkan pass yang sudah mereka miliki.

Ketika pengguna membeli paket Robux yang memenuhi syarat, mereka menerima pass yang dipromosikan dan diminta untuk mengklaim pass mereka dengan bergabung ke game Anda.

Untuk memilih mempromosikan salah satu pass Anda:
- Pergi ke Monetisasi ⟩ Pass.
- Pilih pass yang ingin Anda promosikan.
- Pilih Promosi.
- Aktifkan Sertakan item ini dalam kumpulan bonus.
- Klik Simpan Perubahan. Pass ditampilkan kepada pengguna yang relevan di halaman Beli Robux.
Pass yang dipromosikan:
- Dapat tidak dijual atau dijual. Jika mereka dijual, nilai Robux mereka harus lebih besar dari 49 Robux dan kurang dari 801 Robux.
- Harus menyertakan thumbnail.
- Tidak dapat memberikan item acak berbayar.
- Harus mematuhi Standar Komunitas.
Analitik pass
Gunakan analitik pass untuk menganalisis keberhasilan pass individu, mengidentifikasi tren, dan meramalkan potensi pendapatan di masa depan.
Dengan analitik, Anda dapat:
- Melihat pass teratas Anda selama periode waktu yang dipilih.
- Menampilkan hingga delapan item terlaris dalam grafik deret waktu untuk menganalisis penjualan keseluruhan dan pendapatan bersih.
- Memantau katalog Anda dan mengurutkan item berdasarkan penjualan dan pendapatan bersih.
- Melihat berapa banyak pass yang diperoleh pengguna melalui promosi di halaman Beli Robux.
- Melihat berapa banyak pengguna yang bergabung dengan game Anda setelah memperoleh pass melalui halaman Beli Robux.
Untuk mengakses analitik pass:
- Pergi ke Kreasi dan pilih sebuah game.
- Pergi ke Monetisasi ⟩ Pass.
- Pilih tab Analitik.
