Plugin Studio

Sebuah plugin adalah ekstensi yang menambahkan fitur atau fungsionalitas tambahan ke Studio. Anda dapat menginstal plugin yang dibuat oleh komunitas dari Toko Creator, atau Anda dapat membuat dan menerbitkan milik Anda sendiri ke Toolbox untuk digunakan di seluruh pengalaman Anda.

Jika Anda memilih untuk juga mendistribusikan plugin Anda ke Toko Creator, Anda dapat menawarkannya secara gratis atau menjualnya dengan Dolar Amerika Serikat. Roblox menawarkan bagi hasil yang terdepan di pasar untuk penjualan ini, karena hanya pajak dan biaya pemrosesan pembayaran yang dipotong. Untuk informasi lebih lanjut tentang menjual plugin, lihat Toko Creator - Distribusikan dan jual aset.

Buat plugin baru

Anda dapat membuat plugin Anda sendiri untuk meningkatkan alur kerja Anda di Studio. Contoh kode berikut adalah plugin bernama AddEmptyScript yang menyisipkan Script kosong sebagai anak dari Instance atau di ServerScriptService. Bagian berikut menjelaskan bagian-bagian utama dalam membuat plugin ini.

Untuk memulai, Anda harus mengaktifkan Plugin Debugging Enabled di bagian Studio dari pengaturan Studio. Ini akan mengekspos PluginDebugService di Studio yang menyediakan debugging waktu nyata untuk kode plugin Anda dan memudahkan untuk memuat ulang dan menyimpan plugin Anda.

Plugin AddEmptyScript
local ServerScriptService = game:GetService("ServerScriptService")
local Selection = game:GetService("Selection")

-- Buat bagian toolbar baru dan folder menu Plugin yang berjudul "Custom"
local toolbar = plugin:CreateToolbar("Custom")

-- Tambahkan tombol toolbar berlabel "Empty Script"
local newScriptButton = toolbar:CreateButton("Empty Script", "Buat script kosong", "rbxassetid://14978048121")

-- Buat tombol dapat diklik meskipun viewport 3D disembunyikan
newScriptButton.ClickableWhenViewportHidden = true

local function onPluginButtonClicked()
	local selectedObjects = Selection:Get()
	local parent = selectedObjects[1] or ServerScriptService
	local newScript = Instance.new("Script")
	newScript.Source = ""
	newScript.Parent = parent
end

newScriptButton.Click:Connect(onPluginButtonClicked)

Simpan skrip plugin

Untuk membuat plugin, pertama buat Script dan simpan secara lokal.

1. Sisipkan Script baru di dalam ServerStorage dan ganti namanya menjadi AddEmptyScript.

   

2. Salin dan tempel kode Plugin AddEmptyScript di atas ke dalam skrip baru.

3. Dengan skrip baru yang dipilih di jendela Explorer, pilih Save as Local Plugin dari menu Plugins Studio.

4. Di jendela pop-up, klik Simpan untuk menyisipkan skrip plugin ke dalam folder Plugins lokal dari instalasi Studio Anda.

5. Plugin harus muncul di PluginDebugService dan mulai berjalan.

6. PENTING

   Hapus skrip asli di ServerStorage dan kerja dari plugin AddEmptyScript di dalam PluginDebugService, jika tidak, Anda mungkin akan menerapkan perubahan pada skrip yang salah.

   

Tambahkan tombol toolbar

Untuk menambahkan tombol untuk plugin Anda ke tab Plugins di toolbar Studio, gunakan metode Plugin:CreateToolbar() dan PluginToolbar:CreateButton(). Dalam kode untuk AddEmptyScript, baris 5 membuat bagian baru di toolbar dan folder menu Plugins yang berjudul Custom, sementara baris 8 membuat tombol berlabel Empty Script.

Jalankan kode saat diklik

Untuk membuat plugin menjalankan kode saat pengguna mengklik tombol toolbar, sambungkan fungsi ke acara PluginToolbarButton.Click dari tombol. Dalam kode untuk AddEmptyScript, fungsi yang menghubungkan adalah onPluginButtonClicked().

Periksa pemilihan pengguna

