Skip to main content

​
Overview

Converter settings control the behavior of the conversion process, allowing you to enable or disable specific features, optimize performance, and customize how different game elements are processed.

​
Configuration File

Converter settings are defined in converter_settings.chunker.json or passed via the -c flag (CLI.java:234-271).

​
Available Settings

All settings are optional and have sensible defaults:
converter_settings.chunker.json
{
  "mapConversion": true,
  "lootTableConversion": true,
  "itemConversion": true,
  "blockConnections": true,
  "enableCompact": true,
  "discardEmptyChunks": false,
  "preventYBiomeBlending": false
}

​
Settings Reference

​
Map Conversion

​
mapConversion
boolean
default:"true"
Process and convert map items during conversion (CLI.java:251, 260)When disabled:
  • Map items are not converted
  • Map data is not processed
  • Faster conversion if your world has many maps
{
  "mapConversion": true
}
Disabling map conversion can significantly speed up conversion for worlds with many map items.

​
Loot Table Conversion

​
lootTableConversion
boolean
default:"true"
Process and convert loot tables in chests, spawners, etc. (CLI.java:252, 261)When disabled:
  • Loot table data is not converted
  • Chest contents may not convert properly
  • Spawner configurations may not transfer correctly
{
  "lootTableConversion": true
}
Disabling loot table conversion may result in lost or incorrect loot in chests, barrels, and other containers.

​
Item Conversion

​
itemConversion
boolean
default:"true"
Process and convert items in inventories, item frames, etc. (CLI.java:253, 262)When disabled:
  • Items in player inventories are not converted
  • Items in containers are not converted
  • Item frames and other item entities are not converted
{
  "itemConversion": true
}
Disabling item conversion will likely result in missing or incorrect items in your converted world.

​
Block Connections

​
blockConnections
boolean
default:"true"
Process block connections and states (fences, walls, glass panes, etc.) (CLI.java:254, 263)When disabled:
  • Connecting blocks may not connect properly
  • Block states may be incorrect
  • Faster conversion but lower visual quality
{
  "blockConnections": true
}
Disabling block connections improves performance but may result in fences, walls, and similar blocks not connecting properly.

​
Enable Compact (Bedrock)

​
enableCompact
boolean
default:"true"
Compact LevelDB database after conversion (Bedrock output only) (CLI.java:255, 264)When enabled:
  • Bedrock worlds are compacted after conversion
  • Reduces file size
  • Takes additional time after conversion
When disabled:
  • Skips compaction step
  • Faster conversion completion
  • Larger output file size
{
  "enableCompact": true
}
Compaction only applies when converting to Bedrock Edition. Java Edition conversions ignore this setting.

​
Discard Empty Chunks

​
discardEmptyChunks
boolean
default:"false"
Skip writing chunks that are completely empty (CLI.java:256, 265)When enabled:
  • Empty chunks are not written to output
  • Reduces output file size
  • May affect world generation boundaries
When disabled:
  • All chunks are written, even if empty
  • Preserves exact world boundaries
{
  "discardEmptyChunks": true
}
Enabling this may affect world borders and generation if empty chunks at world edges are discarded.

​
Prevent Y Biome Blending (Java)

​
preventYBiomeBlending
boolean
default:"false"
Prevent biomes from blending vertically (Java output only) (CLI.java:257, 266)When enabled:
  • Biomes don’t blend on the Y axis
  • More defined biome boundaries vertically
  • May look less natural
When disabled:
  • Natural vertical biome blending
  • Smoother transitions
{
  "preventYBiomeBlending": true
}
This setting only applies when converting to Java Edition. Bedrock conversions ignore this setting.

​
Complete Examples

​
Performance Optimized

Maximize conversion speed:
converter_settings.chunker.json
{
  "mapConversion": false,
  "lootTableConversion": true,
  "itemConversion": true,
  "blockConnections": false,
  "enableCompact": false,
  "discardEmptyChunks": true,
  "preventYBiomeBlending": false
}

​
Quality Focused

