# Configuration


> **Documentation baseline:** VoxelCore `main` at `452b569` · 14 September 2026.  
> **Repository:** [https://github.com/VoxelHorizons/VoxelCore](https://github.com/VoxelHorizons/VoxelCore)


The bundled configuration schema is currently version `1`:

```yaml
version: 1 # DO NOT CHANGE
game:
  bedrock_support: false
```

## `version`

`version` is managed by VoxelCore and should not be manually changed. At startup VoxelCore compares the current file with the bundled schema version.

When the schema changes or the version is missing, VoxelCore:

1. creates an incremental backup (`config.yml.old`, then `.old.1`, `.old.2`, ...);
2. merges newly introduced defaults;
3. preserves existing user values;
4. writes the new schema version;
5. reloads the configuration.

This is intentionally non-destructive; current migration logic does not replace an operator's whole configuration merely because a schema version changed.

## `game.bedrock_support`

This setting exists as a future integration point. Setting it to `true` **does not currently implement Bedrock support** in the item/content MVP. Bedrock/Geyser presentation and mappings remain roadmap work.