Memory and performance
RAM is what limits how big your map can be. TalePainter starts with 4 GB by default, which isn’t enough for big maps. Typical sign: the export fails with an OutOfMemoryError.
How much do I need?
Section titled “How much do I need?”| Map size | Notes |
|---|---|
| 3,000 × 3,000 | runs fine on normal PCs |
| 10,000 × 10,000 | export took about 3 hours |
| 16,000 × 16,000 | about 32 GB RAM in the PC |
| 100,000 × 100,000 | not supported |
Only give TalePainter memory your PC actually has free. Close other heavy programs while exporting.
Raise the RAM
Section titled “Raise the RAM”There is a setting in Edit → Preferences → Performance (Maximum heap size, at the bottom).
Every system has the same line -Xmx4G in TalePainter’s start file. Change 4G to what you want, e.g. 8G, 12G or 16G, then restart TalePainter.
Windows
Section titled “Windows”Open PowerShell as administrator and run:
powershell -Command "(Get-Content 'C:\Program Files\TalePainter\app\TalePainter.cfg') -replace '-Xmx4G', '-Xmx8G' | Set-Content 'C:\Program Files\TalePainter\app\TalePainter.cfg'"Or open C:\Program Files\TalePainter\app\TalePainter.cfg in an editor started as administrator and change the line.
The file is /Applications/TalePainter.app/Contents/app/TalePainter.cfg:
sudo sed -i '' 's/-Xmx4G/-Xmx8G/' /Applications/TalePainter.app/Contents/app/TalePainter.cfgIf macOS then says the app is damaged, undo the change (-Xmx8G back to -Xmx4G) and start TalePainter from Terminal instead:
_JAVA_OPTIONS=-Xmx8g /Applications/TalePainter.app/Contents/MacOS/TalePainterThe file is /opt/talepainter/lib/app/talepainter.cfg (lowercase):
sudo sed -i 's/-Xmx4G/-Xmx8G/' /opt/talepainter/lib/app/talepainter.cfgFaster exports
Section titled “Faster exports”- Use Test Export on a few tiles instead of exporting the whole map, see Export to Hytale.
- Keep the world height at 320. Higher worlds take several times longer.
- The time remaining shown during export can be way off on big maps. Better estimates are coming in the next release.