/aimassist

The /aimassist command configures or clears camera targeting assistance for players. It allows map makers to define detection cones, maximum lock-on distances, and target prioritization modes. This command requires cheats to be enabled and works best when paired with a third-person camera preset.

Operator (cheats on)Cheats must be onChecked on 1.26.66.1

Syntax

Exactly as the game prints it. <angle brackets> are required, [square brackets] are optional.

/aimassist <players: target> clear
/aimassist <players: target> set [x angle: float] [y angle: float] [max distance: float] [target mode: AimAssistTargetMode] [preset id: string]

What it is used for

Parameters

ParameterWhat it means
players: targetThe player or players to modify. Accepts player names or target selectors like @p, @a, @r, and @s.
clearLiteral keyword. Removes active aim assist settings from the targeted players.
setLiteral keyword. Enables or updates the aim assist settings for the targeted players.
x angle: floatOptional float. The horizontal width angle (in degrees) in front of the player where targets are detected. If omitted, uses the preset's default angle.
y angle: floatOptional float. The vertical height angle (in degrees) in front of the player where targets are detected. If omitted, uses the preset's default angle.
max distance: floatOptional float. The maximum distance in blocks that aim assist will reach to detect targets. If omitted, uses the preset's default distance.
target mode: AimAssistTargetModeOptional mode for how the game picks the best target. Accepted values are 'distance' (prioritizes the closest target) or 'angle' (prioritizes the target closest to the crosshair). Defaults to the preset configuration if omitted.
preset id: stringOptional string. The namespaced ID of the aim assist preset from a behavior pack (for example, minecraft:aim_assist_default). If omitted, uses the built-in default preset.

Examples

Every example below was sent to a real Bedrock Dedicated Server (1.26.66.1) and accepted by the game.

/aimassist @s set

Enables aim assist for the player running the command using the default angles, distance, and preset.

/aimassist @s clear

Disables aim assist for the player running the command.

/aimassist @a clear

Removes aim assist from all players currently on the server.

/aimassist @p set 45 45

Enables aim assist for the nearest player with a 45-degree horizontal and vertical detection cone.

/aimassist @a set 60 45 10

Sets aim assist for all players with a 60-degree horizontal angle, 45-degree vertical angle, and a 10-block reach.

/aimassist @p set 30 30 16 angle

Configures aim assist for the nearest player up to 16 blocks away, prioritizing targets closest to the center of the screen.

/aimassist @a[tag=melee] set 90 60 5 distance

Gives all players with the 'melee' tag a wide, short-range aim assist that locks onto the closest target.

/aimassist @s set 40 40 12 angle minecraft:aim_assist_default

Applies the vanilla default aim assist preset to the executing player with custom angles, a 12-block range, and angle priority.

/execute as @a[m=a] at @s if block ~ ~-1 ~ grass_block run aimassist @s set 50 50 8 distance

Enables an 8-block distance-based aim assist for any adventure mode player currently standing on a grass block.

/execute as @a[scores={pvp_zone=1}] run aimassist @s clear

Clears aim assist for any player whose 'pvp_zone' scoreboard objective is set to 1.

Accepted values

AimAssistTargetMode

distanceangle

Common mistakes

Trying to target non-player entities like @e[type=armor_stand] or @e[type=zombie].

Only target players. Use @p, @a, @r, @s (when executed by a player), or @e[type=player].

Syntax error when trying to specify 'target mode' without providing the angle and distance numbers first.

Optional parameters must be filled in order from left to right. You must enter values for x angle, y angle, and max distance before you can specify the target mode.

Typing an invalid target mode like 'nearest' or 'crosshair'.

Use only the two accepted enum values: 'distance' or 'angle'.

Entering a custom preset ID that is not loaded in the world's active behavior packs.

Check the identifier in your behavior pack's aim_assist folder, or omit the preset ID to use the vanilla default.

Tips

Questions about /aimassist

What is the difference between the 'distance' and 'angle' target modes?

The 'distance' mode prioritizes the target that is physically closest to your character in blocks. The 'angle' mode prioritizes the target that is closest to the center of your camera view or crosshair.

Can I use /aimassist on mobs to make them aim better?

No. The target selector only accepts players. It controls the player's camera and targeting behavior, not mob AI.

How do I turn aim assist back off?

Run the command '/aimassist <player> clear'. This immediately removes the active aim assist settings from the targeted player.

More from 9Minecraft

Command reference © 2026 9Minecraft.net. Syntax read from Minecraft Bedrock Edition 1.26.66.1.