@wumx-labs/noxaeapi-mcp 1.0.1 → 1.0.2

package/dist/index.js

@@ -1905,8 +1905,230 @@ function registerLeaderboardTools(server) {
   );
 }
 
-// src/tools/auto-register.ts
+// src/tools/rankforge.ts
 import { z as z10 } from "zod";
+async function resolveUuid5(client, playerOrUuid) {
+  if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(playerOrUuid)) {
+    return playerOrUuid;
+  }
+  try {
+    const res = await client.players.resolve(playerOrUuid);
+    return res.uuid;
+  } catch {
+    return playerOrUuid;
+  }
+}
+function registerRankForgeTools(server) {
+  server.tool(
+    "rankforge_get_player_stats",
+    "Get full RankForge PvP stats for a player: points, current tier, next tier, kills, deaths, K/D ratio, and daily kills. Accepts UUID or player name.",
+    {
+      player: z10.string().describe("Player UUID or player name"),
+      nodeId: z10.string().optional().describe("Target server node ID when connected via Velocity hub")
+    },
+    async ({ player, nodeId }) => {
+      const session = getSession();
+      try {
+        const { client, effectiveNodeId } = await session.resolveTargetClient(nodeId);
+        const uuid = await resolveUuid5(client, player);
+        const stats = await client.rankforge.getPlayerStats(uuid);
+        const prefix = effectiveNodeId ? `[Target Node: @${effectiveNodeId}]
+` : "";
+        return {
+          content: [{ type: "text", text: prefix + JSON.stringify(stats, null, 2) }]
+        };
+      } catch (err) {
+        return {
+          isError: true,
+          content: [{ type: "text", text: `Failed to get RankForge stats for '${player}': ${err instanceof Error ? err.message : String(err)}` }]
+        };
+      }
+    }
+  );
+  server.tool(
+    "rankforge_get_points",
+    "Get current RankForge points for a player. Accepts UUID or player name.",
+    {
+      player: z10.string().describe("Player UUID or player name"),
+      nodeId: z10.string().optional().describe("Target server node ID when connected via Velocity hub")
+    },
+    async ({ player, nodeId }) => {
+      const session = getSession();
+      try {
+        const { client, effectiveNodeId } = await session.resolveTargetClient(nodeId);
+        const uuid = await resolveUuid5(client, player);
+        const result = await client.rankforge.getPoints(uuid);
+        const prefix = effectiveNodeId ? `[Target Node: @${effectiveNodeId}]
+` : "";
+        return {
+          content: [{ type: "text", text: prefix + JSON.stringify(result, null, 2) }]
+        };
+      } catch (err) {
+        return {
+          isError: true,
+          content: [{ type: "text", text: `Failed to get points for '${player}': ${err instanceof Error ? err.message : String(err)}` }]
+        };
+      }
+    }
+  );
+  server.tool(
+    "rankforge_set_points",
+    "Set RankForge points for a player to an exact amount. This will override their current points. Accepts UUID or player name.",
+    {
+      player: z10.string().describe("Player UUID or player name"),
+      amount: z10.number().describe("Exact points value to set"),
+      nodeId: z10.string().optional().describe("Target server node ID when connected via Velocity hub")
+    },
+    async ({ player, amount, nodeId }) => {
+      const session = getSession();
+      try {
+        const { client, effectiveNodeId } = await session.resolveTargetClient(nodeId);
+        const uuid = await resolveUuid5(client, player);
+        const result = await client.rankforge.setPoints(uuid, amount);
+        const prefix = effectiveNodeId ? `[Target Node: @${effectiveNodeId}]
+` : "";
+        return {
+          content: [{ type: "text", text: prefix + JSON.stringify(result, null, 2) }]
+        };
+      } catch (err) {
+        return {
+          isError: true,
+          content: [{ type: "text", text: `Failed to set points for '${player}': ${err instanceof Error ? err.message : String(err)}` }]
+        };
+      }
+    }
+  );
+  server.tool(
+    "rankforge_add_points",
+    "Add RankForge points to a player. Accepts UUID or player name.",
+    {
+      player: z10.string().describe("Player UUID or player name"),
+      amount: z10.number().describe("Number of points to add"),
+      nodeId: z10.string().optional().describe("Target server node ID when connected via Velocity hub")
+    },
+    async ({ player, amount, nodeId }) => {
+      const session = getSession();
+      try {
+        const { client, effectiveNodeId } = await session.resolveTargetClient(nodeId);
+        const uuid = await resolveUuid5(client, player);
+        const result = await client.rankforge.addPoints(uuid, amount);
+        const prefix = effectiveNodeId ? `[Target Node: @${effectiveNodeId}]
+` : "";
+        return {
+          content: [{ type: "text", text: prefix + JSON.stringify(result, null, 2) }]
+        };
+      } catch (err) {
+        return {
+          isError: true,
+          content: [{ type: "text", text: `Failed to add points for '${player}': ${err instanceof Error ? err.message : String(err)}` }]
+        };
+      }
+    }
+  );
+  server.tool(
+    "rankforge_remove_points",
+    "Remove (deduct) RankForge points from a player. Accepts UUID or player name.",
+    {
+      player: z10.string().describe("Player UUID or player name"),
+      amount: z10.number().describe("Number of points to remove"),
+      nodeId: z10.string().optional().describe("Target server node ID when connected via Velocity hub")
+    },
+    async ({ player, amount, nodeId }) => {
+      const session = getSession();
+      try {
+        const { client, effectiveNodeId } = await session.resolveTargetClient(nodeId);
+        const uuid = await resolveUuid5(client, player);
+        const result = await client.rankforge.removePoints(uuid, amount);
+        const prefix = effectiveNodeId ? `[Target Node: @${effectiveNodeId}]
+` : "";
+        return {
+          content: [{ type: "text", text: prefix + JSON.stringify(result, null, 2) }]
+        };
+      } catch (err) {
+        return {
+          isError: true,
+          content: [{ type: "text", text: `Failed to remove points for '${player}': ${err instanceof Error ? err.message : String(err)}` }]
+        };
+      }
+    }
+  );
+  server.tool(
+    "rankforge_list_tiers",
+    "List all registered PvP tiers from RankForge (name, minPoints, maxPoints, etc.).",
+    {
+      nodeId: z10.string().optional().describe("Target server node ID when connected via Velocity hub")
+    },
+    async ({ nodeId }) => {
+      const session = getSession();
+      try {
+        const { client, effectiveNodeId } = await session.resolveTargetClient(nodeId);
+        const tiers = await client.rankforge.getTiers();
+        const prefix = effectiveNodeId ? `[Target Node: @${effectiveNodeId}]
+` : "";
+        return {
+          content: [{ type: "text", text: prefix + JSON.stringify(tiers, null, 2) }]
+        };
+      } catch (err) {
+        return {
+          isError: true,
+          content: [{ type: "text", text: `Failed to list RankForge tiers: ${err instanceof Error ? err.message : String(err)}` }]
+        };
+      }
+    }
+  );
+  server.tool(
+    "rankforge_get_top",
+    "Get the top players ranked by RankForge points (PvP leaderboard). Returns rank, UUID, name, points, and tier.",
+    {
+      limit: z10.number().optional().describe("Number of top players to return (default 10, max 100)"),
+      nodeId: z10.string().optional().describe("Target server node ID when connected via Velocity hub")
+    },
+    async ({ limit = 10, nodeId }) => {
+      const session = getSession();
+      try {
+        const { client, effectiveNodeId } = await session.resolveTargetClient(nodeId);
+        const top = await client.rankforge.getTop(limit);
+        const prefix = effectiveNodeId ? `[Target Node: @${effectiveNodeId}]
+` : "";
+        return {
+          content: [{ type: "text", text: prefix + JSON.stringify(top, null, 2) }]
+        };
+      } catch (err) {
+        return {
+          isError: true,
+          content: [{ type: "text", text: `Failed to get RankForge top: ${err instanceof Error ? err.message : String(err)}` }]
+        };
+      }
+    }
+  );
+  server.tool(
+    "rankforge_save",
+    "Trigger an async save of all RankForge player data to disk/database.",
+    {
+      nodeId: z10.string().optional().describe("Target server node ID when connected via Velocity hub")
+    },
+    async ({ nodeId }) => {
+      const session = getSession();
+      try {
+        const { client, effectiveNodeId } = await session.resolveTargetClient(nodeId);
+        const result = await client.rankforge.save();
+        const prefix = effectiveNodeId ? `[Target Node: @${effectiveNodeId}]
+` : "";
+        return {
+          content: [{ type: "text", text: prefix + JSON.stringify(result, null, 2) }]
+        };
+      } catch (err) {
+        return {
+          isError: true,
+          content: [{ type: "text", text: `Failed to trigger RankForge save: ${err instanceof Error ? err.message : String(err)}` }]
+        };
+      }
+    }
+  );
+}
+
+// src/tools/auto-register.ts
+import { z as z11 } from "zod";
 var SKIP_MODULES = /* @__PURE__ */ new Set(["http", "connect"]);
 function registerAllSdkModules(server, registeredNames) {
   const session = getSession();
@@ -1934,8 +2156,8 @@ function registerAllSdkModules(server, registeredNames) {
         toolName,
         `NoxAeApi ${modName}.${action}() action. Supports standalone server or Velocity node targeting via nodeId.`,
         {
-          args: z10.array(z10.unknown()).optional().describe(`Arguments array for ${modName}.${action}()`),
-          nodeId: z10.string().optional().describe("Target server node ID (e.g. 'survival', 'lobby') when connected via Velocity hub")
+          args: z11.array(z11.unknown()).optional().describe(`Arguments array for ${modName}.${action}()`),
+          nodeId: z11.string().optional().describe("Target server node ID (e.g. 'survival', 'lobby') when connected via Velocity hub")
         },
         async ({ args = [], nodeId }) => {
           const currentSession = getSession();
@@ -2001,8 +2223,8 @@ async function main() {
     );
   }
   const server = new McpServer({
-    name: "noxaeapi-mcp",
-    version: "1.0.0"
+    name: true ? "@wumx-labs/noxaeapi-mcp" : "noxaeapi-mcp",
+    version: true ? "1.0.2" : "1.0.1"
   });
   const registeredNames = /* @__PURE__ */ new Set();
   const track = (names) => names.forEach((n) => registeredNames.add(n));
@@ -2062,6 +2284,17 @@ async function main() {
     "leaderboards_list",
     "leaderboards_get_top"
   ]);
+  registerRankForgeTools(server);
+  track([
+    "rankforge_get_player_stats",
+    "rankforge_get_points",
+    "rankforge_set_points",
+    "rankforge_add_points",
+    "rankforge_remove_points",
+    "rankforge_list_tiers",
+    "rankforge_get_top",
+    "rankforge_save"
+  ]);
   registerWorldTools(server);
   track([
     "worlds_list",
@@ -2106,6 +2339,8 @@ Follow these operational guidelines to make accurate, reliable decisions:
 3. LEADERBOARD DECISION TREE:
    - For gameplay rankings (kills, deaths, playtime, mcmmo, auraskills): use 'leaderboards_get_top' with IDs like 'player:kills', 'player:deaths', 'player:playtime'.
    - Use 'leaderboards_list' to discover valid game stats (it automatically filters internal noise).
+   - For RankForge PvP tier/points rankings: use 'rankforge_get_top' or the generic 'leaderboards_get_top' with id 'rankforge:points' or 'rankforge:kills'.
+   - To inspect or modify a specific player's RankForge points: use 'rankforge_get_player_stats', 'rankforge_set_points', 'rankforge_add_points', 'rankforge_remove_points'.
 
 4. PERFORMANCE & DIAGNOSTICS:
    - For lag or TPS inquiries: call 'server_get_status'. TPS: 20.0 is perfect, <18.0 is lagging.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wumx-labs/noxaeapi-mcp",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Official Model Context Protocol (MCP) server for NoxAeApi - control Minecraft servers & Velocity networks from any AI agent",
   "author": "wumx",
   "license": "MIT",