MythicHud

The MythicHud Extension bridges TypeWriter's dialogue system with the MythicHUD plugin. It enables spoken dialogue with typing effects, option-based choice dialogues, cinematic segments, and look-at-audience popups — all powered by MythicHUD's command-based popup system.

Key Features

• Spoken Dialogue — Typing animation with per-character sound support.
  • Option Dialogue — Interactive choice menus with grid navigation and scrollable option window.
  • Cinematic Dialogue — Multi-segment cinematic sequences with typing effects.
  • Look Audience — Contextual popups when a player looks at a position.

Installation

1. Place TypeWriter-MythicHudExtension.jar in plugins/TypeWriter/extensions/
2. Copy the default YAML files to plugins/MythicHUD/:
   • Assets → hud_assets/hud/typewriter_spoken_asset.yml
   • Assets → hud_assets/hud/typewriter_option_asset.yml
   • Assets → hud_assets/hud/typewriter_look_asset.yml
   • Popups → popups/typewriter_spoken_dialogue.yml
   • Popups → popups/typewriter_option_dialogue.yml
   • Popups → popups/typewriter_look_popup.yml
3. Auto-extraction: The extension automatically extracts these defaults on first load if they don't already exist. You can also copy them manually from the defaults/ folder in the extension's distribution.
4. Run /hud reload to register the new assets and popups
5. Run /typewriter reload to load the extension

Quick Start

• 1. Explore Entries — This extension provides the following entries. Add them in your Typewriter page to get started: - mythichud_spoken - mythichud_option - mythichud_spoken_dialogue_cinematic - mythichud_look_audience

Commands

MythicHUD popups are triggered by commands dispatched automatically by the extension:

/happyhud popup <player> <popup_id> <ticks> <arg1|arg2|...>

Arguments are pipe-separated (|) and become %arg-1%, %arg-2%, etc. in the popup YAML text layers.

Comparison with BetterHUD Extension

Feature	BetterHUD	MythicHUD
Popup API	Programmatic (Java events)	Command-based (/happyhud popup)
Update frequency	Every tick (~50ms)	Every ~250ms (throttled)
Variable injection	Unlimited (Map)	Up to 28 arguments
YAML customization	No	Yes (editable assets/popups)
Typing sound	Yes	Yes
Scroll window	Yes	Yes

Interface Variables

Spoken Dialogue

Argument	Variable	Description
%arg-1%	speaker	Display name of the speaking character
%arg-2%	text	Current text being typed out
%arg-3%	progress	Integer percentage (0-100)
%arg-4%	percentage	Float percentage (0.00-1.00)
%arg-5%	instruction	"finish" or "continue"
%arg-6%	is_complete	"true" or "false"
%arg-7%	pressbutton	"Press X to continue" text

Option Dialogue

Argument	Description
%arg-1%	Speaker name
%arg-2%	Dialogue text
%arg-3%	Progress 0-100
%arg-4%	Animation complete (true/false)
%arg-5%	Instruction text
%arg-6%	Total option count
%arg-7%	Selected index (absolute)
%arg-8%	Selected option text
%arg-9%	Timer remaining (seconds)
%arg-10%–%arg-19%	Option texts (visible window)
%arg-20%–%arg-28%	Scroll window metadata

Placeholders

Placeholder	Description
%typewriter_mythichud_dialogue_timer%	Remaining time on the current dialogue.
%typewriter_mythichuddialogue_timer%	Alias of the placeholder above; both are accepted.