API Reference

JS Action / Condition Types

All custom types use the origins_js: namespace prefix. For the standard types these wrap, see the corresponding documentation:

JSON `type`	Registration Method	Callback Args	Standard Docs
`origins_js:js_entity_action`	`registerEntityAction`	`(entity, params)`	Entity Action
`origins_js:js_block_action`	`registerBlockAction`	`(level, pos, direction, params)`	Block Action
`origins_js:js_item_action`	`registerItemAction`	`(level, entity, slotAccess, params)`	Item Action
`origins_js:js_bientity_action`	`registerBiEntityAction`	`(actor, target, params)`	Bi-entity Action
`origins_js:js_entity_condition`	`registerEntityCondition`	`(entity, params) => bool`	Entity Condition
`origins_js:js_block_condition`	`registerBlockCondition`	`(level, pos, params) => bool`	Block Condition
`origins_js:js_item_condition`	`registerItemCondition`	`(level, itemStack, params) => bool`	Item Condition
`origins_js:js_bientity_condition`	`registerBiEntityCondition`	`(actor, target, params) => bool`	Bi-entity Condition
`origins_js:js_biome_condition`	`registerBiomeCondition`	`(biomeHolder, pos, params) => bool`	Biome Condition
`origins_js:js_damage_condition`	`registerDamageCondition`	`(damageSource, amount, params) => bool`	Damage Condition
`origins_js:js_fluid_condition`	`registerFluidCondition`	`(fluidState, params) => bool`	Fluid Condition
`origins_js:js_power`	`powerBuilder(id).grant/.../...register()`	Builder: `.grant((holder, params) => ...)`	Power Types

HolderWrapper API

Available methods on the wrapper returned by OriginsJS.getHolder(entity):

Origin Management

See Origin JSON Format and Layer JSON Format for data structure details.

Method	Description
`setOrigin(layerId, originId)`	Assign an origin to a layer
`clearOrigin(layerId)`	Remove the origin from a layer
`hasOrigin(originId)`	Check if entity has the given origin (in any layer)
`hasOriginInLayer(layerId, originId)`	Check in a specific layer
`hasLayer(layerId)`	Check if the layer has any origin
`getOriginId(layerId)`	Get the origin ID string for a layer, or `null`
`getAllOrigins()`	Returns `[[layerId, originId], ...]`
`hasAllOrigins()`	Whether all layers are assigned
`fillAutoChoosing()`	Fill auto-choosing layers
`randomOrigin(layerId)`	Randomly assign an origin

Power Management

See Power JSON Format for data structure details. See /power command for command equivalents.

Method	Description
`grantPower(source, powerId)`	Grant a power from a source
`revokePower(source, powerId)`	Revoke a power from a source
`revokeAllPowers(source)`	Remove all powers from a source
`hasPower(powerId)`	Check whether the entity has a power
`hasPowerFromSource(source, powerId)`	Check from a specific source
`getAllPowerIds()`	List all power ID strings

Resource (Integer resource bar)

See Resource (Power Type) for the underlying power type.

Method	Description
`getResource(powerId)`	Get the current resource value
`setResource(powerId, value)`	Set the resource to a specific int
`addResource(powerId, delta)`	Add/subtract to the resource

Cooldown (Usage cooldown timer)

See Cooldown (Power Type) for the underlying power type.

Method	Description
`getCooldown(powerId)`	Get remaining cooldown ticks
`startCooldown(powerId)`	Start the cooldown
`canUseCooldown(powerId)`	Check whether the cooldown is ready

Entity Set (Per-power entity tracking set)

See Action On Set (Entity Action) and Set Size (Condition) for types that interact with entity sets.

Method	Description
`addToEntitySet(powerId, uuid)`	Add an entity (by UUID string)
`removeFromEntitySet(powerId, uuid)`	Remove an entity
`isInEntitySet(powerId, uuid)`	Check if an entity is in the set
`getEntitySetSize(powerId)`	Get the number of entities in the set
`getEntitySetMembers(powerId)`	Get all UUID strings in the set

Static Shortcut Methods

OriginsJS.getPlayerHolder(player)
OriginsJS.grantPower(entity, source, powerId)
OriginsJS.revokePower(entity, source, powerId)
OriginsJS.hasPower(entity, powerId)
OriginsJS.setOrigin(entity, layerId, originId)
OriginsJS.hasOrigin(entity, originId)
OriginsJS.powerBuilder("mypack:power").grant(...).tick(...).register()

// Resource
OriginsJS.getResource(entity, powerId)
OriginsJS.setResource(entity, powerId, value)
OriginsJS.addResource(entity, powerId, delta)

// Cooldown
OriginsJS.getCooldown(entity, powerId)
OriginsJS.startCooldown(entity, powerId)
OriginsJS.canUseCooldown(entity, powerId)

// Entity Set
OriginsJS.addToEntitySet(entity, powerId, uuid)
OriginsJS.removeFromEntitySet(entity, powerId, uuid)
OriginsJS.isInEntitySet(entity, powerId, uuid)
OriginsJS.getEntitySetSize(entity, powerId)

JS Action / Condition Types​

HolderWrapper API​

Origin Management​

Power Management​

Resource (Integer resource bar)​

Cooldown (Usage cooldown timer)​

Entity Set (Per-power entity tracking set)​

Static Shortcut Methods​