ปลั๊กอิน

ส่วนขยาย ปลั๊กอิน เป็นส่วนขยายที่เพิ่มคุณสมบัติหรือฟังก์ชันเพิ่มเติมให้กับ Studioคุณสามารถ ติดตั้ง ปลั๊กอินที่สร้างขึ้นโดยชุมชนจากร้านค้าของผู้สร้าง หรือคุณสามารถ สร้าง และ เผยแพร่ ของคุณเองไปยัง กล่องเครื่องมือ เพื่อใช้กับประสบการณ์ของคุณ

หากคุณเลือกที่จะแจกจ่ายส่วนขยายของคุณไปยังร้านค้าของผู้สร้างด้วย คุณสามารถเสนอพวกเขาฟรีหรือขายพวกเขาในราคา ดอลลาร์สหรัฐ (ราคาขั้นต่ำคือ $4.99)Roblox เสนอส่วนแบ่งรายได้ชั้นนำในตลาดสำหรับการขายเหล่านี้เนื่องจากมีเพียงภาษีและค่าธรรมเนียมการชำระเงินที่ถูกหักออกสำหรับข้อมูลเพิ่มเติมเกี่ยวกับการขายปลั๊กอินดูที่ การขายบนร้านค้าของผู้สร้าง

สร้างปลั๊กอินใหม่

คุณสามารถสร้างปลั๊กอินของคุณเองเพื่อปรับปรุงกระบวนการทำงานใน Studioตัวอย่างโค้ดต่อไปนี้เป็นปลั๊กอินที่เรียกว่า EmptyScriptAdder ซึ่งใส่สคริปต์ว่างเปล่าเป็นลูกของวัตถุหรือใน ServerScriptServiceส่วนต่อไปอธิบายส่วนสำคัญในการสร้างปลั๊กอินนี้

เพื่อเริ่มต้นคุณควรเปิดใช้งาน การดีบักปลั๊กอินเปิดใช้งานแล้ว ในส่วน Studio ของการตั้งค่าของ Studioสิ่งนี้จะเปิดเผย PluginDebugService ใน Studio ซึ่งให้การแก้ไขข้อผิดพลาดแบบเรียลไทม์สําหรับรหัสของปลั๊กอินของคุณและทําให้ง่ายต่อการโหลดและบันทึกปลั๊กอินของคุณ

ปลั๊กอิน EmptyScriptAdder
local ChangeHistoryService = game:GetService("ChangeHistoryService")
local Selection = game:GetService("Selection")

-- สร้างส่วนแถบเครื่องมือใหม่ที่มีชื่อว่า "เครื่องมือสคริปต์ที่กำหนดเอง"
local toolbar = plugin:CreateToolbar("Custom Script Tools")

-- เพิ่มปุ่มแถบเครื่องมือชื่อ "สร้างสคริปต์ว่างเปล่า"
local newScriptButton = toolbar:CreateButton("Create Empty Script", "Create an empty script", "rbxassetid://14978048121")

-- ทำให้ปุ่มคลิกได้แม้ว่าจะมีวิวพอร์ต 3D ซ่อนอยู่
newScriptButton.ClickableWhenViewportHidden = true

local function onNewScriptButtonClicked()
	local selectedObjects = Selection:Get()
	local parent = game:GetService("ServerScriptService")
	if #selectedObjects > 0 then
		parent = selectedObjects[1]
	end

	local newScript = Instance.new("Script")
	newScript.Source = ""
	newScript.Parent = parent
	ChangeHistoryService:SetWaypoint("Added new empty script")
end

newScriptButton.Click:Connect(onNewScriptButtonClicked)

บันทึกสคริปต์ปลั๊กอิน

ปลั๊กอินเริ่มจากสคริปต์เพื่อสร้างปลั๊กอิน สร้าง Script และบันทึกเป็นปลั๊กอินโดยใช้ Explorerตัวอย่างเช่นการสร้าง ปลั๊กอิน EmptyScriptAdder :

1. ใส่ใหม่ Script ภายใน ServerStorage และเปลี่ยนชื่อเป็น EmptyScriptAdder

   

