mostly completed docs

documentation/home.md

@@ -5,7 +5,22 @@ summary: Welcome to the Minecraft Utilities documentation! Here you can find inf
 
 # Getting Started
 
-This is still a work in progress, so please be patient as we continue to add more documentation.
+Welcome to the Minecraft Utilities documentation! Here you can find information on how to use the various features of the API.
+
+## Features
+
+See below for a list of features that are currently available in the API.
+
+| Feature                                                  | Description                            |
+|----------------------------------------------------------|----------------------------------------|
+| [Player Lookup](/docs/player/player-lookup)              | Get a player's information             |
+| [Player Username To Uuid](/docs/player/username-to-uuid) | Get a player's skin parts              |
+| [Player Skin Parts](/docs/player/skin-parts)             | Get a player's skin parts              |
+| [Server Lookup](/docs/server/server-lookup)              | Get a server's information             |
+| [Server Icon](/docs/server/favicon)                      | Get a server's icon                    |
+| [Server Preview](/docs/server/preview)                   | View the server as if you were in-game |
+| [Mojang Status](/docs/mojang/endpoint-status)            | Get the status of Mojang's services    |
+
 
 ## Libraries
 

documentation/mojang/endpoint-status.md

@@ -0,0 +1,63 @@
+---
+title: Mojang - Endpoint Status
+summary: Get the status of the Mojang APIs.
+---
+
+# Mojang - Endpoint Status
+
+The Mojang endpoint status endpoint allows you to get the status of the Mojang APIs.
+
+## Endpoint
+
+```
+GET /mojang/status
+```
+
+## Example
+
+```bash
+curl -X GET "https://api.mcutils.xyz/mojang/status" -H "accept: application/json"
+```
+
+## Response
+
+```json
+{
+  "cache": {
+    "cached": false,
+    "cachedTime": -1
+  },
+  "endpoints": [
+    {
+      "name": "Minecraft Textures",
+      "hostname": "textures.minecraft.net",
+      "status": "ONLINE"
+    },
+    {
+      "name": "Minecraft Libraries",
+      "hostname": "libraries.minecraft.net",
+      "status": "ONLINE"
+    },
+    {
+      "name": "Minecraft Services",
+      "hostname": "api.minecraftservices.com",
+      "status": "ONLINE"
+    },
+    {
+      "name": "Mojang Assets",
+      "hostname": "assets.mojang.com",
+      "status": "ONLINE"
+    },
+    {
+      "name": "Mojang API",
+      "hostname": "api.mojang.com",
+      "status": "ONLINE"
+    },
+    {
+      "name": "Mojang Session Server",
+      "hostname": "sessionserver.mojang.com",
+      "status": "ONLINE"
+    }
+  ]
+}
+```

documentation/player/player-lookup.md

