mcbe-leveldb 1.15.0-jsonly → 1.16.0-jsonly

package/Changelog.md

@@ -1,3 +1,55 @@
+# v1.16.0
+
+## Additions
+
+-   Added a custom serializer and parser for the `BiomeState` content type.
+-   Added the `BiomeState` NBT schema.
+-   Added a custom serializer and parser for the `BorderBlocks` content type.
+-   Added the `BorderBlocks` NBT schema.
+-   Added a custom serializer and parser for the `HardcodedSpawners` content type.
+-   Added the `HardcodedSpawners` NBT schema.
+-   Added a custom serializer and parser for the `AABBVolumes` content type.
+-   Added the `AABBVolumes` NBT schema.
+-   Added the format type for the following content types:
+    -   `GeneratedPreCavesAndCliffsBlending`
+    -   `MetaDataHash`
+    -   `ActorDigestVersion`
+-   Added default values for the following content types:
+    -   `GeneratedPreCavesAndCliffsBlending`
+    -   `MetaDataHash`
+    -   `ActorDigestVersion`
+-   Documented the possible values for the following content types:
+    -   `Version`
+    -   `LegacyVersion`
+    -   `FinalizedState`
+    -   `GeneratedPreCavesAndCliffsBlending`
+    -   `ActorDigestVersion`
+-   Added/Updated documentation for several content types.
+-   Added enum descriptions to the `version` fields of the versioned `SubChunkPrefix` NBT schemas.
+-   Added the following properties to the `experiments` property of the `LevelDat` NBT schema:
+    -   `data_driven_items`
+    -   `data_driven_vanilla_blocks_and_items`
+    -   `experimental_molang_features`
+    -   `next_major_update`
+    -   `vanilla_experiments`
+-   Added the following properties to the `LevelDat` NBT schema:
+    -   `allowAnonymousBlockDropsInEditorWorlds`
+    -   `cheatsEnabled`
+    -   `daylightCycle`
+    -   `PlayerHasDied`
+    -   `permissionsLevel`
+    -   `playerPermissionsLevel`
+    -   `playerssleepingpercentage`
+    -   `playerwaypoints`
+    -   `serverEditorConnectionPolicy`
+    -   `WorldVersion`
+
+## Fixes
+
+-   Fixed a typo where the `doentitydrops` property of the `LevelDat` NBT schema was incorrectly named `doentitiydrops`.
+-   Many fixes for the NBT schema to JSON schema converter.
+-   Fixes for the NBT schema to TypeScript interface converter.
+
 # v1.15.0
 
 ## Additions

package/LevelUtils.d.ts

