Giter Club home page Giter Club logo

minemap's Introduction

chat on Discord follow on Twitter

To download it head to the Releases section.

To run it: either double click it on it if you have the Java Runtime (JRE) or use the command line (shift+right click in the folder then open command prompt/Powershell) and type java -jar MineMap-X.X.X.jar.

This is a program to replace the old amidst with a non Minecraft based one (meaning you can run it without Minecraft installed), it is also way more efficient since it is fully multithreaded.

There are severals nice features added, you can see per layers of biome generation, find closest structures, draw circle, area and use a ruler.

Supports all Minecraft release starting from 1.0+

Demo video

Demo Video

Features

  • View Biome map for Overworld/Nether/End for all version from 1.0 till 1.16.5.
  • Load multiple seeds with a navigation tab to switch between them.
  • View structures, and some features placement on the biome map for version 1.8+.
  • View chest loot for 1.16.5 structures: Desert Pyramid, Buried Treasure, Ruined Portal and Shipwreck.
  • Multithreaded processing
  • List the N closest structure and get tp/location to those.
  • Draw line, polygon and circle as overlay to the map.
  • View proportion of biome in a pie chart.
  • Structure seed mode to see all the sister seeds (all seeds sharing the same 48 bottom bits and thus structures)
  • Themes, Shortcuts, Biome colors and structure salts are customizable.
  • Possibility to take screenshot in app via a button or shortcut.
  • View different biomes layers
  • View extra infos such as Stronghold portal order, type of structure (Bastion, Shipwreck, Village are currently supported)
  • Fully customized icons for structures and features + Mojang ones downloaded for item in chest loot.
  • 3D viewer for portals

Shortcuts

Main controls:

  • Ctrl + N : New seed
  • Ctrl + S : Screenshot
  • Ctrl + O : Open screenshot folder
  • Ctrl + Q : Close

Optional controls :

  • Alt + A : Toggle Structure Seed Mode
  • Alt + C : Change Salts
  • Alt + E : Open Settings Folder (see Configuration)
  • Alt + G : Go to Coordinates
  • Alt + K : Show Shortcuts Menu
  • Alt + L : Load Shadow Seed
  • Alt + O : Open Screenshot Folder
  • Alt + P : Go to Spawn
  • Alt + S : Go to Structure
  • Alt + Q : Close current tab
  • Alt + Shift + Q : Close current tab group

Zooming in and out:

  • Ctrl + Numpad + : Zoom in
  • Ctrl + Numpad - : Zoom out
  • Alt + Numpad + : Layer +
  • Alt + Numpad - : Layer -

Go through opened seeds (understood as an infinite tape)

  • Ctrl + Left Arrow : Previous one
  • Ctrl + Right Arrow : Next One

In a dialog type enter to activate the continue button or esc to close the dialog.

Hold alt then press H, W, U, E or B to get one of the 5 menus to open.

You can navigate the menus and press enter to use the button in it.

Specific to 3D viewer

  • Q : Enter mouse control
  • Esc : Exit mouse control
  • WASD : Move around in the world
  • Mouse movement : Look around
  • 0-9 : specific control (might not be binded to anything)

Configuration

All configuration can be found in %HOMEPATH%/.minemap (Windows) or $HOME/.minemap (Mac/Linux)

There are 4 folder here:

  • configs: User config file in json to save user preferences, can be edited manually but highly discouraged (be sure to save them after editing in a safe place, also please check your json syntax like comma at the end)
  • downloads: Assets downloaded from mojang.com with mostly the icons for the items, those are the property of Mojang AB
  • logs: log to be send if any bug happens, this will help to pinpoint the error
  • screenshots : screenshot made in the application

Command line

  • Take a screenshot :

    java -jar Minemap-<version>.jar --screenshot --seed <seed> --version <version> --pos <x> <z> --size <size>
  • Don't show any update popup even if there is a update available

    java -jar Minemap-<version>.jar --no-update
  • Update Minemap without a popup

    java -jar Minemap-<version>.jar --update

Support and bugs

  • This project is still in its enfancy (while packing most of the necessary features) so bug will likely still happen inside it.

  • However, as it is actively maintained you can get a hold of me on Discord or by simply submitting a bug report in the Issues tab.

  • We also have a roadmap of future ideas here and you are welcome to open a discussion here or on Discord to ask for any feature that you deem reasonable enough (be aware for performance issues some might be denied).

