55 lines
1.9 KiB
Plaintext
55 lines
1.9 KiB
Plaintext
HUD API
|
|
=======
|
|
|
|
hud.register(name, def)
|
|
-- name: statbar name (health, air, hunger, armor already used by default)
|
|
-- def: <HUD item definition> (see below)
|
|
|
|
hud.change_item(player, name, def)
|
|
-- player: player object
|
|
-- name: statbar name
|
|
-- def: table containing new values
|
|
-- currently supported: number, text and offset
|
|
|
|
hud.swap_statbar(player, name1, name2) -- swaps position and offset of statbar with name1 with statbar with name2
|
|
-- player: player object
|
|
-- name1: statbar name
|
|
-- name2: statbar name
|
|
|
|
hud.remove_item(player, name)
|
|
|
|
HUD item definition
|
|
{
|
|
hud_elem_type = "statbar", -- currently only supported type (same as in lua-api.txt)
|
|
position = {x=<x>, y=<y>}, -- position of statbar (same as in lua-api.txt)
|
|
size = {x=24, y=24}, -- statbar texture size (default 24x24), needed to be scaled correctly
|
|
text = "hud_heart_fg.png", -- texture name (same as in lua-api.txt)
|
|
number = 20, -- number/2 = number of full textures(e.g. hearts)
|
|
max = 20, -- used to prevent "overflow" of statbars
|
|
alignment = {x=-1,y=-1}, -- alignment on screen (same as in lua-api.txt)
|
|
offset = HUD_HEALTH_OFFSET,
|
|
background = "hud_heart_bg.png", -- statbar background texture name
|
|
autohide_bg = false, -- hide statbar background textures when number = 0
|
|
events = { -- called on events "damage" and "breath_changed" of players
|
|
{
|
|
type = "damage",
|
|
func = function(player)
|
|
-- do something here
|
|
end
|
|
}
|
|
},
|
|
}
|
|
|
|
|
|
HUNGER API
|
|
==========
|
|
|
|
-- Register food with given values to change eating actions
|
|
hunger.register_food(name, saturation, replace_with_item, poisen, heal, sound)
|
|
-- name: item name, e.g. "default:apple"
|
|
-- saturation: amount of added saturation
|
|
-- replace_with_item: item name that get returned after eating (can be nil)
|
|
-- poisen: duration in seconds (1hp damage per second, player can't die) (can be nil)
|
|
-- heal: added HP when eating this food (can be nil)
|
|
-- sound: costum eating sound (replaces default eating sound) (can be nil)
|