Maximize conversion accuracy:
converter_settings.chunker.json
{
  "mapConversion": true,
  "lootTableConversion": true,
  "itemConversion": true,
  "blockConnections": true,
  "enableCompact": true,
  "discardEmptyChunks": false,
  "preventYBiomeBlending": false
}

​
Minimal Conversion

Just blocks, no extras:
converter_settings.chunker.json
{
  "mapConversion": false,
  "lootTableConversion": false,
  "itemConversion": false,
  "blockConnections": false,
  "enableCompact": false,
  "discardEmptyChunks": true,
  "preventYBiomeBlending": false
}
Minimal conversion will result in missing items, incorrect loot, and improperly connected blocks.

​
Usage

# Place in world directory
my_world/converter_settings.chunker.json

# Run conversion
java -jar chunker-cli.jar -i my_world -f BEDROCK_1_20_80 -o output

​
Default Behavior

When no converter settings are provided (CLI.java:251-257):
  • mapConversion: true
  • lootTableConversion: true
  • itemConversion: true
  • blockConnections: true
  • enableCompact: true
  • discardEmptyChunks: false
  • preventYBiomeBlending: false
You only need to specify settings you want to change from defaults.

​
Edition-Specific Settings

​
Bedrock Only

  • enableCompact: Only affects Bedrock output

​
Java Only

  • preventYBiomeBlending: Only affects Java output

​
Universal

  • mapConversion
  • lootTableConversion
  • itemConversion
  • blockConnections
  • discardEmptyChunks

​
Performance Impact

SettingSpeed ImpactQuality Impact
mapConversion: false+10-20% fasterLost map data
lootTableConversion: false+5-10% fasterIncorrect loot
itemConversion: false+15-25% fasterNo items
blockConnections: false+20-30% fasterIncorrect connections
enableCompact: false+5-15% fasterLarger file size
discardEmptyChunks: true+5-10% fasterSmaller output
preventYBiomeBlending: trueMinimalDifferent biomes
Performance impacts are approximate and vary based on world content.

​
Exporting Settings

Generate converter settings from the web UI:
  1. Visit chunker.app
  2. Go to Advanced Settings → Converter Settings
  3. Configure your preferences
  4. Export the converter_settings.chunker.json file

​
Validation

Chunker validates converter settings during startup (CLI.java:246-270):
  • Unknown fields are ignored
  • Invalid values fall back to defaults
  • Missing settings use defaults
Invalid JSON will cause the conversion to fail with a parse error.

​
Combining with Other Settings

Converter settings work alongside:
  • Block mappings: Custom block conversions
  • Pruning: Region selection
  • World settings: World property changes
  • Dimension mappings: Dimension routing

​
Best Practices

  1. Start with defaults and only change what you need
  2. Test performance settings on copies before production use
  3. Document your choices for future conversions
  4. Enable quality settings for important worlds
  5. Use performance settings for test conversions

​
Common Configurations

{
  "mapConversion": false,
  "blockConnections": false,
  "enableCompact": false
}
Fast conversion for testing purposes.
{
  "mapConversion": true,
  "lootTableConversion": true,
  "itemConversion": true,
  "blockConnections": true,
  "enableCompact": true,
  "discardEmptyChunks": false
}
Full quality conversion for live servers.
{
  "mapConversion": false,
  "lootTableConversion": false,
  "itemConversion": false,
  "blockConnections": true,
  "discardEmptyChunks": true
}
Focus on blocks and structures only.

​
Troubleshooting

  • Check JSON syntax is valid
  • Verify file name is converter_settings.chunker.json
  • Ensure file is in world directory or specified with -c flag
  • Set "enableCompact": false to skip compaction
  • Compaction time varies with world size
  • Monitor console for compaction progress
  • Ensure "itemConversion": true
  • Check "lootTableConversion": true
  • Verify conversion completed successfully

Configuration Overview

Learn about all configuration options

Block Mappings

Customize block conversions

Pruning

Optimize world size

World Settings

Customize world properties

Build docs developers (and LLMs) love

Get started for freeTalk to us