VoxeLibre/mods/HUD/mcl_title/API.md
Mikita Wiśniewski 19d662dee4 Fix some typos in the API documentation (#4630)
Reviewed-on: https://git.minetest.land/VoxeLibre/VoxeLibre/pulls/4630
Reviewed-by: teknomunk <teknomunk@protonmail.com>
Co-authored-by: Mikita Wiśniewski <rudzik8@protonmail.com>
Co-committed-by: Mikita Wiśniewski <rudzik8@protonmail.com>
2024-09-12 18:13:52 +02:00

1.5 KiB

mcl_title

Allow mods to show messages in the hud of players.

mcl_title.set(player, type, data)

Show a hud message of type to player player with data as params.

The element will stay for the per-player param stay or data.stay (in gametick which is 1/20 second).

Here is a usage example:

--show a title in the HUD with minecraft color "gold" 
mcl_title.set(player, "title", {text="dummy text", color="gold"})

--show a subtitle in the HUD with hex color "#612D2D" 
mcl_title.set(player, "subtitle", {text="dummy subtitle", color="#612D2D"})

--show an actionbar in the HUD (above the hotbar) with minecraft color "red"
mcl_title.set(player, "subtitle", {text="dummy actionbar", color="red"})

--show a title in the HUD with minecraft color "gold" staying for 3 seconds (override stay setting)
mcl_title.set(player, "title", {text="dummy text", color="gold", stay=60})

mcl_title.remove(player, type)

Hide HUD element of type type for player player.

mcl_title.clear(player)

Remove every title/subtitle/actionbar from a player. Basicaly run mcl_title.remove(player, type) for every type.

mcl_title.params_set(player, params)

Allow mods to set stay and upcoming fadeIn/fadeOut params.

mcl_title.params_set(player, {stay = 600}) --elements with no 'data.stay' field will stay during 30s (600/20)

mcl_title.params_get(player)

Get stay and upcoming fadeIn and fadeOut params of a player as a table.

mcl_title.params_get(player)