2. คัดลอกและวางรหัส EmptyScriptAdder Plugin ในสคริปต์ใหม่

3. ในหน้าต่าง สํารวจ คลิกขวาที่สคริปต์และเลือก บันทึกเป็นส่วนประกอบท้องถิ่น

4. ในหน้าต่างป๊อปอัพ คลิก บันทึก เพื่อใส่สคริปต์ปลั๊กอินในโฟลเดอร์ท้องถิ่น ปลั๊กอิน ของการติดตั้ง Studio

5. ปลั๊กอินควรปรากฏใน PluginDebugService และเริ่มทำงาน

รีโหลดและบันทึกการเปลี่ยนแปลง

ด้วย Plugin ภายใน PluginDebugService คุณสามารถอัปเดตปลั๊กอินได้ง่ายโดยคลิกขวาแล้วเลือก บันทึกและโหลดปลั๊กอิน จากเมนูบริบทหากคุณเพียงต้องการรีโหลดปลั๊กอิน เช่น เพื่อผ่านส่วนหนึ่งของโค้ดโดยใช้จุดหยุดโดยไม่บันทึกปลั๊กอิน คุณสามารถเลือก รีโหลดปลั๊กอิน ได้แทน

เพิ่มปุ่มแถบเครื่องมือ

เพื่อเพิ่มปุ่มสำหรับปลั๊กอินของคุณในแท็บ ปลั๊กอิน ของแถบเครื่องมือ Studio ใช้วิธี Plugin:CreateToolbar() และ PluginToolbar:CreateButton()ในรหัสสําหรับ EmptyScriptAdder บรรทัดที่ 5 สร้างส่วนใหม่ในแถบเครื่องมือชื่อ เครื่องมือสคริปต์ที่กําหนดเอง และบรรทัดที่ 8 สร้างปุ่มชื่อ สร้างสคริปต์ว่างเปล่า

ดำเนินโค้ดเมื่อคลิก

เพื่อให้แอปพลิเคชันดําเนินโค้ดเมื่อผู้ใช้คลิกปุ่มแถบเครื่องมือ ให้เชื่อมฟังก์ชันกับอีเวนต์ของปุ่ม PluginToolbarButton.Clickในรหัสสําหรับ EmptyScriptAdder ฟังก์ชันการเชื่อมต่อคือ onNewScriptButtonClicked()

ตรวจสอบการเลือกผู้ใช้

เพื่อปรับพฤติกรรมของปลั๊กอินตามสิ่งที่ผู้ใช้เลือกใช้บริการ Selectionฟังก์ชัน onNewScriptButtonClicked() ตรวจสอบว่าผู้ใช้มีสิ่งที่เลือกและสร้างสคริปต์ใหม่เป็นลูกของมันแทนที่จะอยู่ภายใน ServerScriptServiceหากผู้ใช้ไม่มีอะไรถูกเลือก มันจะสร้างสคริปต์ใหม่ใน ServerScriptService

สนับสนุนการยกเลิกและทำซ้ำ

ใช้ ChangeHistoryService เพื่ออนุญาตให้ผู้ใช้ยกเลิกและทำซ้ำการเปลี่ยนแปลงที่ทำโดยปลั๊กอินภายในประสบการณ์ในสคริปต์ของคุณ ตั้งค่าปลั๊กอินให้เรียก ChangeHistoryService:TryBeginRecording() และบันทึกตัวระบุที่กำหนดให้กับการโทร API ก่อนที่จะทำการเปลี่ยนแปลงจากนั้นตั้งค่าปลั๊กอินให้โทร ChangeHistoryService:FinishRecording() หลังจากทำการเปลี่ยนแปลงเพื่อให้มันจับการเปลี่ยนแปลงที่ทำในระหว่างเซสชันบันทึกเพื่อยกเลิกและทำซ้ำ

ตัวอย่างโค้ดต่อไปนี้สร้างตัวอย่างปลั๊กอินที่สามารถใช้วัสดุนีออนกับส่วนที่เลือกได้มันใช้ ChangeHistoryService ในการบันทึกและจัดการการเปลี่ยนแปลงที่ทำโดยปลั๊กอิน:

