Improved Map Colors

# Improved Map Colors Improved Map Colors is a Minecraft mod made for Gneiss Name's video that improves Minecraft's default map colors, including making them configurable by the user or by datapacks on a server or singleplayer world. Because of that server functionality, this mod must be installed on both the dedicated server and the client distributions. There are also several pre-configured options for Minecraft map colors, including sepia tones, grayscale, and inverted colors. > **Gneiss Name's channel:** (https://www.youtube.com/@gneissname) <details> <summary>Video this mod was made for</summary> <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/4dEx8D1mjso" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> </details> ## Usage The mod allows you to configure both the color palette Minecraft uses as well as which blocks and blockstates show up as which colors. This is achieved through two main ways: Mod config files and datapacks. ### Config The config file provides two fields that can be used to directly modify the palette and state list: `colorlist` and `state_list`. `colorlist`, as the name and description suggest, allows you to modify the color palette Minecraft uses. This is set to vanilla by default, to illustrate the format that the mod expects, which is a list containing up to 63 colors specified by their hexadecimal color code. `state_list` allows you to modify the color ID that a BlockState or a Block shows up as on a map. The format the mod expects is also illustrated by the default entries, graciously provided by Gneiss: blockid:colorID. The blockstate information is specified in the same way as vanilla blockstate data, . The mod will do its best to guess what you intend with a specified state, but it can be a bit finicky. Also included is something like a debug method of overriding everything in the form of a CSV file. This must be specified in the provided config fields, `color_file` and `blockstate_file`. The format for each is described and shown below. <details> <summary>CSV format</summary> Color CSV should be in the format: |hex color||, like: ```csv "#000000","0" "#00ff00","3" "#ff00ff" ``` Block State CSV should be in the format: <br> |BlockID|colorID<required>| OR |BlockID||colorID<required>|, like: ```csv "minecraft:grass_block","1" "minecraft:black_bed","3" "minecraft:grass_block","","2" ``` </details> ### Datapacks These allow per-world map settings and are how the included presets work. The format for them is provided in the presets, but in short the mod will scan the `mapcolors/colors` and `mapcolors/states` subdirectories in any datapack. Colors: The format for the color list files is a "colorlist" JSON object for colors in the /colors directory, mapping from a numerical colorID string to a hex color code, like "id":"hex color", where id is in a range from 0 to 63 inclusive. States: The format for the blockstate file is an array called "stateColorIDList", which contains JSON objects in the format below. <details> <summary>State Holder Format</summary> ```json { "state": { "Name": "<minecraft block id>", "Properties": { "name": "value", "name1": "value1", "name2": "value2" } }, "colorID": <id>, "trackedProperties": } ``` </details> Big thanks to Gneiss for inspiring the project and Grassy for translating it into Russian!