@@ -0,0 +1,68 @@
+---
+title: Player Lookup
+summary: Get information about a player.
+---
+
+# Player Lookup
+
+The player lookup endpoint allows you to get information about a player. This includes their UUID, username, and any other information that is available.
+
+## Endpoint
+
+```
+GET /player/:query
+```
+
+## Parameters
+
+| Parameter | Description                                             | Required |
+|-----------|---------------------------------------------------------|----------|
+| query     | The username or uuid of the player you want to look up. | Yes      |
+
+## Example
+
+```bash
+curl -X GET "https://api.mcutils.xyz/player/imfascinated" -H "accept: application/json"
+```
+
+## Response
+
+```json
+{
+  "cache": {
+    "cached": false,
+    "cachedTime": -1
+  },
+  "uniqueId": "eeab5f8a-18dd-4d58-af78-2b3c4543da48",
+  "trimmedUniqueId": "eeab5f8a18dd4d58af782b3c4543da48",
+  "username": "ImFascinated",
+  "skin": {
+    "url": "http://textures.minecraft.net/texture/ba1e0c9e21983c06e45614642316cd7029a297bc246bc6d236a41388c3ff9a09",
+    "model": "SLIM",
+    "legacy": false,
+    "parts": {
+      "head": "https://api.mcutils.xyz/player/head/eeab5f8a-18dd-4d58-af78-2b3c4543da48",
+      "face": "https://api.mcutils.xyz/player/face/eeab5f8a-18dd-4d58-af78-2b3c4543da48",
+      "body": "https://api.mcutils.xyz/player/body/eeab5f8a-18dd-4d58-af78-2b3c4543da48"
+    }
+  },
+  "cape": {
+    "url": "http://textures.minecraft.net/texture/2340c0e03dd24a11b15a8b33c2a7e9e32abb2051b2481d0ba7defd635ca7a933"
+  },
+  "rawProperties": [
+    {
+      "name": "textures",
+      "value": "ewogICJ0aW1lc3RhbXAiIDogMTcxMzY3MDc4MTM0NSwKICAicHJvZmlsZUlkIiA6ICJlZWFiNWY4YTE4ZGQ0ZDU4YWY3ODJiM2M0NTQzZGE0OCIsCiAgInByb2ZpbGVOYW1lIiA6ICJJbUZhc2NpbmF0ZWQiLAogICJ0ZXh0dXJlcyIgOiB7CiAgICAiU0tJTiIgOiB7CiAgICAgICJ1cmwiIDogImh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYmExZTBjOWUyMTk4M2MwNmU0NTYxNDY0MjMxNmNkNzAyOWEyOTdiYzI0NmJjNmQyMzZhNDEzODhjM2ZmOWEwOSIsCiAgICAgICJtZXRhZGF0YSIgOiB7CiAgICAgICAgIm1vZGVsIiA6ICJzbGltIgogICAgICB9CiAgICB9LAogICAgIkNBUEUiIDogewogICAgICAidXJsIiA6ICJodHRwOi8vdGV4dHVyZXMubWluZWNyYWZ0Lm5ldC90ZXh0dXJlLzIzNDBjMGUwM2RkMjRhMTFiMTVhOGIzM2MyYTdlOWUzMmFiYjIwNTFiMjQ4MWQwYmE3ZGVmZDYzNWNhN2E5MzMiCiAgICB9CiAgfQp9",
+      "signed": false
+    }
+  ]
+}
+```
+
+## Errors
+
+| Status Code | Description                                   |
+|-------------|-----------------------------------------------|
+| 400         | The username is invalid.                      |
+| 404         | The player was not found.                     |
+| 429         | The Mojang API rate limit has been exhausted. |

documentation/player/skin-parts.md

