プラグイン

プラグイン は、Studio に追加の機能を追加する拡張機能です。クリエイターストアから コミュニティ製のプラグインをインストールしたり、独自のプラグインを作成し、ツールボックスに公開して、エクスペリエンス全体で使用することができます。

プラグインをクリエイターストアにも配布することを選択すると、無料で提供するか、<a href=\"#額外の費用</a> （最小額は $4.99）でアメリカドルで販売することができます。プラグインの販売については、<a href=\"#����

新規プラグインの作成

Studio で独自のプラグインを作成してワークフローを向上させることができます。次のコードサンプルは、EmptyScriptAdderというプラグインで、オブジェクトの子または ServerScriptService に空のスクリプトを挿入します。次のセクションでは、このプラグインを作成するための主要な部分について説明します。

まず、Studio の設定の Studio セクションで PluginDebugService を有効にする必要があります。これにより、Studioの 2>Class.PluginDebugService2> が公開され、プラグインのコードのリアルタイムデバッグが提供され、プラグインの再読み込みと保存が容易になります。

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)

プラグインスクリプトを保存する

プラグインはスクリプトから始まります。To create a plugin, プラグインを作成するには、 Script を作成し、 Explorer を使用してプラグインとして保存します。たとえば、 EmptyScriptAdder Plugin を作成するには：

1. 新しい Script を ServerStorage の中に挿入し、 EmptyScriptAdder に名前を変更します。

   

2. Copy and paste the EmptyScriptAdder プラグイン コード into the new script.

3. In the Explorer window, right-click the script and select ローカルプラグインとして保存 .

4. ポップアップウィンドウで 保存する をクリックして、Studio インストールのローカル プラグイン フォルダにプラグインスクリプトを挿入します。

5. プラグインは PluginDebugService に表示され、実行を開始します。

変更の再読み込みと保存

Class.Plugin を PluginDebugService の中に置くと、プラグインを右クリックし、コンテキストメニューから プラグインの保存と再読み込み を選択して、簡単にプラグインを更新できます。プラグインを保存せずにコードのセ

ツールバーボタンの追加

To add a button for your plugin to the Studio ツールバーの [プラグイン] タブ of the toolbar, use the Plugin:CreateToolbar() and PluginToolbar:CreateButton() methods. In the code for 1> EmptyScriptAdder1> , line 5 creates a new

クリックでコードを実行中

ユーザーがツールバーボタンをクリックしたときにプラグインがコードを実行させるには、ボタンの PluginToolbarButton.Click イベントに機能を接続します。在EmptyScriptAdderのコードでは、接続機能は onNewScriptButtonClicked() です。

ユーザーの選択をチェック

ユーザーが選択した内容に基づいてプラグインの動作を変更するには、Selectionを使用します。onNewScriptButtonClicked() 機能は、ユーザーが何かを選択しているかどうかをチェックし、 Class.ServerScriptService 内で

取り消しとやり直しをサポート

Class.ChangeHistoryService を使用して、ユーザーがエクスペリエンス内のプラグインによって行われた変更を取り消し、やり直すことができます。スクリプトで、 Class.ChangeHistoryService:TryBeginRecording() を呼び出すようにプラグインを設

次のコードサンプルは、ネオン素材を選択したパーツに適用できる例のプラグインを作成します。 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
        -- ここでエラーを処理します。これは、あなたのプラグインが以前に開始したことを示します
        -- 記録し、それは決して完了しませんでした。 あなたは 1つの記録しか持つことができません
        -- プラグインのアクティブ時間に基づいて。
        return
    end

    -- 選択したパーツをイテレート
    for _, part in parts do
        part.Material = Enum.Material.Neon -- パーツの材料をネオンに設定
    end

    -- レコーディングを完了し、変更をログにコミット
    ChangeHistoryService:FinishRecording(recording, Enum.FinishRecordingOperation.Commit)
end)

プラグインのアップロード、配布、および収益化

モデル、メッシュ、画像、およびアニメーションと同様に、プラグインを Roblox に配布して、2>ツールボックス2>から簡単に再使用できます。

プラグインを配布するには：

1. In the Explorer ウィンドウ, right-click a プラグインスクリプト, then select プラグインとして公開 from the contextual menu.

2. (オプション) アセットコンフィグウィンドウの左上隅で、画像をクリックして 512×512 の画像をアップロードします。

3. 次のフィールドに記入してください:

   • 名前 : プラグインのタイトル。
   • 説明 : 潜在的ユーザーがプラグインを期待するものを説明します。
   • クリエイター : プラグインのクリエーターとして帰属させたいクリエイター。

4. クリックしてください 送信 ボタン。あなたのプラグインは インベントリ と クリエーション タブの 1>ツールボックス1> で利用可能です。

5. クリエイターダッシュボード をクリックして配信を構成する。