The KiosMerchan modul pengembang lets you offer aset avatar, akses pasar, dan produk pengembang for sale directly within your experience. Players can browse items, preview assets on their own avatar, purchase items, and instantly use or equip them — all without leaving your experience. This can help you monetize your experience and gain revenue through the 40% affiliate fee associated with selling other creators' items.
Penggunaan modul
Instalasi
Untuk menggunakan modul KiosMerchan dalam pengalaman:
Dari menu Jendela Studio atau toolbar tab Beranda, buka Kotak Alat dan pilih tab Toko Pembuat.

Pastikan pemilihan Model telah dipilih, lalu klik tombol Lihat Semua untuk Kategori.

Temukan dan klik ubin Paket.
Temukan modul Kios Merchan dan klik, atau seret dan lepas ke dalam tampilan 3D.

Di jendela Penjelajah, pindahkan seluruh model KiosMerchan ke ReplicatedStorage. Setelah menjalankan pengalaman, modul akan mulai berjalan.
Konfigurasi
Modul ini telah dikonfigurasi sebelumnya agar berfungsi untuk sebagian besar kasus penggunaan, tetapi dapat dengan mudah disesuaikan melalui fungsi konfigurasi. Misalnya, untuk membuat tema yang lebih ringan dan menonaktifkan tombol Filter default di area kiri atas tampilan katalog:
Di StarterPlayerScripts, buat LocalScript baru dan ubah namanya menjadi KonfigurasiKiosMerchan.

Tempelkan kode berikut ke dalam skrip baru tersebut.
LocalScript - ConfigureMerchBoothlocal ReplicatedStorage = game:GetService("ReplicatedStorage")local KiosMerchan = require(ReplicatedStorage.KiosMerchan)KiosMerchan.configure({backgroundColor = Color3.fromRGB(220, 210, 200),textSize = 17,textFont = Enum.Font.Fondamento,textColor = Color3.fromRGB(20, 20, 20),useFilters = false})
Tambahkan item
Apa artinya kios merchan tanpa barang? Bagian berikut menjelaskan cara menambahkan aset avatar, akses pasar, dan produk pengembang ke kios merchan Anda.
Aset avatar
Barang-barang seperti pakaian dan aksesori harus ditambahkan melalui ID aset mereka yang terletak di halaman detail barang di Toko Avatar.
Buat Script di dalam ServerScriptService dan tempelkan kode berikut.
Script - Tambah Aset Avatarlocal ReplicatedStorage = game:GetService("ReplicatedStorage")local KiosMerchan = require(ReplicatedStorage.KiosMerchan)local items = {}for _, assetId in items dolocal success, errorMessage = pcall(function()KiosMerchan.addItemAsync(assetId)end)if not success thenwarn(errorMessage)endendSalin ID aset barang dari URL situs web Toko Avatar. Misalnya, ID dari Topi Baseball Roblox adalah 607702162.

Tempelkan setiap ID yang disalin ke dalam daftar yang dipisahkan oleh koma dalam tabel items. Secara default, barang muncul di tampilan katalog dalam urutan abjad, tetapi Anda dapat menyesuaikan penyortiran menggunakan setCatalogSort.
Script - Tambah Aset Avatarlocal ReplicatedStorage = game:GetService("ReplicatedStorage")local KiosMerchan = require(ReplicatedStorage.KiosMerchan)local items = {607702162, -- Topi Baseball Roblox4819740796, -- Robox1374269, -- Telinga Kucing11884330, -- Kacamata Nerd10476359, -- Topi Kertas}for _, assetId in items dolocal success, errorMessage = pcall(function()KiosMerchan.addItemAsync(assetId)end)if not success thenwarn(errorMessage)endend
Akses pasar
Menambahkan akses pasar memerlukan ID akses yang dapat ditemukan di Dasbor Pembuat.
Buat Script di dalam ServerScriptService dan tempelkan kode berikut.
Script - Tambah Akseslocal ReplicatedStorage = game:GetService("ReplicatedStorage")local KiosMerchan = require(ReplicatedStorage.KiosMerchan)local items = {}for _, assetId in items dolocal success, errorMessage = pcall(function()KiosMerchan.addItemAsync(assetId)end)if not success thenwarn(errorMessage)endendArahkan ke Dasbor Pembuat dan pilih pengalaman.
Di kolom kiri, di bawah Monetisasi, pilih Akses.
Arahkan mouse ke thumbnail akses, klik tombol ⋯, dan pilih Salin ID Aset dari menu konteks.

