yeow-api 0.2.108 → 0.2.110

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "yeow-api",
-    "version": "0.2.108",
+    "version": "0.2.110",
     "description": "Yeow API",
     "type": "module",
     "main": "./src/index.ts",

package/src/core.ts

@@ -32,7 +32,7 @@ export type {
 export { onInit, onLoad, onUnload } from './lifecycle.js';
 export {
     broadcast, broadcastSync, dispatchCommand, dispatchCommandSync,
-    setMotd, setMotdSync, setIcon, setIconSync,
+    setMotd, setMotdSync,
     getMotd, getMotdSync, getVersion, getVersionSync,
     getTps, getTpsSync, getMaxPlayers, getMaxPlayersSync,
 } from './server.js';

package/src/event.ts

@@ -151,10 +151,18 @@ export interface InventoryCloseEvent {
 }
 export interface ServerPingEvent {
   address: string;
+  /** 当前在线人数。handler 可返回 `{ numPlayers: <number> }` 覆盖该次 ping 响应显示的在线人数——**不建议修改**（伪装在线人数可能违反服务器列表政策）。 */
   numPlayers: number;
+  /** 最大玩家数。handler 可返回 `{ maxPlayers: <number> }` 覆盖该次 ping 响应显示的最大玩家数——**不建议修改**（仅影响显示，不改变实际进入限制）。 */
   maxPlayers: number;
+  /** MOTD 文本。handler 可返回 `{ motd: "<text>" }` 覆盖该次 ping 响应的 MOTD。 */
   motd: string;
   cancelled?: boolean;
+  /**
+   * handler 可返回 `{ icon: "<PNG base64>" }` 修改服务器列表图标
+   * （自动缩放至 64×64；无效图片忽略，保持原图标）。
+   */
+  icon?: string;
 }
 export interface PlayerTeleportEvent {
   player: Player;
@@ -344,7 +352,7 @@ function adaptEvent<K extends keyof EventMap>(type: K, data: RawEvent): EventMap
 
 // ── Event Subscription ─────────────────────────────────────────────
 
-type EventHandler<K extends keyof EventMap> = (e: EventMap[K]) => void;
+type EventHandler<K extends keyof EventMap> = (e: EventMap[K]) => unknown;
 type ManualHandler<K extends keyof EventMap> = (
   e: EventMap[K],
   complete: (result?: Record<string, unknown>) => void,
@@ -394,7 +402,10 @@ export function eventOn<K extends keyof EventMap>(
     }
 
     const result = (handler as EventHandler<typeof eventType>)(wrapped);
-    const mods = { cancelled: localMods.cancelled || false };
+    const mods: Record<string, unknown> = {
+      ...(result && typeof result === 'object' ? result : {}),
+    };
+    if (localMods.cancelled) mods.cancelled = true;
     $send('task', { type: 'event.complete', params: { callbackId: cbId, mods }, cb: '' });
   }, { persistent: true });
 

package/src/server.ts

@@ -7,8 +7,6 @@ export function dispatchCommand(cmd: string, options?: TaskOptions): Promise<boo
 export function dispatchCommandSync(cmd: string, options?: TaskOptions): boolean { return call<boolean>('command.dispatch', { command: cmd }, options); }
 export function setMotd(motd: string, options?: TaskOptions): Promise<void> { return post('server.setMotd', { motd }, options); }
 export function setMotdSync(motd: string, options?: TaskOptions): void { call('server.setMotd', { motd }, options); }
-export function setIcon(base64: string, options?: TaskOptions): Promise<void> { return post('server.setIcon', { icon: base64 }, options); }
-export function setIconSync(base64: string, options?: TaskOptions): void { call('server.setIcon', { icon: base64 }, options); }
 export function getMotd(options?: TaskOptions): Promise<string> { return post<string>('server.getMotd', {}, options); }
 export function getMotdSync(options?: TaskOptions): string { return call<string>('server.getMotd', {}, options); }
 export function getVersion(options?: TaskOptions): Promise<string> { return post<string>('server.getVersion', {}, options); }