Giter Club home page Giter Club logo

worldtools's Introduction

WorldTools: World Downloader (Fabric / Forge)

CurseForge Downloads Modrinth Downloads Minecraft Minecraft Minecraft License

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.

Fabric Supported Forge Supported

Link to the lambda discord server https://discord.gg/3y3ah5BtjB

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: Positions and attributes of all 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 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:

Forge

  1. Installation:

    • Install Forge by following the Forge Download Link.
    • Download the latest Forge version of WorldTools from the releases page
    • Place the WorldTools Forge mod JAR file in the "mods" folder of your Forge installation.
  2. Prerequisites: Make sure you have the following mods installed:

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

Contributing

Contributions are welcome! Please read our Code of Conduct and Contributing Guidelines before submitting a Pull Request.

  1. Fork the repository and clone it to your local machine.
    git clone https://github.com/Avanatiker/WorldTools
  2. Create a new branch for your feature.
    git checkout -b my-new-feature
  3. Make your changes and commit them to your branch.
    git commit -am 'Add some feature'
  4. Push your changes to your fork.
    git push origin my-new-feature
  5. Open a Pull Request in this repository.
  6. Your Pull Request will be reviewed and merged as soon as possible.
  7. Wait for the next release to see your changes in action!

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.

ToDo

Fixes

  • Fix statistics not updated on stop because the packet answer is not received before the world is saved
  • Fix on capture switch config button functionality in capture gui
  • Dimension, XP, selected item slot, player game type, is not saved to player nbt in level.dat

Features

  • Capture Mode: Choose between two capture modes: Full and Incremental. The Full mode captures all data from the server, while the Incremental mode only captures data that has changed since the last capture.
  • Save lectern contents
  • Save server datapack to the downloaded world
  • Save more entity data (NBT) like trades, inventory from boats and minecarts, etc.
  • Live statistics: Data usage, time elapsed, etc.

License

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


If you have any questions, concerns, or suggestions, you can visit our official Discord server.

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.

worldtools's People

Contributors

aprme avatar avanatiker avatar calvineries avatar chiekn avatar dependabot[bot] avatar ironexception avatar p529 avatar rfresh2 avatar yomo2b2t avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.