Class BlockButtonTrait

Hierarchy (View Summary)

BlockTrait
- BlockButtonTrait

Index

Constructors

Properties

block components dimension identifier releaseTick state components identifier state types

Methods

clone getState onAdd? onBreak? onContainerUpdate? onInteract onPick? onPlace? onRemove? onReplace? onStartBreak? onStopBreak? onTick onUpdate? setState

Constructors

constructor

new BlockButtonTrait(block: Block, _options?: JSONLikeObject): BlockButtonTrait
Creates a new instance of the block trait.
Parameters
- block: Block
  The block that this trait will be attached to.
- Optional_options: JSONLikeObject
Returns BlockButtonTrait
Inherited from BlockTrait.constructor
- Defined in packages/core/src/block/traits/trait.ts:60

Properties

`Protected` `Readonly`block

block: Block

The block that this trait is attached to.

`Readonly`components

components: string[] = ...

The block component identifiers that this trait is compatible with. If empty, the trait will not be initialized by any component.

`Protected` `Readonly`dimension

dimension: Dimension

The dimension that the block is in.

`Readonly`identifier

identifier: string = ...

The identifier of the trait.

releaseTick

releaseTick: bigint = -1n

The tick at which the button will be released.

`Readonly`state

state: null | string = ...

The block state key that this trait is compatible with. If null, the trait will not be initialized by any block state.

`Static` `Readonly`components

components: string[] = []

The block component identifiers that this trait is compatible with by default. If empty, the trait will not be initialized by any component.

`Static` `Readonly`identifier

identifier: "button"

The identifier of the trait.

`Static` `Readonly`state

state: "button_pressed_bit"

The block state key that this trait is compatible with by default. If null, the trait will not be initialized by any block state.

`Static` `Readonly`types

types: BlockIdentifier[] = []

The block type identifiers that this trait is compatible with by default.

Methods

clone

clone(..._arguments: unknown[]): Trait
Clones the trait with the specified arguments.
Parameters
- ..._arguments: unknown[]
Returns Trait
Inherited from BlockTrait.clone
- Defined in packages/core/src/trait.ts:59

getState

getState(): boolean
Get the current state of the button.

Returns boolean
The current state of the button (pressed or not).
- Defined in packages/core/src/block/traits/button.ts:59

`Optional`onAdd

onAdd(): void
Called when the trait is added to an object.

Returns void
Inherited from BlockTrait.onAdd
- Defined in packages/core/src/trait.ts:42

`Optional`onBreak

onBreak(options: BlockDestroyOptions): boolean | void
Called when the block is broken in the world.
Parameters
- options: BlockDestroyOptions
Returns boolean | void
Whether the block break was successful; default is true.
Inherited from BlockTrait.onBreak
- Defined in packages/core/src/block/traits/trait.ts:86

`Optional`onContainerUpdate

onContainerUpdate(container: Container): void
Called when a container that is attached to the block is updated.
Parameters
- container: Container
  The container that was updated.
Returns void
Inherited from BlockTrait.onContainerUpdate
- Defined in packages/core/src/block/traits/trait.ts:118

onInteract

onInteract(options: BlockInteractionOptions): void
Called when the block is interacted with by a player.
Parameters
- options: BlockInteractionOptions
  The options of the block interaction.
Returns void
Whether the interaction was successful; default is true.
Overrides BlockTrait.onInteract
- Defined in packages/core/src/block/traits/button.ts:21

`Optional`onPick

onPick(player: Player, withData: boolean): void
Called when a player pick blocks the block.
Parameters
- player: Player
  The player that picked the block.
- withData: boolean
  Whether the player picked the block with a data request.
Returns void
Inherited from BlockTrait.onPick
- Defined in packages/core/src/block/traits/trait.ts:112

`Optional`onPlace

onPlace(options: BlockPlacementOptions): boolean | void
Called when the block is placed in the world.
Parameters
- options: BlockPlacementOptions
  The options of the block placement.
Returns boolean | void
Whether the block placement was successful; default is true.
Inherited from BlockTrait.onPlace
- Defined in packages/core/src/block/traits/trait.ts:79

`Optional`onRemove

onRemove(): void
Called when the trait is removed from an object.

Returns void
Inherited from BlockTrait.onRemove
- Defined in packages/core/src/trait.ts:47

`Optional`onReplace

onReplace(): void
Returns void
Inherited from BlockTrait.onReplace
- Defined in packages/core/src/block/traits/trait.ts:120

`Optional`onStartBreak

onStartBreak(player: Player): boolean | void
Called when the block is started to be broken in the world.
Parameters
- player: Player
  The player that started to break the block.
Returns boolean | void
Inherited from BlockTrait.onStartBreak
- Defined in packages/core/src/block/traits/trait.ts:92

`Optional`onStopBreak

onStopBreak(player: Player): void
Called when the block is stopped to be broken in the world.
Parameters
- player: Player
  The player that stopped breaking the block.
Returns void
Inherited from BlockTrait.onStopBreak
- Defined in packages/core/src/block/traits/trait.ts:98

onTick

onTick(): void
Called when the trait is ticked by the dimension.

Returns void
Overrides BlockTrait.onTick
- Defined in packages/core/src/block/traits/button.ts:41

`Optional`onUpdate

onUpdate(source?: Block): void
Called when the block is updated in the world.
Parameters
- Optionalsource: Block
  The source of the update, if any.
Returns void
Inherited from BlockTrait.onUpdate
- Defined in packages/core/src/block/traits/trait.ts:72

setState

setState(state: boolean, silent?: boolean): void
Set the state of the button.
Parameters
- state: boolean
  The desired state of the button (true for pressed, false for not pressed).
- silent: boolean = false
  If the sound event should be played (default is false).
Returns void
- Defined in packages/core/src/block/traits/button.ts:69

Class BlockButtonTrait

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns BlockButtonTrait

Properties

Protected Readonlyblock

Readonlycomponents

Protected Readonlydimension

Readonlyidentifier

releaseTick

Readonlystate

Static Readonlycomponents

Static Readonlyidentifier

Static Readonlystate

Static Readonlytypes

Methods

clone

Parameters

Returns Trait

getState

Returns boolean

OptionalonAdd

Returns void

OptionalonBreak

Parameters

Returns boolean | void

OptionalonContainerUpdate

Parameters

Returns void

onInteract

Parameters

Returns void

OptionalonPick

Parameters

Returns void

OptionalonPlace

Parameters

Returns boolean | void

OptionalonRemove

Returns void

OptionalonReplace

Returns void

OptionalonStartBreak

Parameters

Returns boolean | void

OptionalonStopBreak

Parameters

Returns void

onTick

Returns void

OptionalonUpdate

Parameters

Returns void

setState

Parameters

Returns void

Settings

On This Page

`Protected` `Readonly`block

`Readonly`components

`Protected` `Readonly`dimension

`Readonly`identifier

`Readonly`state

`Static` `Readonly`components

`Static` `Readonly`identifier

`Static` `Readonly`state

`Static` `Readonly`types

`Optional`onAdd

`Optional`onBreak

`Optional`onContainerUpdate

`Optional`onPick

`Optional`onPlace

`Optional`onRemove

`Optional`onReplace

`Optional`onStartBreak

`Optional`onStopBreak

`Optional`onUpdate