MCC Island API - Docs

MCC Island API is a GraphQL API that provides access to public data from the MCC Island Minecraft server.

An API key is required. These can be generated on the Noxcrew Gateway website.
Any application using this API should send requests using an identifiable user-agent string, preferably including a way to contact you.
Ratelimits are enforced on a per-user basis, with the ratelimit being shown in the response headers (prefixed with X-Ratelimit).

Contact

Noxcrew

[email protected]

https://noxcrew.com

Terms of Service

https://noxcrew.com/terms-of-service

API Endpoints

https://api.mccisland.net/graphql

Headers

X-API-Key: <YOUR_API_KEY_HERE>

Queries

`nextRotation`

Description

Returns when this rotation will next rotate.

If the rotation is due the exact time this method is called, this method will return the next time that it will rotate.

Response

Returns a DateTime!

Arguments

Name	Description
`rotation` - `Rotation!`

Example

Query

query nextRotation($rotation: Rotation!) {
  nextRotation(rotation: $rotation)
}

Variables

{"rotation": "DAILY"}

Response

{
  "data": {
    "nextRotation": "1996-12-19T16:39:57-08:00"
  }
}

Queries

`player`

Description

Given a UUID, returns a Player if they have logged in to MCC Island.

Response

Returns a Player

Arguments

Name	Description
`uuid` - `UUID!`

Example

Query

query player($uuid: UUID!) {
  player(uuid: $uuid) {
    uuid
    username
    ranks
    mccPlusStatus {
      ...MCCPlusStatusFragment
    }
    crownLevel {
      ...CrownLevelFragment
    }
    status {
      ...StatusFragment
    }
    collections {
      ...CollectionsFragment
    }
    social {
      ...SocialFragment
    }
    statistics {
      ...StatisticsFragment
    }
  }
}

Variables

{
  "uuid": "6a085b2c-19fb-4986-b453-231aa942bbec"
}

Response

{
  "data": {
    "player": {
      "uuid": "6a085b2c-19fb-4986-b453-231aa942bbec",
      "username": "LadyAgnes",
      "ranks": ["CHAMP"],
      "mccPlusStatus": MCCPlusStatus,
      "crownLevel": CrownLevel,
      "status": Status,
      "collections": Collections,
      "social": Social,
      "statistics": Statistics
    }
  }
}

Queries

`playerByUsername`

Description

Given a username, returns a Player object if they have logged into MCC Island with this username.

This method may not return a player that has this username if they have not logged in recently enough for us to verify that the player still owns this username.

Response

Returns a Player

Arguments

Name	Description
`username` - `String!`

Example

Query

query playerByUsername($username: String!) {
  playerByUsername(username: $username) {
    uuid
    username
    ranks
    mccPlusStatus {
      ...MCCPlusStatusFragment
    }
    crownLevel {
      ...CrownLevelFragment
    }
    status {
      ...StatusFragment
    }
    collections {
      ...CollectionsFragment
    }
    social {
      ...SocialFragment
    }
    statistics {
      ...StatisticsFragment
    }
  }
}

Variables

{"username": "LadyAgnes"}

Response

{
  "data": {
    "playerByUsername": {
      "uuid": "6a085b2c-19fb-4986-b453-231aa942bbec",
      "username": "LadyAgnes",
      "ranks": ["CHAMP"],
      "mccPlusStatus": MCCPlusStatus,
      "crownLevel": CrownLevel,
      "status": Status,
      "collections": Collections,
      "social": Social,
      "statistics": Statistics
    }
  }
}

Queries

`previousRotation`

Description

Returns when this rotation last rotated.

If the rotation is due the exact time this method is called, this method will return the current time.

Response

Returns a DateTime!

Arguments

Name	Description
`rotation` - `Rotation!`

Example

Query

query previousRotation($rotation: Rotation!) {
  previousRotation(rotation: $rotation)
}

Variables

{"rotation": "DAILY"}

Response

{
  "data": {
    "previousRotation": "1996-12-19T16:39:57-08:00"
  }
}

Queries

`statistic`

Description

Returns a statistic by it's name.

Response

Returns a Statistic

Arguments

Name	Description
`key` - `String!`

Example

Query

query statistic($key: String!) {
  statistic(key: $key) {
    key
    forLeaderboard
    rotations
    leaderboard {
      ...LeaderboardEntryFragment
    }
  }
}

Variables

{"key": "games_played"}

Response

