Minecraft /test Command

Data packs and command blocks

Starts game tests from a data pack — builds with checks to ensure mechanisms work.

  • rights — game master
  • Minecraft 26.3
My Game select version

Save your preferences in this browser and apply them to supported tools. Settings in a shared link take priority. Wiki version labels are not affected.

On this page 6 sections

At a glance

Examples have been tested in the game — copy

  • Nearest test
    /test runclosest
  • Remove all tests
    /test clearall

Permissions — game master.

Syntax

The game itself shows this in /help test: in angular brackets — what to substitute, in square brackets — optional, separated by a slash — one of.

  • /test run <tests> [<numberOfTimes>]
  • /test runmultiple <tests> [<amount>]
  • /test runthese [<numberOfTimes>]
  • /test runclosest [<numberOfTimes>]
  • /test runthat [<numberOfTimes>]
  • /test runfailed [<onlyRequiredTests>|<numberOfTimes>]
  • /test verify <tests>
  • /test locate <tests>
  • /test resetclosest
  • /test resetthese
  • /test resetthat
  • /test clearthat
  • /test clearthese
  • /test clearall [<radius>]
  • /test stop
  • /test pos [<var>]
  • /test create <id> [<width>]

Permissions

A 'Game Master' level is required: Operator level 2 — for team blocks, data pack functions, and guests on a public world with allowed commands. In the server console, it is written without a slash.

Numbers

WhatValue
The command/test
PermissionsGame master (2)
Where it isOn the server and in single-player with cheats enabled
Subcommandsclearall, clearthat, clearthese, create, locate, pos, resetclosest, resetthat, resetthese, run, runclosest, runfailed, runmultiple, runthat, runthese, stop, verify

Frequently asked questions

How do I use /test?

Syntax: /test run <tests> [<numberOfTimes>]. For example, /test runclosest — runs the closest test.

What permissions are needed for /test?

An game master level is required: operator level 2 — in command blocks, data pack functions, and guests in a world open to the network with allowed commands.

Does /test work in a command block?

Yes: a Command Block executes commands with level 2 permission, and that's all required. The slash is not needed in the block.

More: data packs and command blocks

Minecraft 26.3 data: syntax — from the game's /help hint, permissions — from command report, each example verified by command parsing.