@occultus/api 0.28.0 → 0.29.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@occultus/api",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "repository": {
     "type": "git",
     "url": "https://codeberg.org/TeamOccultus/StarTenonAPI"
@@ -23,27 +23,27 @@
   "license": "MIT",
   "author": "CTN Studios",
   "dependencies": {
-    "@occultus/artifact-api": "0.23.0",
     "@occultus/common": "0.20.0",
+    "@occultus/artifact-api": "0.23.0",
     "@occultus/article-api": "0.24.0",
-    "@occultus/time-api": "0.22.0",
-    "@occultus/block-api": "0.23.0",
     "@occultus/entity-api": "0.22.1",
+    "@occultus/block-api": "0.23.0",
     "@occultus/text-api": "0.24.0",
-    "@occultus/skill-api": "0.21.0",
+    "@occultus/time-api": "0.22.0",
     "@occultus/format-api": "0.21.0",
+    "@occultus/skill-api": "0.21.0",
     "@occultus/task-api": "0.23.2",
-    "@occultus/item-api": "0.23.0",
     "@occultus/music-api": "0.22.0",
+    "@occultus/item-api": "0.23.0",
     "@occultus/math-api": "0.23.0",
+    "@occultus/logger-api": "0.21.0",
+    "@occultus/notification-api": "0.22.0",
+    "@occultus/tutorial-api": "0.24.0",
     "@occultus/random-api": "0.22.1",
-    "@occultus/notification-api": "0.21.0",
     "@occultus/loot-api": "0.21.0",
-    "@occultus/logger-api": "0.21.0",
     "@occultus/job-api": "0.23.0",
-    "@occultus/tutorial-api": "0.24.0",
-    "@occultus/toolkit": "0.25.0",
     "@occultus/condition-api": "0.23.1",
+    "@occultus/toolkit": "0.25.0",
     "@occultus/effect-api": "0.22.0",
     "@occultus/credits-api": "0.23.2",
     "@occultus/logue-api": "0.26.0-beta.1"

package/script/api.js

@@ -25,12 +25,13 @@ var StarTenon = class {
    * - 10：加入了 Server Binding API
    *   - 10.1：新的工具集函数，BlockEntity 的 API 行为变化
    * - 11：教程 API 的改进，单独的依赖库文件的提供
+   * - 12：加入了 Toast API
    */
-  static apiLevel = 11;
+  static apiLevel = 12;
   /**
    * Star Tenon API 对应的版本号
    */
-  static version = `0.28.0 (API: ${this.apiLevel})`;
+  static version = `0.29.0 (API: ${this.apiLevel})`;
 };
 
 // ../node_modules/.pnpm/@occultus+core@1.1.0_@minec_cddd9d27654ecc6961f34ac46dfd0b14/node_modules/@occultus/core/src/api/error/SDKError.ts
@@ -4053,6 +4054,42 @@ var WelcomeNotification = class {
   }
 };
 