@@ -160,9 +160,34 @@ export declare const entryContentTypeToFormatMap: {
     /**
      * The version of a chunk.
      *
-     * The current chunk version as of `v1.21.111` is `41` (`0x29`).
-     *
      * Deleting think key causes the game to completely regenerate the corresponding chunk.
+     *
+     * Possible values:
+     * - `20`: v1.16.100.52
+     * - `21`: v1.16.100.57
+     * - `22`: v1.16.210
+     * - `23`: v1.16.220.50 (+Caves & Cliffs Experimental Toggle)
+     * - `24`: v1.16.220.50 (+Caves & Cliffs Experimental Toggle) (internal/developer builds)
+     * - `25`: v1.16.230.50 (+Caves & Cliffs Experimental Toggle)
+     * - `26`: v1.16.230.50 (+Caves & Cliffs Experimental Toggle) (internal/developer builds)
+     * - `27`: v1.17.30.23 (+Caves & Cliffs Experimental Toggle)
+     * - `28`: v1.17.30.23 (+Caves & Cliffs Experimental Toggle) (internal/developer builds)
+     * - `29`: v1.17.30.25 (+Caves & Cliffs Experimental Toggle)
+     * - `30`: v1.17.30.25 (+Caves & Cliffs Experimental Toggle) (internal/developer builds)
+     * - `31`: v1.17.40.20 (+Caves & Cliffs Experimental Toggle)
+     * - `32`: v1.17.40.20 (+Caves & Cliffs Experimental Toggle) (internal/developer builds)
+     * - `33`: v1.18.0.20
+     * - `34`: v1.18.0.20 (internal/developer builds)
+     * - `35`: v1.18.0.22
+     * - `36`: v1.18.0.22 (internal/developer builds)
+     * - `37`: v1.18.0.24
+     * - `38`: v1.18.0.24 (internal/developer builds)
+     * - `39`: v1.18.0.25
+     * - `40`: v1.18.30 after upgrading entities to independent storage
+     * - `41`: v1.21.40
+     * - `42`: v1.21.120
+     *
+     * @since v1.16.100
      */
     readonly Version: {
         /**
@@ -474,6 +499,10 @@ export declare const entryContentTypeToFormatMap: {
      *
      * @todo Figure out how to parse this.
      * @todo Add a description for this.
+     *
+     * @see https://github.com/yechentide/core-bedrock/blob/77d815439da14b3d0b7d0335b80deb1860aee42a/Analysis/chunk-0x34-legacy-block-extra-data.md
+     * @see https://github.com/robofinch/Prismarine-Anchor/blob/main/crates/bedrock/leveldb-entries/src/entries/legacy_extra_block_data.rs
+     * @see https://github.com/MiemieMethod/bedrock-docs/blob/8cd37dacbd064f5fb2a4953548739a258b31dd21/.knowledge/wiki%E6%91%98%E5%BD%95/%E4%B8%AD%E6%96%87Minecraft%20Wiki/%E5%9F%BA%E5%B2%A9%E7%89%88LevelDB%E6%A0%BC%E5%BC%8F.wikitext#L331
      */
     readonly LegacyBlockExtraData: {
         /**
@@ -482,24 +511,71 @@ export declare const entryContentTypeToFormatMap: {
         readonly type: "unknown";
     };
     /**
-     * @todo Figure out how to parse this.
+     * @todo Figure out what this is used for.
      * @todo Add a description for this.
+     *
+     * @see {@link NBTSchemas.nbtSchemas.BiomeState}
+     *
+     * @description
+     * https://github.com/robofinch/Prismarine-Anchor/blob/6ce90fa2a27c5d81e6cc1cc376e91c757a80e321/crates/bedrock/leveldb-entries/src/entries/biome_state.rs#L103C1-L109C41
+     *
+     * The above source says the following:
+     *
+     * > These state values seem to have something to do with snow accumulation level.
+     * Maybe the maximum level that snow can accumulate to naturally.
+     *
+     * > TODO: determine this
+     *
+     * > Also, note that these could be backed by HashMaps,
+     *
+     * > but the order of real game data is inconsistent, and have very, very few values.
+     *
+     * > This makes things easier for testing to be able to round-trip,
+     * and is probably more performant, too.
      */
     readonly BiomeState: {
         /**
          * The format type of the data.
          */
-        readonly type: "unknown";
+        readonly type: "custom";
+        /**
+         * The format type that results from the {@link entryContentTypeToFormatMap.BiomeState.parse | parse} method.
+         */
+        readonly resultType: "JSONNBT";
+        /**
+         * The function to parse the data.
+         *
+         * The {@link data} parameter should be the buffer read directly from the file or LevelDB entry.
+         *
+         * @param data The data to parse, as a buffer.
+         * @returns The parsed data.
+         *
+         * @throws {RangeError} If the buffer is empty.
+         * @throws {RangeError} If the number of BiomeState entries does is less than the number indicated in buffer.
+         * @throws {RangeError} If one of the BiomeState entries does not contain enough bytes.
+         * @throws {TypeError} If the BiomeState format is unknown.
+         */
+        readonly parse: (data: Buffer) => NBTSchemas.NBTSchemaTypes.BiomeState;
+        /**
+         * The function to serialize the data.
+         *
+         * This result of this can be written directly to the file or LevelDB entry.
+         *
+         * @param data The data to serialize.
+         * @returns The serialized data, as a buffer.
+         *
+         * @throws {TypeError} If one of the BiomeState entries are undefined.
+         * @throws {TypeError} If the BiomeState format is unknown.
+         */
+        readonly serialize: (data: NBTSchemas.NBTSchemaTypes.BiomeState) => Buffer<ArrayBuffer>;
     };
     /**
      * A value that indicates the finalization state of a chunk's data.
      *
      * Possible values:
-     * - `0`: Unknown
-     * - `1`: Unknown
-     * - `2`: Unknown
-     *
-     * @todo Figure out the meanings of the values.
+     * - `0`: NeedsInstaticking - Chunk needs to be ticked
+     * - `1`: NeedsPopulation - Chunk needs to be populated with mobs
+     * - `2`: Done - Chunk generation is fully complete
      */
     readonly FinalizedState: {
         /**
@@ -533,6 +609,9 @@ export declare const entryContentTypeToFormatMap: {
      *
      * @todo Figure out how to parse this.
      * @todo Add a description for this.
+     *
+     * @see https://github.com/MiemieMethod/bedrock-docs/blob/8cd37dacbd064f5fb2a4953548739a258b31dd21/.knowledge/wiki%E6%91%98%E5%BD%95/%E4%B8%AD%E6%96%87Minecraft%20Wiki/%E5%9F%BA%E5%B2%A9%E7%89%88LevelDB%E6%A0%BC%E5%BC%8F.wikitext#L382
+     * @see https://github.com/MiemieMethod/bedrock-docs/blob/8cd37dacbd064f5fb2a4953548739a258b31dd21/.knowledge/wiki%E6%91%98%E5%BD%95/%E4%B8%AD%E6%96%87Minecraft%20Wiki/%E5%9F%BA%E5%B2%A9%E7%89%88LevelDB%E6%A0%BC%E5%BC%8F.wikitext#L1445
      */
     readonly ConversionData: {
         /**
@@ -541,27 +620,80 @@ export declare const entryContentTypeToFormatMap: {
         readonly type: "unknown";
     };
     /**
-     * @todo Figure out how to parse this.
-     * @todo Add a description for this.
+     * The border block data for the chunk.
+     *
+     * @todo Add a better description for this.
      */
     readonly BorderBlocks: {
         /**
          * The format type of the data.
          */
-        readonly type: "unknown";
+        readonly type: "custom";
+        /**
+         * The format type that results from the {@link entryContentTypeToFormatMap.BorderBlocks.parse | parse} method.
+         */
+        readonly resultType: "JSONNBT";
+        /**
+         * The function to parse the data.
+         *
+         * The {@link data} parameter should be the buffer read directly from the file or LevelDB entry.
+         *
+         * @param data The data to parse, as a buffer.
+         * @returns The parsed data.
+         *
+         * @throws {RangeError} If the buffer is empty.
+         * @throws {RangeError} If the length of the buffer is not equal to the expected length based on the first byte.
+         */
+        readonly parse: (data: Buffer) => NBTSchemas.NBTSchemaTypes.BorderBlocks;
+        /**
+         * The function to serialize the data.
+         *
+         * This result of this can be written directly to the file or LevelDB entry.
+         *
+         * @param data The data to serialize.
+         * @returns The serialized data, as a buffer.
+         *
+         * @throws {TypeError} If one of the BorderBlocks entries are undefined.
+         */
+        readonly serialize: (data: NBTSchemas.NBTSchemaTypes.BorderBlocks) => Buffer<ArrayBuffer>;
     };
     /**
      * Bounding boxes for structure spawns, such as a Nether Fortress or Pillager Outpost.
      *
-     * @deprecated Replaced with {@link AABBVolumes} in either 1.21.120 or one of the 1.21.120 previews.
-     *
-     * @todo Figure out how to parse this.
+     * @deprecated Replaced with {@link entryContentTypeToFormatMap.AABBVolumes | AABBVolumes} in either 1.21.10 or one of the 1.21.10 previews.
      */
     readonly HardcodedSpawners: {
         /**
          * The format type of the data.
          */
-        readonly type: "unknown";
+        readonly type: "custom";
+        /**
+         * The format type that results from the {@link entryContentTypeToFormatMap.HardcodedSpawners.parse | parse} method.
+         */
+        readonly resultType: "JSONNBT";
+        /**
+         * The function to parse the data.
+         *
+         * The {@link data} parameter should be the buffer read directly from the file or LevelDB entry.
+         *
+         * @param data The data to parse, as a buffer.
+         * @returns The parsed data.
+         *
+         * @throws {RangeError} If the buffer is less than 4 bytes.
+         * @throws {RangeError} If the length of the buffer is not equal to the expected length based on the first four bytes.
+         */
+        readonly parse: (data: Buffer) => NBTSchemas.NBTSchemaTypes.HardcodedSpawners;
+        /**
+         * The function to serialize the data.
+         *
+         * This result of this can be written directly to the file or LevelDB entry.
+         *
+         * @param data The data to serialize.
+         * @returns The serialized data, as a buffer.
+         *
+         * @throws {TypeError} If one of the HardcodedSpawners entries are undefined.
+         */
+        readonly serialize: (data: NBTSchemas.NBTSchemaTypes.HardcodedSpawners) => Buffer<ArrayBuffer>;
     };
     /**
      * @see {@link NBTSchemas.nbtSchemas.RandomTicks}
@@ -619,20 +751,53 @@ export declare const entryContentTypeToFormatMap: {
         readonly type: "unknown";
     };
     /**
-     * @deprecated Unused.
+     * UNDOCUMENTED.
      *
-     * @todo Figure out how to parse this.
+     * Possible values:
+     * - `0`: False
+     * - `1`: True
+     *
+     * @todo Try to get a world with this to see how it works.
      * @todo Add a description for this.
+     *
+     * @see https://github.com/MiemieMethod/bedrock-docs/blob/8cd37dacbd064f5fb2a4953548739a258b31dd21/.knowledge/wiki%E6%91%98%E5%BD%95/%E4%B8%AD%E6%96%87Minecraft%20Wiki/%E5%9F%BA%E5%B2%A9%E7%89%88LevelDB%E6%A0%BC%E5%BC%8F.wikitext?plain=1#L481
+     *
+     * @see https://github.com/MiemieMethod/bedrock-docs/blob/8cd37dacbd064f5fb2a4953548739a258b31dd21/.knowledge/wiki%E6%91%98%E5%BD%95/%E4%B8%AD%E6%96%87Minecraft%20Wiki/%E5%9F%BA%E5%B2%A9%E7%89%88LevelDB%E6%A0%BC%E5%BC%8F.wikitext#L1470
+     * One of the sources seem to indicate this was added in 1.17.30.25. (Verify this, then add the \@since tag.)
      */
     readonly GeneratedPreCavesAndCliffsBlending: {
         /**
          * The format type of the data.
          */
-        readonly type: "unknown";
+        readonly type: "int";
+        /**
+         * How many bytes this integer is.
+         */
+        readonly bytes: 1;
+        /**
+         * The endianness of the data.
+         */
+        readonly format: "LE";
+        /**
+         * The signedness of the data.
+         */
+        readonly signed: false;
+        /**
+         * The default value to use when initializing a new entry.
+         *
+         * Bytes:
+         * ```json
+         * [0]
+         * ```
+         */
+        readonly defaultValue: Buffer<ArrayBuffer>;
     };
     /**
      * @todo Figure out how to parse this.
      * @todo Add a description for this.
+     *
+     * @see https://github.com/MiemieMethod/bedrock-docs/blob/8cd37dacbd064f5fb2a4953548739a258b31dd21/.knowledge/wiki%E6%91%98%E5%BD%95/%E4%B8%AD%E6%96%87Minecraft%20Wiki/%E5%9F%BA%E5%B2%A9%E7%89%88LevelDB%E6%A0%BC%E5%BC%8F.wikitext#L1471
+     * One of the sources seem to indicate this was added in 1.17.30.25.
      */
     readonly BlendingBiomeHeight: {
         /**
@@ -645,17 +810,40 @@ export declare const entryContentTypeToFormatMap: {
      * for the NBT metadata of this chunk. Seems like it might default to something dependent
      * on the current game or chunk version.
      *
-     * @todo Figure out how to parse this.
+     * This is an unsigned 64-bit hex value (16 digits, 8 bytes).
      */
     readonly MetaDataHash: {
         /**
          * The format type of the data.
          */
-        readonly type: "unknown";
+        readonly type: "hex";
+        /**
+         * The default value to use when initializing a new entry.
+         *
+         * Bytes:
+         * ```json
+         * [0, 0, 0, 0, 0, 0, 0, 0]
+         * ```
+         */
+        readonly defaultValue: Buffer<ArrayBuffer>;
+        /**
+         * The minimum length of the data in bytes (if the hex data is a string of hexadecimal characters, two characters is one byte).
+         */
+        readonly minLength: 8;
+        /**
+         * The maximum length of the data in bytes (if the hex data is a string of hexadecimal characters, two characters is one byte).
+         */
+        readonly maxLength: 8;
     };
     /**
      * @todo Figure out how to parse this.
      * @todo Add a description for this.
+     *
+     * @see https://github.com/robofinch/Prismarine-Anchor/blob/main/crates/bedrock/leveldb-entries/src/entries/blending_data.rs#L10
+     * @see https://github.com/MiemieMethod/bedrock-docs/blob/8cd37dacbd064f5fb2a4953548739a258b31dd21/.knowledge/wiki%E6%91%98%E5%BD%95/%E4%B8%AD%E6%96%87Minecraft%20Wiki/%E5%9F%BA%E5%B2%A9%E7%89%88LevelDB%E6%A0%BC%E5%BC%8F.wikitext#L526
+     *
+     * @see https://github.com/MiemieMethod/bedrock-docs/blob/8cd37dacbd064f5fb2a4953548739a258b31dd21/.knowledge/wiki%E6%91%98%E5%BD%95/%E4%B8%AD%E6%96%87Minecraft%20Wiki/%E5%9F%BA%E5%B2%A9%E7%89%88LevelDB%E6%A0%BC%E5%BC%8F.wikitext#L1475
+     * One of the sources seem to indicate this was added in 1.17.30.
      */
     readonly BlendingData: {
         /**
@@ -664,21 +852,64 @@ export declare const entryContentTypeToFormatMap: {
         readonly type: "unknown";
     };
     /**
-     * @todo Figure out how to parse this.
-     * @todo Add a description for this.
+     * The version of the actor digest data.
      *
-     * Seems to always be one byte with a value of `0x00`.
+     * Current known versions:
+     * - `0`: 1.18.30 Format
      */
     readonly ActorDigestVersion: {
         /**
          * The format type of the data.
          */
-        readonly type: "unknown";
+        readonly type: "int";
+        /**
+         * How many bytes this integer is.
+         */
+        readonly bytes: 1;
+        /**
+         * The endianness of the data.
+         */
+        readonly format: "LE";
+        /**
+         * The signedness of the data.
+         */
+        readonly signed: false;
+        /**
+         * The default value to use when initializing a new entry.
+         *
+         * Bytes:
+         * ```json
+         * [0]
+         * ```
+         */
+        readonly defaultValue: Buffer<ArrayBuffer>;
     };
     /**
-     * @deprecated Only used in versions < 1.16.100. Later versions use {@link entryContentTypeToFormatMap.Version}
+     * The version of a chunk for versions < 1.16.100.
      *
-     * @todo Add a description for this.
+     * Possible values:
+     * - `0`: v0.9.0
+     * - `1`: v0.9.2
+     * - `2`: v0.9.5
+     * - `3`: v0.17.0.1
+     * - `4`: v1.1.0
+     * - `5`: Converted from console to v1.1.0
+     * - `6`: v1.2.0.2
+     * - `7`: v1.2.0
+     * - `8`: v1.2.13
+     * - `9`: v1.8.0
+     * - `10`: v1.9.0
+     * - `11`: v1.11.0.1
+     * - `12`: v1.11.0.3
+     * - `13`: v1.11.0.4
+     * - `14`: v1.11.1
+     * - `15`: v1.12.0.4
+     * - `16`: v1.14.0
+     * - `17`: v1.15.0
+     * - `18`: v1.16.0.51
+     * - `19`: v1.16.0
+     *
+     * @deprecated Only used in versions < 1.16.100. Later versions use {@link entryContentTypeToFormatMap.Version | Version}
      */
     readonly LegacyVersion: {
         /**
@@ -916,6 +1147,8 @@ export declare const entryContentTypeToFormatMap: {
      * @deprecated Only used in versions < 1.5.0.
      *
      * @todo Add a description for this.
+     *
+     * @see https://github.com/robofinch/Prismarine-Anchor/blob/main/crates/bedrock/leveldb-entries/src/entries/flat_world_layers.rs
      */
     readonly FlatWorldLayers: {
         /**
@@ -927,6 +1160,8 @@ export declare const entryContentTypeToFormatMap: {
      * @deprecated It is unknown when this was removed, it was found in a Windows 10 Edition Beta v0.15.0 world.
      *
      * @todo Add a description for this.
+     *
+     * @see https://github.com/robofinch/Prismarine-Anchor/blob/main/crates/bedrock/leveldb-entries/src/entries/level_spawn_was_fixed.rs
      */
     readonly LevelSpawnWasFixed: {
         /**
@@ -946,7 +1181,7 @@ export declare const entryContentTypeToFormatMap: {
     /**
      * Stores the location of a lodestone compass.
      *
-     * @todo Add a schema for this.
+     * @see {@link NBTSchemas.nbtSchemas.PositionTrackingDB}
      */
     readonly PositionTrackingDB: {
         /**
@@ -957,7 +1192,7 @@ export declare const entryContentTypeToFormatMap: {
     /**
      * The last ID used for a lodestone compass.
      *
-     * @todo Add a schema for this.
+     * @see {@link NBTSchemas.nbtSchemas.PositionTrackingLastId}
      */
     readonly PositionTrackingLastId: {
         /**
@@ -1178,7 +1413,6 @@ export declare const entryContentTypeToFormatMap: {
      *
      * @since 1.26.10 (maybe 1.26.0)
      *
-     * @todo Update the linked NBT schema once it is known the structure of the items of the `clocks` list.
      * @todo Figure out that this is used for.
      * @todo Figure out what preview and full release this was actually added in.
      */
@@ -1214,13 +1448,46 @@ export declare const entryContentTypeToFormatMap: {
      * and volumes where mobs cannot spawn through the normal biome-based means (such as
      * Trial Chambers).
      *
-     * @todo Figure out how to parse this.
+     * @see {@link NBTSchemas.nbtSchemas.AABBVolumes}
+     *
+     * @since 1.21.20 (or some 1.21.20 preview)
      */
     readonly AABBVolumes: {
         /**
          * The format type of the data.
          */
-        readonly type: "unknown";
+        readonly type: "custom";
+        /**
+         * The format type that results from the {@link entryContentTypeToFormatMap.AABBVolumes.parse | parse} method.
+         */
+        readonly resultType: "JSONNBT";
+        /**
+         * The function to parse the data.
+         *
+         * The {@link data} parameter should be the buffer read directly from the file or LevelDB entry.
+         *
+         * @param data The data to parse, as a buffer.
+         * @returns The parsed data.
+         *
+         * @throws {RangeError} If the buffer is less than 4 bytes.
+         * @throws {unknown} If an error occurs while parsing the data.
+         */
+        readonly parse: (data: Buffer) => NBTSchemas.NBTSchemaTypes.AABBVolumes;
+        /**
+         * The function to serialize the data.
+         *
+         * This result of this can be written directly to the file or LevelDB entry.
+         *
+         * @param data The data to serialize.
+         * @returns The serialized data, as a buffer.
+         *
+         * @throws {TypeError} If one of the StructureTypes entries are undefined.
+         * @throws {TypeError} If one of the ChunkBoundingBoxes entries are undefined.
+         * @throws {TypeError} If one of the DynamicSpawnAreas entries are undefined.
+         * @throws {TypeError} If one of the StaticSpawnAreas entries are undefined.
+         * @throws {unknown} If an error occurs while serializing the data.
+         */
+        readonly serialize: (data: NBTSchemas.NBTSchemaTypes.AABBVolumes) => Buffer<ArrayBuffer>;
     };
     /**
      * The content type of the `DynamicProperties` LevelDB key, which stores dynamic properties data for add-ons.
@@ -1254,6 +1521,8 @@ export declare const entryContentTypeToFormatMap: {
      * ```
      * {BYTEx4}{BYTEx8}{NBTCompound}{BYTEx8}{NBTCompound}{BYTEx8}{NBTCompound}{BYTEx8}{NBTCompound}
      * ```
+     *
+     * @see {@link NBTSchemas.nbtSchemas.LevelChunkMetaDataDictionary}
      */
     readonly LevelChunkMetaDataDictionary: {
         /**
@@ -1297,8 +1566,11 @@ export declare const entryContentTypeToFormatMap: {
         readonly defaultValue: Buffer<ArrayBuffer>;
     };
     /**
-     * @todo Add a schema for this.
      * @todo Add a description for this.
+     *
+     * @see {@link NBTSchemas.nbtSchemas.ChunkLoadedRequest}
+     *
+     * @see https://github.com/MiemieMethod/bedrock-docs/blob/main/.knowledge/wiki%E6%91%98%E5%BD%95/%E4%B8%AD%E6%96%87Minecraft%20Wiki/%E5%9F%BA%E5%B2%A9%E7%89%88LevelDB%E6%A0%BC%E5%BC%8F.wikitext#L1175
      */
     readonly ChunkLoadedRequest: {
         /**
@@ -1327,7 +1599,49 @@ export type EntryContentTypeFormatData = ({
     /**
      * The format type of the data.
      */
-    readonly type: "JSON" | "SNBT" | "ASCII" | "binary" | "binaryPlainText" | "hex" | "UTF-8" | "unknown";
+    readonly type: "JSON" | "SNBT" | "unknown";
+} | {
+    /**
+     * The format type of the data.
+     */
+    readonly type: "ASCII" | "binary" | "binaryPlainText" | "UTF-8";
+    /**
+     * The minimum length of the data.
+     *
+     * If not present, `0` should be assumed.
+     *
+     * @default 0
+     */
+    readonly minLength?: number;
+    /**
+     * The maximum length of the data.
+     *
+     * If not present, `Infinity` should be assumed.
+     *
+     * @default Infinity
+     */
+    readonly maxLength?: number;
+} | {
+    /**
+     * The format type of the data.
+     */
+    readonly type: "hex";
+    /**
+     * The minimum length of the data in bytes (if the hex data is a string of hexadecimal characters, two characters is one byte).
+     *
+     * If not present, `0` should be assumed.
+     *
+     * @default 0
+     */
+    readonly minLength?: number;
+    /**
+     * The maximum length of the data in bytes (if the hex data is a string of hexadecimal characters, two characters is one byte).
+     *
+     * If not present, `Infinity` should be assumed.
+     *
+     * @default Infinity
+     */
+    readonly maxLength?: number;
 } | {
     /**
      * The format type of the data.