@vaitosoi/minejs 0.2.1 → 0.3.1

package/dist/world/entity.d.ts

@@ -0,0 +1,43 @@
+import { AABB } from "../physics/aabb";
+import { SharedState } from "./state";
+export declare class EntitiesManager {
+    private state;
+    /**
+     * Split chunks into 16x16x16 sections, so each chunk sections will contain a set of entities
+     *
+     * A key is `{chunkSectionX}:{chunkSectionY}:{chunkSectionZ}`
+     */
+    sections: Map<string, Set<number>>;
+    /**
+     * A map mapping entity ID to section key.
+     */
+    entityToSection: Map<number, string>;
+    constructor(state: SharedState);
+    /**
+     * Clear data
+     */
+    wipe(): void;
+    /**
+     * Convert real-world position into section key
+     */
+    static getSectionKey(x: number, y: number, z: number): string;
+    /**
+     * Add an entity (represented by ID)
+     */
+    add(entityId: number, x: number, y: number, z: number): void;
+    /**
+     * Remove entity
+     */
+    remove(entityId: number): void;
+    /**
+     * Update entity position
+     */
+    update(entityId: number, x: number, y: number, z: number): void;
+    /**
+     * Query the entity in the section that intersec with BB
+     * @param queryBB The querying bounding box
+     * @returns
+     */
+    queryAABB(queryBB: AABB, exclude?: number[]): AABB[];
+}
+//# sourceMappingURL=entity.d.ts.map

package/dist/world/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../src/world/entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,qBAAa,eAAe;IAYZ,OAAO,CAAC,KAAK;IAXzB;;;;OAIG;IACI,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAa;IACtD;;OAEG;IACI,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IAExD,YAAoB,KAAK,EAAE,WAAW,EAAK;IAE3C;;OAEG;IACI,IAAI,SAGV;IAED;;OAEG;IACH,OAAc,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,UAI1D;IAED;;OAEG;IACI,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,QAK3D;IAED;;OAEG;IACI,MAAM,CAAC,QAAQ,EAAE,MAAM,QAM7B;IAED;;OAEG;IACI,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,QAM9D;IAED;;;;OAIG;IACI,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,GAAE,MAAM,EAAO,UAyBrD;CACJ"}

package/dist/world/entity.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntitiesManager = void 0;
+const aabb_1 = require("../physics/aabb");
+class EntitiesManager {
+    state;
+    /**
+     * Split chunks into 16x16x16 sections, so each chunk sections will contain a set of entities
+     *
+     * A key is `{chunkSectionX}:{chunkSectionY}:{chunkSectionZ}`
+     */
+    sections = new Map();
+    /**
+     * A map mapping entity ID to section key.
+     */
+    entityToSection = new Map();
+    constructor(state) {
+        this.state = state;
+    }
+    /**
+     * Clear data
+     */
+    wipe() {
+        this.sections = new Map();
+        this.entityToSection = new Map();
+    }
+    /**
+     * Convert real-world position into section key
+     */
+    static getSectionKey(x, y, z) {
+        // Divide 2^4 = 16
+        const sx = x >> 4, sy = y >> 4, sz = z >> 4;
+        return `${sx}:${sy}:${sz}`;
+    }
+    /**
+     * Add an entity (represented by ID)
+     */
+    add(entityId, x, y, z) {
+        const key = EntitiesManager.getSectionKey(x, y, z);
+        if (!this.sections.has(key))
+            this.sections.set(key, new Set());
+        this.sections.get(key).add(entityId);
+        this.entityToSection.set(entityId, key);
+    }
+    /**
+     * Remove entity
+     */
+    remove(entityId) {
+        const key = this.entityToSection.get(entityId);
+        if (key) {
+            this.sections.get(key)?.delete(entityId);
+            this.entityToSection.delete(entityId);
+        }
+    }
+    /**
+     * Update entity position
+     */
+    update(entityId, x, y, z) {
+        const newKey = EntitiesManager.getSectionKey(x, y, z);
+        if (this.entityToSection.get(entityId) !== newKey) {
+            this.remove(entityId);
+            this.add(entityId, x, y, z);
+        }
+    }
+    /**
+     * Query the entity in the section that intersec with BB
+     * @param queryBB The querying bounding box
+     * @returns
+     */
+    queryAABB(queryBB, exclude = []) {
+        this.state.checkReady();
+        const { minX, minY, minZ, maxX, maxY, maxZ } = queryBB;
+        const results = [];
+        const sx0 = minX >> 4, sx1 = maxX >> 4;
+        const sy0 = minY >> 4, sy1 = maxY >> 4;
+        const sz0 = minZ >> 4, sz1 = maxZ >> 4;
+        for (let sx = sx0; sx <= sx1; sx++) {
+            for (let sy = sy0; sy <= sy1; sy++) {
+                for (let sz = sz0; sz <= sz1; sz++) {
+                    const bucket = this.sections.get(`${sx},${sy},${sz}`);
+                    if (bucket)
+                        for (const id of bucket) {
+                            if (exclude.includes(id))
+                                continue;
+                            const entity = this.state.world.entities[id];
+                            const entityBB = aabb_1.AABB.fromEntityType(entity.type);
+                            if (queryBB.isIntersect(entityBB))
+                                results.push(entityBB);
+                        }
+                }
+            }
+        }
+        return results;
+    }
+}
+exports.EntitiesManager = EntitiesManager;
+//# sourceMappingURL=entity.js.map

