# randomMove(for:fromNumberOfBestMoves:) Computes several of the best possible moves for the specified player, and returns a move randomly selected from among them. ``` func randomMove(for player: any GKGameModelPlayer, fromNumberOfBestMoves numMovesToConsider: Int) -> (any GKGameModelUpdate)? ``` ## Parameters `player` The player for whom the strategist should plan a move. This object must be in the current game model’s [`players`](/documentation/GameplayKit/GKGameModel/players) array. `numMovesToConsider` The number of moves from which to randomize the selection. ## Return Value An object describing the move found by the strategist. ## Discussion This method looks ahead at the possible moves for the specified player, as well as possible future moves by other players on subsequent turns (according to the [`maxLookAheadDepth`](/documentation/GameplayKit/GKMinmaxStrategist/maxLookAheadDepth) property) and examines the state of the game model resulting from each possible move. Your game model class provides a score for each state in its [`score(for:)`](/documentation/GameplayKit/GKGameModel/score(for:)) method, allowing the strategist to find and rank sequences of future moves that maximize the score for the specified player. This method then returns a random selection representing the first move in one of the most highly ranked sequences. The object returned is an instance of your custom class implementing the [`GKGameModelUpdate`](/documentation/GameplayKit/GKGameModelUpdate) protocol. This object was created in your game model’s [`gameModelUpdates(for:)`](/documentation/GameplayKit/GKGameModel/gameModelUpdates(for:)) method, describing in your game’s terms a possible move—examine that information to make use of the strategist’s selection. For example, you could implement a computer-controlled player by performing the selected move. If the [`randomSource`](/documentation/GameplayKit/GKStrategist/randomSource) property is `nil`, this method does not randomize its selection, but instead behaves identically to the [`bestMove(for:)`](/documentation/GameplayKit/GKMinmaxStrategist/bestMove(for:)) method. This method returns `nil` if the specified player is invalid or has no available moves. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)