Skip to content

Latest commit

 

History

History
52 lines (35 loc) · 2.48 KB

README.md

File metadata and controls

52 lines (35 loc) · 2.48 KB

Emacs Minecraft Biome Viewer

A tool for viewing your Minecraft worlds from within Emacs using Amidst.

The package currently supports reading a Minecraft world from a save file (mc-biome-viewer-view-save), and from a seed (mc-biome-viewer-view-seed).

Minecraft versions from 1.0 to 1.16.1 are currently supported (but you must have a Minecraft launcher profile which uses the version in question).

mc-biome-viewer example

Each character in the grid corresponds to one chunk.

Keys

Once you have loaded a world, navigating through it is easy:

Key Command Description
f mc-biome-viewer-forward-x Move the camera to the right one chunk
b mc-biome-viewer-backward-x Move the camera left one chunk
n mc-biome-viewer-backward-y Move the camera downwards one chunk
p mc-biome-viewer-forward-y Move the camera upwards one chunk
j mc-biome-viewer-centre-camera Centre the camera at the prompted world coordinate

Alternatively the traditional UP, DOWN, LEFT, RIGHT keys can be used to shift the camera.

You can move from biome to biome using the usual text movement commands and information about the chunk the cursor is on will be displayed in a label in the bottom left corner (see the image above).

Installation

The easiest way is with quelpa-use-package:

(use-package mc-biome-viewer
    :ensure nil
    :quelpa (mc-biome-viewer :fetcher github :repo "LaurenceWarne/mc-biome-viewer" :stable t)
    ;; Example configuration
    :config
    ;; Note you must have a Minecraft launcher profile which uses this version!
    (setq mc-biome-viewer-default-version "my.preferred.version")
    (setq mc-biome-viewer-column-chunks-in-camera 48)  ; But fewer chunks will be faster
    (puthash "ice plains" '(:foreground "silver") mc-biome-viewer-biome-to-face-map))

Java 8 is also required (along with a Minecraft installation).

Changelog

0.2

  • Support for Minecraft 1.16.1
  • More feedback when downloading the mc-biome-server