Customization

The colors used for the different visualizer types can be changed via resource packs, this page describes how to do so

Rivers and Mountains

The colors for the Rivers and Mountains visualizer are defined in assets/tfcgenviewer/tfcgenviewer/colors/rivers_and_mountains/*.json

  • colors/rivers_and_mountains/river.json: A color definition, the color used for rivers
  • colors/rivers_and_mountains/lake.json: A color definition, the color used for lakes
  • colors/rivers_and_mountains/oceanic_volcanic_mountain.json: A color definition, the color used by oceanic and volcanic mountains
  • colors/rivers_and_mountains/inland_mountain.json: A color definition, the color used by inland mountains

tfcgenviewer/tfcgenviewer/colors/rivers_and_mountains/lake.json default

{
    "color": {
        "r": 150,
        "g": 160,
        "b": 255
    },
    "key": "biome.tfc.lake"
}

Rock Types

The colors of the rock types are defined by a color gradient definition in a resource pack. The definitions are located at assets/tfcgenviewer/tfcgenviewer/gradients/rock_type/oceanic.json, assets/tfcgenviewer/tfcgenviewer/gradients/rock_type/volcanic.json, assets/tfcgenviewer/tfcgenviewer/gradients/rock_type/land.json, and assets/tfcgenviewer/tfcgenviewer/gradients/rock_type/uplift.json

An example from the mod:

tfcgenviewer/tfcgenviewer/gradients/rock_type/uplift.json default

{
    "reference": "uplift",
    "key": "tfcgenviewer.rock_type.uplift"
}

Rocks

The color of a rock is defined by a color definition in a resource pack matching the registry id of the the raw block of that rock layer. For a rock layer with minecraft:dirt as its raw block, the definition would need to be at assets/minecraft/tfcgenviewer/rocks/dirt.json

An example from the mod:

tfc/tfcgenviewer/rocks/rock/raw/andesite.json default

{
    "color": {
        "r": 96,
        "g": 96,
        "b": 96
    },
    "key": "rock.tfc.andesite",
    "sort": 12
}

Additionally, the color definition for unknown rocks is located at assets/tfcgenviewer/tfcgenviewer/rocks/unknown.json

Biomes

The color of a biome is defined by a color definition in a resource pack matching the registry id of the biome. For the biome tfc:canyons, the definition would need to be at assets/tfc/tfcgenviewer/biomes/canyons.json

An example from the mod:

tfc/tfcgenviewer/biomes/plains.json default

{
    "color": {
        "r": 100,
        "g": 200,
        "b": 100
    },
    "key": "biome.tfc.plains",
    "sort": 21
}

Additionally, the color definition for unknown biomes is located at assets/tfcgenviewer/tfcgenviewer/biomes/unknown.json

Rainfall

A color gradient definition at assets/tfcgenviewer/tfcgenviewer/gradients/rainfall.json that defines the gradient used for land in the Rainfall visualizer

Default

{
    "reference": "climate",
    "key": "tfcgenviewer.climate.rainfall"
}

Temperature

A color gradient definition at assets/tfcgenviewer/tfcgenviewer/gradients/temperature.json that defines the gradient used for land in the Temperature visualizer

Default

{
    "reference": "climate",
    "key": "tfcgenviewer.climate.temperature"
}

Biome Altitude

The colors for land in the Biome Altitude visualizer are defined in assets/tfcgenviewer/tfcgenviewer/colors/biome_altitude/*.json

  • colors/biome_altitude/low.json: A color definition, the color for low altitude land
  • colors/biome_altitude/medium.json: A color definition, the color for medium altitude land
  • colors/biome_altitude/high.json: A color definition, the color for high altitude land
  • colors/biome_altitude/mountain.json: A color definition, the color for mountain land

tfcgenviewer/tfcgenviewer/colors/biome_altitude/medium.json default

{
    "color": {
        "r": 26,
        "g": 133,
        "b": 26
    },
    "key": "tfcgenviewer.biome_altitude.medium"
}

Inland Height

The colors for the Inland Height visualizer are defined in assets/tfcgenviewer/tfcgenviewer/colors/inland_height/*.json and assets/tfcgenviewer/tfcgenviewer/gradients/inland_height.json

  • gradients/inland_height.json: A color gradient definition, the gradient used on the land
  • colors/inland_height/shallow_water.json: A color definition, the color used for shallow water
  • colors/inland_height/deep_water.json: A color definition, the color used for deep water
  • colors/inland_height/very_deep_water.json: A color definition, the color used for very deep water

tfcgenviewer/tfcgenviewer/colors/inland_height/shallow_water.json default

{
    
    "color": {
        "r": 150,
        "g": 160,
        "b": 255
    },
    "key": "tfcgenviewer.inland_height.shallow_water"
}

Fill Ocean

A color gradient definition at assets/tfcgenviewer/tfcgenviewer/gradients/fill_ocean.json that defines the gradient of colors used for the ocean in the Rainfall, Temperature, Biome Altitude, and Rivers and Mountains visualizers

Default

{
    "reference": "blue",
    "key": "biome.tfc.ocean"
}

Spawn Overlay

The colors for the spawn overlay are defined in assets/tfcgenviewer/tfcgenviewer/colors/spawn/border.json and assets/tfcgenviewer/tfcgenviewer/colors/spawn/reticule.json

  • colors/spawn/border.json: A Color Definition, the color used to illustrate the maximum spawning radius
  • colors/spawn/reticule.json: A Color Definition, the color used to illustrate the center of the spawning radius

tfcgenviewer/tfcgenviewer/colors/spawn/border.json default

{
    "color": {
        "r": 50,
        "g": 50,
        "b": 50
    }
}

Color Definition

A color definition is an object with up to five fields

Properties

  • color: Mandatory. A color, defines the color of the definition
  • key: Optional. A string, defines the lang key used to describe the color in the color key, defaults to an autogenerated value based on the context used
  • sort: Optional. An integer which defines the sort order of rocks and biomes, defaults to 100. Only relevant for the Rocks and Biomes visualizer types
  • tooltip_key: Optional. A string, defines the lang key used to describe the color when hovering over the preview, defaults to the value used for or provided in key
  • disabled: Optional. A boolean, determines if the color should not be shown in the color key on the right, defaults to false. Only applies to the Rocks and Biomes visualizer types

Color

A Color may be:

  • An object with fields r, g, and b which are integers in the range [0, 255]. The red, green, and blue properties of the color
  • An object with fields h, s, and v which are numbers in the range [0, 1]. The hue, saturation, and value properties of the color
  • A string. A base 16 representation of a rgb number
  • A number. An rgb number
  • A null object, creates a random color during resource reload

Examples:

rgb object

{
    "r": 65,
    "g": 41,
    "b": 245
}

hsv object

{
    "h": 0.234,
    "s": 0.812,
    "v": 0.473
}

String

"F24DE9"

Number

15879657

Color Gradient Definition

A color gradient definition is an object with up to three fields:

  • gradient or reference: Mandatory. May use one or the other, gradient will be used if both are present
    • gradient: Any of:
      • An object with from and to fields
        • from: A color, the ‘low’ end of the gradient
        • to: A color, the ‘high’ end of the gradient
      • A color, a constant gradient
      • An array whose members are colors, the first element is the ‘low’ end of the gradient and the last element is the ‘high’ end
    • reference: Any of:
      • blue, ocean: A gradient from #323296 to #648CFF
      • green, land: A gradient from #006400 to #50C850
      • climate, temp, temperature, rain, rainfall: A gradient through #B414F0, #00B4F0, #B4B4DC, #D2D200, #C8783C, and #C82828
      • volcanic, volcanic_rock: A gradient from #C80064 to #C86464
      • uplift, uplift_rock: A gradient from #B400C8 to #B4B4C8
      • gray, grey, grayscale, greyscale: A gradient from #FFFFFF to #000000
      • random: A gradient between two random colors
  • key: Optional. A string, defines the lang key used, defaults to an autogenerated value based on the context used
  • tooltip_keys: Optional. An array of strings, defines the lang keys used over the gradient when hovering over the preview, any number of keys may be present. Defaults to the value used for or provided in key

Examples:

Reference: tfcgenviewer/tfcgenviewer/gradients/rock_type/oceanic.json

{
    "reference": "blue",
    "key": "tfcgenviewer.rock_type.oceanic"
}

{
    "gradient": {
        "from": {
            "r": 12,
            "g": 0,
            "b": 164
        },
        "to": {
            "h": 0.44,
            "s": 0.1222,
            "v": 0.36
        }
    }
}

{
    "gradient": [
        "B4B4C8",
        "C8783C",
        "B4B4DC",
        "50C850",
        {
            "r": 32,
            "g": 48,
            "b": 120
        }
    ]
}