> For the complete documentation index, see [llms.txt](https://buildsystem.eintosti.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://buildsystem.eintosti.de/v4/getting-started/world-backups.md).

# World Backups

BuildSystem includes a database-linked backup subsystem. Backups copy region files and world configurations, sending them to local or remote storage drivers.

***

## Backup Scheduling

### Automatic Backups

If configured in `config.yml` (`world.backup.auto-backup.enabled`), backups run on a recurring schedule.

* **Interval**: Set in seconds via `interval` (e.g., `900` for 15 minutes).
* **Active World Filtering**: If `only-active-worlds` is set to `true`, background timer counts increment only when a registered builder is present in the world.

### Manual Backups

Administrators or builders can force an immediate backup of their current world:

* **Command**: `/worlds backup create`
* **Permission**: `buildsystem.backup.create`

***

## Viewing & Restoring Backups

To view the history of backups for the current world:

* **Command**: `/worlds backup`
* **Permission**: `buildsystem.backup` (requires being the world creator or having the `buildsystem.admin` bypass permission).

### Restoration

1. Open the backups list (`/worlds backup`).
2. Click on the target backup item (named with the timestamp of creation).
3. Confirm the restoration prompt.

{% hint style="danger" %}
Restoring a backup overwrites the current world directory and is non-reversible. To avoid database locks or data corruption, restoring the server's primary spawn world (usually `world`) is highly discouraged without taking a manual backup first.
{% endhint %}


---

# 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:

```
GET https://buildsystem.eintosti.de/v4/getting-started/world-backups.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.