Point of Interest format

This feature is exclusive to Java Edition.

Point of Interests are stored in the poi folder of respective dimension folders. It is stored like Minecraft Anvil format files, which are named in the form r.x.z.mca.

Folder structure[edit | edit source]

(world save directory)
- poi
  - r.x.z.mca
- DIM-1
  - poi
    - r.x.z.mca
- DIM1
  - poi
    - r.x.z.mca

NBT structure[edit | edit source]

Every Point of Interest is an unnamed compound contained in the Records list of a chunk file.

The root tag.
- DataVersion: Version of the chunk data.
- Sections: All chunk sections. One chunk section is a area of 16×16×16 blocks.
  - <section>^[1]: A section of a chunk holding point of interest data related to that section.
    - Vaild: 1 or 0 (true/false) - Most often true. If the value is false, the entries in Records are removed and the value is set back to true when the chunk is loaded the next time.
    - Records: A list of all point of interest blocks in the section.
      - : A point of interest block.
        type: Defines what type of point of interest this is. It is always one of the following: minecraft:armorer, minecraft:bee_nest, minecraft:beehive, minecraft:butcher, minecraft:cartographer, minecraft:cleric, minecraft:farmer, minecraft:fisherman, minecraft:fletcher, minecraft:home, minecraft:leatherworker, minecraft:librarian, minecraft:lightning_rod, minecraft:lodestone, minecraft:mason, minecraft:meeting, minecraft:nether_portal, minecraft:shepherd, minecraft:toolsmith, minecraft:weaponsmith.
        
        free_tickets: The number of villagers that can claim this point of interest block. Value decreases / increases by 1 for each villager that claims / loses the point of interest block.
        
        pos: The point of interest blocks position in the world.
        : X coordinate.
        
        : Y coordinate.
        
        : Z coordinate.

History[edit | edit source]

Java Edition
1.14	19w11a	Added point of interest system. Valid point of interest types for this version are: `minecraft:armorer`, `minecraft:butcher`, `minecraft:cartographer`, `minecraft:cleric`, `minecraft:farmer`, `minecraft:fisherman`, `minecraft:fletcher`, `minecraft:home`, `minecraft:leatherworker`, `minecraft:librarian`, `minecraft:mason`, `minecraft:meeting`, `minecraft:shepherd`, `minecraft:toolsmith`, `minecraft:weaponsmith`
1.14	1.14 Pre-Release 1	Changed the point of interest format. Renamed the `<section>`^[1] list to `Records` and moved it into a TAG_Compound named `<section>`^[1] instead along with a `Vaild` TAG_Byte, which is in a `Sections` TAG_Compound itself, and added `DataVersion` to the root compound.
1.15	19w34a	Added point of interest types `minecraft:bee_nest` and `minecraft:bee_hive`
	19w36a	Added point of interest type `minecraft:nether_portal`
	19w41a	Renamed point of interest type `minecraft:bee_hive` to `minecraft:beehive`
1.16	20w13a	Added point of interest type `minecraft:lodestone`
1.17	20w45a	Added point of interest type `minecraft:lightning_rod`

References[edit | edit source]

↑ ^a ^b ^c "<section>" is a variable which is equal to the chunk sections Y value. i.e: "0"

Navigation[edit | edit source]

[section_naming-1] "<section>" is a variable which is equal to the chunk sections Y value. i.e: "0"

[1]