Examples

Managing Origins & Powers

// Get the holder for a player or entity
let holder = OriginsJS.getHolder(event.player);

// Grant / revoke powers
holder.grantPower("origins:origin", "origins:fire_immunity");
holder.revokePower("origins:origin", "origins:climbing");

// Check powers
if (holder.hasPower("origins:fire_immunity")) {
    event.player.tell("You are immune to fire!");
}

// Set / check origins
holder.setOrigin("origins:origin", "origins:human");
if (holder.hasOrigin("origins:human")) {
    event.player.tell("You are a human.");
}

// Get origin in a layer
let originId = holder.getOriginId("origins:origin");

// Revoke all powers from a source
holder.revokeAllPowers("origins_js:script");

// Random origin for a layer
holder.randomOrigin("origins:origin");

// List all origins
holder.getAllOrigins().forEach(([layer, origin]) => {
    console.log(`Layer ${layer}: ${origin}`);
});

// Resource / Cooldown / Entity Set
holder.setResource("origins:climbing", 20);
holder.startCooldown("origins:fireball");
holder.addToEntitySet("mypack:friends", event.player.getStringUuid());

Custom Actions

// Entity Action — callback: (entity, params)
OriginsJS.registerEntityAction("mypack:greet", (entity, params) => {
    let msg = params.message || "Hello!";
    entity.tell(msg);
});

// Block Action — callback: (level, pos, direction, params)
OriginsJS.registerBlockAction("mypack:break_notify", (level, pos, dir, params) => {
    console.log(`Block at ${pos}, check: ${params.check}`);
});

// Item Action — callback: (level, entity, slotAccess, params)
OriginsJS.registerItemAction("mypack:modify", (level, entity, slot, params) => {
    let count = params.count || 1;
    let stack = slot.get();
    if (!stack.isEmpty()) stack.setCount(stack.getCount() + count);
});

// BiEntity Action — callback: (actor, target, params)
OriginsJS.registerBiEntityAction("mypack:splash", (actor, target, params) => {
    let duration = params.duration || 100;
    target.addEffect("minecraft:slowness", duration, 1);
});

JSON usage for custom actions:

{
    "type": "origins_js:js_entity_action",
    "id": "mypack:greet",
    "params": { "message": "Hi!" }
}

Custom Conditions

// Entity Condition — callback: (entity, params) => bool
OriginsJS.registerEntityCondition("mypack:low_health", (entity, params) => {
    let threshold = params.threshold || 10;
    return entity.health < threshold;
});

// Block Condition — callback: (level, pos, params) => bool
OriginsJS.registerBlockCondition("mypack:is_block", (level, pos, params) => {
    let blockId = params.block || "minecraft:air";
    return level.getBlockState(pos).is(blockId);
});

JSON usage for custom conditions:

{
    "type": "origins_js:js_entity_condition",
    "id": "mypack:low_health",
    "params": { "threshold": 5 }
}

Custom Powers

// All callbacks receive (holder, params) where params comes from JSON
OriginsJS.powerBuilder("mypack:custom_power")
    .grant((holder, params) => holder.getEntity().tell(params.msg || "Granted!"))
    .revoke((holder, params) => holder.getEntity().tell("Revoked!"))
    .tick((holder, params) => holder.getEntity().heal(params.amount || 0.5))
    .register();

JSON usage for custom powers:

{
    "type": "origins_js:js_power",
    "id": "mypack:custom_power",
    "name": "My Custom Power",
    "description": "A power defined in KubeJS scripts",
    "params": {
        "msg": "Hello custom power!",
        "amount": 1.0
    }
}