Skip to content
Roblox API Reference

ChangeHistoryService

Must be used by plugins to communicate to Studio how to undo and redo the changes which they make to the experience.
  • Not creatable
  • Service
Memory category
Instances
Own members
14
Inherited members
75
Subclasses
0
Siblings
608

Properties23

Inherited fromObject2

Property categoryData

Inherited fromInstance21

Property categoryBehavior

Property categoryData

Property categoryPermissions

Methods52

Inherited fromObject3
  • Get an event that fires when a given property of the object changes.
    Parameters
    ParameterDescription
    property: string
    The property to connect to.
    Returns
    TypeDescription
    RBXScriptSignal
    A signal that fires whenever the property changes.
  • Object:IsA(className: string): boolean
    Returns true if an object's class matches or inherits from a given class.
    • Custom Lua state
    • Thread safe
    Parameters
    ParameterDescription
    className: string
    The class against which the Object's class will be checked. Case-sensitive.
    Returns
    TypeDescription
    boolean
    Describes whether the Object's class matched or is a subclass of the given class.
  • Object:isA(className: string): boolean
    Deprecated: This deprecated function is a variant of Object:IsA() which should be used instead.
    • Deprecated
    • Custom Lua state
    Parameters
    Parameter
    className: string
    Returns
    Type
    boolean

    Use IsA instead.

Inherited fromInstance39
Defined byChangeHistoryService10
  • ChangeHistoryService:FinishRecording(identifier: string,operation: Enum.FinishRecordingOperation,finalOptions: { [string]: any }?,)
    Communicates to Studio that the identified recording is finished and to take the final operation to complete the recording.
    • Plugin security
    Parameters
    ParameterDescription
    identifier: string
    Identifies the recording from the previous call to TryBeginRecording(). If the operation is FinishRecordingOperation.Cancel, this value is ignored, and the recording is determined by context.
    operation: Enum.FinishRecordingOperation
    Specifies the operation to take.
    finalOptions: { [string]: any }?
    Optional table of values to pass to OnFinishRecording.
  • ChangeHistoryService:GetCanRedo(): ...any
    Returns whether there is an action available to redo and, if so, the name of that action.
    • Plugin security
    Returns
    TypeDescription
    ...any
    true followed by the name of the action that would be redone when a redo is available; otherwise false.
  • ChangeHistoryService:GetCanUndo(): ...any
    Returns whether there is an action available to undo and, if so, the name of that action.
    • Plugin security
    Returns
    TypeDescription
    ...any
    true followed by the name of the action that would be undone when an undo is available; otherwise false.
  • ChangeHistoryService:IsRecordingInProgress(identifier: string?): boolean
    Returns whether the plugin currently has a recording in progress, optionally checking for a specific recording identifier.
    • Plugin security
    Parameters
    ParameterDescription
    identifier: string?
    Optional identifier of a specific recording to check for. When omitted, the method reports whether any recording is in progress for the plugin.
    Returns
    TypeDescription
    boolean
    true if a matching recording is in progress; otherwise false.
  • ChangeHistoryService:Redo()
    Re-executes the most recently undone action, advancing forward through the undo/redo history.
    • Plugin security
  • ChangeHistoryService:ResetWaypoints()
    Clears the undo/redo history by collapsing it into a single base waypoint.
    • Plugin security
  • ChangeHistoryService:SetEnabled(state: boolean)
    Sets whether or not the ChangeHistoryService is enabled.
    • Plugin security
    Parameters
    ParameterDescription
    state: boolean
    Whether to enable (true) or disable (false) the service.
  • ChangeHistoryService:SetWaypoint(name: string)
    Sets a new waypoint which can be used as an undo or redo point.
    • Plugin security
    Parameters
    ParameterDescription
    name: string
    The name to assign to the new waypoint, which appears in the undo/redo history.
  • ChangeHistoryService:TryBeginRecording(name: string,displayName: string?,): string?
    Begins tracking changes made to the data model into a recording.
    • Plugin security
    Parameters
    ParameterDescription
    name: string
    Name of the action being performed suitable for logging and coding purposes.
    displayName: string?
    Name of the action being performed to display to the user.
    Returns
    TypeDescription
    string?
    A unique string identifier for the recording on success, or nil if the recording could not be started.
  • ChangeHistoryService:Undo()
    Reverts the most recent action, stepping backward through the undo/redo history.
    • Plugin security

Events14

Inherited fromObject1
Inherited fromInstance9
Defined byChangeHistoryService4