> For the complete documentation index, see [llms.txt](https://jpprison.gitbook.io/jpprison-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jpprison.gitbook.io/jpprison-docs/mines/systems/mine-world.md).

# Mine World

### Mine world

* World name: `mina_mundo`
* Uses void generation
* Always stays in daytime
* Does not spawn mobs
* Disables weather
* Uses peaceful difficulty
* Creates automatically when the plugin starts
* Returns players to the main spawn when the server shuts down

### Mine generation

* **Schematic mode:** pastes `Mine.schematic` and carves the mine area based on the tier
* **Legacy mode:** creates a `25×25×25` bedrock box with random block fill
* The spawn point comes from a `jack-o-lantern` inside the schematic

### How schematic-based mine creation works

When schematic mode is enabled, the plugin uses `Mine.schematic` as the base structure for each private mine.

1. It picks the player's mine coordinates in the mine world.
2. It pastes `Mine.schematic` at that location.
3. It checks the player's active tier.
4. It carves the mine area using that tier's width, height, and length.
5. It fills the carved area with random blocks from the configured composition.
6. It uses the `jack-o-lantern` inside the schematic as the mine spawn point.

This lets you keep a custom outer structure while changing the mine size and ore composition per tier.

The center of the mine's first layer is generated at the position where you place a `redstone torch` in the schematic.

If the schematic is missing, the plugin falls back to legacy generation.

### Progressive reset

* Uses `BukkitRunnable`
* Refills from top to bottom
* Processes `4000` blocks per tick
* Teleports players to a safe area before the reset


---

# 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://jpprison.gitbook.io/jpprison-docs/mines/systems/mine-world.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.
