Querz/mcaselector 1.12.1

mcaselector-1.12.1

on GitHub

This release fixes some bugs and changes default directories.

Update 1.11 added new features that can be useful when migrating a world to Minecraft 1.16. Here is a document with some tips and tricks regarding 1.16.

Details:

• Fixed a bug where importing chunks with an offset would not correctly relocate TileEntities.
• Copying Entities now generates new UUIDs so Minecraft doesn't delete Entities with duplicate UUIDs.
• Changed default directories to make use of OS directories for cache, log files and settings:
  • Windows:
    • Cache directory: %LOCALAPPDATA%\mcaselector\cache if %LOCALAPPDATA% is set, otherwise <parent directory of mcaselector.jar>\mcaselector\cache
    • Log file: %LOCALAPPDATA%\mcaselector\debug.log if %LOCALAPPDATA% is set, otherwise <parent directory of mcaselector.jar>\mcaselector\debug.log
    • Config file: %LOCALAPPDATA%\mcaselector\settings.ini if %LOCALAPPDATA% is set, otherwise <parent directory of mcaselector.jar>\mcaselector\settings.ini
  • MacOS:
    • Cache directory: ~/Library/Caches/mcaselector
    • Log file: ~/.log/mcaselector/debug.log
    • Settings file: ~/Library/Application Support/mcaselector/settings.ini
  • Linux:
    • Cache directory: $XDG_CACHE_DIR/mcaselector if $XDG_CACHE_DIR is set, otherwise ~/.cache/mcaselector
    • Log file: ~/.log/mcaselector/debug.log
    • Config file: ~/.mcaselector
• The cache directory and log file can be configured by adding the options BaseCacheDir and LogFile to the config file. In headless mode when generating cache files, the output directory must still be provided with the --output parameter.
• The log file directory can now be opened by clicking a link in the settings.
• Updated the Readme accordingly.

"Requirements":

• Either:
  • 64bit JRE 8+, you can get it from HERE
  • A Minecraft Java Edition installation
• A computer
  • At least 6 GB of RAM. If lower, more RAM has to manually be assigned to the JVM using the -Xmx argument. Assigning 4 GB is recommended.
• A brain

If you have Java from Oracle installed on your system

Most likely, .jar files are associated with java on your computer, it should therefore launch by simply double clicking the file (or however your OS is configured to open files using your mouse or keyboard). If not, you can try java -jar mcaselector-1.12.1.jar from your console. If this doesn't work, you might want to look into how to modify the PATH variable on your system to tell your system that java is an executable program.

If you have Minecraft Java Edition installed on your system

Minecraft Java Edition comes with a JRE that you can use to start the MCA Selector, so there is no need to install another version of java on your system. On Windows, that java version is usually located in C:\Program Files (x86)\Minecraft\runtime\jre-x64\bin\ and once inside this folder you can simply run java.exe -jar <path-to-mcaselector- .jar>. On Mac OS you should find it in ~/Library/Application\ Support/minecraft/runtime/jre-x64/jre.bundle/Contents/Home/bin/ where you can execute ./java -jar <path-to-mcaselector-1.12.1.jar>.

WARNING: For macOS 10.14+ (Mojave) It is NOT recommended to use the JRE provided by Minecraft (1.8.0_74), because it contains a severe bug that causes JavaFX applications to crash when they lose focus while a dialog window (such as the save-file-dialog) is open (see the bug report here). This bug has been fixed in Java 1.8.0_201 and above.

If you are using OpenJDK

If you are using a distribution of OpenJDK, you have to make sure that it comes with JavaFX, as it is needed to run the MCA Selector. Some distributions like AdoptOpenJDK (shipped with most Linux distributions) do not ship with JavaFX by default. On Debian distributions, an open version of JavaFX is contained in the openjfx package. This or some other installation of JavaFX is required to run the .jar.

If you are using Java 11 or higher

If you are using Java 11 or higher, the JavaFX modules are not included automatically. You will need to include them by specifying the module path for JavaFX. Some examples are included below, but you may need to edit paths if your system stores the JavaFX modules in a different location.

On Windows with Oracle Java 13:

"C:\Program Files\Java\jdk-13.0.1\bin\java.exe" --module-path "C:\Program Files\Java\javafx-sdk-13.0.1\lib" --add-modules ALL-MODULE-PATH -jar mcaselector-1.12.1.jar

On Debian with OpenJDK 11 and openjfx:

java --module-path /usr/share/openjfx/lib --add-modules ALL-MODULE-PATH -jar mcaselector-1.12.1.jar

If none of these instructions work, apply "A brain" that you providently held ready after having read the "Requirements" section carefully.