README.md

Dungeon Finder

👹 A command line tool that finds multi-dungeon configurations in a Minecraft world save.
⚠️ Won't work for Minecraft version 1.13 and later.

Features

Find Dungeon Configurations of Any Size

• 📐 Welzl's Algorithm Integration
• 💻 Multithreading Support
• ⚙️ Custom Region Ranges

Getting Started

Installing

• Download the latest Dungeon Finder binary.

Development

Prerequisites

• 🔗 Git Version Control System
• ☕ Java SE Development Kit 8
• 🌏 A Pregenerated Minecraft World

Building

💻 Run the following commands in your terminal:

git clone https://github.com/rayferric/dungeon-finder.git
cd dungeon-finder
./gradlew shadowJar

A standalone output binary will be written to the ./build/libs/ directory.

You can use these to acquire the binary and libraries separately:

./gradlew build
./gradlew copyDependencies

The binary file will be generated in the ./build/libs/ directory. Any required libraries will be copied to ./lib/.

Running

Find three-spawner configurations in a 16384x16384 area around (0, 0):

java -jar dungeon-finder-{version}-all.jar -w="{save-directory}" --min-x=-16 --min-z=-16 --max-x=15 --max-z=15

Find double-dungeon XP farms in a 2048x2048 region:

java -jar dungeon-finder-{version}-all.jar -w="{save-directory}" --min-x=-2 --min-z=-2 --max-x=1 --max-z=1 -c=2

List all spawners in a 1024x1024 square:

java -jar dungeon-finder-{version}-all.jar -w="{save-directory}" --min-x=-1 --min-z=-1 --max-x=0 --max-z=0 -c=1

Example output:

Processing 16 regions on 8 threads...
Found 151 dungeons. (10 s)
Started proximity filtering...
Found 5 dungeon configurations with size of at least 2:
(635, 49, -198) skeleton + zombie
(309, 44, -423) spider + zombie
(-814, 47, 605) zombie + skeleton
(318, 31, 596) skeleton + zombie
(860, 35, 568) zombie + spider

About

Authors

• Ray Ferric (rayferric)

License

This project is licensed under the MIT License. See the LICENSE file for details.