WorldTools: World Downloader (Fabric / NeoForge)

WorldTools is a powerful Minecraft mod that allows you to capture and save high-detail snapshots of server worlds locally. It empowers you to download comprehensive information, including chunks, entities, chests, players, statistics, advancements, and detailed metadata. WorldTools ensures that you can retain an accurate and unaltered representation of the server's world for analysis, sharing, or backup purposes on your local machine.

This project is a fork of the original WorldTools, updated to support newer Minecraft versions(1.21.5+) on Fabric and NeoForge, with some bugs fixed.

Features

• World Download (default keybind: F12): Initiate a quick download by hitting the F12 key, which can be altered in the keybind settings. Alternatively, you can access the GUI (default keybind: F10) via the escape menu. The GUI allows you to tailor the capture process according to your requirements. WorldTools facilitates the capture of a wide range of crucial elements, ensuring no detail is missed.

  • Chunks: Terrain, biomes and structures
  • Entities: Inventories and attributes of most entities
  • Containers: Contents of all tile entities like chests, shulkers, hoppers, furnaces, brewing stands, droppers, dispensers etc...
  • Players: Player positions and inventories
  • Statistics: Full personal player statistics
  • Advancements: Player advancements and progress
  • Special Objects: Maps, Lecterns and Banners
  • Detailed Metadata: Exhaustive capture details like modt, server version, timestamps, and more

• Easy Access to Saved Worlds: Your locally captured world save can be found in the single-player worlds list, allowing you to load and explore it conveniently.

• Advanced Configuration: WorldTools provides a wide range of settings to customize the capture process to your needs. Select elements to capture, modify game rules, alter entity NBT data, and configure the capture process in detail.

Getting Started

Fabric

1. Installation:

   • Install Fabric by following the Fabric Installation Guide.
   • Download the latest Fabric version of WorldTools from the releases page
   • Place the WorldTools Fabric mod JAR file in the "mods" folder of your Fabric installation.

2. Prerequisites: Make sure you have the following mods installed:

   • fabric-language-kotlin
   • Cloth Config API

NeoForge

1. Installation:

   • Install NeoForge by following the NeoForge Download Link.
   • Download the latest NeoForge version of WorldTools from the releases page
   • Place the WorldTools NeoForge mod JAR file in the "mods" folder of your NeoForge installation.

2. Prerequisites: Make sure you have the following mods installed:

   • Kotlin For Forge
   • Cloth Config API

Usage

1. Download:
   • Enable capture mode: Hit F12 the GUI (on ESC menu) or /worldtools capture to start capturing data.
   • Play the game normally while WorldTools downloads the all data. You need to open containers like chests to capture their contents.
   • Save captured data: Hit F12 the GUI (on ESC menu) or /worldtools capture again to stop capturing data and save the world.
2. Access Downloaded World: Your downloaded world can be found in the single-player worlds list.

File Structure

After capturing data, WorldTools creates the following files in the world directory's folder:

• Capture Metadata.md: Contains detailed information about the capture process itself.

• Dimension Tree.txt: Provides a tree of all dimension folder paths of the server, not just the downloaded ones.

• Player Entry List.csv: Lists all players that were online during the capture including all known metadata.

Supported Languages

For the best user experience, WorldTools is available in the following languages:

• German
• English (Pirate)
• English (United States)
• French (Canada)
• French (France)
• Dutch (Belgium)
• Dutch (Netherlands)
• Nynorsk (Norwegian)
• Norwegian (Norway)
• Portuguese (Brazil)
• Portuguese (Portugal)
• Russian

Building

1. Once forked and cloned, run ./gradlew build to build the mod for both mod loaders.
2. IntelliJ IDEA will generate run configurations for both mod loaders that can be used to run the mod in a test environment.
3. The Fabric mod JAR file can be found in fabric/build/libs and the Forge mod JAR file in forge/build/libs.

License

WorldTools is distributed under the GNU General Public License v3.0.

Disclaimer: WorldTools is not affiliated with Mojang Studios. Minecraft is a registered trademark of Mojang Studios. Use of the WorldTools software is subject to the terms outlined in the license agreement.