Class Tool

This is used for creating tools that can be used by in-game players.

Hierarchy

  • EventEmitter
    • Tool

Constructors

Properties

_slotId: number

The slotId of the tool. [Used internally].

enabled: boolean = true

If set to false, players will not be able to equip or de-equip the tool.

model: number = 0

The assetId of the tool's model.

name: string

The name of the tool. *

captureRejectionSymbol: typeof captureRejectionSymbol
captureRejections: boolean

Sets or gets the default captureRejection value for all emitters.

defaultMaxListeners: number
errorMonitor: typeof errorMonitor

This symbol shall be used to install a listener for only monitoring 'error' events. Listeners installed using this symbol are called before the regular 'error' listeners are called.

Installing a listener using this symbol does not change the behavior once an 'error' event is emitted, therefore the process will still crash if no regular 'error' listener is installed.

toolId: number = 0

Events

activated: Activated = ToolEvents.Activated

Fires when a player holding the tool clicks the left mouse button.
This will not be emitted if you disable the toolHandler.js core script.

Example

let tool = new Tool("Balloon")
tool.model = 84038
Game.on("playerJoin", (player) => {
player.on("initialSpawn", () => {
player.equipTool(tool)
})
})
tool.on("activated", (p) => {
console.log(p.username + " has clicked with the tool equipped!")
})
equipped: Equipped = ToolEvents.Equipped

Fires when a player equips a tool.

unequipped: Unequipped = ToolEvents.Unequipped

Fires when a player unequips a tool.

Methods

  • Parameters

    • event: string | symbol
    • listener: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns Tool

  • Completely destroys the tool, unequips it from all players, deletes it from their inventroy, and removes it from Game.world.tools.

    Returns Promise<boolean>

  • Parameters

    • event: string | symbol
    • Rest ...args: any[]

    Returns boolean

  • Calls the specified callback with the player who equipped the tool.

    Example

    let tool = new Tool("Balloon")
    tool.model = 84038
    tool.equipped((p) => {
    p.setJumpPower(20) // Give the player a height boost
    })

    Parameters

    • callback: ((player: Player) => void)
        • (player: Player): void
        • Parameters

          Returns void

    Returns Disconnectable

  • Returns (string | symbol)[]

  • Returns number

  • Parameters

    • type: string | symbol

    Returns number

  • Parameters

    • event: string | symbol

    Returns Function[]

  • Parameters

    • event: string | symbol
    • listener: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns Tool

  • Parameters

    • event: string | symbol
    • listener: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns Tool

  • Parameters

    • event: string | symbol
    • listener: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns Tool

  • Parameters

    • event: string | symbol
    • listener: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns Tool

  • Parameters

    • event: string | symbol
    • listener: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns Tool

  • Parameters

    • event: string | symbol

    Returns Function[]

  • Parameters

    • Optional event: string | symbol

    Returns Tool

  • Parameters

    • event: string | symbol
    • listener: ((...args: any[]) => void)
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns Tool

  • Parameters

    • n: number

    Returns Tool

  • Calls the specified callback with the player who un-equipped the tool.

    Example

    let tool = new Tool("Balloon")
    tool.model = 84038
    tool.unequipped((p) => {
    p.setJumpPower(5) // Reset their jump power back to normal.
    })

    Parameters

    • callback: ((player: Player) => void)
        • (player: Player): void
        • Parameters

          Returns void

    Returns Disconnectable

  • Deprecated

    since v4.0.0

    Parameters

    • emitter: EventEmitter
    • event: string | symbol

    Returns number

  • Parameters

    • emitter: EventEmitter
    • event: string

    Returns AsyncIterableIterator<any>

  • Parameters

    • emitter: NodeEventTarget
    • event: string | symbol

    Returns Promise<any[]>

  • Parameters

    • emitter: DOMEventTarget
    • event: string

    Returns Promise<any[]>