package/dist/world/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../src/world/entity.ts"],"names":[],"mappings":"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"}

package/dist/world/state.d.ts

@@ -0,0 +1,151 @@
+import { Cipheriv, Decipheriv } from "node:crypto";
+import { If } from "../base/typing";
+import { Angle, BaseVec3 } from "../physics/direction";
+import { ClientEvents, ClientOption } from "../client/client";
+export interface Server {
+    knownPacks?: ServerKnownPack;
+}
+export interface ServerKnownPack {
+    namespace: string;
+    id: string;
+    version: string;
+}
+/**
+ * Represent world information
+ */
+export interface ServerWorld {
+    /** Is hardcore enabled */
+    hardcore: boolean;
+    /** All dimensions */
+    dimensions: string[];
+    /** Max players allowed */
+    maxPlayers: number;
+    /** View distances */
+    viewDistance: number;
+    /** Simulation distance */
+    simulationDistance: number;
+    /**
+     * The record key is a chunk section position packed as `Player Dimension:Chunk X:Chunk Z[Section Y]`
+     *
+     * For `Section Y`, a chunk is splitted into several cubic 16x16x16 sections, or in other word, a chunk is a bund of 16x16x16 sections stacked on each other.
+     */
+    chunks: Record<string, ChunkColumn>;
+    /**
+     * The record key is entity ID
+     */
+    entities: Record<number, Entity>;
+}
+/**
+ * Represent a chunk collumns, which may contains multiple chunks sections
+ */
+export interface ChunkColumn {
+    sections: Record<number, ChunkSection>;
+    blockEntities: Record<number, BlockEntity>;
+}
+export interface ChunkSection {
+    block: PaletteContainer;
+    biome: PaletteContainer;
+}
+/**
+ * Used for indirect mapping
+ *
+ * @see https://minecraft.wiki/w/Java_Edition_protocol/Chunk_format#Paletted_Container_structure
+ */
+export interface PaletteContainer {
+    bpe: number;
+    palette: number[];
+    data: BigInt64Array | null;
+}
+/** Represent a block entity */
+export interface BlockEntity {
+    type: number;
+    data: Record<string, any>;
+}
+/** Represent an entity */
+export interface Entity {
+    id: number;
+    type: number;
+    position: BaseVec3;
+    velocity: BaseVec3;
+    angle: Angle;
+    data: number;
+}
+export declare enum GameMode {
+    Survival = 0,
+    Creative = 1,
+    Adventure = 2,
+    Spectator = 3
+}
+export interface ClientPlayer {
+    /** Player UUID */
+    uuid: string;
+    /** Player username */
+    username: string;
+    /** Player entity ID */
+    entityId: number;
+    /** Current game mode */
+    gameMode: GameMode;
+    position: BaseVec3;
+    velocity: BaseVec3;
+    angle: Angle;
+    /** Current dimension */
+    dimension: string;
+}
+export declare enum ClientStatus {
+    Disconnected = 0,
+    Connecting = 1,
+    Logining = 2,
+    Ready = 3
+}
+export declare enum ConnectionState {
+    Disconnected = 0,
+    Handshake = 1,
+    Login = 2,
+    Configure = 3,
+    Play = 4
+}
+export interface ServerRegistryEntry {
+    id: string;
+    data: object;
+}
+export type MutateState = (state: SharedState) => void;
+export type EmittedEvent = {
+    [K in keyof ClientEvents]: {
+        event: K;
+        args: ClientEvents[K];
+    };
+}[keyof ClientEvents];
+export type SendingPacket = {
+    id: string | number;
+    data: Record<string, any>;
+};
+export declare class SharedState<IsReady extends boolean = boolean> {
+    clientOptions: ClientOption;
+    getUuid: () => Buffer;
+    private mutationQueue;
+    private eventQueue;
+    private sendQueue;
+    state: ConnectionState;
+    status: ClientStatus;
+    compressionThreshold: number;
+    sharedSecret: Buffer | undefined;
+    cipher: Cipheriv | undefined;
+    decipher: Decipheriv | undefined;
+    server: Server | undefined;
+    registry: Record<string, ServerRegistryEntry[]> | undefined;
+    world: If<IsReady, ServerWorld>;
+    player: If<IsReady, ClientPlayer>;
+    constructor(clientOptions: ClientOption, getUuid: () => Buffer);
+    isReady(): this is SharedState<true>;
+    checkReady(): void;
+    pruneStates(): void;
+    enqueueMutation(mutation: MutateState): void;
+    enqueuePacket(packet: string, data: object): void;
+    enqueuePacket(packet: SendingPacket): void;
+    enqueueEvent<K extends keyof ClientEvents>(event: K, ...args: ClientEvents[K]): void;
+    enqueueEvent(event: EmittedEvent): void;
+    drainMutation(): void;
+    drainEvent(): EmittedEvent[];
+    drainPacket(): SendingPacket[];
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/world/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/world/state.ts"],"names":[],"mappings":"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"}

package/dist/world/state.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SharedState = exports.ConnectionState = exports.ClientStatus = exports.GameMode = void 0;
+const error_1 = require("../base/error");
+var GameMode;
+(function (GameMode) {
+    GameMode[GameMode["Survival"] = 0] = "Survival";
+    GameMode[GameMode["Creative"] = 1] = "Creative";
+    GameMode[GameMode["Adventure"] = 2] = "Adventure";
+    GameMode[GameMode["Spectator"] = 3] = "Spectator";
+})(GameMode || (exports.GameMode = GameMode = {}));
+var ClientStatus;
+(function (ClientStatus) {
+    ClientStatus[ClientStatus["Disconnected"] = 0] = "Disconnected";
+    ClientStatus[ClientStatus["Connecting"] = 1] = "Connecting";
+    ClientStatus[ClientStatus["Logining"] = 2] = "Logining";
+    ClientStatus[ClientStatus["Ready"] = 3] = "Ready";
+})(ClientStatus || (exports.ClientStatus = ClientStatus = {}));
+var ConnectionState;
+(function (ConnectionState) {
+    ConnectionState[ConnectionState["Disconnected"] = 0] = "Disconnected";
+    ConnectionState[ConnectionState["Handshake"] = 1] = "Handshake";
+    ConnectionState[ConnectionState["Login"] = 2] = "Login";
+    ConnectionState[ConnectionState["Configure"] = 3] = "Configure";
+    ConnectionState[ConnectionState["Play"] = 4] = "Play";
+})(ConnectionState || (exports.ConnectionState = ConnectionState = {}));
+class SharedState {
+    clientOptions;
+    getUuid;
+    mutationQueue = [];
+    eventQueue = [];
+    sendQueue = [];
+    state = ConnectionState.Disconnected;
+    status = ClientStatus.Disconnected;
+    compressionThreshold = 0;
+    sharedSecret = undefined;
+    cipher = undefined;
+    decipher = undefined;
+    server = undefined;
+    registry = undefined;
+    world = null;
+    player = null;
+    constructor(clientOptions, getUuid) {
+        this.clientOptions = clientOptions;
+        this.getUuid = getUuid;
+    }
+    isReady() {
+        return this.status === ClientStatus.Ready;
+    }
+    checkReady() {
+        if (!this.isReady())
+            throw new error_1.ClientNotReady();
+    }
+    pruneStates() {
+        this.mutationQueue = [];
+        this.eventQueue = [];
+        this.sendQueue = [];
+        this.state = ConnectionState.Disconnected;
+        this.compressionThreshold = 0;
+        this.sharedSecret = undefined;
+        this.cipher = undefined;
+        this.decipher = undefined;
+        this.server = undefined;
+        this.registry = undefined;
+        this.world = undefined;
+        this.player = undefined;
+    }
+    enqueueMutation(mutation) { this.mutationQueue.push(mutation); }
+    enqueuePacket(packet, data) {
+        if (typeof packet === "string")
+            this.sendQueue.push({
+                id: packet,
+                data: data
+            });
+        else
+            this.sendQueue.push(packet);
+    }
+    enqueueEvent(event, ...args) {
+        if (typeof event === "string")
+            this.eventQueue.push({
+                event,
+                args: args
+            });
+        else
+            this.eventQueue.push(event);
+    }
+    drainMutation() {
+        while (true) {
+            const mutation = this.mutationQueue.shift();
+            if (mutation)
+                mutation(this);
+            else
+                break;
+        }
+    }
+    drainEvent() {
+        const events = structuredClone(this.eventQueue);
+        this.eventQueue = [];
+        return events;
+    }
+    drainPacket() {
+        const packets = structuredClone(this.sendQueue);
+        this.sendQueue = [];
+        return packets;
+    }
+}
+exports.SharedState = SharedState;
+//# sourceMappingURL=state.js.map

package/dist/world/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/world/state.ts"],"names":[],"mappings":"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"}

package/dist/world/tick.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Tick manager.
+ *
+ * Maintaining 20Hz tick like what vanilla does
+ */
+export declare class TickLoop {
+    private onTick;
+    static readonly TICK_MS = 50;
+    private static readonly TICK_NS;
+    static readonly MAX_CATCHUP_TICKS = 10;
+    private running;
+    private nextTickTime;
+    private timer;
+    constructor(onTick: () => any);
+    start(): void;
+    stop(): void;
+    private next;
+}
+//# sourceMappingURL=tick.d.ts.map

package/dist/world/tick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tick.d.ts","sourceRoot":"","sources":["../../src/world/tick.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,QAAQ;IAUb,OAAO,CAAC,MAAM;IATlB,gBAAuB,OAAO,MAAM;IACpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAqC;IACpE,gBAAuB,iBAAiB,MAAM;IAE9C,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,KAAK,CAAa;IAE1B,YACY,MAAM,EAAE,MAAM,GAAG,EAI5B;IAEM,KAAK,SAIX;IAEM,IAAI,SAIV;IAED,OAAO,CAAC,IAAI;CAiBf"}

package/dist/world/tick.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TickLoop = void 0;
+/**
+ * Tick manager.
+ *
+ * Maintaining 20Hz tick like what vanilla does
+ */
+class TickLoop {
+    onTick;
+    static TICK_MS = 50;
+    static TICK_NS = BigInt(this.TICK_MS) * 1000000n;
+    static MAX_CATCHUP_TICKS = 10;
+    running;
+    nextTickTime;
+    timer = null;
+    constructor(onTick) {
+        this.onTick = onTick;
+        this.running = false;
+        this.nextTickTime = BigInt(0);
+    }
+    start() {
+        this.running = true;
+        this.nextTickTime = process.hrtime.bigint();
+        this.next();
+    }
+    stop() {
+        this.running = false;
+        clearInterval(this.timer);
+        this.nextTickTime = BigInt(0);
+    }
+    next() {
+        if (!this.running)
+            this.stop();
+        const now = process.hrtime.bigint();
+        let tickRuns = 0;
+        while (this.nextTickTime < now && tickRuns < TickLoop.MAX_CATCHUP_TICKS) {
+            this.onTick();
+            this.nextTickTime += TickLoop.TICK_NS;
+            tickRuns++;
+        }
+        if (tickRuns >= TickLoop.MAX_CATCHUP_TICKS)
+            this.nextTickTime = now + TickLoop.TICK_NS;
+        const delayMs = Number((this.nextTickTime - process.hrtime.bigint())) / 1_000_000;
+        this.timer = setTimeout(() => this.next(), Math.max(0, delayMs));
+    }
+}
+exports.TickLoop = TickLoop;
+//# sourceMappingURL=tick.js.map

package/dist/world/tick.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tick.js","sourceRoot":"","sources":["../../src/world/tick.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH;IAUgB,MAAM;IATX,MAAM,CAAU,OAAO,GAAG,EAAE,CAAC;IAC5B,MAAM,CAAU,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,QAAU,CAAC;IAC7D,MAAM,CAAU,iBAAiB,GAAG,EAAE,CAAC;IAEtC,OAAO,CAAU;IACjB,YAAY,CAAS;IACrB,KAAK,GAAQ,IAAI,CAAC;IAE1B,YACY,MAAiB;sBAAjB,MAAM;QAEd,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IAEM,KAAK;QACR,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI,EAAE,CAAC;IAChB,CAAC;IAEM,IAAI;QACP,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IAEO,IAAI;QACR,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAE/B,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACpC,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC,YAAY,GAAG,GAAG,IAAI,QAAQ,GAAG,QAAQ,CAAC,iBAAiB,EAAE,CAAC;YACtE,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,IAAI,CAAC,YAAY,IAAI,QAAQ,CAAC,OAAO,CAAC;YACtC,QAAQ,EAAE,CAAC;QACf,CAAC;QAED,IAAI,QAAQ,IAAI,QAAQ,CAAC,iBAAiB;YACtC,IAAI,CAAC,YAAY,GAAG,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC;QAE/C,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC;QAClF,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACrE,CAAC;CACJ"}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@vaitosoi/minejs",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "A Minecraft client package",
   "license": "MIT",
   "repository": {
     "url": "git+https://github.com/VaitoSoi/minejs"
   },
+  "homepage": "https://minejs.vaito.dev/",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -23,6 +24,9 @@
   "engines": {
     "node": ">=22"
   },
+  "scripts": {
+    "prepare": "eslint . --fix && tsc --noEmit"
+  },
   "devDependencies": {
     "@clean-jsdoc-theme/typedoc": "5.0.5",
     "@eslint/js": "^10.0.1",
@@ -38,7 +42,8 @@
     "typescript-eslint": "^8.60.1"
   },
   "dependencies": {
-    "bitset": "^5.2.3"
+    "bitset": "^5.2.3",
+    "zod": "^4.4.3"
   },
   "packageManager": "pnpm@11.15.1+sha512.81350b07e53c9538a02f1f2303b4290fa2d7be04e56e2a970c4cc4b417dc761de196edabd49d55c7dc9580db81007c44143e4e3d7e462b3000d23c255122d065"
 }

