Main Config

The main configuration file is located at config/masuholograms/config.json. It is generated on first startup with default values.

After editing, run /mh reload to apply changes.

Full Default Config

{
  "defaultText": "Blank Line",
  "defaultDisplayRange": 48,
  "defaultUpdateRange": 48,
  "defaultUpdateInterval": 20,
  "defaultDownOrigin": false,
  "defaultTextHeight": 0.3,
  "defaultIconHeight": 0.6,
  "defaultHeadHeight": 0.75,
  "defaultSmallHeadHeight": 0.6,
  "clickCooldownTicks": 1,
  "allowPlaceholdersInsideAnimations": false,
  "updateVisibilityOnTeleport": false,
  "entityScaleAttribute": "",
  "damageDisplay": {
    "enabled": false,
    "showForPlayers": true,
    "showForMobs": true,
    "showZeroDamage": false,
    "durationTicks": 40,
    "heightOffset": 2.0,
    "format": "&c-{damage}",
    "criticalFormat": "&4&l-{damage}"
  },
  "healingDisplay": {
    "enabled": false,
    "showForPlayers": true,
    "showForMobs": false,
    "durationTicks": 40,
    "heightOffset": 2.0,
    "format": "&a+{healing}"
  },
  "lecternHolograms": {
    "enabled": true,
    "maxLinesPerPage": 6,
    "defaultLimit": 3,
    "maxLimit": 20,
    "heightOffset": 0.0,
    "displayRange": 48,
    "allowColorCodes": true,
    "disablePlaceholders": true,
    "disableAnimations": true,
    "validationIntervalTicks": 100
  },
  "customReplacements": {
    "[x]": "\u2588",
    "[X]": "\u2588",
    "[/]": "\u2580",
    "[,]": "\u2591",
    "[,,]": "\u2592",
    "[,,,]": "\u2593",
    "[p]": "\u2022",
    "[P]": "\u2022",
    "[|]": "\u23ae"
  }
}

General Settings

defaultText

Default: "Blank Line"

The text used when creating a new line without specifying content (e.g., /mh line add myHolo 1).

defaultDisplayRange

Default: 48 Range: 1-256

The default maximum distance (in blocks) at which players can see newly created holograms.

defaultUpdateRange

Default: 48 Range: 1-256

The default maximum distance at which placeholder/animation updates are sent to players.

defaultUpdateInterval

Default: 20 Range: 1-1200

The default number of ticks between placeholder refreshes. 20 ticks = 1 second.

defaultDownOrigin

Default: false

Default line stacking direction for new holograms. - false = top-down (line 1 at top) - true = bottom-up (last line at origin)

Default Heights

Setting	Default	For
`defaultTextHeight`	`0.3`	Text lines
`defaultIconHeight`	`0.6`	Icon (item) lines
`defaultHeadHeight`	`0.75`	Head lines
`defaultSmallHeadHeight`	`0.6`	Small head lines

Entity lines always default to 1.0. Player lines default to 2.0.

clickCooldownTicks

Default: 1

Minimum ticks between click action triggers per player. Prevents action spam.

Value	Cooldown
`1`	0.05s (essentially none)
`5`	0.25s
`10`	0.5s
`20`	1s

allowPlaceholdersInsideAnimations

Default: false

When true, placeholders like {player} inside {#ANIM:...}...{/#ANIM} tags are resolved before the animation processes the text.

updateVisibilityOnTeleport

Default: false

When true, hologram visibility is immediately rechecked when a player teleports, instead of waiting for the next periodic check (every 1 second).

entityScaleAttribute

Default: "" (empty, disabled)

The attribute name used for scaling via /mh line setscale. Applies to both #ENTITY: and #PLAYER: lines. The attribute must be provided by an installed mod.

Example for Vault Hunters:

{
  "entityScaleAttribute": "the_vault:generic.size_scale"
}

When empty, the /mh line setscale command is unavailable.

Player lines

For #PLAYER: lines, the scale is applied directly to the Taterzens NPC as a server-side entity attribute. This requires Taterzens to be installed in addition to the mod providing the attribute.

Damage Display

See Damage Display for detailed configuration.

Healing Display

See Healing Display for detailed configuration.

Lectern Holograms

See Lectern Holograms for detailed configuration.

Custom Replacements

Text shortcuts that are replaced before color processing. Keys are the shortcut text, values are the replacement characters.

Default Replacements

Shortcut	Character	Unicode	Description
`[x]` / `[X]`	`█`	U+2588	Full block
`[/]`	`▀`	U+2580	Upper half block
`[,]`	`░`	U+2591	Light shade
`[,,]`	`▒`	U+2592	Medium shade
`[,,,]`	`▓`	U+2593	Dark shade
`[p]` / `[P]`	`•`	U+2022	Bullet
`[\|]`	`⎮`	U+23AE	Vertical bar

Adding Custom Replacements

Add entries to the customReplacements object. Use Unicode escape sequences or paste characters directly:

{
  "customReplacements": {
    "[star]": "\u2605",
    "[heart]": "\u2764",
    "[arrow]": "\u279c",
    "[check]": "\u2714",
    "[cross]": "\u2718"
  }
}

Then in holograms:

/mh line set myHolo 1 1 &a[check] Task Complete
/mh line set myHolo 1 2 &c[cross] Task Failed