Untuk memodifikasi perilaku plugin berdasarkan apa yang dipilih pengguna, gunakan layanan Selection. Fungsi onPluginButtonClicked() memeriksa apakah pengguna memiliki sesuatu yang dipilih dan membuat skrip baru sebagai anaknya alih-alih di dalam ServerScriptService. Jika pengguna tidak memiliki apa pun yang dipilih, itu membuat skrip baru di ServerScriptService.

Dukung pembatalan dan pengulangan

Gunakan ChangeHistoryService untuk memungkinkan pengguna membatalkan dan mengulangi perubahan yang dilakukan oleh plugin dalam pengalaman. Dalam skrip Anda, atur plugin untuk memanggil TryBeginRecording() dan simpan pengidentifikasi yang diberikan untuk panggilan API sebelum melakukan perubahan. Kemudian atur plugin untuk memanggil FinishRecording() setelah melakukan perubahan, sehingga menangkap setiap perubahan yang dibuat selama sesi perekaman untuk pembatalan dan pengulangan.

Contoh kode berikut membuat plugin contoh yang dapat menerapkan bahan neon ke bagian yang dipilih. Ini menggunakan ChangeHistoryService untuk merekam dan mengelola perubahan yang dilakukan oleh plugin:

Contoh Plugin Bahan dengan Perekaman untuk Pembatalan dan Pengulangan
local ChangeHistoryService = game:GetService("ChangeHistoryService")
local Selection = game:GetService("Selection")

-- Buat plugin contoh
local toolbar = plugin:CreateToolbar("Contoh Plugin")
local button = toolbar:CreateButton("Nyalakan Neon", "", "")

-- Hubungkan fungsi ke acara klik
button.Click:Connect(function()
	-- Coba mulai merekam dengan pengidentifikasi spesifik
	local recording = ChangeHistoryService:TryBeginRecording("Set pemilihan ke neon")

	-- Periksa apakah perekaman berhasil dimulai
	if not recording then
		-- Ini menunjukkan bahwa plugin Anda memulai perekaman sebelumnya dan tidak pernah menyelesaikannya
		-- Anda hanya dapat memiliki satu perekaman per plugin aktif pada satu waktu
		return
	end

	-- Iterasi melalui instance yang dipilih
	for _, instance in Selection:Get() do
		-- Periksa apakah instance adalah BasePart
		if instance:IsA("BasePart") then
			instance.Material = Enum.Material.Neon -- Set bahan dari bagian ke Neon
		end
	end

	-- Selesaikan perekaman, mengkomit perubahan ke dalam riwayat
	ChangeHistoryService:FinishRecording(recording, Enum.FinishRecordingOperation.Commit)
end)

Unggah plugin

Setelah Anda selesai membuat plugin, Anda dapat menguploadnya ke inventaris Anda sehingga dapat diakses di semua proyek Anda.

Untuk mengupload plugin:

1. Di jendela Explorer, pilih skrip plugin.

2. Navigasi ke menu Plugins di Studio, kemudian pilih Publish as Plugin.

3. OPSIONAL

   Di pojok kiri atas jendela konfigurasi aset, klik gambar ubin default untuk mengupload gambar mini 512×512 untuk plugin Anda.

4. Isi kolom berikut:

   • Nama — Sebuah judul untuk plugin Anda.
   • Deskripsi — Deskripsi yang menjelaskan apa yang dapat diharapkan pengguna potensial dari plugin tersebut.
   • Penggagas — Penggagas atau grup yang ingin Anda atributkan sebagai penggagas plugin tersebut.

5. Klik tombol Kirim. Plugin Anda sekarang tersedia untuk Anda di Toolbox di bawah tab Inventaris dan Karya.

Distribusikan dan jual plugin

Anda dapat mendistribusikan secara publik dan menjual plugin Anda sendiri di Toko Creator agar orang lain dapat menggunakannya dalam pengembangan game mereka sendiri. Metode monetisasi ini memungkinkan Anda mendapatkan 100% dari hasil bersih dari transaksi, melewati biaya platform dan tarif DevEx. Untuk informasi lebih lanjut tentang proses ini, termasuk cara menyiapkan akun penjual untuk menetapkan harga dan menerima pembayaran, lihat Toko Creator - Persyaratan.