Point of Interest format

It has been suggested that this page be merged with Point of interest.

^[discuss^]

If this merge affects many pages or may potentially be controversial, do not merge the page until a consensus is reached.

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

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

NBT structure

Every point of interest is an unnamed [NBT Compound / JSON Object] compound contained in the Records list of a chunk file.

[NBT Compound / JSON Object] The root tag.
- [Int] DataVersion: Version of the chunk data.
- [NBT Compound / JSON Object] Sections: All chunk sections. One chunk section is a area of 16×16×16 blocks.
  - [NBT Compound / JSON Object] <section>^[1]: A section of a chunk holding point of interest data related to that section.
    - [Byte] Valid: 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.
    - [NBT List / JSON Array] Records: A list of all point of interest blocks in the section.
      - [NBT Compound / JSON Object]: A point of interest block.
        [String] 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 or minecraft:test_instance.
        
        [Int] 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.
        
        [Int Array] pos: The point of interest blocks position in the world.
        [Int]: X coordinate.
        
        [Int]: Y coordinate.
        
        [Int]: Z coordinate.

History

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 `Valid` 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`.
1.21.6	25w16a	Added point of interest type `minecraft:test_instance`.

References

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

Navigation

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

[1]