User Docs: Emissive Format

This guide aims to show you how to use MoreMcmeta's emissive format to make Minecraft textures emissive with MoreMcmeta 4.0.0+.

You must have the emissive plugin installed for your metadata files to have an effect.

OptiFine Format

MoreMcmeta also supports the OptiFine format for emissive textures. Please see the OptiFine documentation for details about this format.

Emissive Properties

Structure

See Examples for examples of correct syntax. This chart merely describes how properties are nested.

.
+-- "overlay"
|   +-- "texture"
|   +-- "emissive"
|   +-- "transparency"

Property Definitions

All of these properties are optional. The default value will be used if you do not specify them.

Property	Description	Type	Required?	Default
"texture"	full path to a texture to use as the overlay	string	required	N/A
"emissive"	whether the overlay should be emissive	boolean	optional	false
"transparency"	translucent enables partial transparency. auto determines an appropriate transparency based on the transparency of the block or entity. The transparency used with the auto setting may change between versions and may not be consistent between mod loaders or Minecraft versions. If you need partial transparency, always use the translucent setting.	string	optional	auto

.moremcmeta Examples

Bare Minimum

{
    "overlay": {
        "texture": "minecraft:textures/block/spruce_sapling.png"
    }
}

Emissive Overlay

{
    "overlay": {
        "texture": "minecraft:textures/block/spruce_sapling.png",
        "emissive": true
    }
}

Partially-Transparent Emissive Overlay

{
    "overlay": {
        "texture": "minecraft:textures/block/spruce_sapling.png",
        "emissive": true,
        "transparency": "translucent"
    }
}

Overlays for Mod Textures

Minecraft Forge uses a resource caching mechanism that can prevent overlays from loading if you don't include the base texture in your resource pack. For example, say there is a texture advanced_furnace.png, the base texture, included in Forge's mod resource pack. You add an overlay called advanced_furnace_e.png in your resource pack. To work with Forge's caching, then you also need to include a copy of advanced_furnace.png in your resource pack alongside advanced_furnace_e.png.

The caching does not apply to non-mod resources, so including the base texture in your resource pack is optional for textures that aren't loaded by Forge.

A fix on MoreMcmeta's side would disable Forge's caching mechanism, which could cause performance issues.

Synchronizing Overlay and Base Texture Animations

If you want to synchronize an overlay's animation with its base texture's animation, both textures need to have their metadata defined in .moremcmeta files. MoreMcmeta's policy is to let vanilla manage .mcmeta animations, but vanilla and MoreMcmeta do not update animations at the same time, which leads to desynchronization. Using .moremcmeta files for the base texture and the overlay makes MoreMcmeta control both animations, so they'll always update at the same time.