Releases · Querz/mcaselector

26 Feb 09:36

Querz

aecf5fd

mcaselector-1.14

This release adds a lot of new features and support for the upcoming 1.17 changes (so far).

WARNING: This release contains some significant changes to a lot of features of MCA Selector. Always make backups of your world before using MCA Selector. If you encounter any bugs, please report them either on GitHub or on Discord.

Details:

Added support for entities and poi files. They will now be adjusted when copying, deleting, merging and moving chunks.
Added support for the 21w06a height changes.
Added Open World option in the File menu that will replace the current Open option. The old Open option has been renamed to Open Region. Open World now detects an entire Minecraft world, including poi and entities folders. To use Open World, navigate to your world folder (not the region folder!), click Open and you will see a window displaying all dimensions found for this world. Select the one you want to view / edit, and press OK. If your world only has a single dimension (e.g. if you haven't explored the Nether or the End yet, this dialog will be skipped.
Added a World Settings option in the File menu that allows to specify the world's entities and poi folders manually.
Made grass color more green instead of blue.
Added new Structure filter by @polarbub , see #164 .
Added error dialogs for some occasions.
Reworked headless mode to work with the separation of region, poi and entities folders.
Removed the --headless parameter - it is now automatically switching to headless mode as soon as there are any parameters.
Slightly changed the command structure and renamed some commands. An overview of the command structure can be found here.
Added some tools that can be used in headless mode to make translations easier: --mode printMissingTranslationswhich lists all missing translations,--mode printTranslation which prints a full translation file, including untranslated keys and--mode printTranslationKeys` which prints all translation keys.
Improved the chunk editor, it now shows the chunk data of region, poi and entities.
The chunk editor now allows to completely delete a chunk by deleting the root compound tag or to create a new chunk by creating a new root compound tag.
Added a "Reset zoom" option in the View menu.
It is now allowed for a filter to be limited to a selection in all scenarios. This option also works in headless mode, see #161 .
The chunk filter dialog now remembers the selected options in addition to the filter.
Added a new field for the Change NBT dialog: "ReplaceBlocks"
- A list of block replacements can be supplied, in the following format:
  <block-name>=<block-name|block-nbt>[;<tile-nbt>]
  Examples:
  - iron_block=diamond_block will replace all iron blocks with diamond blocks in the selection
  - iron_block={Name:"minecraft:chest",Properties:{facing:east,type:single}};{id:"minecraft:chest",Items:[{Slot:0b,id:"minecraft:stone",Count:1b}]} will replace all iron blocks with east-facing single chests that contain 1 stone in the first slot.
Added a way to save the current view as an image (View-->Save Screenshot).
Added a way to save the current selection as an image (Selection-->Export as image). Depending on the size of the selection, this might take a while.
Added CI with travis to build an automatic Windows installer that installs MCA Selector as a Windows desktop application. It will download an appropriate standalone JRE to run MCA Selector, so you don't have to. It can also create a desktop shortcut. The installer will be attached below alongside the usual .jar file.
The path to the currently opened world is now displayed in the window title.
Updated mappings to 21w08a.
Fixed a concurrency issue with the progress bar (i hope) that would sometimes cause the progress bar to become stuck.
Doubled the maximum zoom level, you can now zoom out much further. This requires MCA Selector to have a maximum heap size of at least 4 GB.
Added an option in the Settings to configure the default Minecraft saves directory, see #163 .
Fixed a bug that caused the filter box in the filter editor to throw an exception when switching between text based filters (e.g. from "Status" to "Palette" filter)
Fixed a bug where it was assumed that Palette index 0 does always contain air. This bug caused some chunks to render incorrectly, see #157 .
Fixed a bug where unmarking a partially marked region in region selection mode would not work.
Made some type checks in filters and the rendering process more lenient.
Added support for oversized chunks that are saved as .mcc files, see #169 .
Made some code more future-proof.

Assets 4

17 Nov 08:40

Querz

1.13.3

b16e8ee

mcaselector-1.13.3

This release fixes some bugs.

Details:

Fixed a bug where using a filter to create a selection with a radius would deselect regions that were fully selected.
Fixed a bug when running with Java 15 checking for the most recent version in the About dialog would not work as expected.
Some translation fixes by @LovesAsuna for zh_CN.

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.3.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.3.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.3.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.3.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.3.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.3.jar into the console and hit Enter.

For Linux:

Run java -jar <path to mcaselector-1.13.3.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.3.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.3.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.3.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.3.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.

Assets 3

15 Oct 19:10

Querz

1.13.2

6a93d16

mcaselector-1.13.2

This release fixes some more bugs.

Details:

Fixed a bug where the palette filter would not work for pre-1.13 worlds.
Fixed a bug where the entire region would not render if it's index leads to nowhere.
Fixed a bug where deleting an inverted selection was not inverted.

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.2.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.2.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.2.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.2.jar into the console and press Enter.

If you receive a JavaFX error

"When I run mcaselector-1.13.2.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.2.jar into the console and hit Enter.

For Linux:

Run java -jar <path to mcaselector-1.13.2.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.2.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.2.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.2.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.2.jar.

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.

Assets 3

20 Sep 11:53

Querz

1.13.1

c9e2489

mcaselector-1.13.1

This release fixes a major bug when trying to import chunks.

Details:

Fixed a bug where the open files dialog throws an exception when trying to import chunks via Tools-->Import chunks.

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

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.1.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.1.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.1.jar into the console and press Enter.

If you receive a JavaFX error

"When I run mcaselector-1.13.1.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.1.jar into the console and hit Enter.

For Linux:

Run java -jar <path to mcaselector-1.13.1.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.1.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.1.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.1.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.1.jar.

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.

Assets 3

19 Sep 19:11

Querz

1.13

797f26f

mcaselector-1.13

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.

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.

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.

Assets 3

22 Jul 09:08

Querz

1.12.3

e6b7d61

mcaselector-1.12.3

This release fixes some bugs.

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 filtering for chunks containing air wouldn't work correctly
Fixed a bug where LOCALAPPDATA on Windows was divided into two paths because it was using the same code used for Linux that divided environment variables containing multiple paths into their individual pieces.
Updated entity mappings to include new entities added in recent snapshots
Updated installation instructions to include a Java version check in the console.

"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.12.3.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.12.3.jar into the console and press Enter.

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.12.3.jar into the console and press Enter.

If you receive a JavaFX error

"When I run mcaselector-1.12.3.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.12.3.jar into the console and hit Enter.

For Linux:

Run java -jar <path to mcaselector-1.12.3.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.12.3.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.12.3.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.12.3.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.12.3.jar.

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.

Assets 3

14 Jul 13:37

Querz

1.12.2

fa65a85

mcaselector-1.12.2

This release fixes a bug and changes default directories again.

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 without using Copy-Paste would throw an NPE.
Fixed the default directories for cache, logs and settings to comply with XDG and changed the Log file directory for MacOS (see Readme).
It doesn't make sense to store the path of the config file inside the config file...

"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.12.2.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.12.2.jar into the console and press Enter.

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.12.2.jar into the console and press Enter.

If you receive a JavaFX error

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

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.12.2.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.12.2.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 type java --module-path <path to unzipped folder>/lib --add-modules ALL-MODULE-PATH -jar <path to mcaselector-1.12.2.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.12.2.jar.

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.

Assets 3

09 Jul 15:19

Querz

1.12.1

0677fa2

mcaselector-1.12.1

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.

Assets 3

01 Jul 15:29

Querz

1.12

62edae9

mcaselector-1.12

This release adds copy & paste!

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:

Changed the default color for region selection to the same as chunk selection (orange) to avoid confusion. The colors can still be changed separately in the settings.
Copy-Paste:
- Make a selection
- Use Selections --> Copy chunks or press Ctrl+C (Cmd+C on Mac) to copy the selection to the clipboard.
- Go to where you want the selection to be pasted. Copying works through instances of MCA Selector, so you can even close and reopen the program! Open a different world, stay in the same world and navigate to the desired location.
- Use Selections --> Paste chunks or press Ctrl+V (Cmd+V on Mac) to display an overlay that shows where the chunks would be pasted.
- Move the overlay to the desired location by pressing and holding the left mouse button.
- Pasting can be cancelled by pressing Esc.
- Use Selections --> Paste chunks or press Ctrl+V again to open the Import chunks dialog, prefilled with the offset values according to your choice.
- Make your choice with the remaining options and press OK to start the import.
Added a new option in the settings to change the color of the Pasting overlay.
Fixed a bug where key combinations that opened a dialog would be stuck and mess with scrolling and zooming on trackpads after closing the dialog.
Tweaked the default values for the Threadpool so MCA Selector doesn't use 100% of all available processor cores.
A dialog with an error is now shown before the program starts when JavaFX has not been found.
Updated the screenshots and documentation in the Readme.
Added translation to Portuguese (Portugal) (thanks to @D3W10 for translating).

"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.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-1.12.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.jar>.

If you are using OpenJDK

If you are using Java 11 or higher

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

On Debian with OpenJDK 11 and openjfx:

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

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

Assets 3

24 Jun 10:20

Querz

1.11.1

10aa35f

mcaselector-1.11.1

This release fixes some bugs.

The 1.11 update adds 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 the map view mixed up cache files when opening a world while the previous world was still generating images.
Fixed a bug where Sections without a Palette were spamming exceptions.
Fixed a bug where the Nether would not render as the Nether if the chunks were from Minecraft 1.13.
Improved rendering of the Nether by skipping more block types.
When rendering a chunk fails, it is now visible in the map view.
The current version number is now visible in the window title.
Cleaned up the code.

"Requirements":

Either:
- JRE 8+, you can get it from HERE
- A Minecraft Java Edition installation
A computer
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.11.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-1.11.1.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.11.1.jar>.

If you are using OpenJDK

If you are using Java 11 or higher

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.11.1.jar

On Debian with OpenJDK 11 and openjfx:

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

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

Assets 3

Releases: Querz/mcaselector

mcaselector-1.14

Details:

Uh oh!

mcaselector-1.13.3

Details:

What works on most systems

If you have Minecraft Java Edition installed

If you receive a JavaFX error

Uh oh!

mcaselector-1.13.2

Details:

What works on most systems

If you have Minecraft Java Edition installed

If you receive a JavaFX error

Uh oh!

mcaselector-1.13.1

Details:

What works on most systems

If you have Minecraft Java Edition installed

If you receive a JavaFX error

Uh oh!

mcaselector-1.13

Details:

What works on most systems

If you have Minecraft Java Edition installed

If you receive a JavaFX error

Uh oh!

mcaselector-1.12.3

Details:

What works on most systems

If you have Minecraft Java Edition installed

If you receive a JavaFX error

Uh oh!

mcaselector-1.12.2

Details:

What works on most systems

If you have Minecraft Java Edition installed

If you receive a JavaFX error

Uh oh!

mcaselector-1.12.1

Details:

If you have Java from Oracle installed on your system

If you have Minecraft Java Edition installed on your system

If you are using OpenJDK

If you are using Java 11 or higher

Uh oh!

mcaselector-1.12

Details:

If you have Java from Oracle installed on your system

If you have Minecraft Java Edition installed on your system

If you are using OpenJDK

If you are using Java 11 or higher

Uh oh!

mcaselector-1.11.1

Details:

If you have Java from Oracle installed on your system

If you have Minecraft Java Edition installed on your system

If you are using OpenJDK

If you are using Java 11 or higher

Uh oh!