Server List Explorer

Server List Explorer is a tool for managing your Minecraft: Java Edition server list and, in the future, your single-player world list. A complete overview of the features can be found on the Feature List wiki page.

User Interface Preview

Table of Contents

• User Interface Preview
• How to Build the Project
• Wiki

How to Build the Project

This project is built using Gradle and requires Java 21 or higher to run. Follow the steps below to build and execute the application:

1. Build the Project

From the root of the project, run the following Gradle task to generate the shadow JAR:

./gradlew :app:shadowJar

This task will produce a fat JAR (a JAR containing all dependencies) that can be run independently.

2. Locate the JAR

Once the build completes, the generated JAR files can be found in the app/build/libs/ directory:

• Shadow JAR (includes all dependencies): ServerListExplorer-all.jar This is the recommended JAR to run for ease of use.

• Normal JAR (without bundled dependencies): ServerListExplorer.jar Use this only if you plan to manage dependencies manually.

3. Run the Application

Run the shadow JAR using Java 21 or higher:

java -jar app/build/libs/ServerListExplorer-all.jar

If you prefer the normal JAR, make sure to provide all required dependencies on the classpath.

Wiki

For detailed usage instructions and troubleshooting tips, please refer to the GitHub Wiki.