Class System

ReadonlyafterEvents

Readonly BetabeforeEvents

ReadonlycurrentTick

clearJob

• clearJob(jobId: number): void
  Beta

  Parameters

  • jobId: number

  Returns void

clearRun

• clearRun(runId: number): void

  Parameters

  • runId: number

  Returns void

  Remarks

  Cancels the execution of a function run that was previously scheduled via the run function.

  Example: clearRun.js

  const runId = system.run(() => {
      console.log("Running callback function...");
  });
  
  // Clear the run, so it will not run again.
  system.clearRun(runId);
  Copy

run

• run(callback: () => void): number

  Parameters

  • callback: () => void

    Function callback to run when the tickDelay time criteria is met.

  Returns number

  An opaque identifier that can be used with the clearRun function to cancel the execution of this run.

  Remarks

  Runs a specified function at a future time. This is frequently used to implement delayed behaviors and game loops.

  Example: trapTick.ts

    const overworld = mc.world.getDimension("overworld");
  
    try {
      // Minecraft runs at 20 ticks per second.
      if (mc.system.currentTick % 1200 === 0) {
        mc.world.sendMessage("Another minute passes...");
      }
    } catch (e) {
      console.warn("Error: " + e);
    }
  
    mc.system.run(trapTick);
  Copy

  Example: run.js

  const runId = system.run(() => {
      console.log("Running callback function...");
  });
  Copy

runInterval

• runInterval(callback: () => void, tickInterval?: number): number

  Parameters

  • callback: () => void

    Functional code that will run when this interval occurs.
  • OptionaltickInterval: number

    An interval of every N ticks that the callback will be called upon.

  Returns number

  An opaque handle that can be used with the clearRun method to stop the run of this function on an interval.

  Remarks

  Runs a set of code on an interval.

  Example: every30Seconds.ts

    let intervalRunIdentifier = Math.floor(Math.random() * 10000);
  
    mc.system.runInterval(() => {
      mc.world.sendMessage("This is an interval run " + intervalRunIdentifier + " sending a message every 30 seconds.");
    }, 600);
  Copy

runJob

• runJob(generator: Generator<void, void, void>): number
  Beta

  Parameters

  • generator: Generator<void, void, void>

  Returns number

runTimeout

• runTimeout(callback: () => void, tickDelay?: number): number

  Parameters

  • callback: () => void

    Functional code that will run when this timeout occurs.
  • OptionaltickDelay: number

    Amount of time, in ticks, before the interval will be called.

  Returns number

  An opaque handle that can be used with the clearRun method to stop the run of this function on an interval.

  Remarks

  Runs a set of code at a future time specified by tickDelay.

  Example: runTimeout.js

  import { TicksPerSecond } from "@minecraft/server";
  
  system.runTimeout(() => {
      console.log("Running callback function after delay...");
  }, TicksPerSecond * 5); // Tick delay of 5 seconds
  Copy