@@ -0,0 +1,47 @@
+---
+title: Player - Skin Parts
+summary: Get a specific part of a player's skin.
+---
+
+# Player - Skin Parts
+
+The player skin parts endpoint allows you to get a specific part of a player's skin.
+
+## Endpoint
+
+```
+GET /player/:part/:query
+```
+
+## Parts
+
+| Part | Description           |
+|------|-----------------------|
+| head | Get the player's head |
+| face | Get the player's face |
+| body | Get the player's body |
+
+## Parameters
+
+| Parameter | Description                                             | Required |
+|-----------|---------------------------------------------------------|----------|
+| part      | The part of the skin you want to get.                   | Yes      |
+| query     | The username or uuid of the player you want to look up. | Yes      |
+
+## Example
+
+```bash
+curl -X GET "https://api.mcutils.xyz/player/head/imfascinated" -H "accept: image/png"
+```
+
+## Response
+
+![Skin Part](https://api.mcutils.xyz/player/head/eeab5f8a-18dd-4d58-af78-2b3c4543da48 "Player's Head")
+
+## Errors
+
+| Status Code | Description                                   |
+|-------------|-----------------------------------------------|
+| 400         | The username is invalid.                      |
+| 404         | The player was not found.                     |
+| 429         | The Mojang API rate limit has been exhausted. |

documentation/player/username-to-uuid.md

@@ -0,0 +1,46 @@
+---
+title: Player - Username to UUID
+summary: Get a player's UUID from their username.
+---
+
+# Player  - Username to UUID
+
+The player username to UUID endpoint allows you to get a player's UUID from their username.
+
+## Endpoint
+
+```
+GET /player/uuid/:query
+```
+
+## Parameters
+
+| Parameter | Description                                             | Required |
+|-----------|---------------------------------------------------------|----------|
+| query     | The username of the player you want to look up.         | Yes      |
+
+## Example
+
+```bash
+curl -X GET "https://api.mcutils.xyz/player/uuid/imfascinated" -H "accept: application/json"
+```
+
+## Response
+
+```json
+{
+  "cache": {
+    "cached": false,
+    "cachedTime": -1
+  },
+  "uniqueId": "eeab5f8a-18dd-4d58-af78-2b3c4543da48",
+  "username": "ImFascinated"
+}
+```
+
+## Errors
+
+| Status Code | Description                                   |
+|-------------|-----------------------------------------------|
+| 400         | The username is invalid.                      |
+| 429         | The Mojang API rate limit has been exhausted. |

documentation/server/blocked.md

@@ -0,0 +1,45 @@
+---
+title: Server - Blocked Status
+summary: Get the Mojang blocked status of a Minecraft server.
+---
+
+# Server - Blocked Status
+
+The server blocked status endpoint allows you to get the Mojang blocked status of a Minecraft server.
+
+## Endpoint
+
+```
+GET /server/blocked/:query
+```
+
+## Platforms
+
+This endpoint is only available for Java servers.
+
+## Parameters
+
+| Parameter | Description                                                   | Required |
+|-----------|---------------------------------------------------------------|----------|
+| query     | The IP address or hostname of the server you want to look up. | Yes      |
+
+## Example
+
+```bash
+curl -X GET "https://api.mcutils.xyz/server/blocked/play.hypixel.net"
+```
+
+## Response
+
+```json
+{
+  "blocked": false
+}
+```
+
+## Errors
+
+| Status Code | Description                                   |
+|-------------|-----------------------------------------------|
+| 400         | The server was not found.                     |
+| 429         | The Mojang API rate limit has been exhausted. |

documentation/server/favicon.md

@@ -0,0 +1,41 @@
+---
+title: Server - Favicon
+summary: Get the favicon of a Minecraft server.
+---
+
+# Server - Favicon
+
+The server favicon endpoint allows you to get the favicon of a Minecraft server.
+
+## Endpoint
+
+```
+GET /server/:query
+```
+
+## Platforms
+
+This endpoint is only available for Java servers.
+
+## Parameters
+
+| Parameter | Description                                                               | Required |
+|-----------|---------------------------------------------------------------------------|----------|
+| query     | The IP address or hostname of the server you want to get the favicon for. | Yes      |
+
+## Example
+
+```bash
+curl -X GET "https://api.mcutils.xyz/server/icon/hypixel.net" -H "accept: image/png"
+```
+
+## Response
+
+![Server Icon](https://api.mcutils.xyz/server/icon/play.hypixel.net)
+
+## Errors
+
+| Status Code | Description                                   |
+|-------------|-----------------------------------------------|
+| 400         | The server was not found.                     |
+| 429         | The Mojang API rate limit has been exhausted. |

documentation/server/preview.md

@@ -0,0 +1,45 @@
+---
+title: Server - Preview
+summary: Get the server list preview of a Minecraft server.
+---
+
+# Server - Preview
+
+The server preview endpoint allows you to get the server list preview of a Minecraft server.
+
+## Endpoint
+
+```
+GET /server/:platform/preview/:query
+```
+
+## Platforms
+
+| Platform | Description     |
+|----------|-----------------|
+| bedrock  | Bedrock Edition |
+| java     | Java Edition    |
+
+## Parameters
+
+| Parameter | Description                                                               | Required |
+|-----------|---------------------------------------------------------------------------|----------|
+| platform  | The platform of the server you want to get the preview for.               | Yes      |
+| query     | The IP address or hostname of the server you want to get the preview for. | Yes      |
+
+## Example
+
+```bash
+curl -X GET "https://api.mcutils.xyz/server/java/preview/hypixel.net" -H "accept: image/png"
+```
+
+## Response
+
+![Server Icon](https://api.mcutils.xyz/server/java/preview/play.hypixel.net)
+
+## Errors
+
+| Status Code | Description                                   |
+|-------------|-----------------------------------------------|
+| 400         | The server was not found.                     |
+| 429         | The Mojang API rate limit has been exhausted. |