{
  "data": {
    "statistic": {
      "key": "games_played",
      "forLeaderboard": false,
      "rotations": ["DAILY"],
      "leaderboard": [LeaderboardEntry]
    }
  }
}

Queries

`statistics`

Description

Returns a list of all known statistics.

Response

Returns [Statistic!]!

Example

Query

query statistics {
  statistics {
    key
    forLeaderboard
    rotations
    leaderboard {
      ...LeaderboardEntryFragment
    }
  }
}

Response

{
  "data": {
    "statistics": [
      {
        "key": "games_played",
        "forLeaderboard": true,
        "rotations": ["DAILY"],
        "leaderboard": [LeaderboardEntry]
      }
    ]
  }
}

Types

Boolean

Description

The Boolean scalar type represents true or false.

Example

true

Types

Collections

Description

Collections data.

Fields

Field Name	Description
`currency` - `Currency!`	The player's earned currency.
`equippedCosmetics` - `[Cosmetic!]!`	A list of cosmetics the player currently has equipped.
`cosmetics` - `[CosmeticOwnershipState!]!`	Returns the ownership state of all cosmetics, optionally in a category and/or collection.
Arguments `category` - `CosmeticCategory` `collection` - `String`
`fish` - `[FishRecord!]!`	Returns the record data for all fish, optionally in a specific collection.
Arguments `collection` - `String`

Example

{
  "currency": Currency,
  "equippedCosmetics": [Cosmetic],
  "cosmetics": [CosmeticOwnershipState],
  "fish": [FishRecord]
}

Types

Cosmetic

Description

A cosmetic.

Fields

Field Name	Description
`name` - `String!`	The name of the cosmetic.
`category` - `CosmeticCategory!`	The category the cosmetic is in.
`collection` - `String!`	The collection this cosmetic is in.
`rarity` - `Rarity!`	The rarity of the cosmetic.
`colorable` - `Boolean!`	If this cosmetic can be colored using Chroma Packs.
`trophies` - `Int!`	The number of trophies this cosmetic awards. Note that this does not include the completion bonus for applying all Chroma Packs to the cosmetic.
`isBonusTrophies` - `Boolean`	If this cosmetic awards bonus trophies. This will be `null` if the cosmetic does not award any trophies.
`canBeDonated` - `Boolean!`	If this cosmetic can be donated for Royal Reputation.

Example

{
  "name": "xyz789",
  "category": "HAT",
  "collection": "abc123",
  "rarity": "COMMON",
  "colorable": false,
  "trophies": 987,
  "isBonusTrophies": false,
  "canBeDonated": true
}

Types

CosmeticCategory

Description

Different categories of cosmetics.

Values

Enum Value	Description
`HAT`	Hats.
`HAIR`	Hair.
`ACCESSORY`	Accessories.
`AURA`	Auras.
`TRAIL`	Trails.
`CLOAK`	Cloaks.
`ROD`	Fishing rods.

Example

"HAT"

Types

CosmeticOwnershipState

Description

The ownership state of a cosmetic.

Fields

Field Name	Description
`cosmetic` - `Cosmetic!`	The cosmetic in question.
`owned` - `Boolean!`	If the cosmetic is owned.
`chromaPacks` - `[String!]`	The Chroma Packs that have applied to this cosmetic, if it is colorable.
`donationsMade` - `Int`	The number of Royal Reputation donations that have been made of this cosmetic, if it can be donated.

Example

{
  "cosmetic": Cosmetic,
  "owned": true,
  "chromaPacks": ["oceanic", "natural"],
  "donationsMade": 123
}

Types

CrownLevel

Description

A Crown Level and associated trophy data.

Fields

Field Name	Description
`level` - `Int!`	The overall Crown Level. Use levelData instead.
`evolution` - `Int!`	The zero-indexed evolution of the crown. Use levelData instead.
`nextEvolutionLevel` - `Int`	The next level that the crown will evolve, if any. Use levelData instead.
`nextLevelProgress` - `ProgressionData`	The progress the player is making towards their next level, if any. Use levelData instead.
`levelData` - `LevelData!`	The overall level data.
`fishingLevelData` - `LevelData!`	The fishing level data.
`trophies` - `TrophyData!`	The amount of trophies the player has.
Arguments `category` - `TrophyCategory`

Example

{
  "level": 987,
  "evolution": 123,
  "nextEvolutionLevel": 987,
  "nextLevelProgress": ProgressionData,
  "levelData": LevelData,
  "fishingLevelData": LevelData,
  "trophies": TrophyData
}

