mcutils-js-api 2.0.2 → 2.0.3

package/dist/index.d.ts

@@ -89,10 +89,9 @@ export declare class McUtilsAPI {
      * Fetch a player's skin image.
      *
      * @param id the UUID or username of the player (eg: ImFascinated)
-     * @param extension the image format - png or jpg (default: png)
-     * @returns the skin image or the error (if one occurred)
+     * @returns the skin PNG image or the error (if one occurred)
      */
-    fetchPlayerSkin(id: string, extension?: string): Promise<{
+    fetchPlayerSkin(id: string): Promise<{
         image?: ArrayBuffer;
         error?: ErrorResponse;
     }>;
@@ -101,12 +100,21 @@ export declare class McUtilsAPI {
      *
      * @param id the UUID or username of the player (eg: ImFascinated)
      * @param part the skin part to fetch (eg: head)
-     * @param extension the image format - png or jpg (default: png)
      * @param size the image size (default: 256)
      * @param overlays whether to render skin overlay layers (default: false)
-     * @returns the skin part image or the error (if one occurred)
+     * @returns the skin part PNG image or the error (if one occurred)
      */
-    fetchPlayerSkinPart(id: string, part: string, extension?: string, size?: number, overlays?: boolean): Promise<{
+    fetchPlayerSkinPart(id: string, part: string, size?: number, overlays?: boolean): Promise<{
+        image?: ArrayBuffer;
+        error?: ErrorResponse;
+    }>;
+    /**
+     * Fetch a player's cape image.
+     *
+     * @param id the UUID or username of the player (eg: ImFascinated)
+     * @returns the cape PNG image or the error (if one occurred)
+     */
+    fetchPlayerCape(id: string): Promise<{
         image?: ArrayBuffer;
         error?: ErrorResponse;
     }>;

package/dist/index.js

@@ -132,11 +132,10 @@ export class McUtilsAPI {
      * Fetch a player's skin image.
      *
      * @param id the UUID or username of the player (eg: ImFascinated)
-     * @param extension the image format - png or jpg (default: png)
-     * @returns the skin image or the error (if one occurred)
+     * @returns the skin PNG image or the error (if one occurred)
      */
-    async fetchPlayerSkin(id, extension = "png") {
-        const response = await fetch(`${this.endpoint}/player/${id}/skin.${extension}`);
+    async fetchPlayerSkin(id) {
+        const response = await fetch(`${this.endpoint}/skin/texture/${id}.png`);
         if (response.ok) {
             return { image: await response.arrayBuffer() };
         }
@@ -149,13 +148,27 @@ export class McUtilsAPI {
      *
      * @param id the UUID or username of the player (eg: ImFascinated)
      * @param part the skin part to fetch (eg: head)
-     * @param extension the image format - png or jpg (default: png)
      * @param size the image size (default: 256)
      * @param overlays whether to render skin overlay layers (default: false)
-     * @returns the skin part image or the error (if one occurred)
+     * @returns the skin part PNG image or the error (if one occurred)
      */
-    async fetchPlayerSkinPart(id, part, extension = "png", size = 256, overlays = false) {
-        const response = await fetch(`${this.endpoint}/player/${id}/skin/${part}.${extension}${this.buildParams({ size: String(size), overlays: String(overlays) })}`);
+    async fetchPlayerSkinPart(id, part, size = 256, overlays = false) {
+        const response = await fetch(`${this.endpoint}/skin/${id}/${part}.png${this.buildParams({ size: String(size), overlays: String(overlays) })}`);
+        if (response.ok) {
+            return { image: await response.arrayBuffer() };
+        }
+        return {
+            error: (await response.json()),
+        };
+    }
+    /**
+     * Fetch a player's cape image.
+     *
+     * @param id the UUID or username of the player (eg: ImFascinated)
+     * @returns the cape PNG image or the error (if one occurred)
+     */
+    async fetchPlayerCape(id) {
+        const response = await fetch(`${this.endpoint}/cape/texture/${id}.png`);
         if (response.ok) {
             return { image: await response.arrayBuffer() };
         }

package/dist/types/player/player.d.ts

@@ -3,11 +3,11 @@ export type SkinParts = Record<string, string>;
 export type Skin = {
     model: SkinModel;
     legacy: boolean;
-    url: string;
+    textureUrl: string;
     parts: SkinParts;
 };
 export type Cape = {
-    id?: string;
+    textureUrl: string;
 };
 export type ProfileProperty = {
     name: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcutils-js-api",
-  "version": "2.0.2",
+  "version": "2.0.3",
   "module": "dist/index.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",