API Reference

const obj = ctx.objects.getById("some-id");
const obj = ctx.objects.getByName("Player");
const enemies = ctx.objects.findBy((o) => o.name.startsWith("Enemy"));
const first = ctx.objects.findFirst((o) => o.type === "box");
const all = ctx.objects.getAll();

const boxes = ctx.objects.query({ type: "box" });
const first = ctx.objects.queryFirst({ name: "Player" });
const count = ctx.objects.count();

ctx.objects.add(newObject);
ctx.objects.remove(id);
ctx.objects.move(id, newParentId);
ctx.objects.duplicate(id, parentId);

export function update(ctx) {
  if (ctx.input.keys.has("KeyW")) {
    // Move forward
  }
  if (ctx.input.keys.has("Space")) {
    // Jump
  }
}

export function update(ctx) {
  const { x, y } = ctx.input.mousePosition;

  if (ctx.input.mouseButtons.has(0)) {
    // Left click held
  }
}

export function update(ctx) {
  // Frame-rate independent movement
  const speed = 5;
  ctx.entity.position.x += speed * ctx.time.delta;

  // Time since game started
  console.log(ctx.time.elapsed);
}

// Read
const score = ctx.variables.score;

// Write
ctx.variables.score = 100;

// Watch changes
ctx.watchKey(ctx.variables, "score", (value) => {
  console.log("New score:", value);
});

// Send a message
ctx.send("game:over", { winner: "player1" });

// Receive messages
export function onMessage(ctx, message) {
  if (message.type === "game:over") {
    console.log(message.payload.winner);
  }
}

export function update(ctx) {
  // Access transform
  ctx.entity.position.x += 1 * ctx.time.delta;
  ctx.entity.rotation.y += 0.5 * ctx.time.delta;
  ctx.entity.scale.x = 2;
}