---
title: "gameModelUpdates(for:)"
framework: gameplaykit
role: symbol
role_heading: Instance Method
path: "gameplaykit/gkgamemodel/gamemodelupdates(for:)"
---

# gameModelUpdates(for:)

Returns the set of moves available to the specified player.

## Declaration

```swift
func gameModelUpdates(for player: any GKGameModelPlayer) -> [any GKGameModelUpdate]?
```

## Parameters

- `player`: An instance of your game’s player class (a custom class implementing the doc://com.apple.gameplaykit/documentation/GameplayKit/GKGameModelPlayer protocol) representing the player whose moves are to be evaluated.

## Return Value

Return Value An array of instances of your game’s move class (a custom class implementing the GKGameModelUpdate protocol), each representing a possible move for the specified player.

## Discussion

Discussion Your implementation of the GKGameModelUpdate protocol, or move class, should add properties or methods that describe a move in terms of your game. In this method, you create one instance of your move class for each move currently allowed to the specified player, filling in each instance’s custom properties with the information that describes that move. GameplayKit calls this method to speculate about possible future moves and their effects, using a copy of the active game board. For example, in a Tic-Tac-Toe game, the move class would identify which of the nine spaces on the board to place a mark in. Your gameModelUpdates(for:) method would create an instance of the move class for each space not already marked. Your implementation should also take into account whether any moves are possible at all—if the game has already been won or has resulted in a draw, this method should return nil. This method should return nil if the specified player is not valid or if no moves are available to that player. note: If the current game model represents an end state for the game—that is, if one player has won, or if the game has resulted in a draw—return nil to indicate that the strategist should not attempt to plan further moves.

## See Also

### Evaluating a Game Model

- [score(for:)](gameplaykit/gkgamemodel/score(for:).md)
- [isLoss(for:)](gameplaykit/gkgamemodel/isloss(for:).md)
- [isWin(for:)](gameplaykit/gkgamemodel/iswin(for:).md)