Releases: Querz/mcaselector
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.
- Press
- 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
tozPos
), 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.
- At least 6 GB of RAM. If lower, more RAM has to manually be assigned to the JVM using the
- 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 selectOpen 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 themcaselector-1.13.jar into the console
and pressEnter
. 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 tomcaselector-1.13.jar
must be typed or copied and pasted into the console manually.
For MacOS:
- Press
Cmd+Space
, typeTerminal
and pressEnter
. - 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 themcaselector-1.13.jar
into the console and pressEnter
.
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 selectOpen PowerShell here
(Open Command window here
on Windows 8 and earlier).
For MacOS:
- Press
Cmd+Space
, typeTerminal
and pressEnter
.
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 themcaselector-1.13.jar
into the console and hitEnter
.
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 selectOpen PowerShell window here
(Open Command window here
on Windows 8 and earlier). Typejava --module-path
(with a space at the end), then drag and drop thelib
-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 themcaselector-1.13.jar
into the console and hitEnter
.
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
, typeTerminal
and pressEnter
. Typejava --module-path
(with a space at the end), then drag and drop thelib
-folder into the console. Continue to type--add-modules ALL-MODULE-PATH -jar
(with a space at the end), then drag and drop themcaselector-1.13.jar
into the console and hitEnter
.
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 themcaselector-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.
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.
- At least 6 GB of RAM. If lower, more RAM has to manually be assigned to the JVM using the
- 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 selectOpen 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 themcaselector-1.12.3.jar into the console
and pressEnter
.
For MacOS:
- Press
Cmd+Space
, typeTerminal
and pressEnter
. - 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 themcaselector-1.12.3.jar
into the console and pressEnter
.
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.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 selectOpen PowerShell here
(Open Command window here
on Windows 8 and earlier).
For MacOS:
- Press
Cmd+Space
, typeTerminal
and pressEnter
.
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 themcaselector-1.12.3.jar
into the console and hitEnter
.
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 selectOpen PowerShell window here
(Open Command window here
on Windows 8 and earlier). Typejava --module-path
(with a space at the end), then drag and drop thelib
-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 themcaselector-1.12.3.jar
into the console and hitEnter
.
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
, typeTerminal
and pressEnter
. Typejava --module-path
(with a space at the end), then drag and drop thelib
-folder into the console. Continue to type--add-modules ALL-MODULE-PATH -jar
(with a space at the end), then drag and drop themcaselector-1.12.3.jar
into the console and hitEnter
.
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 themcaselector-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.
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.
- At least 6 GB of RAM. If lower, more RAM has to manually be assigned to the JVM using the
- 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 selectOpen 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 themcaselector-1.12.2.jar into the console
and pressEnter
.
For MacOS:
- Press
Cmd+Space
, typeTerminal
and pressEnter
. - 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 themcaselector-1.12.2.jar
into the console and pressEnter
.
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.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 selectOpen PowerShell window here
(Open Command window here
on Windows 8 and earlier). Typejava --module-path
(with a space at the end), then drag and drop thelib
-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 themcaselector-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
, typeTerminal
and pressEnter
. Typejava --module-path
(with a space at the end), then drag and drop thelib
-folder into the console. Continue to type--add-modules ALL-MODULE-PATH -jar
(with a space at the end), then drag and drop themcaselector-1.12.2.jar
into the console and hitEnter
.
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 themcaselector-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.
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
- Cache directory:
- MacOS:
- Cache directory:
~/Library/Caches/mcaselector
- Log file:
~/.log/mcaselector/debug.log
- Settings file:
~/Library/Application Support/mcaselector/settings.ini
- Cache directory:
- 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
- Cache directory:
- Windows:
- The cache directory and log file can be configured by adding the options
BaseCacheDir
andLogFile
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.
- At least 6 GB of RAM. If lower, more RAM has to manually be assigned to the JVM using the
- 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.
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 pressCtrl+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 pressCtrl+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 pressCtrl+V
again to open theImport 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.
- At least 6 GB of RAM. If lower, more RAM has to manually be assigned to the JVM using the
- 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>
.
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.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.
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>
.
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.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.
mcaselector-1.11
This release adds support for deleting and importing specific vertical sections of chunks.
This update adds new features that can be useful when migrating a world to 1.16. Here is a document with some tips and tricks regarding 1.16.
Details:
- Fixed spanish translation (thanks to @NathanielFreeman.
- Fixed some information regarding compatibility in the Readme. MCA Files were first introduced in 1.2.1, not Beta 1.3.
- Removed unused icon for a "default NBT tag" from resources.
- Improved rendering for underwater features, now showing hints of the color of the blocks and better showing the depth of the water. This can still be disabled in the settings.
- Added support for comma separated ranges when deleting chunks. The field
DeleteSections
now accepts ranges in the format<from>:<to>
. E.g:3:7
means "all sections from 3 to 7, inclusive". From and to can be omitted to define no upper and/or lower bounds, e.g.:7
means "all seaction up to 7, inclusive". - Added support for custom entities with custom namespaces in the chunk filter. Defining an entity without a namespace automatically assumes the namespace
minecraft:
. Use single quotes to define custom entities. When using single quotes, a namespace must be defined. - Added support to import specific sections when importing chunks:
- The field uses the same range syntax as the
DeleteSections
field in the NBT Changer. - Merges Biomes, Entities, TileTicks, TileEntities, LiquidTicks, Lights, LightsToBeTicked, ToBeTicked and PostProcessing fields.
- When merging into an empty or non-existing chunk, its
Status
is set tofull
. - Entity UUIDs are randomized to avoid duplicates.
- Minecraft does weird things with biomes, so they might not show up correctly in game.
- The field uses the same range syntax as the
- Updated dependencies to use NBT 5.5.
- Updated documentation, discord badge and screenshots in the Readme.
- Fixed a crash when processing indexed but nonexistent chunks in region files.
- Fixed a memory overflow error when logging too many exceptions.
- Fixed an error that occurred when drawing chunks of an "optimized" world.
"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.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.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.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.11.jar
On Debian with OpenJDK 11 and openjfx:
java --module-path /usr/share/openjfx/lib --add-modules ALL-MODULE-PATH -jar mcaselector-1.11.jar
If none of these instructions work, apply "A brain" that you providently held ready after having read the "Requirements" section carefully.
mcaselector-1.10
This release makes everything more pretty!
Details:
- Added shading to show different height levels. Shading can be disabled in the settings to return to the old render style. Shading for water can be turned of separately, as it might be slower than shading for land.
- Made rendering slightly faster by writing directly to an int array instead of the
PixelWriter
for every pixel. - Added
DeleteSections
feature to the NBT Changer. It works similar toDeleteEntities
; setting it to1
ortrue
it will delete all sections of the chunks. This only works for already generated chunks, so in order to make e.g. a Skyblock world, you would need to let Minecraft generate the world first before deleting the sections. Biomes, Entities and the bounding boxes of structures will persist of not otherwise specified in the NBT Changer. Biome
in the NBT Changer can now be set to-1
to force Minecraft to regenerate all biomes.- Filter conditions can now be moved using drag-and-drop.
- Added a text field below the filter editor that shows the current filter as a query that can be used in headless mode. Pasting a query into this text field and pressing
Enter
will also parse the text and display it in the filter editor above. - Fixed a bug where checking if a filter applies to a region file before opening the file would not work correctly.
- Status in the Chunk Filter and the NBT Changer should validate correctly now using the most recent allowed values.
- Minimized the distributed jar file to exclude unused classes from dependencies.
- Updated Readme with more detailed information on how the filter logic works, see #107.
- Fixed some CSS in group filters. Nested group filters are more visible now and more consistent with the overall look of the other filters.
- Larger-than-or-equal and does-not-contain sign now use the correct unicode character.
"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.10.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.10jar>
. 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.10.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.10.jar
On Debian with OpenJDK 11 and openjfx:
java --module-path /usr/share/openjfx/lib --add-modules ALL-MODULE-PATH -jar mcaselector-1.10.jar
If none of these instructions work, apply "A brain" that you providently held ready after having read the "Requirements" section carefully.
mcaselector-1.9.11
This release adds a few minor features and fixes some bugs.
Details:
- Chunk filter and NBT Changer now support Biome IDs. Custom IDs can be used when they are quoted using single quotes.
- Updated NBT to 5.3.
settings.ini
is no longer incorrectly saved inside thecache
folder, but in the same directory as themcaselector.jar
.- Checking for a new version via the About dialog didn't work with versions that had multiple digits.
- Removed redundant Manifest section in
shadowJar
Gradle task.
"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.9.11.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.9.11.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.9.11.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.9.11.jar
On Debian with OpenJDK 11 and openjfx:
java --module-path /usr/share/openjfx/lib --add-modules ALL-MODULE-PATH -jar mcaselector-1.9.11.jar
If none of these instructions work, apply "A brain" that you providently held ready after having read the "Requirements" section carefully.
mcaselector-1.9.10
Fixed some bugs and added support for the new blockstate format.
Details
- Fixed a bug where the map would not update correctly after swapping chunks.
- Forcing a biome change is actually forced now.
- Added support for the new 20w17a blockstate format.
- Fixed the status bar not showing complete values.
- Added a loading icon to the bottom right corner when things are loading.
- Improved zooming. Zooming is also possible now using the
+
- and-
-keys. - Set initial offset for coordinate 0,0 to be centered, instead of the center of region 0,0.
- Fixed alignments in the About dialog.
- Updated issue templates.
- Fixed Swedish translation, see #95 .
- Added more instructions for later Java versions regarding JavaFX, see #96 .
- Updated NBT to 5.0.
- 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.9.10.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.9.10.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.9.10.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.9.10.jar
On Debian with OpenJDK 11 and openjfx:
java --module-path /usr/share/openjfx/lib --add-modules ALL-MODULE-PATH -jar mcaselector-1.9.10.jar
If none of these instructions work, apply "A brain" that you providently held ready after having read the "Requirements" section carefully.