Types

Currency

Description

A player's earned currency.

Fields

Field Name	Description
`coins` - `Int!`	The number of coins the player currently has.
`gems` - `Int!`	The number of gems the player currently has. Deprecated for removal. Will always return 0 until removal.
`royalReputation` - `Int!`	The number of Royal Reputation the player currently has.
`silver` - `Int!`	The number of silver the player currently has.
`materialDust` - `Int!`	The number of material dust the player currently has.
`anglrTokens` - `Int!`	The number of A.N.G.L.R. Tokens the player currently has.

Example

{
  "coins": 123,
  "gems": 123,
  "royalReputation": 987,
  "silver": 987,
  "materialDust": 987,
  "anglrTokens": 123
}

Types

Date

Description

An RFC-3339 compliant date.

Example

"1996-12-19"

Types

DateTime

Description

An RFC-3339 compliant date time.

Example

"1996-12-19T16:39:57-08:00"

Types

Fish

Description

A fish.

Fields

Field Name	Description
`name` - `String!`	The name of the fish.
`climate` - `String!`	The climate this fish can be found in.
`collection` - `String!`	The collection this fish can be found in.
`rarity` - `Rarity!`	The rarity of the fish.
`catchTime` - `FishCatchTime!`	The time this fish can be caught.
`elusive` - `Boolean!`	If this fish is elusive.
`trophies` - `Int`	The number of trophies awarded for catching this fish in a given weight.
Arguments `weight` - `FishWeight!`

Example

{
  "name": "Midnight Tang",
  "climate": "Temperate",
  "collection": "Dark Grove",
  "rarity": "COMMON",
  "catchTime": "ALWAYS",
  "elusive": true,
  "trophies": 123
}

Types

FishCatchTime

Description

The time a fish can be caught in.

Values

Enum Value	Description
`ALWAYS`	The fish can always be caught.
`DAY`	The fish can only be caught during daytime.
`NIGHT`	The fish can only be caught during nighttime.

Example

"ALWAYS"

Types

FishCaughtWeight

Description

Data about a caught fish weight.

Fields

Field Name	Description
`weight` - `FishWeight!`	The weight that was caught.
`firstCaught` - `Date!`	When the player first caught this weight.

Example

{
  "weight": "AVERAGE",
  "firstCaught": "1996-12-19"
}

Types

FishRecord

Description

A record of the weight of fish that have been caught.

Fields

Field Name	Description
`fish` - `Fish!`	The fish this record is for.
`weights` - `[FishCaughtWeight!]!`	A list of data about the weights that have been caught.

Example

{
  "fish": Fish,
  "weights": [FishCaughtWeight]
}

Types

FishWeight

Description

The weight of a fish.

Note that some weights are not used for crabs, or are only used for crabs.

Values

Enum Value	Description
`AVERAGE`	Average.
`LARGE`	Large.
`MASSIVE`	Massive. This weight is not used for crabs.
`GARGANTUAN`	Gargantuan. This weight is not used for crabs.
`COLOSSAL`	Colossal. This weight is only used for crabs.

Example

"AVERAGE"

Types

Game

Description

A game.

Values

Enum Value	Description
`HOLE_IN_THE_WALL`	Hole in the Wall.
`TGTTOS`	To Get To The Other Side (TGTTOS).
`BATTLE_BOX`	Battle Box.
`SKY_BATTLE`	Sky Battle.
`PARKOUR_WARRIOR`	Parkour Warrior.
`DYNABALL`	Dynaball.
`ROCKET_SPLEEF`	Rocket Spleef.

Example

"HOLE_IN_THE_WALL"

Types

Int

Description

The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

Example

Types

LeaderboardEntry

Description

An entry in a leaderboard.

Fields

Field Name Description

Field Name	Description
`player` - `Player`	The player who has this entry. This will be `null` if the player does not have the statistics enabled for the API. However, for Crown Level or Trophy count leaderboards, the player will not be `null`.
`rank` - `Int!`	The rank for this entry.
`value` - `Int!`	The value for this entry.

player - Player

The player who has this entry.

This will be null if the player does not have the statistics enabled for the API. However, for Crown Level or Trophy count leaderboards, the player will not be null.

rank - Int! The rank for this entry.

value - Int! The value for this entry.

Example

{"player": Player, "rank": 987, "value": 123}

Types

LevelData

Description

Data relating to a level.

