/mineshot-revived

A revived version of Mineshot: "A Minecraft mod for creating high resolution screenshots."

Primary LanguageJavaThe UnlicenseUnlicense

Mineshot Revived

The future of this version of Mineshot Revived is unsure. I also developed a version for Fabric and while doing that, I noticed that I much prefer the flexibilty and portability of that framework. So check that version out if you are interested.

Mineshot Revived is a mod for Minecraft (using Forge) for creating high-resolution screenshots, optionally using the orthographic camera.

The majority of the code is based on the original Mineshot by Barracuda. So many thanks to the original creator. Unfortunately that project seems dead, probably because of the big changes which were introduced.

The main purpose of this project is to keep Mineshot alive by updating for newer Minecraft/Forge versions. For now, the project is in ALPHA-stage. This means that only part of the original Mineshot functions is available and those that are, are still very experimental. However you are very welcome to test this project and create issues.

Only Minecraft 1.15.2 and 1.16.5 are currently supported.

Usage

The controls are the same as in the original Mineshot:

  • F9: Take screenshot
  • Numpad 4: Rotate left
  • Numpad 6: Rotate right
  • Numpad 8: Rotate up
  • Numpad 2: Rotate down
  • Numpad 7: Top view
  • Numpad 1: Front view
  • Numpad 3: Side view
  • Numpad 5: Switch between perspective and orthograpic projection
  • MOD-key (Left Control) + Numpad 5: Switch between fixed and free camera.
  • MOD-key (Left Control) + Numpad 4, 6, 8, or 2: Incremental instead of smooth rotation
  • Plus: Zoom in
  • Minus: Zoom out

The key-bindings can be changed in the Minecraft Controls menu.

As there is no configuration GUI in Forge 1.15 yet, you have to change the size of the screenshot manually in: <mc-folder>/config/mineshotrevived-client.toml. This file will be created the first time this mod is loaded and defaults to 4K (3840x2160).

Please note that the screenshots created will be huge (4K is already 23,7 MB), so choose your resolution carefully. The screenshot will be a Targa image file and will therefore be limited to 65535 by 65535 pixels.

Known limitations

There are several features which aren't working (yet) in Mineshot Revived:

  • Tiled rendering: only off-screen framebuffer rendering for now
  • Clipping is not correct: there is no easy way to disable the ClippingHelper in 1.15
  • No GUI for configuration

Download

Compiled jars are available on the releases page.