Known issues

  • Linux gpu performance-> this is due to java not providing a gpu backend on some distros and using cpu rendering instead (you can try tweaking wayland, adding proprietary drivers or enabling sun opengl backend)

  • Weird artefacts appears on windows -> you are using Riva Tuner or MSI Afterburner which tampers with java swing. You should disable them or add an exception for all java.exe apps or Minemap-*.exe.

  • Minemap fails to start, maybe some config was not correctly written, go to $HOME/.minemap or %HOMEPATH%/.minemap and delete the config folder.

  • Minemap fails to update, maybe you are ratelimited by Github, please try later.

Development

You just need to have the Java JDK installed then do: git clone https://github.com/hube12/MineMap

Go in the directory and run ./gradlew run to run Minemap (we enable the no-update option)

Run ./gradlew shadowJar to generate the release jar (modify gradle.properties version variable accordingly)

Run ./gradlew release to generate the .exe and the .jar.

To use vulkan with debug and validation layers please install the vulkan Lunar SDK.

Signature and due diligence

Since 1.0.24 we sign both commits and release files (as such each exe and jar are provided with a sha512 and the jar with a signature and all of that is zipped then signed once again).

Signature can be verified with gpg --verify Minemap-<version>.zip.asc Minemap-<version>.zip.

You will need my signature which can be found here or here.

Then you will need to dearmor it: gpg -o neil_pubkey.gpg --dearmor *.asc and then import it or use directly:

gpg --no-default-keyring --keyring neil_pubkey.gpg --verify Minemap-<version>.zip.asc Minemap-<version>.zip

You can download a dearmored version here (fair warning do not open it in a text editor as it is not ANSI)

Contributors

  • KaptainWutax : Core part of the map system and libs setup
  • Neil : libs enrichment + utilities in Minemap + rich icons
  • Uniquepotatoes : Flat icons design
  • Speedrunning and monkeys discord ppl : input on feature for Minemap

Legal mentions

The main core part was done by KaptainWutax.

Any of the work done by Neil is released under MIT. However all materials which are not hand made will be released under the specific author license, this includes but not limit to some icons and the logo.

The visualizer is made by SnkSynthesis and released under MIT : https://github.com/SnkSynthesis/voxel-game

All the structures and features icons are released under CC-0 at https://github.com/hube12/mc_icons.

NOT OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG.

minemap's People

Contributors

burgerindividual avatar hube12 avatar kaptainwutax avatar wearblackallday avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

minemap's Issues

Minemap Overworld Coords Off

With the seed I am using all the coords are wrong for overworld. The end coords are correct and haven't checked the nether coords.

Seed rendering for 1.18 and up seems to be off (completely different world)

I've been tinkering with the program for a bit now to make a Discord bot that uses it and some other programs to render a map of a seed, and ran into the issue that whatever my structure finder finds just does not match up with the render provided by MineMap, while other things that use amidst seem to be more correct. While it seems newer versions are supported but all this is going on.

Support latest Minecraft versions

The readme says till 1.16.5, so question is:
Will there be support for 1.17 and 1.18?
The program looks nice on first glance so I would like to use it.

Crash when using screenshot command

When running java -jar F:\pictures\MineMap-1.0.19.jar --screenshot --seed 1974532499 --version 1.17 --pos 0 0 --size 1600 using any version of java results in this error with the current release:

Exception in thread "main" java.lang.NullPointerException at kaptainwutax.minemap.ui.map.fragment.Fragment.refreshBiomeCache(Fragment.java:200) at kaptainwutax.minemap.ui.map.fragment.Fragment.<init>(Fragment.java:52) at kaptainwutax.minemap.MineMap.doScreenshot(MineMap.java:166) at kaptainwutax.minemap.MineMap.main(MineMap.java:84)

More Structure Loot Displays

I'm guessing this is already in development. But if it isn't, it might be useful to be able to see chest contents for all structures!

Bug: Cannot take screenshot of a grid containing a zombie village

Basic issue:
If you have the icon for villages enabled, any grid on the map that contains a zombie village icon will not let you take a screenshot using the built-in screenshot function. Normal villages work fine. It's just zombie villages that are a problem.
image

More detail:
Here is a screen snip I took of a map I have.
image
I colored in one grid that contains a zombie village icon. If any part of that grid is being displayed on screen, your program's screenshot function will not work. Even if it's only 1 pixel in frame.

If you disable the village icons from appearing on the map, then you are able to screenshot again. I don't know if this issue exists for other icons as I'm only using a limited selection of enabled icons.

Recreation:
Version 1.0.24
Seed I'm using: 3971198378293864095 [1.16.1]
Example of zombie village: (1337, 6713)

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.