> For the complete documentation index, see [llms.txt](https://evanthebearge.gitbook.io/minecraft-earth-map/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://evanthebearge.gitbook.io/minecraft-earth-map/minecraft-earth-tiles/required-addons/addons-pbf-file.md).

# Addons - PBF File

The purpose of having a PBF file is to help with the generation of the Earth Map using more accurate geographical data compared to downloading lower resolution from the overpass api.

### Recommended, if checked inside the program when not using the pre-filtered pbf file addon.

If you have not downloaded the pre-filtered pbf file, you can find it in [Addons - Part 1](/minecraft-earth-map/minecraft-earth-tiles/required-addons/addons-part-1.md)

<figure><img src="/files/9dtlW7ez9LWrQKRmSY1x" alt=""><figcaption><p>Found on "Map Generation" tab</p></figcaption></figure>

#### Different regions will not require the entire planet pbf, and can be done with just their region-specific pbf or the offline generation option. For example, if you are generating Europe, the map may only require a PBF specific to this region.

{% hint style="info" %}
This file is optional.
{% endhint %}

### **Download Links:**

{% hint style="warning" %}
This planet file can be over 60GB! This file can also be of any region you are trying to make; For example, North America does not require the entire planet file.
{% endhint %}

{% hint style="success" %}
You only need to download **one** version of a **PBF File**. Multiple mirrors are provided mainly for convenience.
{% endhint %}

* **Slow** Download - [PlanetOSM](https://planet.openstreetmap.org)
* **Suggested** Mirror List -  [OSM](https://wiki.openstreetmap.org/wiki/Planet.osm#Planet.osm_mirrors) (You are looking for a file named `planet.osm.pbf`)
* Mirror 2 - [GeoFabrik](https://download.geofabrik.de/) (German Hosted) (Region PBF Files)
* **Recommended Mirror for U.S.** *-* [planet-latest.osm.pbf](https://ftpmirror.your.org/pub/openstreetmap/pbf/planet-latest.osm.pbf) (71 GB)

{% hint style="success" %}
This file can go in anywhere on your disk drive, but for our example, it is in the main folder/directory installation of Tiles.
{% endhint %}

![planet.osm.pbf File Example](/files/VU13cNQm1oY67LKTTMwp)

Instructions on how to use the PBF file are shown in [Map Generation](/minecraft-earth-map/minecraft-earth-tiles/configuring-earth-tiles/map-generation.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://evanthebearge.gitbook.io/minecraft-earth-map/minecraft-earth-tiles/required-addons/addons-pbf-file.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.