+// ../packages/notification/src/api/Toast.ts
+import { world as world12 } from "@minecraft/server";
+var Toast = class {
+  /**
+   * @param content 通知消息，推荐不超过两行
+   * @param iconPath 通知图标路径
+   */
+  constructor(content, iconPath) {
+    this.content = content;
+    this.iconPath = iconPath;
+  }
+  /**
+   * 向玩家发送吐司通知
+   * @param player
+   */
+  send(player) {
+    player.onScreenDisplay.setTitle(
+      {
+        rawtext: [{ text: "toast:" }, parseToRaw(this.content, player)]
+      },
+      {
+        subtitle: `toast:${this.iconPath}`,
+        fadeInDuration: 0,
+        fadeOutDuration: 0,
+        stayDuration: 1
+      }
+    );
+  }
+  /**
+   * 向所有玩家发送吐司通知
+   */
+  sendToWorld() {
+    world12.getAllPlayers().forEach((player) => this.send(player));
+  }
+};
+
 // ../packages/loot/src/api/base/CustomLoot.ts
 var CustomLoot = class {
   /**
@@ -4124,7 +4161,7 @@ var CustomEntityLoot = class extends CustomLoot {
 };
 
 // ../packages/loot/src/api/CustomLootServer.ts
-import { world as world12, system as system10 } from "@minecraft/server";
+import { world as world13, system as system10 } from "@minecraft/server";
 var CustomLootServer = class {
   /**
    * 存储实体类型ID与对应战利品表路径的映射
@@ -4135,14 +4172,14 @@ var CustomLootServer = class {
    */
   blockLootMap = /* @__PURE__ */ new Map();
   constructor() {
-    world12.afterEvents.entityDie.subscribe((event) => {
+    world13.afterEvents.entityDie.subscribe((event) => {
       const entity = event.deadEntity;
       const lootTable = this.entityLootMap.get(entity.typeId);
       if (lootTable) {
         loot(entity.dimension, entity.location, lootTable);
       }
     });
-    world12.beforeEvents.playerBreakBlock.subscribe((event) => {
+    world13.beforeEvents.playerBreakBlock.subscribe((event) => {
       const block = event.block;
       const lootTable = this.blockLootMap.get(block.typeId);
       if (lootTable) {
@@ -4171,7 +4208,7 @@ var CustomLootServer = class {
 };
 
 // ../packages/logger/src/api/Logger.ts
-import { world as world14 } from "@minecraft/server";
+import { world as world15 } from "@minecraft/server";
 
 // ../packages/logger/src/enum/LogLevel.ts
 var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
@@ -4184,7 +4221,7 @@ var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
 })(LogLevel || {});
 
 // ../packages/logger/src/api/LoggerInternalUtils.ts
-import { world as world13 } from "@minecraft/server";
+import { world as world14 } from "@minecraft/server";
 
 // ../packages/logger/src/data/LogLevelMap.ts
 var LogLevelMap = {
@@ -4201,13 +4238,13 @@ var LoggerInternalUtils = class {
     if (player) {
       return player.getDynamicProperty("occultus:log_level") ?? 3 /* Fatal */;
     }
-    return world13.getDynamicProperty("occultus:log_level") ?? 3 /* Fatal */;
+    return world14.getDynamicProperty("occultus:log_level") ?? 3 /* Fatal */;
   }
   static setLogLevel(level, player) {
     if (player) {
       player.setDynamicProperty("occultus:log_level", level);
     } else {
-      world13.setDynamicProperty("occultus:log_level", level);
+      world14.setDynamicProperty("occultus:log_level", level);
     }
   }
   static stringfyMessage(message, level, namespace) {
@@ -4235,7 +4272,7 @@ var LoggerInternalUtils = class {
     if (this.getLogLevel() > level) {
       return;
     }
-    world13.sendMessage(message);
+    world14.sendMessage(message);
   }
   static sendLogToPlayer(message, player, level) {
     if (this.getLogLevel(player) > level) {
@@ -4352,7 +4389,7 @@ var Logger = class _Logger {
     );
     this.addToHistory(msg);
     console.error(msg);
-    world14.sendMessage(msg);
+    world15.sendMessage(msg);
     throw new Error(msg);
   }
   /**
@@ -4677,9 +4714,9 @@ import { ActionFormData as ActionFormData3 } from "@minecraft/server-ui";
 import {
   CustomCommandSource as CustomCommandSource2,
   CustomCommandStatus as CustomCommandStatus2,
-  Player as Player16,
+  Player as Player17,
   system as system13,
-  world as world15
+  world as world16
 } from "@minecraft/server";
 var ArtifactEvents = class _ArtifactEvents {
   static registryConponent(componentName) {
@@ -4690,16 +4727,16 @@ var ArtifactEvents = class _ArtifactEvents {
         }
       });
     });
-    world15.afterEvents.playerBreakBlock.subscribe((arg) => {
+    world16.afterEvents.playerBreakBlock.subscribe((arg) => {
       _ArtifactEvents.onMineBlock(arg);
     });
-    world15.afterEvents.entityHitEntity.subscribe((arg) => {
+    world16.afterEvents.entityHitEntity.subscribe((arg) => {
       _ArtifactEvents.onHitEntity(arg);
     });
-    world15.afterEvents.entityHurt.subscribe((arg) => {
+    world16.afterEvents.entityHurt.subscribe((arg) => {
       _ArtifactEvents.onHurt(arg);
     });
-    world15.afterEvents.playerSpawn.subscribe((arg) => {
+    world16.afterEvents.playerSpawn.subscribe((arg) => {
       if (arg.player.hasTag("artifact_cooldown") && arg.player.isValid) {
         arg.player.removeTag("artifact_cooldown");
       }
@@ -4735,7 +4772,7 @@ var ArtifactEvents = class _ArtifactEvents {
   }
   static onHitEntity(arg) {
     const { damagingEntity } = arg;
-    if (!(damagingEntity instanceof Player16)) return;
+    if (!(damagingEntity instanceof Player17)) return;
     ArtifactUtils.getArtifactSlotRegistry().getAll().forEach((slot) => {
       slot.getArtifact(damagingEntity)?.hitEntityEvent(arg);
     });
@@ -4748,7 +4785,7 @@ var ArtifactEvents = class _ArtifactEvents {
   }
   static onHurt(arg) {
     const { hurtEntity } = arg;
-    if (!(hurtEntity instanceof Player16)) return;
+    if (!(hurtEntity instanceof Player17)) return;
     ArtifactUtils.getArtifactSlotRegistry().getAll().forEach((slot) => {
       slot.getArtifact(hurtEntity)?.hurtEvent(arg);
     });
@@ -4769,7 +4806,7 @@ var ArtifactEvents = class _ArtifactEvents {
           return {
             status: CustomCommandStatus2.Failure
           };
-        if (!(origin.sourceEntity instanceof Player16))
+        if (!(origin.sourceEntity instanceof Player17))
           return {
             status: CustomCommandStatus2.Failure
           };
@@ -5581,7 +5618,7 @@ import {
   system as system17,
   CustomCommandSource as CustomCommandSource3,
   CustomCommandStatus as CustomCommandStatus3,
-  Player as Player19
+  Player as Player20
 } from "@minecraft/server";
 var TutorialUtils = class {
   constructor() {
@@ -5603,7 +5640,7 @@ var TutorialUtils = class {
             return {
               status: CustomCommandStatus3.Failure
             };
-          if (!(origin.sourceEntity instanceof Player19))
+          if (!(origin.sourceEntity instanceof Player20))
             return {
               status: CustomCommandStatus3.Failure
             };
@@ -5684,7 +5721,7 @@ var TutorialCenter = class extends FormLike {
 };
 
 // ../packages/tutorial/src/api/base/TutorialServer.ts
-import { Player as Player21, world as world16 } from "@minecraft/server";
+import { Player as Player22, world as world17 } from "@minecraft/server";
 var TutorialServer = class {
   tutorials = {
     itemMap: /* @__PURE__ */ new Map(),
@@ -5703,7 +5740,7 @@ var TutorialServer = class {
    * @private
    */
   startUp() {
-    world16.afterEvents.playerInventoryItemChange.subscribe((arg) => {
+    world17.afterEvents.playerInventoryItemChange.subscribe((arg) => {
       const { itemStack, player } = arg;
       if (!itemStack) return;
       itemStack.getTags().forEach((tag) => {
@@ -5715,33 +5752,33 @@ var TutorialServer = class {
         this.tutorials.itemMap.get(itemStack.typeId)?.unlock(player);
       }
     });
-    world16.afterEvents.playerBreakBlock.subscribe((arg) => {
+    world17.afterEvents.playerBreakBlock.subscribe((arg) => {
       const { brokenBlockPermutation } = arg;
       const id = brokenBlockPermutation.type.id;
       if (this.tutorials.blockMap.has(id)) {
         this.tutorials.blockMap.get(id)?.unlock(arg.player);
       }
     });
-    world16.afterEvents.playerPlaceBlock.subscribe((arg) => {
+    world17.afterEvents.playerPlaceBlock.subscribe((arg) => {
       const { block, player } = arg;
       if (this.tutorials.blockMap.has(block.typeId)) {
         this.tutorials.blockMap.get(block.typeId)?.unlock(player);
       }
     });
-    world16.afterEvents.entityHitEntity.subscribe((arg) => {
+    world17.afterEvents.entityHitEntity.subscribe((arg) => {
       const { damagingEntity, hitEntity } = arg;
-      if (damagingEntity instanceof Player21) {
+      if (damagingEntity instanceof Player22) {
         const tutorial = this.tutorials.entityMap.get(hitEntity.typeId);
         if (tutorial) tutorial.unlock(damagingEntity);
         return;
       }
-      if (hitEntity instanceof Player21) {
+      if (hitEntity instanceof Player22) {
         const tutorial = this.tutorials.entityMap.get(damagingEntity.typeId);
         if (tutorial) tutorial.unlock(hitEntity);
         return;
       }
     });
-    world16.afterEvents.playerDimensionChange.subscribe((arg) => {
+    world17.afterEvents.playerDimensionChange.subscribe((arg) => {
       const { toDimension, player } = arg;
       if (this.tutorials.dimensionMap.has(toDimension.id)) {
         this.tutorials.dimensionMap.get(toDimension.id)?.unlock(player);
@@ -5931,7 +5968,7 @@ import {
   CustomCommandStatus as CustomCommandStatus4,
   ItemLockMode,
   ItemStack as ItemStack11,
-  Player as Player22,
+  Player as Player23,
   system as system20
 } from "@minecraft/server";
 var JobInternalUtils = class _JobInternalUtils {
@@ -6038,7 +6075,7 @@ var JobInternalUtils = class _JobInternalUtils {
             return {
               status: CustomCommandStatus4.Failure
             };
-          if (!(origin.sourceEntity instanceof Player22))
+          if (!(origin.sourceEntity instanceof Player23))
             return {
               status: CustomCommandStatus4.Failure
             };
@@ -6361,7 +6398,7 @@ var JobDetailScreen = class {
 };
 
 // ../packages/job/src/api/JobSkill.ts
-import { system as system22, world as world17 } from "@minecraft/server";
+import { system as system22, world as world18 } from "@minecraft/server";
 var JobSkillComponent = class {
   constructor(componentName) {
     this.componentName = componentName;
@@ -6380,7 +6417,7 @@ var JobSkill = class {
     this.name = name;
     this.description = description;
     this.lastingTicks = lastingTicks;
-    world17.afterEvents.itemUse.subscribe((arg) => {
+    world18.afterEvents.itemUse.subscribe((arg) => {
       const { source, itemStack } = arg;
       if (itemStack.typeId !== this.typeId) return;
       if (isInCooldown(itemStack, source)) {
@@ -6411,18 +6448,18 @@ var JobSkill = class {
 };
 
 // ../packages/job/src/api/JobServer.ts
-import { world as world18 } from "@minecraft/server";
+import { world as world19 } from "@minecraft/server";
 
 // ../packages/job/src/events/JobEvents.ts
 import {
-  Player as Player25
+  Player as Player26
 } from "@minecraft/server";
 var JobEvents = class {
   constructor() {
   }
   static onHitEntity(arg, server) {
     const { damagingEntity } = arg;
-    if (!(damagingEntity instanceof Player25)) return;
+    if (!(damagingEntity instanceof Player26)) return;
     const job = server.getJob(damagingEntity);
     if (!job) return;
     job.hitEntityEvent(arg, damagingEntity);
@@ -6435,9 +6472,9 @@ var JobEvents = class {
   }
   static onHurt(arg, server) {
     const { hurtEntity } = arg;
-    if (!(hurtEntity instanceof Player25)) {
+    if (!(hurtEntity instanceof Player26)) {
       const damagingEntity = arg.damageSource.damagingEntity;
-      if (!(damagingEntity instanceof Player25)) return;
+      if (!(damagingEntity instanceof Player26)) return;
       const job2 = server.getJob(damagingEntity);
       if (!job2) return;
       job2.causeDamageEvent(arg, damagingEntity);
@@ -6449,7 +6486,7 @@ var JobEvents = class {
   }
   static onProjectileHit(arg, server) {
     const { source } = arg;
-    if (!(source instanceof Player25)) return;
+    if (!(source instanceof Player26)) return;
     const job = server.getJob(source);
     if (!job) return;
     job.projectileHitEvent(arg, source);
@@ -6460,16 +6497,16 @@ var JobEvents = class {
 var JobServer = class {
   jobs = /* @__PURE__ */ new Map();
   startUp() {
-    world18.afterEvents.playerBreakBlock.subscribe((arg) => {
+    world19.afterEvents.playerBreakBlock.subscribe((arg) => {
       JobEvents.onMineBlock(arg, this);
     });
-    world18.afterEvents.entityHitEntity.subscribe((arg) => {
+    world19.afterEvents.entityHitEntity.subscribe((arg) => {
       JobEvents.onHitEntity(arg, this);
     });
-    world18.afterEvents.entityHurt.subscribe((arg) => {
+    world19.afterEvents.entityHurt.subscribe((arg) => {
       JobEvents.onHurt(arg, this);
     });
-    world18.afterEvents.projectileHitEntity.subscribe((arg) => {
+    world19.afterEvents.projectileHitEntity.subscribe((arg) => {
       JobEvents.onProjectileHit(arg, this);
     });
   }
@@ -6586,7 +6623,7 @@ var CreditsScreen = class {
 import {
   CustomCommandSource as CustomCommandSource5,
   CustomCommandStatus as CustomCommandStatus5,
-  Player as Player27,
+  Player as Player28,
   system as system23
 } from "@minecraft/server";
 var CreditsManager = class {
@@ -6613,7 +6650,7 @@ var CreditsManager = class {
             return {
               status: CustomCommandStatus5.Failure
             };
-          if (!(origin.sourceEntity instanceof Player27))
+          if (!(origin.sourceEntity instanceof Player28))
             return {
               status: CustomCommandStatus5.Failure
             };
@@ -6784,6 +6821,7 @@ export {
   Tick,
   Time,
   TimeSpec,
+  Toast,
   ToolMaterial,
   TranslateProvider,
   Tutorial,

package/src/apiVer.ts

@@ -26,10 +26,11 @@ export class StarTenon {
    * - 10：加入了 Server Binding API
    *   - 10.1：新的工具集函数，BlockEntity 的 API 行为变化
    * - 11：教程 API 的改进，单独的依赖库文件的提供
+   * - 12：加入了 Toast API
    */
-  static apiLevel: number = 11;
+  static apiLevel: number = 12;
   /**
    * Star Tenon API 对应的版本号
    */
-  static version: string = `0.28.0 (API: ${this.apiLevel})`;
+  static version: string = `0.29.0 (API: ${this.apiLevel})`;
 }