← Back to Command Directory ← Back to Home

/test

Manages and executes GameTests — automated test structures that verify game mechanics work correctly. Originally only available in development environments, now accessible during normal gameplay.

Syntax

/test run <test> [<rotationSteps>] [<testsPerRow>]
/test runmultiple <test> [<amount>]
/test runall [<namespace>] [<rotationSteps>] [<testsPerRow>]
/test runfailed [<rotationSteps>] [<testsPerRow>]
/test runthis
/test resetclosest
/test resetall
/test locate <test>
/test pos
/test create <test> [<width>] [<height>] [<depth>]
/test clearall [<radius>]

Parameters

Name	Required	Description
test	Varies	The namespaced identifier of the test to run, locate, or create.
rotationSteps	No	Number of 90° clockwise rotations to apply (0–3).
testsPerRow	No	How many tests to place per row when running multiple.
amount	No	Number of times to run the same test.
namespace	No	Run all tests in this namespace.
width/height/depth	No	Dimensions for a new test structure.
radius	No	Radius around the player to clear test structures.

Examples

/test run minecraft:minecart_test
/test runall
/test clearall 50

Notes

• Requires permission level 2.
• Originally added for internal testing; now accessible in Java Edition 1.21.2+ during normal gameplay.
• GameTests are defined in data packs and use structure templates to set up test conditions.
• Tests run automatically and report success or failure with visual indicators.

Related Commands

• /function
• /place
• /debug