@minecraft/server-admin 1.0.0-beta.1.21.20-preview.21 → 1.0.0-beta.1.21.3-stable

package/README.md

@@ -1,6 +1,6 @@
 # `@minecraft/server-admin`
 
-Contains types related to administering a Bedrock Dedicated Server. These types allow for the configuration of variables and secrets in JSON files in the Bedrock Dedicated Server folder. These types cannot be used on Minecraft clients or within Minecraft Realms.
+Contains types related to administering a Bedrock Dedicated Server. These types allow for the configuration of variables and secrets in JSON files in the Bedrock Dedicated Server folder. These types cannot be used on Minecraft clients.
 
 ## **NOTE: This version of this module is still in pre-release.  It may change or it may be removed in future releases.**
 

package/index.d.ts

@@ -12,14 +12,13 @@
  * Contains types related to administering a Bedrock Dedicated
  * Server. These types allow for the configuration of variables
  * and secrets in JSON files in the Bedrock Dedicated Server
- * folder. These types cannot be used on Minecraft clients or
- * within Minecraft Realms.
+ * folder. These types cannot be used on Minecraft clients.
  *
  * Manifest Details
  * ```json
  * {
  *   "module_name": "@minecraft/server-admin",
- *   "version": "1.0.0-beta"
+ *   "version": "1.0.0-beta.1.21.3-stable"
  * }
  * ```
  *
@@ -62,6 +61,8 @@ export class SecretString {
  *
  *     return http.request(req);
  * }
+ *
+ * getPlayerProfile('dark navi');
  * ```
  */
 export class ServerSecrets {
@@ -113,6 +114,8 @@ export class ServerSecrets {
  *
  *     return http.request(req);
  * }
+ *
+ * getPlayerProfile('dark navi');
  * ```
  */
 export class ServerVariables {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft/server-admin",
-  "version": "1.0.0-beta.1.21.20-preview.21",
+  "version": "1.0.0-beta.1.21.3-stable",
   "description": "",
   "contributors": [
     {

package/tests.ts

@@ -0,0 +1,142 @@
+/* eslint-disable  @typescript-eslint/no-unused-vars */
+import * as mc from '@minecraft/server';
+
+export async function getPlayerProfile(log: (message: string, status?: number) => void, targetLocation: mc.Vector3) {
+    const serverUrl = mcsa.variables.get('serverEndpoint');
+
+    const req = new mcnet.HttpRequest(serverUrl + 'getPlayerProfile');
+
+    req.body = JSON.stringify({
+        playerId: 'johndoe',
+    });
+
+    req.method = mcnet.HttpRequestMethod.POST;
+    req.headers = [
+        new mcnet.HttpHeader('Content-Type', 'application/json'),
+        new mcnet.HttpHeader('auth', mcsa.secrets.get('authtoken')),
+    ];
+
+    await mcnet.http.request(req);
+}
+
+export default class SampleManager {
+    tickCount = 0;
+
+    _availableFuncs: {
+        [name: string]: Array<(log: (message: string, status?: number) => void, location: mc.Vector3) => void>;
+    };
+
+    pendingFuncs: Array<{
+        name: string;
+        func: (log: (message: string, status?: number) => void, location: mc.Vector3) => void;
+        location: mc.Vector3;
+    }> = [];
+
+    gameplayLogger(message: string, status?: number) {
+        if (status !== undefined && status > 0) {
+            message = 'SUCCESS: ' + message;
+        } else if (status !== undefined && status < 0) {
+            message = 'FAIL: ' + message;
+        }
+
+        this.say(message);
+    }
+    say(message: string) {
+        mc.world.getDimension('overworld').runCommand('say ' + message);
+    }
+
+    newChatMessage(chatEvent: mc.ChatEvent) {
+        const message = chatEvent.message.toLowerCase();
+
+        if (message.startsWith('howto') && chatEvent.sender) {
+            const nearbyBlock = chatEvent.sender.getBlockFromViewVector();
+            if (!nearbyBlock) {
+                this.gameplayLogger('Please look at the block where you want me to run this.');
+                return;
+            }
+
+            const nearbyBlockLoc = nearbyBlock.location;
+            const nearbyLoc: mc.Vector3 = { x: nearbyBlockLoc.x, y: nearbyBlockLoc.y + 1, z: nearbyBlockLoc.z };
+
+            const sampleId = message.substring(5).trim();
+
+            if (sampleId.length < 2) {
+                let availableFuncStr = 'Here is my list of available samples:';
+
+                for (const sampleFuncKey in this._availableFuncs) {
+                    availableFuncStr += ' ' + sampleFuncKey;
+                }
+
+                this.say(availableFuncStr);
+            } else {
+                for (const sampleFuncKey in this._availableFuncs) {
+                    if (sampleFuncKey.toLowerCase() === sampleId) {
+                        const sampleFunc = this._availableFuncs[sampleFuncKey];
+
+                        this.runSample(sampleFuncKey + this.tickCount, sampleFunc, nearbyLoc);
+
+                        return;
+                    }
+                }
+
+                this.say(`I couldn't find the sample '${sampleId}"'`);
+            }
+        }
+    }
+
+    runSample(
+        sampleId: string,
+        snippetFunctions: Array<(log: (message: string, status?: number) => void, location: mc.Vector3) => void>,
+        targetLocation: mc.Vector3,
+    ) {
+        for (let i = snippetFunctions.length - 1; i >= 0; i--) {
+            this.pendingFuncs.push({ name: sampleId, func: snippetFunctions[i], location: targetLocation });
+        }
+    }
+
+    worldTick() {
+        if (this.tickCount % 10 === 0) {
+            if (this.pendingFuncs.length > 0) {
+                const funcSet = this.pendingFuncs.pop();
+
+                if (funcSet) {
+                    funcSet.func(this.gameplayLogger, funcSet.location);
+                }
+            }
+        }
+
+        this.tickCount++;
+    }
+
+    constructor() {
+        this._availableFuncs = {};
+
+        this.gameplayLogger = this.gameplayLogger.bind(this);
+
+        mc.world.events.tick.subscribe(this.worldTick.bind(this));
+        mc.world.events.chat.subscribe(this.newChatMessage.bind(this));
+    }
+
+    registerSamples(sampleSet: {
+        [name: string]: Array<(log: (message: string, status?: number) => void, location: mc.Vector3) => void>;
+    }) {
+        for (const sampleKey in sampleSet) {
+            if (sampleKey.length > 1 && sampleSet[sampleKey]) {
+                this._availableFuncs[sampleKey] = sampleSet[sampleKey];
+            }
+        }
+    }
+}
+
+import * as mcsa from '@minecraft/server-admin';
+import * as mcnet from '@minecraft/server-net'; // keep in for net samples
+
+const mojangServerAdminTestFuncs: {
+    [name: string]: Array<(log: (message: string, status?: number) => void, location: mc.Vector3) => void>;
+} = {
+    getPlayerProfile: [getPlayerProfile],
+};
+
+export function register(sampleManager: SampleManager) {
+    sampleManager.registerSamples(mojangServerAdminTestFuncs);
+}