color_lib 🔗
Shared color token parsing and rendering for mods, including Minecraft Bukkit color coding.
Primary supported tokens:
&0..&9,&a..&f,&r(Bukkit/Minecraft legacy)- section-sign form:
\u00A70..\u00A79,\u00A7a..\u00A7f,\u00A7r
Also available (advanced): HEX token rendering (&#RRGGBB, &#RRGGBB;, <&#RRGGBB>, <&#RRGGBB;>).
Main APIs 🔗
color_lib.render_bukkit_text(raw, opts)color_lib.render_minecraft_hex_text(raw, opts)
Returns: rendered, stored, err, visible
Bukkit Example 🔗
local C = rawget(_G, "color_lib")
local raw = "&dHello &fworld"
local rendered, _, err = C.render_bukkit_text(raw, {
trim = false,
allow_newlines = false,
append_white = true,
})
if err then
minetest.chat_send_player(name, minetest.colorize("#ff7777", err))
return
end
minetest.chat_send_player(name, rendered)
HEX Example 🔗
local C = rawget(_G, "color_lib")
local raw = "DF9FF[Server] &#FFFFFFWelcome!"
local rendered, _, err = C.render_minecraft_hex_text(raw, {
trim = false,
allow_newlines = false,
append_white = true,
})
if err then
minetest.chat_send_player(name, minetest.colorize("#ff7777", err))
return
end
minetest.chat_send_player(name, rendered)