ตัวอย่างปลั๊กอินวัสดุที่มีการบันทึกสําหรับยกเลิกและทําซ้ํา
local ChangeHistoryService = game:GetService("ChangeHistoryService")
local Selection = game:GetService("Selection")

-- สร้างตัวอย่างปลั๊กอิน
local toolbar = plugin:CreateToolbar("Example Plugin")
local button = toolbar:CreateButton("Neon it up", "", "")

-- เชื่อมฟังก์ชันกับอีเวนต์การคลิก
button.Click:Connect(function()
    local parts = {}
    for _, part in Selection:Get() do
        if part:IsA("BasePart") then
            parts[#parts + 1] = part
        end
    end
    if #parts < 1 then
        -- ไม่มีอะไรต้องทำ
        return
    end

    -- ลองเริ่มบันทึกด้วยตัวระบุเฉพาะ
    local recording = ChangeHistoryService:TryBeginRecording("Set selection to neon")

    -- ตรวจสอบว่าการบันทึกเริ่มต้นสําเร็จหรือไม่
    if not recording then
        -- จัดการข้อผิดพลาดที่นี่ ซึ่งบ่งชี้ว่าปลั๊กอินของคุณเริ่มต้นก่อนหน้านี้
        -- บันทึกและไม่เคยสำเร็จ คุณอาจมีการบันทึกเพียงครั้งเดียว
        -- ต่อปลั๊กอินที่ใช้งานในแต่ละครั้ง
        return
    end

    -- จัดเตรียมผ่านส่วนที่เลือก
    for _, part in parts do
        part.Material = Enum.Material.Neon -- ตั้งวัสดุของชิ้นส่วนเป็นนีออน
    end

    -- เสร็จสิ้นการบันทึกโดยการส่งเปลี่ยนแปลงไปยังประวัติ
    ChangeHistoryService:FinishRecording(recording, Enum.FinishRecordingOperation.Commit)
end)

อัปโหลด จำหน่าย และสร้างรายได้จากปลั๊กอิน

เช่นเดียวกับ โมเดล , เมช , รูปภาพ และ แอนิเมชัน คุณสามารถจัดจำหน่ายส่วนประกอบให้ Roblox เพื่อให้ง่ายต่อการใช้ซ้ำจาก กล่องเครื่องมือคุณสามารถเลือกที่จะทำให้พวกเขาเป็นที่เปิดเผยสาธารณะสำหรับผู้สร้างคนอื่น ๆ ทั้งหมดใน ร้านค้าผู้สร้าง หรือจะแจกจ่ายพวกเขาเป็นความลับสำหรับการใช้งานของคุณเองหากคุณเลือกที่จะแจกจ่ายปลั๊กอินของคุณสาธารณะคุณสามารถตั้งราคาที่จะขายให้กับผู้สร้างคนอื่นได้

เพื่อจัดจำหน่ายปลั๊กอิน:

1. ในหน้าต่าง สํารวจ คลิกขวาที่สคริปต์ปลั๊กอินจากนั้นเลือก เผยแพร่เป็นปลั๊กอิน จากเมนูบริบท

2. (เลือกได้) ในมุมบนซ้ายของหน้าต่างการกำหนดค่าสินทรัพย์ คลิกที่ภาพเพื่ออัปโหลดภาพ 512×512

3. กรอกฟิลด์ต่อไปนี้:

   • ชื่อ : ชื่อสำหรับปลั๊กอินของคุณ
   • คําอธิบาย : คําอธิบายที่อธิบายสิ่งที่ผู้ใช้ที่มีศักยภาพควรคาดหวังจากปลั๊กอิน
   • ผู้สร้าง : ปลั๊กอิน

4. คลิกที่ปุ่ม ส่ง ปลั๊กอินของคุณมีให้ใช้แล้วในแท็บ สินค้าคงคลัง และ สิ่งประดิษฐ์ ของ กล่องเครื่องมือ

5. คลิกที่ลิงก์ไปยังแดชบอร์ดของผู้สร้างเพื่อ กำหนดการจัดจำหน่าย