Description

Screenshot Settings

ScreenshotSettings is a mod for Quilt/Fabric that allows you to configure various things about in-game screenshots.

"Various Things" includes choosing where screenshots are saved to on-disk, as well as how you'd like them to be named. Relevant information to a screenshot can be optionally embedded into the filename or metadata, such as player position, rotation, active texture or shader packs, the name of the world or server the screenshot was taken on, and if on singleplayer, the world seed.

This should allow for convenient sorting/searching through screenshots by relevant metadata, and is also nice just for making your screenshots more accessible. (Seriously, I hate having to go into my AppData folder when I'm playing on Windows. It's terribly annoying.)

Things you can do with the custom File Naming system.

The file naming system is somewhat bare bones at the moment, only supporting 8 templates.

• <datetime>
  • Minecraft's default screenshot naming format.
  • (This may be changed in the future to support more customizable formatting, like having separate tags for <year> <month> <day> <hour> <minute> <second>)
• <world>
  • The name of the world in Single Player, and the name of the server in Multiplayer.
• <version>
  • The version of Minecraft the screenshot was taken on. (Ex. 1.19.2)
• <x> <y> and <z>
  • The respective coordinates of where the screenshot was taken.
• <shader>
  • The active Shader pack. (requires Iris Shaders)
• <player>
  • Your Minecraft username. Useful for if you want to put screenshots from multiple accounts in the same place but keep them organized. (Not entirely sure why you would want to do that, but the point of this mod is to give you options, damnit!)

Automatically Creating Subdirectories

By including a / in your naming scheme, you can create a directory structure based on the templates above.

You can automatically organize your screenshots into folders according to what world/server they were taken on, or what shaderpack was in use at the time of the screenshot.

My favorite naming scheme is <world>/<datetime> because it gives me all the organizational structure I really need, as well as being effective at preventing naming collisions.

If you, however, were to have many servers saved as "Minecraft Server" and many singleplayer worlds named "New World", this wouldn't do much to help you.

A note on PNG Metadata

The Windows Explorer cannot display the metadata included by this mod. You will need to get a dedicated program for windows to be able to see it.

To be frank, the existing solutions for viewing PNG metadata on Windows are somewhat disappointing. I may make a standalone tool for this in the future just to get something more accessible out there.

Viewing Metadata: CLI

If you're comfortable using a command-line tool, you can use ImageMagick's identify --verbose command to see it.

ImageMagick has releases for Windows, Mac, and Linux, and if you're on Linux chances are you already have it installed anyway.

This is the way I'd recommend, because it allows you to set up scripts for searching through or organizing your screenshots, but if all you're interested in is viewing metadata, perhaps you'd be more interested in a GUI.

An option for any weirdos out there like myself - (WSL).

Because Minecraft uses URIs to resolve file paths on Windows, you can actually use the path to an installed WSL distribution as a valid save location to make manipulating your screenshot collection via WSL more convenient.

Viewing Metadata: GUI

If you aren't comfortable using a command-line tool... the best way I've found (on Windows, at least) is exiftoolgui.

It requires that you have the base exiftool installed, but the "default" installation process for it isn't very user-friendly. For installing the base tool, I recommend Oliver Betz's exiftool for windows. It comes packaged with a GUI installer and is just generally more convenient.

Once installed, you'll want to navigate to your screenshot and view the All tab to see all of its metadata. The metadata attached by this mod should appear at the bottom, as it does in the screenshot above.

DISCLAIMER FOR MODPACK DEVELOPERS!

MAKE SURE that you do not accidentally ship any custom config you might have for this mod to users. Add it to a .gitignore or something, just be careful that you don't end up making it so other people's games try saving screenshots to arbitrary non-existent directories.

I intend on eventually adding a way for the mod to detect that it is being run on a new unique machine for the first time, but I haven't decided how to implement that yet. For now, just don't ship your config.

What means Verified?

• Compatibility: The mod should be compatible with the latest version of Minecraft and be clearly labeled with its supported versions.
• Functionality: The mod should work as advertised and not cause any game-breaking bugs or crashes.
• Security: The mod should not contain any malicious code or attempts to steal personal information.
• Performance: The mod should not cause a significant decrease in the game's performance, such as by causing lag or reducing frame rates.
• Originality: The mod should be original and not a copy of someone else's work.
• Up-to-date: The mod should be regularly updated to fix bugs, improve performance, and maintain compatibility with the latest version of Minecraft.
• Support: The mod should have an active developer who provides support and troubleshooting assistance to users.
• License: The mod should be released under a clear and open source license that allows others to use, modify, and redistribute the code.
• Documentation: The mod should come with clear and detailed documentation on how to install and use it.

How to Install