@occultus/task-api 0.21.0-alpha → 0.21.0-beta.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@occultus/task-api",
-  "version": "0.21.0-alpha",
+  "version": "0.21.0-beta.1",
   "repository": {
     "type": "git",
     "url": "https://codeberg.org/TeamOccultus/StarTenonAPI"
@@ -24,10 +24,10 @@
   "author": "CTN Studios",
   "type": "module",
   "dependencies": {
-    "@occultus/format-api": "0.21.0-alpha",
-    "@occultus/item-api": "0.20.0",
+    "@occultus/format-api": "0.21.0-beta.1",
+    "@occultus/entity-api": "0.20.0",
     "@occultus/text-api": "0.20.0",
-    "@occultus/entity-api": "0.20.0"
+    "@occultus/item-api": "0.20.0"
   },
   "peerDependencies": {
     "@minecraft/server": ">=2.1.0",

package/src/api/Task.ts

@@ -7,6 +7,7 @@ import { TaskCenter } from "./TaskCenter";
 import { MessageFormData } from "@minecraft/server-ui";
 import { TaskUtils } from "../utils/TaskUtils";
 import { LockedScreen } from "../ui/LockedScreen";
+import { TaskServer } from "./TaskServer";
 
 export class Task {
   /**
@@ -128,4 +129,13 @@ export class Task {
     });
     player.playSound(this.options.completeSound ?? "random.levelup");
   }
+  /**
+   * 直接将任务上传到服务端监听器中
+   * 
+   * **IMPORTANT: 除非任务使用的条件有特殊说明，否则此方法一般无用**
+   * @param server 
+   */
+  pushToServer(server: TaskServer){
+    server.addTask(this);
+  }
 }

package/src/api/TaskServer.ts

@@ -42,4 +42,9 @@ export class TaskServer {
       this.families.set(condition.family, condition.bindTo);
     }
   }
+  addTask(task: Task) {
+    task.options.conditions.forEach((condition) => {
+      this.addCondition(condition);
+    });
+  }
 }

package/src/api/conditions/KillEntityCondition.ts

@@ -5,6 +5,8 @@ import { Localization } from "@occultus/format-api";
 
 /**
  * 击杀实体条件
+ * 
+ * **IMPORTANT: 此条件必须调用 {@link TaskConditions.pushToServer()} 方法才能生效**
  */
 export class KillEntityConditions extends TaskConditions {
   /**

package/src/api/conditions/KillEntityFamilyCondition.ts

@@ -4,6 +4,8 @@ import { Task } from "../Task";
 
 /**
  * 击杀实体条件
+ * 
+ * **IMPORTANT: 此条件必须调用 {@link TaskConditions.pushToServer()} 方法才能生效**
  */
 export class KillEntityFamilyConditions extends TaskConditions {
   /**

package/src/api/conditions/TaskConditions.ts

@@ -1,9 +1,10 @@
 import { Player } from "@minecraft/server";
 import { TextProvider } from "@occultus/text-api";
+import { TaskServer } from "../TaskServer";
 
 /**
  * 任务条件的抽象类
- * 
+ *
  * 定义了任务条件的基本结构和必须实现的方法，所有具体的任务条件类都应该继承此抽象类并实现其抽象方法
  */
 export abstract class TaskConditions {
@@ -11,24 +12,34 @@ export abstract class TaskConditions {
    * @param data 任务条件所需的数据
    */
   constructor(protected data: unknown) {}
-  
   /**
-   * 检查玩家是否满足任务条件
+   * 直接将条件上传到服务端监听器中
    * 
+   * **IMPORTANT: 除非有特殊说明，否则此方法一般无用**
+   * @param server 要上传的服务端监听器
+   * @return 条件自身
+   */
+  pushToServer(server: TaskServer): TaskConditions {
+    server.addCondition(this);
+    return this;
+  }
+  /**
+   * 检查玩家是否满足任务条件
+   *
    * @param player 要检查的玩家对象
    * @return 如果玩家满足条件返回`true`，否则返回`false`
    */
   abstract check(player: Player): boolean;
-  
+
   /**
    * 获取任务条件的文本，该文本将会在任务面板中显示
-   * 
+   *
    * @return 用于显示任务条件描述的文本
    */
   abstract getTextProvider(): TextProvider;
   /**
    * 获取条件检查失败时的原因说明文本
-   * 
+   *
    * @return 用于显示失败原因的文本
    */
   abstract getFailedReason(): TextProvider;