Fields

Field Name	Description
`level` - `Int!`	The overall level.
`evolution` - `Int!`	The zero-indexed evolution of the level.
`nextEvolutionLevel` - `Int`	The next level that will have an evolution, if any.
`nextLevelProgress` - `ProgressionData`	The progress the player is making towards their next level, if any.

Example

{
  "level": 987,
  "evolution": 987,
  "nextEvolutionLevel": 987,
  "nextLevelProgress": ProgressionData
}

Types

MCCPlusStatus

Description

The status of a player's MCC+ subscription.

Fields

Field Name	Description
`evolution` - `Int!`	The current evolution index for MCC+ icon.
`streakStart` - `DateTime!`	The instant they started their current streak.
`totalDays` - `Int!`	The total number of days they have been subscribed for.

Example

{
  "evolution": 123,
  "streakStart": "1996-12-19T16:39:57-08:00",
  "totalDays": 123
}

Types

Party

Description

A player's status within a party.

Fields

Field Name	Description
`active` - `Boolean!`	Whether the player is in an active party.
`leader` - `Player`	The leader of the party, populated if the party exists.
`members` - `[Player!]`	The members of the party, populated if the party exists.

Example

{
  "active": false,
  "leader": Player,
  "members": [Player]
}

Types

Player

Description

A player who has logged in to MCC Island.

Fields

Field Name	Description
`uuid` - `UUID!`	The player's Minecraft UUID in dashed format.
`username` - `String`	The player's username, if known.
`ranks` - `[Rank!]!`	The ranks which the user is associated with, if any.
`mccPlusStatus` - `MCCPlusStatus`	The player's MCC+ status, if currently subscribed.
`crownLevel` - `CrownLevel!`	The player's Crown Level and associated trophy data.
`status` - `Status`	The current status of the player. This method is conditional on the player having the in-game "status" API setting enabled.
`collections` - `Collections`	Collections data for the player. This method is conditional on the player having the in-game "collections" API setting enabled.
`social` - `Social`	Social data for the player. This method is conditional on the player having the in-game "social" API setting enabled.
`statistics` - `Statistics`	Statistics data for the player. This method is conditional on the player having the in-game "statistics" API setting enabled.

Example

{
  "uuid": "6a085b2c-19fb-4986-b453-231aa942bbec",
  "username": "LadyAgnes",
  "ranks": ["CHAMP"],
  "mccPlusStatus": MCCPlusStatus,
  "crownLevel": CrownLevel,
  "status": Status,
  "collections": Collections,
  "social": Social,
  "statistics": Statistics
}

Types

ProgressionData

Description

Data for types that track some form of progression.

Fields

Field Name	Description
`obtained` - `Int!`	The amount obtained.
`obtainable` - `Int!`	The amount that can be obtained.

Example

{"obtained": 123, "obtainable": 123}

Types

Rank

Description

A rank.

Values

Enum Value	Description
`CHAMP`	The Champ rank.
`GRAND_CHAMP`	The Grand Champ rank.
`GRAND_CHAMP_ROYALE`	The Grand Champ Royale rank.
`CREATOR`	The Creator rank.
`CONTESTANT`	The Contestant rank.
`MODERATOR`	The Moderator rank.
`NOXCREW`	The Noxcrew rank.

Example

"CHAMP"

Types

Rarity

Description

Different tiers of rarity.

Values

Enum Value	Description
`COMMON`	Common.
`UNCOMMON`	Uncommon.
`RARE`	Rare.
`EPIC`	Epic.
`LEGENDARY`	Legendary.
`MYTHIC`	Mythic.

Example

"COMMON"

Types

Rotation

Description

A rotation period.

Each period resets at 10AM UTC.

Values

Enum Value	Description
`DAILY`	A daily rotation that resets.
`WEEKLY`	A weekly rotation that resets on Tuesdays.
`MONTHLY`	A monthly rotation that resets on the first day of every month.
`YEARLY`	A yearly rotation that resets on the first day of every year.
`LIFETIME`	A lifetime rotation; a rotation period used to indicate something never rotates.

Example

"DAILY"

Types

Server

Description

A server on the network.

Fields

Field Name	Description
`category` - `ServerCategory!`	The category of the server.
`subType` - `String!`	The sub-type of the server that can hold additional information about the server.
`associatedGame` - `Game`	The game associated with this server, if any.

Example

{"category": "GAME", "subType": "daily", "associatedGame": "PARKOUR_WARRIOR"}

