feature: Cosmetics and ownership state

schema.graphqls

@@ -142,6 +142,25 @@ type Social {
 type Collections {
     "The player's earned currency."
     currency: Currency!
+
+    "Returns the ownership state of all cosmetics, optionally in a category and/or collection."
+    cosmetics(
+        category: CosmeticCategory = null,
+        collection: String = null
+        @spectaql(options: { key: "example", value: "oceanic" })
+    ): [CosmeticOwnershipState!]!
+}
+
+"The ownership state of a cosmetic."
+type CosmeticOwnershipState {
+    "The cosmetic in question."
+    cosmetic: Cosmetic!
+
+    "If the cosmetic is owned."
+    owned: Boolean!
+
+    "The Chroma Packs that have applied to this cosmetic, if it is colorable."
+    chromaPacks: [String!]
 }
 
 "A player's earned currency."
@@ -160,7 +179,7 @@ type Currency {
 
     "The number of material dust the player currently has."
     materialDust: Int!
-    
+
     "The number of A.N.G.L.R. Tokens the player currently has."
     anglrTokens: Int!
 }
@@ -343,6 +362,63 @@ enum Rotation {
     LIFETIME
 }
 
+"Different categories of cosmetics."
+enum CosmeticCategory {
+    "Hats."
+    HAT
+
+    "Accessories."
+    ACCESSORY
+
+    "Auras."
+    AURA
+
+    "Trails."
+    TRAIL
+
+    "Cloaks."
+    CLOAK
+
+    "Fishing rods."
+    ROD
+}
+
+"Different tiers of rarity."
+enum Rarity {
+    "Common."
+    COMMON
+
+    "Uncommon."
+    UNCOMMON
+
+    "Rare."
+    RARE
+
+    "Epic."
+    EPIC
+
+    "Legendary."
+    LEGENDARY
+
+    "Mythic."
+    MYTHIC
+}
+
+"A cosmetic."
+type Cosmetic {
+    "The name of the cosmetic."
+    name: String!
+
+    "The category the cosmetic is in."
+    category: CosmeticCategory!
+
+    "The rarity of the cosmetic."
+    rarity: Rarity!
+
+    "If this cosmetic can be colored using Chroma Packs."
+    colorable: Boolean!
+}
+
 "Available queries."
 type Query {
     "Given a UUID, returns a Player if they have logged in to MCC Island."