StudioService

ActiveScript refers to the LuaSourceContainer currently being edited by the user. If the user is not editing a script, this will be nil. Below is an example that shows how you can use this property to measure for how long a script was active.

local startTime = os.time()
local activeScript
local function onActiveScriptChanged(newActiveScript)
	if newActiveScript ~= activeScript then
		local deltaTime = os.time() - startTime
		print(("You edited %s for %d:%2.d"):format(activeScript.Name, math.floor(deltaTime / 60), deltaTime % 60))
	end
	startTime = os.time()
	activeScript = newActiveScript
end
game:GetService("StudioService"):GetPropertyChangedSignal("ActiveScript"):Connect(onActiveScriptChanged)

GridSize determines the distance in studs by which studio's drag and move tools move objects each tick. This is set by the user Model tab under the "Snap to Grid" section.

RotateIncrement determines the angle in degrees by which studio's rotation tool will rotate selected objects each tick. This is set by the user Model tab under the "Snap to Grid" section.

The table below shows how the rotation handles appear while dragging. Notice how lower values render more axles. In these images, UseLocalSpace is true.

RotateIncrement	Image
22.5
90.0

The StudioLocaleId property contains the locale currently in-use by Studio, e.g. en_US. It is useful when localizing plugins.

Below is a trivial example of localization based on the value returned by this function.

local locale = game:GetService("StudioService").StudioLocaleId
if locale == "en_US" then
   print("Howdy, ya'll")
elseif locale == "en_GB" then
   print("'Ello, gov'na")
elseif locale:sub(1, 2) == "en" then
   print("Hello")
elseif locale == "fr_FR" then
   print("Bonjour")
end

UseLocalSpace determines whether the studio movement/rotation tools will manipulate a part's CFrame using the local space of an object or global space. By default, this setting is toggled with Ctrl-L. Plugins can read from this property if they implement their own object movement tools.

The table below shows how movement/rotation tools change when working with parts. Notice how when UseLocalSpace is false, the movement tools align with the global axes, and when true the movement tools align with the part's local axes.

UseLocalSpace	Movement	Rotation
true
false

GetClassIcon provides a dictionary that allows the display of a class' Explorer window icon, e.g. calling this function with "Part" returns property values that display the part icon from the Explorer window.

Below is a literal table representation of the value returned when this function is called with "Part".

{
	Image = "rbxasset://textures/ClassImages.png",
	ImageRectOffset = Vector2.new(16, 0),
	ImageRectSize = Vector2.new(16, 16)
}

The utility function below may prove useful when displaying class icons:

local StudioService = game:GetService("StudioService")
local imageLabel = script.Parent
local function displayClassIcon(image, className)
	for k, v in pairs(StudioService:GetClassIcon(className)) do
		image[k] = v -- Set property
	end
end
displayClassIcon(imageLabel, "Part")

Parameters

Returns

Returns the studio user's userId if they're logged in, otherwise returns 0.

Returns

-- Can only be used in a plugin
local StudioService = game:GetService("StudioService")
local Players = game:GetService("Players")

local loggedInUserId = StudioService:GetUserId()
local loggedInUserName = Players:GetNameFromUserIdAsync(loggedInUserId)
print("Hello,", loggedInUserName)

Parameters

Returns

This function prompts the current Studio user to select one file, which will then be loaded as a File.

See also:

• StudioService:PromptImportFiles(), the same function but for loading a list of files instead of a single file

Parameters

Returns

This function prompts the current Studio user to select one or more files, which will then be loaded as Files.

Throws an error if the fileTypeFilter was an empty list.

See also:

• StudioService:PromptImportFile(), the same function but for loading a single file instead of a list of files

Parameters

Returns