@minecraft/server-admin 1.0.0-beta.1.26.20-preview.20 → 1.0.0-beta.1.26.20-preview.22

package/index.d.ts

@@ -200,6 +200,33 @@ export class DedicatedServerUtils {
      *
      */
     readonly levelStorage: LevelStorage;
+    /**
+     * @remarks
+     * Reloads the cdn configuration from disk.
+     *
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.EngineError}
+     */
+    reloadCDNConfig(): void;
+    /**
+     * @remarks
+     * Reloads the permissions for the server from disk.
+     *
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.EngineError}
+     */
+    reloadPermissions(): void;
+    /**
+     * @remarks
+     * Reloads the script configuration for the server from disk.
+     *
+     * @throws This function can throw errors.
+     *
+     * {@link minecraftcommon.EngineError}
+     */
+    reloadScriptingConfig(): void;
     /**
      * @remarks
      * Shuts down the dedicated server.
@@ -280,28 +307,28 @@ export class SecretString {
  * configuration.
  * @example getPlayerProfile.ts
  * ```typescript
- * import { variables, secrets } from "@minecraft/server-admin";
- * import { http, HttpRequest, HttpRequestMethod, HttpHeader, HttpResponse } from "@minecraft/server-net";
+ * import { variables, secrets } from '@minecraft/server-admin';
+ * import { http, HttpRequest, HttpRequestMethod, HttpHeader, HttpResponse } from '@minecraft/server-net';
  *
  * const serverUrl = variables.get('serverEndpoint');
  *
  * function getPlayerProfile(playerId: string): Promise<HttpResponse> {
- *     const req = new HttpRequest(serverUrl + 'getPlayerProfile');
+ *   const req = new HttpRequest(serverUrl + 'getPlayerProfile');
  *
- *     req.body = JSON.stringify({
- *         playerId,
- *     });
+ *   req.body = JSON.stringify({
+ *     playerId,
+ *   });
  *
- *     const authTokenSec = secrets.get('authtoken');
+ *   const authTokenSec = secrets.get('authtoken');
  *
- *     if (!authTokenSec) {
- *         throw new Error('authtoken secret not defined.');
- *     }
+ *   if (!authTokenSec) {
+ *     throw new Error('authtoken secret not defined.');
+ *   }
  *
- *     req.method = HttpRequestMethod.Post;
- *     req.headers = [new HttpHeader('Content-Type', 'application/json'), new HttpHeader('auth', authTokenSec)];
+ *   req.method = HttpRequestMethod.Post;
+ *   req.headers = [new HttpHeader('Content-Type', 'application/json'), new HttpHeader('auth', authTokenSec)];
  *
- *     return http.request(req);
+ *   return http.request(req);
  * }
  * ```
  */
@@ -333,28 +360,28 @@ export class ServerSecrets {
  * configuration.
  * @example getPlayerProfile.ts
  * ```typescript
- * import { variables, secrets } from "@minecraft/server-admin";
- * import { http, HttpRequest, HttpRequestMethod, HttpHeader, HttpResponse } from "@minecraft/server-net";
+ * import { variables, secrets } from '@minecraft/server-admin';
+ * import { http, HttpRequest, HttpRequestMethod, HttpHeader, HttpResponse } from '@minecraft/server-net';
  *
  * const serverUrl = variables.get('serverEndpoint');
  *
  * function getPlayerProfile(playerId: string): Promise<HttpResponse> {
- *     const req = new HttpRequest(serverUrl + 'getPlayerProfile');
+ *   const req = new HttpRequest(serverUrl + 'getPlayerProfile');
  *
- *     req.body = JSON.stringify({
- *         playerId,
- *     });
+ *   req.body = JSON.stringify({
+ *     playerId,
+ *   });
  *
- *     const authTokenSec = secrets.get('authtoken');
+ *   const authTokenSec = secrets.get('authtoken');
  *
- *     if (!authTokenSec) {
- *         throw new Error('authtoken secret not defined.');
- *     }
+ *   if (!authTokenSec) {
+ *     throw new Error('authtoken secret not defined.');
+ *   }
  *
- *     req.method = HttpRequestMethod.Post;
- *     req.headers = [new HttpHeader('Content-Type', 'application/json'), new HttpHeader('auth', authTokenSec)];
+ *   req.method = HttpRequestMethod.Post;
+ *   req.headers = [new HttpHeader('Content-Type', 'application/json'), new HttpHeader('auth', authTokenSec)];
  *
- *     return http.request(req);
+ *   return http.request(req);
  * }
  * ```
  */
@@ -429,6 +456,15 @@ export class AllowListModificationError extends Error {
     private constructor();
 }
 
+/**
+ * An error which is thrown when attempting to deop a player
+ * which cannot have their permissions removed.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class CannotDeopPlayerError extends Error {
+    private constructor();
+}
+
 /**
  * An error which is thrown when attempting to kick a player
  * who cannot be kicked.
@@ -465,6 +501,32 @@ export class LevelStorageSaveStateChangeError extends Error {
     private constructor();
 }
 
+/**
+ * An error which is thrown when attempting to op a player that
+ * already has op permissions.
+ */
+// @ts-ignore Class inheritance allowed for native defined classes
+export class PlayerAlreadyOpError extends Error {
+    private constructor();
+}
+
+/**
+ * @remarks
+ * Removes the player's op permissions.
+ *
+ * This function can't be called in restricted-execution mode.
+ *
+ * @param player
+ * Player to remove permissions from.
+ * @throws This function can throw errors.
+ *
+ * {@link CannotDeopPlayerError}
+ *
+ * {@link minecraftcommon.EngineError}
+ *
+ * {@link minecraftcommon.InvalidArgumentError}
+ */
+export function deopPlayer(player: minecraftserver.Player): void;
 /**
  * @remarks
  * Kicks a player from the server.
@@ -484,6 +546,23 @@ export class LevelStorageSaveStateChangeError extends Error {
  * {@link minecraftcommon.InvalidArgumentError}
  */
 export function kickPlayer(player: minecraftserver.Player, reason?: string): void;
+/**
+ * @remarks
+ * Gives the player op permissions.
+ *
+ * This function can't be called in restricted-execution mode.
+ *
+ * @param player
+ * Player to add permissions to.
+ * @throws This function can throw errors.
+ *
+ * {@link minecraftcommon.EngineError}
+ *
+ * {@link minecraftcommon.InvalidArgumentError}
+ *
+ * {@link PlayerAlreadyOpError}
+ */
+export function opPlayer(player: minecraftserver.Player): void;
 /**
  * @remarks
  * Transfer player to another server.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft/server-admin",
-  "version": "1.0.0-beta.1.26.20-preview.20",
+  "version": "1.0.0-beta.1.26.20-preview.22",
   "description": "",
   "contributors": [
     {