package/src/base/error.ts

@@ -115,4 +115,40 @@ export class ClientNotReady extends Error {
     constructor() {
         super(`client is not ready`);
     }
+}
+
+/** @hidden */
+export class VersionNotSupport extends Error {
+    constructor(public version: string) {
+        super(`version ${version} is not supported`);
+    }
+}
+
+/** @hidden */
+export class CantReadFile extends Error {
+    constructor(public path: string) {
+        super(`can't read file at "${path}"`);
+    }
+}
+
+/** @hidden */
+export class InvalidPacketStructure extends Error {
+    constructor(public path: string, public zodIssue?: any[]) {
+        super(`packet structure in file "${path}" is invalid` + (zodIssue?.length ? ", zod issue: " + JSON.stringify(zodIssue, null, 4) : ""));
+    }
+}
+
+
+/** @hidden */
+export class MissingPacketField extends Error {
+    constructor(public packetId: number, public field: string, public need: string) {
+        super(`${packetId}: ${field} need ${need}, but not found`);
+    }
+}
+
+/** @hidden */
+export class MissingField extends Error {
+    constructor(public field: string, public where: string) {
+        super(`missing ${field} in ${where}`);
+    }
 }

package/src/base/typing.ts

@@ -1,2 +1,10 @@
 /** @hidden */
-export type If<Condition extends boolean, True, False = null> = Condition extends true ? True : False;
+export type If<Condition extends boolean, True, False = null> = Condition extends true ? True : Condition extends false ? False : True | False;
+
+
+/**
+ * Representing a TextComponent
+ * 
+ * @see https://minecraft.wiki/w/Text_component_format
+ */
+export type TextComponent = Record<string, any>;