Tempelkan setiap ID yang disalin ke dalam daftar yang dipisahkan oleh koma dalam tabel items dan sertakan Enum.InfoType.GamePass sebagai parameter kedua untuk addItemAsync untuk menunjukkan bahwa barang tersebut adalah akses pasar. Secara default, barang akan muncul di tampilan katalog dalam urutan abjad, tetapi penyortiran dapat disesuaikan melalui setCatalogSort.
Script - Tambah Akseslocal ReplicatedStorage = game:GetService("ReplicatedStorage")local KiosMerchan = require(ReplicatedStorage.KiosMerchan)local items = {4343758, -- Armor ColdFyre28521575, -- Perisai Lumpur}for _, assetId in items dolocal success, errorMessage = pcall(function()KiosMerchan.addItemAsync(assetId, Enum.InfoType.GamePass)end)if not success thenwarn(errorMessage)endend
Produk Pengembang
Menambahkan produk pengembang memerlukan ID produk yang dapat ditemukan di Dasbor Pembuat.
Buat Script di dalam ServerScriptService dan tempelkan kode berikut.
Script - Tambah Produk Pengembanglocal ReplicatedStorage = game:GetService("ReplicatedStorage")local KiosMerchan = require(ReplicatedStorage.KiosMerchan)local items = {}for _, assetId in items dolocal success, errorMessage = pcall(function()KiosMerchan.addItemAsync(assetId)end)if not success thenwarn(errorMessage)endendArahkan ke Dasbor Pembuat dan pilih pengalaman.
Di kolom kiri, di bawah Monetisasi, pilih Produk Pengembang.
Arahkan mouse ke thumbnail produk, klik tombol ⋯, dan pilih Salin ID Aset dari menu konteks.

Tempelkan setiap ID yang disalin ke dalam daftar yang dipisahkan oleh koma dalam tabel items dan sertakan Enum.InfoType.Product sebagai parameter kedua untuk addItemAsync untuk menunjukkan bahwa barang tersebut adalah produk pengembang. Secara default, barang muncul di tampilan katalog dalam urutan abjad, tetapi Anda dapat menyesuaikan penyortiran menggunakan setCatalogSort.
Script - Tambah Produk Pengembanglocal ReplicatedStorage = game:GetService("ReplicatedStorage")local KiosMerchan = require(ReplicatedStorage.KiosMerchan)local items = {1236602053, -- Pengisian Mana1257880672, -- Ramuan Penyembuhan}for _, assetId in items dolocal success, errorMessage = pcall(function()KiosMerchan.addItemAsync(assetId, Enum.InfoType.Product)end)if not success thenwarn(errorMessage)endend
Tombol Katalog Kustom
Secara default, tombol katalog di sisi kanan memungkinkan pemain membuka kios kapan saja.

Dalam beberapa kasus, mungkin berguna untuk menghapus tombol ini dan menghubungkan tombol Anda sendiri:
Buat tombol baru seperti yang dijelaskan di Tombol.
Buat LocalScript sebagai anak dari objek tombol tersebut.

Tempelkan kode berikut ke dalam skrip baru.
LocalScript - Tombol Katalog Kustomlocal ReplicatedStorage = game:GetService("ReplicatedStorage")local KiosMerchan = require(ReplicatedStorage.KiosMerchan)-- Menghapus tombol katalog defaultKiosMerchan.toggleCatalogButton(false)-- Menghubungkan tombol kustomscript.Parent.Activated:Connect(function()KiosMerchan.openMerchBooth()end)
Wilayah yang Dapat Dibeli
Cara yang berguna untuk mendorong pembelian dalam pengalaman Anda adalah dengan secara otomatis menunjukkan kios merchan ketika seorang pemain memasuki area.
Untuk membuat wilayah yang dapat dibeli:
Buat blok Anchored yang mencakup wilayah deteksi. Pastikan blok tersebut cukup tinggi untuk bertabrakan dengan PrimaryPart model karakter (HumanoidRootPart secara default).

