awards/api.lua

470 lines
12 KiB
Lua
Raw Permalink Normal View History

2014-09-26 21:36:40 +02:00
-- AWARDS
2015-06-10 19:48:20 +02:00
--
-- Copyright (C) 2013-2015 rubenwardy
-- This program is free software; you can redistribute it and/or modify
-- it under the terms of the GNU Lesser General Public License as published by
-- the Free Software Foundation; either version 2.1 of the License, or
-- (at your option) any later version.
-- This program is distributed in the hope that it will be useful,
-- but WITHOUT ANY WARRANTY; without even the implied warranty of
-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-- GNU Lesser General Public License for more details.
-- You should have received a copy of the GNU Lesser General Public License along
-- with this program; if not, write to the Free Software Foundation, Inc.,
-- 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
--
2013-02-27 13:39:17 +01:00
2013-11-06 20:36:49 +01:00
-- The global award namespace
2014-09-26 20:30:34 +02:00
awards = {
show_mode = "hud"
}
2015-06-11 18:11:15 +02:00
dofile(minetest.get_modpath("awards").."/api_helpers.lua")
2013-11-06 20:36:49 +01:00
2013-02-22 21:43:40 +01:00
-- Table Save Load Functions
2013-11-06 20:36:49 +01:00
function awards.save()
2013-02-22 21:43:40 +01:00
local file = io.open(minetest.get_worldpath().."/awards.txt", "w")
if file then
2013-11-06 19:38:55 +01:00
file:write(minetest.serialize(awards.players))
2013-02-22 21:43:40 +01:00
file:close()
end
end
2015-06-11 18:35:32 +02:00
local S = function(s) return s end
function awards.set_intllib(locale)
S = locale
end
function awards.init()
awards.players = awards.load()
awards.def = {}
2015-06-10 19:39:22 +02:00
awards.trigger_types = {}
awards.on = {}
2015-06-10 20:15:16 +02:00
awards.on_unlock = {}
end
2013-11-06 20:36:49 +01:00
function awards.load()
2013-02-22 21:43:40 +01:00
local file = io.open(minetest.get_worldpath().."/awards.txt", "r")
if file then
local table = minetest.deserialize(file:read("*all"))
if type(table) == "table" then
return table
end
end
return {}
end
2015-06-10 19:39:22 +02:00
function awards.register_trigger(name, func)
awards.trigger_types[name] = func
awards.on[name] = {}
awards['register_on_'..name] = function(func)
table.insert(awards.on[name], func)
end
end
2013-02-22 21:43:40 +01:00
2016-07-29 18:14:57 +02:00
function awards.run_trigger_callbacks(player, data, trigger, table_func)
for i = 1, #awards.on[trigger] do
local res = nil
local entry = awards.on[trigger][i]
if type(entry) == "function" then
res = entry(player, data)
elseif type(entry) == "table" and entry.award then
res = table_func(entry)
end
if res then
awards.unlock(player:get_player_name(), res)
end
end
end
function awards.increment_item_counter(data, field, itemname, count)
local name_split = string.split(itemname, ":")
if #name_split ~= 2 then
return false
end
local mod = name_split[1]
local item = name_split[2]
if data and field and mod and item then
awards.assertPlayer(data)
awards.tbv(data, field)
awards.tbv(data[field], mod)
awards.tbv(data[field][mod], item, 0)
data[field][mod][item] = data[field][mod][item] + (count or 1)
return true
else
return false
end
end
2016-08-01 21:27:12 +02:00
function awards.get_item_count(data, field, itemname)
local name_split = string.split(itemname, ":")
if #name_split ~= 2 then
return false
end
local mod = name_split[1]
local item = name_split[2]
if data and field and mod and item then
awards.assertPlayer(data)
awards.tbv(data, field)
awards.tbv(data[field], mod)
awards.tbv(data[field][mod], item, 0)
return data[field][mod][item]
end
end
2015-06-10 20:15:16 +02:00
function awards.register_on_unlock(func)
table.insert(awards.on_unlock, func)
end
2013-02-22 21:43:40 +01:00
-- API Functions
2015-06-10 19:39:22 +02:00
function awards._additional_triggers(name, def)
-- Depreciated!
end
2015-06-10 19:39:22 +02:00
function awards.register_achievement(name, def)
2015-06-10 20:15:16 +02:00
def.name = name
2015-06-10 19:39:22 +02:00
-- Add Triggers
if def.trigger and def.trigger.type then
local func = awards.trigger_types[def.trigger.type]
if func then
2015-06-10 20:15:16 +02:00
func(def)
else
2015-06-10 19:39:22 +02:00
awards._additional_triggers(name, def)
2013-02-23 13:02:02 +01:00
end
end
2013-02-23 13:02:02 +01:00
2015-06-11 18:35:32 +02:00
-- Add Award
2015-06-10 19:39:22 +02:00
awards.def[name] = def
end
2015-06-11 18:51:36 +02:00
function awards.enable(name)
local data = awards.player(name)
if data then
data.disabled = nil
end
end
function awards.disable(name)
local data = awards.player(name)
if data then
data.disabled = true
end
end
function awards.clear_player(name)
awards.players[name] = nil
end
2013-02-27 13:34:38 +01:00
-- This function is called whenever a target condition is met.
-- It checks if a player already has that achievement, and if they do not,
-- it gives it to them
----------------------------------------------
2015-06-11 18:51:36 +02:00
--awards.unlock(name, award)
2013-02-27 13:34:38 +01:00
-- name - the name of the player
-- award - the name of the award to give
2015-06-11 18:35:32 +02:00
function awards.unlock(name, award)
2013-11-06 19:33:01 +01:00
-- Access Player Data
2015-06-10 20:15:16 +02:00
local data = awards.players[name]
local awdef = awards.def[award]
2013-11-06 19:33:01 +01:00
-- Perform checks
if not data then
return
end
2015-06-10 20:15:16 +02:00
if not awdef then
2015-06-11 18:35:32 +02:00
return
2013-11-06 19:33:01 +01:00
end
2015-06-11 18:51:36 +02:00
if data.disabled then
return
end
2013-11-06 19:33:01 +01:00
awards.tbv(data,"unlocked")
2015-06-10 20:15:16 +02:00
-- Don't give the achievement if it has already been given
if data.unlocked[award] and data.unlocked[award] == award then
return
end
2014-09-26 21:55:44 +02:00
2015-06-11 18:35:32 +02:00
-- Unlock Award
minetest.log("action", name.." has unlocked award "..name)
2015-06-10 20:15:16 +02:00
data.unlocked[award] = award
2015-06-11 18:35:32 +02:00
awards.save()
2013-02-22 21:43:40 +01:00
2015-06-10 20:15:16 +02:00
-- Give Prizes
if awdef and awdef.prizes then
for i = 1, #awdef.prizes do
local itemstack = ItemStack(awdef.prizes[i])
2016-07-29 18:30:59 +02:00
if not itemstack:is_empty() then
local receiverref = minetest.get_player_by_name(name)
if receiverref then
receiverref:get_inventory():add_item("main", itemstack)
end
end
2013-02-22 21:43:40 +01:00
end
2015-06-10 20:15:16 +02:00
end
-- Run callbacks
if awdef.on_unlock and awdef.on_unlock(name, awdef) then
return
end
for _, callback in pairs(awards.on_unlock) do
if callback(name, awdef) then
return
end
end
2015-06-11 18:35:32 +02:00
-- Get Notification Settings
local title = awdef.title or award
local desc = awdef.description or ""
local background = awdef.background or "awards_bg_default.png"
local icon = awdef.icon or "awards_unknown.png"
local custom_announce = awdef.custom_announce
if not custom_announce then
if awdef.secret then
custom_announce = S("Secret Achievement Unlocked:")
else
custom_announce = S("Achievement Unlocked:")
end
end
2015-06-11 18:35:32 +02:00
-- Do Notification
2015-06-10 20:15:16 +02:00
if awards.show_mode == "formspec" then
-- use a formspec to send it
minetest.show_formspec(name, "achievements:unlocked", "size[4,2]"..
"image_button_exit[0,0;4,2;"..background..";close1; ]"..
"image_button_exit[0.2,0.8;1,1;"..icon..";close2; ]"..
"label[1.1,1;"..title.."]"..
"label[0.3,0.1;"..custom_announce.."]")
elseif awards.show_mode == "chat" then
local chat_announce
if awdef.secret == true then
chat_announce = S("Secret Achievement Unlocked: %s")
else
chat_announce = S("Achievement Unlocked: %s")
end
2015-06-10 20:15:16 +02:00
-- use the chat console to send it
minetest.chat_send_player(name, string.format(chat_announce, title))
2015-06-10 20:15:16 +02:00
if desc~="" then
minetest.chat_send_player(name, desc)
end
else
local player = minetest.get_player_by_name(name)
local one = player:hud_add({
hud_elem_type = "image",
name = "award_bg",
scale = {x = 1, y = 1},
text = background,
position = {x = 0.5, y = 0},
offset = {x = 0, y = 138},
alignment = {x = 0, y = -1}
})
local hud_announce
if awdef.secret == true then
hud_announce = S("Secret Achievement Unlocked!")
else
hud_announce = S("Achievement Unlocked!")
end
2015-06-10 20:15:16 +02:00
local two = player:hud_add({
hud_elem_type = "text",
name = "award_au",
number = 0xFFFFFF,
scale = {x = 100, y = 20},
text = hud_announce,
2015-06-10 20:15:16 +02:00
position = {x = 0.5, y = 0},
offset = {x = 0, y = 40},
alignment = {x = 0, y = -1}
})
local three = player:hud_add({
hud_elem_type = "text",
name = "award_title",
number = 0xFFFFFF,
scale = {x = 100, y = 20},
text = title,
position = {x = 0.5, y = 0},
offset = {x = 30, y = 100},
alignment = {x = 0, y = -1}
})
local four = player:hud_add({
hud_elem_type = "image",
name = "award_icon",
scale = {x = 4, y = 4},
text = icon,
position = {x = 0.5, y = 0},
offset = {x = -81.5, y = 126},
alignment = {x = 0, y = -1}
})
minetest.after(3, function()
player:hud_remove(one)
player:hud_remove(two)
player:hud_remove(three)
player:hud_remove(four)
end)
2013-02-22 21:43:40 +01:00
end
end
2015-06-11 18:35:32 +02:00
-- Backwards compatibility
awards.give_achievement = awards.unlock
2014-05-02 19:35:11 +02:00
--[[minetest.register_chatcommand("gawd", {
2014-05-02 19:19:42 +02:00
params = "award name",
description = "gawd: give award to self",
func = function(name, param)
2015-06-11 18:35:32 +02:00
awards.unlock(name,param)
2014-05-02 19:19:42 +02:00
end
2014-05-02 19:35:11 +02:00
})]]--
2014-05-02 19:19:42 +02:00
2016-07-29 17:23:34 +02:00
function awards.getFormspec(name, to, sid)
2016-08-01 23:39:32 +02:00
local formspec = ""
2016-07-29 17:23:34 +02:00
local listofawards = awards._order_awards(name)
2016-08-01 21:27:12 +02:00
local playerdata = awards.players[name]
2016-07-29 17:23:34 +02:00
-- Sidebar
if sid then
local item = listofawards[sid+0]
local def = awards.def[item.name]
if def and def.secret and not item.got then
formspec = formspec .. "label[1,2.75;(Secret Award)]"..
"image[1,0;3,3;awards_unknown.png]"
2016-07-29 17:23:34 +02:00
if def and def.description then
formspec = formspec .. "label[0,3.25;Unlock this award to find out what it is.]"
2016-07-29 17:23:34 +02:00
end
else
local title = item.name
if def and def.title then
title = def.title
end
local status = ""
if item.got then
status = " (got)"
end
formspec = formspec .. "label[1,2.75;" .. title .. status .. "]"
if def and def.icon then
formspec = formspec .. "image[1,0;3,3;" .. def.icon .. "]"
end
2016-08-01 21:27:12 +02:00
local barwidth = 4.6
local perc = nil
local label = nil
if def.getProgress and playerdata then
local res = def:getProgress(playerdata)
perc = res.perc
label = res.label
end
if perc then
if perc > 1 then
perc = 1
end
2016-08-01 23:39:32 +02:00
formspec = formspec .. "background[0,4.80;" .. barwidth ..",0.25;awards_progress_gray.png;false]"
formspec = formspec .. "background[0,4.80;" .. (barwidth * perc) ..",0.25;awards_progress_green.png;false]"
2016-08-01 21:27:12 +02:00
if label then
formspec = formspec .. "label[1.75,4.63;" .. label .. "]"
end
end
2016-07-29 17:23:34 +02:00
if def and def.description then
formspec = formspec .. "label[0,3.25;"..def.description.."]"
end
end
end
-- Create list box
formspec = formspec .. "textlist[4.75,0;6,5;awards;"
local first = true
for _,award in pairs(listofawards) do
local def = awards.def[award.name]
if def then
if not first then
formspec = formspec .. ","
end
first = false
if def.secret and not award.got then
formspec = formspec .. "#707070(Secret Award)"
2016-07-29 17:23:34 +02:00
else
local title = award.name
if def and def.title then
title = def.title
end
if award.got then
formspec = formspec .. minetest.formspec_escape(title)
else
formspec = formspec .. "#ACACAC".. minetest.formspec_escape(title)
end
end
end
end
return formspec .. ";"..sid.."]"
end
2015-06-11 18:51:36 +02:00
function awards.show_to(name, to, sid, text)
2014-05-02 21:09:54 +02:00
if name == "" or name == nil then
name = to
end
2015-06-11 18:51:36 +02:00
if name == to and awards.player(to).disabled then
minetest.chat_send_player("You've disabled awards. Type /awards" ..
" enable to reenable")
return
end
2014-05-02 19:19:42 +02:00
if text then
2013-11-07 09:58:40 +01:00
if not awards.players[name] or not awards.players[name].unlocked then
2014-05-02 21:09:54 +02:00
minetest.chat_send_player(to, "You have not unlocked any awards")
2013-11-07 09:58:40 +01:00
return
2013-11-06 19:33:01 +01:00
end
2014-05-02 19:35:11 +02:00
minetest.chat_send_player(to, name.."'s awards:")
2013-02-22 21:43:40 +01:00
2013-11-06 19:38:55 +01:00
for _, str in pairs(awards.players[name].unlocked) do
2014-05-02 21:09:54 +02:00
local def = awards.def[str]
if def then
if def.title then
if def.description then
minetest.chat_send_player(to, def.title..": "..def.description)
else
minetest.chat_send_player(to, def.title)
end
2014-05-02 21:09:54 +02:00
else
minetest.chat_send_player(to, str)
2014-05-02 21:09:54 +02:00
end
end
2013-02-22 21:43:40 +01:00
end
2014-05-02 19:19:42 +02:00
else
if sid == nil or sid < 1 then
sid = 1
end
2014-05-02 19:35:11 +02:00
-- Show formspec to user
2016-08-01 23:39:32 +02:00
minetest.show_formspec(to,"awards:awards",
"size[11,5]" .. awards.getFormspec(name, to, sid))
2014-05-02 19:19:42 +02:00
end
end
2015-06-11 18:51:36 +02:00
awards.showto = awards.show_to
2014-05-02 19:19:42 +02:00
minetest.register_on_player_receive_fields(function(player, formname, fields)
2015-06-11 18:51:36 +02:00
if formname ~= "awards:awards" then
2014-05-02 19:19:42 +02:00
return false
end
if fields.quit then
return true
end
local name = player:get_player_name()
if fields.awards then
local event = minetest.explode_textlist_event(fields.awards)
if event.type == "CHG" then
2015-06-11 18:51:36 +02:00
awards.show_to(name, name, event.index, false)
end
2014-05-02 19:19:42 +02:00
end
2014-05-02 19:19:42 +02:00
return true
end)
2015-06-10 19:39:22 +02:00
2015-06-10 20:18:56 +02:00
awards.init()
2016-07-29 18:14:57 +02:00
minetest.register_on_newplayer(function(player)
local playern = player:get_player_name()
awards.assertPlayer(playern)
end)
minetest.register_on_shutdown(function()
awards.save()
end)