---
title: GKScore
framework: gamekit
role: symbol
role_heading: Class
path: gamekit/gkscore
---

# GKScore

An object containing information for a score that was earned by the player.

## Declaration

```swift
class GKScore
```

## Overview

Overview important: Your game must initialize a local player before you can use any Game Center classes. If there is no initialized player, your game receives a GKError.Code.notAuthenticated error. For more information, see Authenticating a player. Your game creates GKScore objects to post scores to a leaderboard on Game Center. When your game retrieves score information from a leaderboard, those scores are returned as GKScore objects. Scores and leaderboards work together to help you create a better game. Whenever a new GKScore object is created, it is associated with a leaderboard. You must ensure that the score being sent to a leaderboard is compatible with the leaderboard scoring format set in App Store Connect. See Leaderboards and Leaderboard Sets for information on how to create a leaderboard in App Store Connect. To report a score to Game Center, your game allocates and initializes a new object, sets the value property to the score the player earned, and then calls the report(completionHandler:) method. The mechanism your game uses to calculate scores is up to you to design; scores are only compared within your game.

## Topics

### Reporting a New Score

- [report(_:withEligibleChallenges:withCompletionHandler:)](gamekit/gkscore/report(_:witheligiblechallenges:withcompletionhandler:)-2tycl.md)
- [report(_:withCompletionHandler:)](gamekit/gkscore/report(_:withcompletionhandler:).md)
- [report(_:withEligibleChallenges:withCompletionHandler:)](gamekit/gkscore/report(_:witheligiblechallenges:withcompletionhandler:)-3c5lh.md)

### Issuing a Score Challenge

- [challengeComposeController(withMessage:players:completion:)](gamekit/gkscore/challengecomposecontroller(withmessage:players:completion:).md)
- [GKChallengeComposeHandler](gamekit/gkchallengecomposehandler.md)
- [challengeComposeController(withMessage:players:completionHandler:)](gamekit/gkscore/challengecomposecontroller(withmessage:players:completionhandler:).md)
- [challengeComposeController(withPlayers:message:completionHandler:)](gamekit/gkscore/challengecomposecontroller(withplayers:message:completionhandler:).md)

### Deprecated Methods and Properties

- [category](gamekit/gkscore/category.md)
- [context](gamekit/gkscore/context.md)
- [date](gamekit/gkscore/date.md)
- [formattedValue](gamekit/gkscore/formattedvalue.md)
- [leaderboardIdentifier](gamekit/gkscore/leaderboardidentifier.md)
- [player](gamekit/gkscore/player.md)
- [rank](gamekit/gkscore/rank.md)
- [value](gamekit/gkscore/value.md)
- [shouldSetDefaultLeaderboard](gamekit/gkscore/shouldsetdefaultleaderboard.md)
- [init(leaderboardIdentifier:)](gamekit/gkscore/init(leaderboardidentifier:).md)
- [init(leaderboardIdentifier:player:)](gamekit/gkscore/init(leaderboardidentifier:player:).md)
- [init(category:)](gamekit/gkscore/init(category:).md)
- [init(leaderboardIdentifier:forPlayer:)](gamekit/gkscore/init(leaderboardidentifier:forplayer:).md)
- [issueChallenge(toPlayers:message:)](gamekit/gkscore/issuechallenge(toplayers:message:).md)
- [playerID](gamekit/gkscore/playerid.md)
- [report(completionHandler:)](gamekit/gkscore/report(completionhandler:).md)

### Initializers

- [init(coder:)](gamekit/gkscore/init(coder:).md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSCoding](foundation/nscoding.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [NSSecureCoding](foundation/nssecurecoding.md)

## See Also

### Deprecated classes

- [GKAchievementViewController](gamekit/gkachievementviewcontroller.md)
- [GKChallengeEventHandler](gamekit/gkchallengeeventhandler.md)
- [GKChallengesViewController](gamekit/gkchallengesviewcontroller.md)
- [GKChallenge](gamekit/gkchallenge.md)
- [GKScoreChallenge](gamekit/gkscorechallenge.md)
- [GKAchievementChallenge](gamekit/gkachievementchallenge.md)
- [GKCloudPlayer](gamekit/gkcloudplayer.md)
- [GKGameCenterViewController](gamekit/gkgamecenterviewcontroller.md)
- [GKGameSession](gamekit/gkgamesession.md)
- [GKGameSessionSharingViewController](gamekit/gkgamesessionsharingviewcontroller.md)
- [GKFriendRequestComposeViewController](gamekit/gkfriendrequestcomposeviewcontroller.md)
- [GKLeaderboardViewController](gamekit/gkleaderboardviewcontroller.md)
- [GKPeerPickerController](gamekit/gkpeerpickercontroller.md)
- [GKSession](gamekit/gksession.md)
- [GKTurnBasedEventHandler](gamekit/gkturnbasedeventhandler.md)