/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.
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
- Giving players on touch devices or controllers extra help aiming in a custom PvE arena.
- Adjusting the lock-on range when a player equips a specific custom weapon or class.
- Forcing a wide-angle aim assist during a third-person boss fight.
- Removing all aim assist effects when a player enters a competitive PvP zone or lobby.
Parameters
| Parameter | What it means |
|---|---|
players: target | The player or players to modify. Accepts player names or target selectors like @p, @a, @r, and @s. |
clear | Literal keyword. Removes active aim assist settings from the targeted players. |
set | Literal keyword. Enables or updates the aim assist settings for the targeted players. |
x angle: float | Optional 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: float | Optional 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: float | Optional float. The maximum distance in blocks that aim assist will reach to detect targets. If omitted, uses the preset's default distance. |
target mode: AimAssistTargetMode | Optional 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: string | Optional 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 setEnables aim assist for the player running the command using the default angles, distance, and preset.
/aimassist @s clearDisables aim assist for the player running the command.
/aimassist @a clearRemoves aim assist from all players currently on the server.
/aimassist @p set 45 45Enables aim assist for the nearest player with a 45-degree horizontal and vertical detection cone.
/aimassist @a set 60 45 10Sets 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 angleConfigures 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 distanceGives 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_defaultApplies 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 distanceEnables 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 clearClears 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
- Pair /aimassist with the /camera command using third-person presets (such as minecraft:follow_orbit) where aiming is naturally harder for players.
- Use tags and repeating command blocks to dynamically change a player's aim assist 'max distance' depending on whether they are holding a sword or a bow.
- When building competitive maps, place a repeating command block at the lobby or arena entrance running '/aimassist @a[r=10] clear' to ensure nobody retains campaign aim assist.
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.