Blok untuk mendeteksi kapan pemain mendekati bagian depan konter toko Menggunakan bagian Tag properti blok, terapkan tag ShopRegion pada blok agar CollectionService mendeteksinya.
Atur Transparency bagian ke maksimum untuk menyembunyikannya dari pemain di dalam pengalaman. Juga nonaktifkan properti CanCollide dan CanQuery agar objek tidak bertabrakan secara fisik dengan itu dan raycast tidak mendeteksinya.


Sisipkan LocalScript baru di bawah StarterPlayerScripts.

Di dalam skrip baru, tempelkan kode berikut yang menggunakan acara Touched dan TouchEnded untuk mendeteksi kapan karakter memasuki/meninggalkan wilayah dan memanggil openMerchBooth dan closeMerchBooth untuk membuka/menutup GUI kios.
LocalScriptlocal Players = game:GetService("Players")local ReplicatedStorage = game:GetService("ReplicatedStorage")local CollectionService = game:GetService("CollectionService")local KiosMerchan = require(ReplicatedStorage.KiosMerchan)-- Menghapus tombol katalog defaultKiosMerchan.toggleCatalogButton(false)local function setupRegion(region: BasePart)region.Touched:Connect(function(otherPart)local character = Players.LocalPlayer.Characterif character and otherPart == character.PrimaryPart thenKiosMerchan.openMerchBooth()endend)region.TouchEnded:Connect(function(otherPart)local character = Players.LocalPlayer.Characterif character and otherPart == character.PrimaryPart thenKiosMerchan.closeMerchBooth()endend)end-- Iterasi melalui wilayah toko yang ditandai yang adafor _, region in CollectionService:GetTagged("ShopRegion") dosetupRegion(region)end-- Mendeteksi ketika wilayah toko yang tidak dialirkan mulai dialirkanCollectionService:GetInstanceAddedSignal("ShopRegion"):Connect(setupRegion)
Prompt Proksimitas
Sebagai alternatif dari tampilan katalog 2D, Anda dapat menambahkan prompt proksimitas di objek dalam pengalaman. Ini mendorong pemain untuk menemukan barang-barang di lingkungan 3D, melihatnya di avatar mereka sendiri, membelinya, dan langsung menggunakannya. Lihat addProximityButton untuk detail.
Ubah efek peralatan
Secara default, kios merchan menunjukkan efek sparkle generik ketika seorang pemain menggunakan item dari sana. Untuk mengubah efek, atur particleEmitterTemplate ke instansi ParticleEmitter Anda sendiri dalam panggilan konfigurasi.
LocalScript - ConfigureMerchBoothlocal ReplicatedStorage = game:GetService("ReplicatedStorage")local KiosMerchan = require(ReplicatedStorage.KiosMerchan)local myParticleEmitter = Instance.new("ParticleEmitter")myParticleEmitter.SpreadAngle = Vector2.new(22, 22)myParticleEmitter.Lifetime = NumberRange.new(0.5, 1.5)myParticleEmitter.Shape = Enum.ParticleEmitterShape.SpheremyParticleEmitter.Transparency = NumberSequence.new(0, 1)myParticleEmitter.RotSpeed = NumberRange.new(200, 200)KiosMerchan.configure({particleEmitterTemplate = myParticleEmitter})
Visibilitas GUI
Secara default, kios merchan menyembunyikan semua ScreenGuis dan CoreGuis ketika antarmuka penggunanya muncul, termasuk obrolan, papan peringkat, dan lainnya yang termasuk oleh Roblox. Jika Anda ingin menonaktifkan perilaku ini, atur hideOtherUis ke false dalam panggilan konfigurasi.
LocalScript - ConfigureMerchBoothlocal ReplicatedStorage = game:GetService("ReplicatedStorage")local KiosMerchan = require(ReplicatedStorage.KiosMerchan)KiosMerchan.configure({hideOtherUis = false})
Gerakan karakter
Akan menguntungkan untuk mencegah karakter bergerak sementara mereka berada di kios merchan. Ini bisa dilakukan dengan mengatur disableCharacterMovement ke true dalam panggilan konfigurasi.
LocalScript - ConfigureMerchBoothlocal ReplicatedStorage = game:GetService("ReplicatedStorage")local KiosMerchan = require(ReplicatedStorage.KiosMerchan)KiosMerchan.configure({disableCharacterMovement = true})
Referensi API
Tipe
Item
Item di kios merchan direpresentasikan oleh sebuah kamus dengan pasangan kunci-nilai berikut. Item dapat dikumpulkan melalui fungsi getItems atau acara itemAdded.
| Kunci | Tipe | Deskripsi |
|---|---|---|
| assetId | number | ID katalog dari item, seperti yang diteruskan ke addItemAsync. |
| title | string | Judul item seperti yang muncul dalam katalog. |
| price | number | Harga item dalam Robux. |
| description | string | Deskripsi item seperti yang muncul dalam katalog. |
| assetType | string | String yang merepresentasikan tipe aksesori item. |
| isOwned | bool | Apakah pemain saat ini memiliki item tersebut. |
| creatorName | string | Pembuat item seperti yang ditampilkan dalam katalog. |
| creatorType | Enum.CreatorType | Jenis pembuat untuk item. |
Enums
KiosMerchan.Controls
Digunakan bersama dengan setControlKeyCodes untuk menyesuaikan tombol dan tombol gamepad untuk berinteraksi dengan kios merchan.
| Nama | Ringkasan |
|---|---|
| ProximityPrompts | Tombol dan/atau tombol gamepad untuk membuka tampilan item ketika prompt proksimitas telah dikonfigurasi. |
| OpenMerchBooth | Tombol dan/atau tombol gamepad untuk membuka kios merchan. |
| CloseMerchBooth | Tombol dan/atau tombol gamepad untuk menutup kios merchan. |
| Filter | Tombol dan/atau tombol gamepad untuk menggunakan Filter dropdown default di area kiri atas tampilan katalog. |
| ViewItem | Tombol dan/atau tombol gamepad untuk membuka tampilan item kios tertentu. |
LocalScriptlocal ReplicatedStorage = game:GetService("ReplicatedStorage")local KiosMerchan = require(ReplicatedStorage.KiosMerchan)KiosMerchan.setControlKeyCodes(KiosMerchan.Controls.ProximityPrompts, {keyboard = Enum.KeyCode.Q,gamepad = Enum.KeyCode.ButtonL1})
Fungsi
konfigurasi
konfigurasi(config: table)
Mengganti opsi konfigurasi sisi klien default melalui kunci/nilai berikut dalam tabel config. Fungsi ini hanya dapat dipanggil dari LocalScript.
| Kunci | Deskripsi | Default |
|---|---|---|
| backgroundColor | Warna latar belakang utama jendela (Color3). | [0, 0, 0] |
| cornerRadius | Radius sudut untuk jendela utama (UDim). | (0, 16) |
| cornerRadiusSmall | Radius sudut untuk elemen di dalam jendela (UDim). | (0, 8) |
| textFont | Font dari "teks utama" seperti harga, deskripsi, dan informasi umum lainnya (Enum.Font). | Gotham |
| textSize | Ukuran teks utama. | 14 |
| textColor | Warna teks utama (Color3). | [255, 255, 255] |
| secondaryTextColor | Warna yang digunakan untuk beberapa variasi teks utama (Color3). | [153, 153, 158] |
| headerFont | Font dari teks header yang digunakan untuk judul jendela (Enum.Font). | GothamMedium |
| headerTextSize | Ukuran teks header yang digunakan untuk judul jendela. | 18 |
| titleFont | Font dari teks judul yang digunakan untuk nama item di halaman detail item (Enum.Font). | GothamBold |
| titleTextSize | Ukuran teks judul yang digunakan untuk nama item di halaman detail item. | 28 |
| buttonColor | Warna latar belakang untuk tombol yang lebih besar dalam keadaan dapat diklik, seperti tombol pembelian utama di tampilan item (Color3). | [255, 255, 255] |
| buttonTextColor | Warna teks untuk tombol yang lebih besar dalam keadaan dapat diklik, seperti tombol pembelian utama di tampilan item (Color3). | [0, 0, 0] |
| secondaryButtonColor | Warna latar belakang untuk tombol yang lebih kecil seperti tombol harga di tampilan katalog atau tombol Coba (Color3). | [34, 34, 34] |
| secondaryButtonTextColor | Warna teks untuk tombol yang lebih kecil seperti tombol harga di tampilan katalog atau tombol Coba (Color3). | [255, 255, 255] |
| inactiveButtonColor | Warna latar belakang untuk semua tombol dalam keadaan tidak dapat diklik (Color3). | [153, 153, 158] |
| inactiveButtonTextColor | Warna teks untuk semua tombol dalam keadaan tidak dapat diklik (Color3). | [255, 255, 255] |
| particleEmitterTemplate | Instansi ParticleEmitter kustom opsional yang muncul dan dimainkan saat menggunakan. |
LocalScriptlocal ReplicatedStorage = game:GetService("ReplicatedStorage")local KiosMerchan = require(ReplicatedStorage.KiosMerchan)KiosMerchan.configure({backgroundColor = Color3.fromRGB(255, 255, 255),textSize = 16,textFont = Enum.Font.Roboto,textColor = Color3.fromRGB(20, 20, 20),hideOtherUis = false,})
addItemAsync
addItemAsync(assetId: number, productType: Enum.InfoType, hideFromCatalog: boolean)
Asynchronously adds an item to the kios merchan so that it's eligible for purchase in the experience. assetId is the item's asset ID, productType is the item's Enum.InfoType enum, and hideFromCatalog can be used to hide the item in the catalog view.
See Menambahkan Item for details, as usage varies slightly for aset versus akses pasar atau produk pengembang.
Script - Tambah Aset Avatar
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local KiosMerchan = require(ReplicatedStorage.KiosMerchan)
local items = {
607702162, -- Topi Baseball Roblox
4819740796, -- Robox
1374269, -- Telinga Kucing
11884330, -- Kacamata Nerd
10476359, -- Topi Kertas
}
for _, assetId in items do
local success, errorMessage = pcall(function()
KiosMerchan.addItemAsync(assetId)
end)
if not success then
warn(errorMessage)
end
end
Script - Tambah Akses
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local KiosMerchan = require(ReplicatedStorage.KiosMerchan)
local items = {
4343758, -- Armor ColdFyre
28521575, -- Perisai Lumpur
}
for _, assetId in items do
local success, errorMessage = pcall(function()
KiosMerchan.addItemAsync(assetId, Enum.InfoType.GamePass)
end)
if not success then
warn(errorMessage)
end
end
Script - Tambah Produk Pengembang
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local KiosMerchan = require(ReplicatedStorage.KiosMerchan)
local items = {
1236602053, -- Pengisian Mana
1257880672, -- Ramuan Penyembuhan
}
for _, assetId in items do
local success, errorMessage = pcall(function()
KiosMerchan.addItemAsync(assetId, Enum.InfoType.Product)
end)
if not success then
warn(errorMessage)
end
end
getItems
getItems(): table
Returns a dictionary representing all of the currently registered items. Each key is an item's asset ID as a string, and each key's value is an Item. This function can only be called from a Script.
Script
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local KiosMerchan = require(ReplicatedStorage.KiosMerchan)
local success, errorMessage = pcall(function()
KiosMerchan.addItemAsync(4819740796)
end)
if success then
local items = KiosMerchan.getItems()
print(items)
end
removeItem
removeItem(assetId: number)
Unregisters an item previously added with addItemAsync, removing its tile in the catalog view and any proximity prompts assigned to it. This function can only be called from a Script.
Script
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local KiosMerchan = require(ReplicatedStorage.KiosMerchan)
local success, errorMessage = pcall(function()
KiosMerchan.addItemAsync(4819740796)
end)
if success then
-- Setelah beberapa waktu, hapus item
task.wait(5)
KiosMerchan.removeItem(4819740796)
end
addProximityButton
addProximityButton(adornee: BasePart|Model|Attachment, assetId: number)
Adds a proximity prompt over the given adornee that will trigger the display of an item's purchase view, given its asset ID. This can be used as an alternative to the 2D catalog view, encouraging players to discover items in the 3D environment.
Note that an item must be added via addItemAsync before a proximity button can be assigned to it. See also removeProximityButton to remove the proximity prompt from an object.
Script
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local Workspace = game:GetService("Workspace")
local KiosMerchan = require(ReplicatedStorage.KiosMerchan)
local success, errorMessage = pcall(function()
KiosMerchan.addItemAsync(4819740796)
end)
if success then
local item = Workspace:FindFirstChild("Robox")
if item then
KiosMerchan.addProximityButton(item, 4819740796)
end
end
removeProximityButton
removeProximityButton(adornee: BasePart|Model|Attachment)
Removes a proximity prompt generated through addProximityButton. This function can only be called from a Script.
Script
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local Workspace = game:GetService("Workspace")
local KiosMerchan = require(ReplicatedStorage.KiosMerchan)
local success, errorMessage = pcall(function()
KiosMerchan.addItemAsync(4819740796)
end)
if success then
local item = Workspace:FindFirstChild("Robox")
if item then
KiosMerchan.addProximityButton(item, 4819740796)
end
-- Setelah beberapa waktu, hapus prompt
task.wait(5)
KiosMerchan.removeProximityButton(item)
end
setCatalogSort
setCatalogSort(sortFunction: function): boolean
Sets the sorting function sortFunction to be used in the catalog view. The provided sorting function can use logic based on Item info such as price or title. This function can only be called from a LocalScript.
Here are some examples for sorting the catalog:
Harga Rendah ke Tinggi
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local KiosMerchan = require(ReplicatedStorage.KiosMerchan)
KiosMerchan.setCatalogSort(function(a, b)
return a.price < b.price
end)
Harga Tinggi ke Rendah
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local KiosMerchan = require(ReplicatedStorage.KiosMerchan)
KiosMerchan.setCatalogSort(function(a, b)
return a.price > b.price
end)
Harga Rendah ke Tinggi & Abjad
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local KiosMerchan = require(ReplicatedStorage.KiosMerchan)
KiosMerchan.setCatalogSort(function(a, b)
return if a.price == b.price then a.title < b.title else a.price < b.price
end)
setControlKeyCodes
setControlKeyCodes(control: KiosMerchan.Controls, keyCodes: table)
Configures the key and button values for interactions with the kios merchan. The first parameter must be a KiosMerchan.Controls enum and the second parameter a table containing the keys keyboard and/or gamepad dengan enum kunci terkait Enum.KeyCode.
| Enum (control) | Nilai Kunci/Keys Default keyCodes |
|---|---|
| KiosMerchan.Controls.ProximityPrompts | keyboard = Enum.KeyCode.E gamepad = Enum.KeyCode.ButtonY |
| KiosMerchan.Controls.OpenMerchBooth | gamepad = Enum.KeyCode.ButtonY |
| KiosMerchan.Controls.CloseMerchBooth | gamepad = Enum.KeyCode.ButtonB |
| KiosMerchan.Controls.Filter | gamepad = Enum.KeyCode.ButtonX |
| KiosMerchan.Controls.ViewItem | gamepad = Enum.KeyCode.ButtonA |
LocalScriptlocal ReplicatedStorage = game:GetService("ReplicatedStorage")local KiosMerchan = require(ReplicatedStorage.KiosMerchan)KiosMerchan.setControlKeyCodes(KiosMerchan.Controls.ProximityPrompts, {keyboard = Enum.KeyCode.Q,gamepad = Enum.KeyCode.ButtonL1,})
openMerchBooth
openMerchBooth()
Opens the kios merchan window (if closed) and navigates to the catalog view. This function can only be called from a LocalScript.
LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local KiosMerchan = require(ReplicatedStorage.KiosMerchan)
local success, errorMessage = pcall(function()
KiosMerchan.addItemAsync(assetId)
end)
if not success then
warn(errorMessage)
end
KiosMerchan.openMerchBooth()
openItemView
openItemView(itemId: number)
Navigates to the single item view of the given itemId, opening the kios merchan window if it is currently closed. This function can only be called from a LocalScript.
LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local KiosMerchan = require(ReplicatedStorage.KiosMerchan)
local success, errorMessage = pcall(function()
KiosMerchan.addItemAsync(4819740796)
end)
if success then
KiosMerchan.openItemView(4819740796)
end
toggleCatalogButton
toggleCatalogButton(enabled: boolean)
Toggles on/off the catalog button on the right side of the screen. This is useful when implementing a tombol kustom or limiting penampilan kios merchan ke wilayah atau prompt proksimitas. Dapat hanya dipanggil dari LocalScript.
LocalScriptlocal ReplicatedStorage = game:GetService("ReplicatedStorage")local KiosMerchan = require(ReplicatedStorage.KiosMerchan)KiosMerchan.toggleCatalogButton(false)
isMerchBoothOpen
isMerchBoothOpen(): Tuple
Returns true if either the catalog or the item view is open. If the item view is open, the item's asset ID is returned as the second value. This function can only be called from a LocalScript.
LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local KiosMerchan = require(ReplicatedStorage.KiosMerchan)
local success, errorMessage = pcall(function()
KiosMerchan.addItemAsync(4819740796)
end)
if success then
KiosMerchan.openItemView(4819740796)
local isOpen, itemId = KiosMerchan.isMerchBoothOpen()
print(isOpen, itemId)
end
closeMerchBooth
closeMerchBooth()
Closes the kios merchan window. This function can only be called from a LocalScript.
LocalScriptlocal ReplicatedStorage = game:GetService("ReplicatedStorage")local KiosMerchan = require(ReplicatedStorage.KiosMerchan)KiosMerchan.closeMerchBooth()
isMerchBoothEnabled
isMerchBoothEnabled(): boolean
Fungsi ini dapat digunakan bersama dengan setEnabled untuk memeriksa apakah kios merchan saat ini diaktifkan atau tidak. Hanya dapat dipanggil dari LocalScript.
setEnabled
setEnabled(enabled: boolean)
Menetapkan apakah seluruh kios merchan diaktifkan atau tidak. Ketika dinonaktifkan, fungsi ini menghapus seluruh UI, termasuk prompt proksimitas, dan memutuskan semua acara. Fungsi ini hanya dapat dipanggil dari LocalScript.
LocalScriptlocal ReplicatedStorage = game:GetService("ReplicatedStorage")local KiosMerchan = require(ReplicatedStorage.KiosMerchan)local isEnabled = KiosMerchan.isMerchBoothEnabled()if isEnabled thenKiosMerchan.setEnabled(false)end
Acara
itemAdded
Fires when an item is added through addItemAsync. This event can only be connected in a Script.
| Parameter | |
|---|---|
| assetId: number | ID aset barang. |
| itemInfo: table | Kamus dari informasi Item seperti price atau title. |
Script
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local KiosMerchan = require(ReplicatedStorage.KiosMerchan)
KiosMerchan.itemAdded:Connect(function(assetId, itemInfo)
print("Item added with asset ID of", assetId)
print(itemInfo)
end)
itemRemoved
Fires when an item is removed through removeItem. This event can only be connected in a Script.
| Parameter | |
|---|---|
| assetId: number | ID aset barang. |
Script
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local KiosMerchan = require(ReplicatedStorage.KiosMerchan)
KiosMerchan.itemRemoved:Connect(function(assetId)
print("Item removed with asset ID of", assetId)
end)
merchBoothOpened
Fires when either the catalog or item detail view are opened.
LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local KiosMerchan = require(ReplicatedStorage.KiosMerchan)
KiosMerchan.merchBoothOpened:Connect(function()
print("Tampilan kios dibuka")
end)
merchBoothClosed
Fires when either the catalog or item detail view are closed.
LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local KiosMerchan = require(ReplicatedStorage.KiosMerchan)
KiosMerchan.merchBoothClosed:Connect(function()
print("Tampilan kios ditutup")
end)
catalogViewOpened
Fires when the catalog view is opened.
LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local KiosMerchan = require(ReplicatedStorage.KiosMerchan)
KiosMerchan.catalogViewOpened:Connect(function()
print("Tampilan katalog dibuka")
end)
catalogViewClosed
Fires when the catalog view is closed.
LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local KiosMerchan = require(ReplicatedStorage.KiosMerchan)
KiosMerchan.catalogViewClosed:Connect(function()
print("Tampilan katalog ditutup")
end)
itemViewOpened
Fires when the item detail view is opened.
LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local KiosMerchan = require(ReplicatedStorage.KiosMerchan)
KiosMerchan.itemViewOpened:Connect(function()
print("Tampilan item dibuka")
end)
itemViewClosed
Fires when the item detail view is closed.
LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local KiosMerchan = require(ReplicatedStorage.KiosMerchan)
KiosMerchan.itemViewClosed:Connect(function()
print("Tampilan item ditutup")
end)