Querz/mcaselector 1.13

mcaselector-1.13

on GitHub

This release adds new features for selections and filters. And a lot of bug fixes.

ATTENTION: This release contains internal changes to how chunk deletion, export and import works. Make backups before doing anything you might regret in the future! If you encounter a bug, please create a bug report HERE.

Details:

• Selections can now be inverted:
  • Press Ctrl+U (Cmd+U on Mac) to invert a selection. This should work with all existing features involving selections, like deleting, exporting and changing chunks but also copying and importing chunks.
• Group filters can now be negated using a ! before a group. E.g. !(xPos < -10 OR xPos > 10) will select a vertical strip in the middle of the world.
• Added a Dutch translation (thanks to @Clijmart for translating)
• Added an Italian translation (thanks to @valeilsimpaticone for translating)
• Added a Polish translation (thanks for @Marcinolak for translating)
• Updated the gradle wrapper to 6.6.1 and fixed all related deprecation errors.
• Added instructions to create a .bat or .sh file to run MCA Selector.
• Added unit tests for rendering the map, importing chunks and some small tests for filters.
• Fixed instructions about how to execute MCA Selector using PowerShell
• Fixed a bug where switching a filter condition for another would forget the comparator and operator. When switching "compatible" conditions (e.g. xPos to zPos), they will retain their operator, comparator and value.
• Fixed a bug where the Status filter would not work.
• Fixed a bug where the file dialog would throw an exception and not open if the current world directory was deleted while MCA Selector was running.
• Failing to log something should not interfere with the main program anymore.
• Fixed a bug where logging an exception could throw an uncaught NPE
• Fixed a bug where the css was not minified correctly in the final jar.
• Fixed a bug where de-fragmenting an mca-file would throw an exception if the last chunk was not padded.
• Fixed a bug where biome indexes were calculated incorrectly for Minecraft 1.15+.
• Fixed a rare bug where any text in MCA Selector would be rendered incorrectly ("garbled text") by bundling a custom font with the final jar.
• Fixed a bug where MCA Selector would attempt to create images if no world was loaded.
• Reworked version specific implementations for rendering, filtering and changing NBT data for easier support of future versions without breaking old versions.

MCA Selector modifies and deletes chunks in your Minecraft world. Please make backups of your world before using.

"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

What works on most systems

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.13.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

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.

For Windows:

• Hold Shift and Right-click on an empty space and select Open PowerShell window here (Open Command window here on Windows 8 and earlier).
• Type & "C:\Program Files (x86)\Minecraft\runtime\jre-x64\bin\java" -jar , then drag and drop the mcaselector-1.13.jar into the console and press Enter. In the Command window (Windows 8 and earlier), the command starts with "C:\Program Files (x86)\Minecraft\runtime\jre-x64\bin\java" -jar instead and the path to mcaselector-1.13.jar must be typed or copied and pasted into the console manually.

For MacOS:

• Press Cmd+Space, type Terminal and press Enter.
• Type ~/Library/Application\ Support/minecraft/runtime/jre-x64/jre.bundle/Contents/Home/bin/java -jar (with a space at the end), then drag and drop the mcaselector-1.13.jar into the console and press Enter.

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 receive a JavaFX error

"When I run mcaselector-1.13.jar, an error dialog appears that looks like this:"

Open the console or terminal on your OS.

For Windows:

• Hold Shift and Right-click on an empty space on your desktop and select Open PowerShell here (Open Command window here on Windows 8 and earlier).

For MacOS:

• Press Cmd+Space, type Terminal and press Enter.

Type the command java -version and press Enter. If the output shows that your java command is linked to java version "1.8.0", you can simply run MCA Selector through the console.

For Windows and MacOS:

• Type java -jar (with a space at the end) and drag and drop the mcaselector-1.13.jar into the console and hit Enter.

For Linux:

• Run java -jar <path to mcaselector-1.13.jar where you replace everything in <>.

If the output shows a Java version higher than Java 8, please find and download the appropriate JavaFX version from Here. If you know what to do, do it. If you don't, follow these steps:

For Windows:

• Download "JavaFX Windows SDK" for your Java version from here.
• Unzip the .zip-file with your program of choice, then navigate into the unzipped folder.
• Hold Shift and Right-click on an empty space in that folder and select Open PowerShell window here (Open Command window here on Windows 8 and earlier). Type java --module-path (with a space at the end), then drag and drop the lib-folder into the console. Continue to type --add-modules ALL-MODULE-PATH -jar (with a space at the beginning and the end), then drag and drop the mcaselector-1.13.jar into the console and hit Enter.

For MacOS:

• Download "JavaFX Mac OS X SDK" for your Java version from here.
• Double-click the .zip-file to unpack, then navigate into the unzipped folder.
• Press Cmd+Space, type Terminal and press Enter. Type java --module-path (with a space at the end), then drag and drop the lib-folder into the console. Continue to type --add-modules ALL-MODULE-PATH -jar (with a space at the end), then drag and drop the mcaselector-1.13.jar into the console and hit Enter.

For Linux:

• Download "JavaFX Linux SDK" for your Java version from here.
• Unzip the .zip-file with your program of choice.
• Open the command prompt and run java --module-path <path to unzipped folder>/lib --add-modules ALL-MODULE-PATH -jar <path to mcaselector-1.13.jar> where you replace everything in <> with the appropriate paths.
• Some distributions like AdoptOpenJDK (shipped with most Linux distributions) do not ship with JavaFX by default. On Debian, an open version of JavaFX is contained in the openjfx package. This or some other installation of JavaFX is required to run the mcaselector-1.13.jar.

To avoid having to go through this process every time to start MCA Selector, the resulting command can be copied into a .bat-file on Windows or .sh-file on MacOS and Linux and can then be executed by double-clicking the .bat-file on Windows or running sh <file>.sh in the terminal / console on MacOS or Linux where <file> must be replaced by the name of the .sh-file.

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