Skip to content

Configuration

Andre Carbajal Vargas edited this page Jul 20, 2025 · 1 revision

Configuration Properties

OS-Specific Base Directory ([base_dir])

The base configuration directory varies by operating system:

Operating System Base Directory Path Example Configuration File Path
Windows %APPDATA%\[app_name] C:\Users\USER\AppData\Roaming\MineControlCli\
macOS ~/Library/Application Support/[app_name] /Users/USER/Library/Application Support/MineControlCli/
Linux ~/[app_name] /home/USER/MineControlCli/
Other/Unknown ~/.[app_name] /home/USER/.MineControlCli/

Note: The application name is MineControlCli. If you are running in development mode, the name will appear as MineControlCliDev.

๐Ÿ“ Configuration File

File Name: minecontrol.properties
Location: [base_dir]/minecontrol.properties

๐Ÿ”„ Update Settings

Property Type Default Description
update.check-on-startup Boolean true Checks for updates on application launch

โ˜• Java Settings

Property Type Default Description Validation
java.path string java Java executable path Valid executable
java.min-ram string 2048M Minimum server RAM Pattern: \d+[MGmg]
java.max-ram string 4096M Maximum server RAM Pattern: \d+[MGmg]

๐Ÿ“‚ Path Settings

Property Type Default Description
paths.servers string [base_dir]/servers Server storageServer storage
paths.backups string [base_dir]/backups Backup storage

Examples

  • Windows Users:
paths.backups = C:\\Users\\USER\\Documents\Backups
paths.servers = D:\\Minecraft\\Servers
  • Linux/macOS Users:
paths.backups = /Volumes/Minecraft/Backups
paths.servers = paths.servers = /opt/minecraft/servers

โš–๏ธ EULA Settings

Property Type Default Description
eula.auto-accept boolean false Auto-accept Minecraft EULA

โ™ป๏ธ Reset Behavior

Running config reset:

  1. Reverts all values to hardcoded defaults
  2. Preserves existing directories and files
  3. Maintains server/backup data