Configuration

Documentation baseline: VoxelCore main at 452b569 · 14 September 2026.
Repository: https://github.com/VoxelHorizons/VoxelCore

The bundled configuration schema is currently version 1:

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.