Types

ServerCategory

Description

The category of a server.

Values

Enum Value	Description
`LOBBY`	A lobby server.
`GAME`	A game server.
`LIMBO`	A limbo server.
`QUEUE`	A queue server

Example

"LOBBY"

Types

Social

Description

Social data.

Fields

Field Name	Description
`friends` - `[Player!]!`	A list of the player's friends.
`party` - `Party!`	The player's party.

Example

{
  "friends": [Player],
  "party": Party
}

Types

Statistic

Description

A statistic.

Fields

Field Name	Description
`key` - `String!`	The key of the statistic.
`forLeaderboard` - `Boolean!`	If this statistic generates leaderboards.
`rotations` - `[Rotation!]!`	The rotations for which this statistic is tracked. These are the rotations that can be used to generate leaderboards or fetch rotation values. Note that the `YEARLY` rotation never generates leaderboards, even if it is returned in this list.
`leaderboard` - `[LeaderboardEntry!]`	Returns the leaderboard for this statistic in a given rotation. If this statistic does not generate leaderboards, or the statistic is not tracked for the provided rotation, this will return `null`.
Arguments `rotation` - `Rotation!` `amount` - `Int!`

Example

{
  "key": "games_played",
  "forLeaderboard": true,
  "rotations": ["DAILY"],
  "leaderboard": [LeaderboardEntry]
}

Types

Statistics

Description

Statistic-related data.

Fields

Field Name Description

Field Name	Description
`rotationValue` - `Int`	Returns the value stored for the given statistic in a rotation. The returned number will be `null` if the statistic does not track in the provided rotation, or if the statistic doesn't exist.
Arguments `statisticKey` - `String!` `rotation` - `Rotation!`

rotationValue - Int

Returns the value stored for the given statistic in a rotation.

The returned number will be null if the statistic does not track in the provided rotation, or if the statistic doesn't exist.

Arguments

`statisticKey` - `String!`

`rotation` - `Rotation!`

Example

{"rotationValue": 123}

Types

Status

Description

A player's current status.

Fields

Field Name	Description
`online` - `Boolean!`	Whether the player is online or not.
`server` - `Server`	The player's current server, populated if they are online.
`firstJoin` - `DateTime`	When the player first joined MCC Island, if known.
`lastJoin` - `DateTime`	When the player most recently joined MCC Island, if known.

Example

{
  "online": false,
  "server": Server,
  "firstJoin": "1996-12-19T16:39:57-08:00",
  "lastJoin": "1996-12-19T16:39:57-08:00"
}

Types

String

Description

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

Example

"xyz789"

Types

TrophyCategory

Description

The categories for trophies.

Values

Enum Value	Description
`STYLE`	Style trophies.
`SKILL`	Skill trophies.
`ANGLER`	Angler trophies.

Example

"STYLE"

Types

TrophyData

Description

Data on the amount of trophies a user has/can have.

Fields

Field Name	Description
`obtained` - `Int!`	The amount of trophies obtained.
`obtainable` - `Int!`	The maximum amount of trophies that can be obtained.
`bonus` - `Int!`	The amount of bonus trophies.

Example

{"obtained": 123, "obtainable": 987, "bonus": 987}

Types

UUID

Description

A player's UUID.

Example

"6a085b2c-19fb-4986-b453-231aa942bbec"

MCC Island API - Docs

Contact

Terms of Service

API Endpoints

Headers

Queries

nextRotation

Description

Response

Arguments

Example

Query

Variables

Response

player

Description

Response

Arguments

Example

Query

Variables

Response

playerByUsername

Description

Response

Arguments

Example

Query

Variables

Response

previousRotation

Description

Response

Arguments

Example

Query

Variables

Response

statistic

Description

Response

Arguments

Example

Query

Variables

Response

statistics

Description

Response

Example

Query

Response

Types

Boolean

Description

Example

Collections

Description

Fields

Arguments

category - CosmeticCategory

collection - String

Arguments

collection - String

Example

Cosmetic

Description

Fields

Example

CosmeticCategory

Description

Values

Example

CosmeticOwnershipState

Description

Fields

Example

CrownLevel

Description

Fields

`nextRotation`

`player`

`playerByUsername`

`previousRotation`

`statistic`

`statistics`

`category` - `CosmeticCategory`

`collection` - `String`

`collection` - `String`

`category` - `TrophyCategory`

`weight` - `FishWeight!`