5 --[[ table containing the groups (experimental) ]]
6 playereffects
.groups
= {}
8 --[[ table containing all the HUD info tables, indexed by player names.
9 A single HUD info table is formatted like this: { text_id = 1, icon_id=2, pos = 0 }
10 Where: text_id: HUD ID of the textual effect description
11 icon_id: HUD ID of the effect icon (optional)
12 pos: Y offset factor (starts with 0)
13 Example of full table:
14 { ["player1"] = {{ text_id = 1, icon_id=4, pos = 0 }}, ["player2] = { { text_id = 5, icon_id=6, pos = 0 }, { text_id = 7, icon_id=8, pos = 1 } } }
16 playereffects
.hudinfos
= {}
18 --[[ table containing all the effect types ]]
19 playereffects
.effect_types
= {}
21 --[[ table containing all the active effects ]]
22 playereffects
.effects
= {}
24 --[[ table containing all the inactive effects.
25 Effects become inactive if a player leaves an become active again if they join again. ]]
26 playereffects
.inactive_effects
= {}
28 -- Variable for counting the effect_id
29 playereffects
.last_effect_id
= 0
31 --[=[ Include settings ]=]
32 dofile(minetest
.get_modpath("playereffects").."/settings.lua")
35 if(playereffects
.use_hud
== nil) then
36 playereffects
.use_hud
= true
38 if(playereffects
.use_autosave
== nil) then
39 playereffects
.use_autosave
= true
41 if(playereffects
.autosave_time
== nil) then
42 playereffects
.autosave_time
= 10
44 if(playereffects
.use_examples
== nil) then
45 playereffects
.use_examples
= false
48 --[=[ Load inactive_effects and last_effect_id from playereffects.mt, if this file exists ]=]
50 local filepath
= minetest
.get_worldpath().."/playereffects.mt"
51 local file
= io
.open(filepath
, "r")
53 minetest
.log("action", "[playereffects] playereffects.mt opened.")
54 local string = file
:read()
56 if(string ~= nil) then
57 local savetable
= minetest
.deserialize(string)
58 playereffects
.inactive_effects
= savetable
.inactive_effects
59 minetest
.debug("[playereffects] playereffects.mt successfully read.")
60 minetest
.debug("[playereffects] inactive_effects = "..dump(playereffects
.inactive_effects
))
61 playereffects
.last_effect_id
= savetable
.last_effect_id
62 minetest
.debug("[playereffects] last_effect_id = "..dump(playereffects
.last_effect_id
))
68 function playereffects
.next_effect_id()
69 playereffects
.last_effect_id
= playereffects
.last_effect_id
+ 1
70 return playereffects
.last_effect_id
73 --[=[ API functions ]=]
74 function playereffects
.register_effect_type(effect_type_id
, description
, icon
, groups
, apply
, cancel
, hidden
, cancel_on_death
, repeat_interval
)
75 local effect_type
= {}
76 effect_type
.description
= description
77 effect_type
.apply
= apply
78 effect_type
.groups
= groups
79 effect_type
.icon
= icon
81 effect_type
.cancel
= cancel
83 effect_type
.cancel
= function() end
86 effect_type
.hidden
= hidden
88 effect_type
.hidden
= false
90 if cancel_on_death
~= nil then
91 effect_type
.cancel_on_death
= cancel_on_death
93 effect_type
.cancel_on_death
= true
95 effect_type
.repeat_interval
= repeat_interval
97 playereffects
.effect_types
[effect_type_id
] = effect_type
98 minetest
.log("action", "[playereffects] Effect type "..effect_type_id
.." registered!")
101 function playereffects
.apply_effect_type(effect_type_id
, duration
, player
, repeat_interval_time_left
)
102 local start_time
= os
.time()
103 local is_player
= false
104 if(type(player
)=="userdata") then
105 if(player
.is_player
~= nil) then
106 if(player
:is_player() == true) then
111 if(is_player
== false) then
112 minetest
.log("error", "[playereffects] Attempted to apply effect type "..effect_type_id
.." to a non-player!")
116 local playername
= player
:get_player_name()
117 local groups
= playereffects
.effect_types
[effect_type_id
].groups
118 for k
,v
in pairs(groups
) do
119 playereffects
.cancel_effect_group(v
, playername
)
123 if(playereffects
.effect_types
[effect_type_id
].repeat_interval
== nil) then
124 local status
= playereffects
.effect_types
[effect_type_id
].apply(player
)
125 if(status
== false) then
126 minetest
.log("action", "[playereffects] Attempt to apply effect type "..effect_type_id
.." to player "..playername
.." failed!")
134 local effect_id
= playereffects
.next_effect_id()
135 local smallest_hudpos
136 local biggest_hudpos
= -1
138 if(playereffects
.hudinfos
[playername
] == nil) then
139 playereffects
.hudinfos
[playername
] = {}
141 local hudinfos
= playereffects
.hudinfos
[playername
]
142 for effect_id
, hudinfo
in pairs(hudinfos
) do
143 local hudpos
= hudinfo
.pos
144 if(hudpos
> biggest_hudpos
) then
145 biggest_hudpos
= hudpos
147 if(smallest_hudpos
== nil) then
148 smallest_hudpos
= hudpos
149 elseif(hudpos
< smallest_hudpos
) then
150 smallest_hudpos
= hudpos
153 if(smallest_hudpos
== nil) then
155 elseif(smallest_hudpos
>= 0) then
156 free_hudpos
= smallest_hudpos
- 1
158 free_hudpos
= biggest_hudpos
+ 1
161 local repeat_interval
= playereffects
.effect_types
[effect_type_id
].repeat_interval
162 if(repeat_interval
~= nil) then
163 if(repeat_interval_time_left
== nil) then
164 repeat_interval_time_left
= repeat_interval
168 --[[ show no more than 20 effects on the screen, so that hud_update does not need to be called so often ]]
169 local text_id
, icon_id
170 if(free_hudpos
<= 20) then
171 text_id
, icon_id
= playereffects
.hud_effect(effect_type_id
, player
, free_hudpos
, duration
, repeat_interval_time_left
)
177 playereffects
.hudinfos
[playername
][effect_id
] = hudinfo
179 text_id
, icon_id
= nil, nil
183 playername
= playername
,
184 effect_id
= effect_id
,
185 effect_type_id
= effect_type_id
,
186 start_time
= start_time
,
187 repeat_interval_start_time
= start_time
,
188 time_left
= duration
,
189 repeat_interval_time_left
= repeat_interval_time_left
,
193 playereffects
.effects
[effect_id
] = effect
195 -- minetest.log("action", "[playereffects] Effect type "..effect_type_id.." applied to player "..playername.." (effect_id = "..effect_id..").")
196 if(repeat_interval
~= nil) then
197 minetest
.after(repeat_interval_time_left
, playereffects
.repeater
, effect_id
, duration
, player
, playereffects
.effect_types
[effect_type_id
].apply
)
199 minetest
.after(duration
, function(effect_id
) playereffects
.cancel_effect(effect_id
) end, effect_id
)
205 function playereffects
.repeater(effect_id
, repetitions
, player
, apply
)
206 local effect
= playereffects
.effects
[effect_id
]
207 if(effect
~= nil) then
208 local repetitions
= effect
.time_left
210 repetitions
= repetitions
- 1
211 effect
.time_left
= repetitions
212 if(repetitions
<= 0) then
213 playereffects
.cancel_effect(effect_id
)
215 local repeat_interval
= playereffects
.effect_types
[effect
.effect_type_id
].repeat_interval
216 effect
.repeat_interval_time_left
= repeat_interval
217 effect
.repeat_interval_start_time
= os
.time()
220 playereffects
.repeater
,
230 function playereffects
.cancel_effect_type(effect_type_id
, cancel_all
, playername
)
231 local effects
= playereffects
.get_player_effects(playername
)
232 if(cancel_all
==nil) then all
= false end
234 if(effects
[e
].effect_type_id
== effect_type_id
) then
235 playereffects
.cancel_effect(effects
[e
].effect_id
)
236 if(cancel_all
==false) then
243 function playereffects
.cancel_effect_group(groupname
, playername
)
244 local effects
= playereffects
.get_player_effects(playername
)
246 local effect
= effects
[e
]
247 local thesegroups
= playereffects
.effect_types
[effect
.effect_type_id
].groups
249 for g
=1,#thesegroups
do
250 if(thesegroups
[g
] == groupname
) then
251 playereffects
.cancel_effect(effect
.effect_id
)
258 function playereffects
.get_remaining_effect_time(effect_id
)
259 local now
= os
.time()
260 local effect
= playereffects
.effects
[effect_id
]
261 if(effect
~= nil) then
262 return (effect
.time_left
- os
.difftime(now
, effect
.start_time
))
268 function playereffects
.cancel_effect(effect_id
)
269 local effect
= playereffects
.effects
[effect_id
]
270 if(effect
~= nil) then
271 local player
= minetest
.get_player_by_name(effect
.playername
)
272 local hudinfo
= playereffects
.hudinfos
[effect
.playername
][effect_id
]
273 if(hudinfo
~= nil) then
274 if(hudinfo
.text_id
~=nil) then
275 player
:hud_remove(hudinfo
.text_id
)
277 if(hudinfo
.icon_id
~=nil) then
278 player
:hud_remove(hudinfo
.icon_id
)
280 playereffects
.hudinfos
[effect
.playername
][effect_id
] = nil
282 playereffects
.effect_types
[effect
.effect_type_id
].cancel(effect
, player
)
283 playereffects
.effects
[effect_id
] = nil
284 -- minetest.log("action", "[playereffects] Effect type "..effect.effect_type_id.." cancelled from player "..effect.playername.."!")
288 function playereffects
.get_player_effects(playername
)
289 if(minetest
.get_player_by_name(playername
) ~= nil) then
291 for k
,v
in pairs(playereffects
.effects
) do
292 if(v
.playername
== playername
) then
293 table.insert(effects
, v
)
302 --[=[ Saving all data to file ]=]
303 function playereffects
.save_to_file()
304 local save_time
= os
.time()
306 local inactive_effects
= {}
307 for id
,effecttable
in pairs(playereffects
.inactive_effects
) do
308 local playername
= id
309 if(inactive_effects
[playername
] == nil) then
310 inactive_effects
[playername
] = {}
312 for i
=1,#effecttable
do
313 table.insert(inactive_effects
[playername
], effecttable
[i
])
316 for id
,effect
in pairs(playereffects
.effects
) do
317 local new_duration
, new_repeat_duration
318 if(playereffects
.effect_types
[effect
.effect_type_id
].repeat_interval
~= nil) then
319 new_duration
= effect
.time_left
320 new_repeat_duration
= effect
.repeat_interval_time_left
- os
.difftime(save_time
, effect
.repeat_interval_start_time
)
322 new_duration
= effect
.time_left
- os
.difftime(save_time
, effect
.start_time
)
325 effect_id
= effect
.effect_id
,
326 effect_type_id
= effect
.effect_type_id
,
327 time_left
= new_duration
,
328 repeat_interval_time_left
= new_repeat_duration
,
329 start_time
= effect
.start_time
,
330 repeat_interval_start_time
= effect
.repeat_interval_start_time
,
331 playername
= effect
.playername
,
332 metadata
= effect
.metadata
334 if(inactive_effects
[effect
.playername
] == nil) then
335 inactive_effects
[effect
.playername
] = {}
337 table.insert(inactive_effects
[effect
.playername
], new_effect
)
340 savetable
.inactive_effects
= inactive_effects
341 savetable
.last_effect_id
= playereffects
.last_effect_id
343 local savestring
= minetest
.serialize(savetable
)
345 local filepath
= minetest
.get_worldpath().."/playereffects.mt"
346 local file
= io
.open(filepath
, "w")
348 file
:write(savestring
)
350 minetest
.log("action", "[playereffects] Wrote playereffects data into "..filepath
..".")
352 minetest
.log("error", "[playereffects] Failed to write playereffects data into "..filepath
..".")
357 --[[ Cancel all effects on player death ]]
358 minetest
.register_on_dieplayer(function(player
)
359 local effects
= playereffects
.get_player_effects(player
:get_player_name())
361 if(playereffects
.effect_types
[effects
[e
].effect_type_id
].cancel_on_death
== true) then
362 playereffects
.cancel_effect(effects
[e
].effect_id
)
368 minetest
.register_on_leaveplayer(function(player
)
369 local leave_time
= os
.time()
370 local playername
= player
:get_player_name()
371 local effects
= playereffects
.get_player_effects(playername
)
373 playereffects
.hud_clear(player
)
375 if(playereffects
.inactive_effects
[playername
] == nil) then
376 playereffects
.inactive_effects
[playername
] = {}
379 local new_duration
= effects
[e
].time_left
- os
.difftime(leave_time
, effects
[e
].start_time
)
380 local new_effect
= effects
[e
]
381 new_effect
.time_left
= new_duration
382 table.insert(playereffects
.inactive_effects
[playername
], new_effect
)
383 playereffects
.cancel_effect(effects
[e
].effect_id
)
387 minetest
.register_on_shutdown(function()
388 minetest
.log("action", "[playereffects] Server shuts down. Rescuing data into playereffects.mt")
389 playereffects
.save_to_file()
392 minetest
.register_on_joinplayer(function(player
)
393 local playername
= player
:get_player_name()
395 -- load all the effects again (if any)
396 if(playereffects
.inactive_effects
[playername
] ~= nil) then
397 for i
=1,#playereffects
.inactive_effects
[playername
] do
398 local effect
= playereffects
.inactive_effects
[playername
][i
]
399 playereffects
.apply_effect_type(effect
.effect_type_id
, effect
.time_left
, player
, effect
.repeat_interval_time_left
)
401 playereffects
.inactive_effects
[playername
] = nil
405 playereffects
.globalstep_timer
= 0
406 playereffects
.autosave_timer
= 0
407 minetest
.register_globalstep(function(dtime
)
408 playereffects
.globalstep_timer
= playereffects
.globalstep_timer
+ dtime
409 playereffects
.autosave_timer
= playereffects
.autosave_timer
+ dtime
410 -- Update HUDs of all players
411 if(playereffects
.globalstep_timer
>= 1) then
412 playereffects
.globalstep_timer
= 0
414 local players
= minetest
.get_connected_players()
416 playereffects
.hud_update(players
[p
])
419 -- Autosave into file
420 if(playereffects
.use_autosave
== true and playereffects
.autosave_timer
>= playereffects
.autosave_time
) then
421 playereffects
.autosave_timer
= 0
422 minetest
.log("action", "[playereffects] Autosaving mod data to playereffects.mt ...")
423 playereffects
.save_to_file()
431 function playereffects
.hud_update(player
)
432 if(playereffects
.use_hud
== true) then
433 local now
= os
.time()
434 local playername
= player
:get_player_name()
435 local hudinfos
= playereffects
.hudinfos
[playername
]
436 if(hudinfos
~= nil) then
437 for effect_id
, hudinfo
in pairs(hudinfos
) do
438 local effect
= playereffects
.effects
[effect_id
]
439 if(effect
~= nil and hudinfo
.text_id
~= nil) then
440 local description
= playereffects
.effect_types
[effect
.effect_type_id
].description
441 local repeat_interval
= playereffects
.effect_types
[effect
.effect_type_id
].repeat_interval
442 if(repeat_interval
~= nil) then
443 local repeat_interval_time_left
= os
.difftime(effect
.repeat_interval_start_time
+ effect
.repeat_interval_time_left
, now
)
444 player
:hud_change(hudinfo
.text_id
, "text", description
.. " ("..tostring(effect
.time_left
).."/"..tostring(repeat_interval_time_left
) .. "s )")
446 local time_left
= os
.difftime(effect
.start_time
+ effect
.time_left
, now
)
447 player
:hud_change(hudinfo
.text_id
, "text", description
.. " ("..tostring(time_left
).." s)")
455 function playereffects
.hud_clear(player
)
456 if(playereffects
.use_hud
== true) then
457 local playername
= player
:get_player_name()
458 local hudinfos
= playereffects
.hudinfos
[playername
]
459 if(hudinfos
~= nil) then
460 for effect_id
, hudinfo
in pairs(hudinfos
) do
461 local effect
= playereffects
.effects
[effect_id
]
462 if(hudinfo
.text_id
~= nil) then
463 player
:hud_remove(hudinfo
.text_id
)
465 if(hudinfo
.icon_id
~= nil) then
466 player
:hud_remove(hudinfo
.icon_id
)
468 playereffects
.hudinfos
[playername
][effect_id
] = nil
474 function playereffects
.hud_effect(effect_type_id
, player
, pos
, time_left
, repeat_interval_time_left
)
475 local text_id
, icon_id
476 local effect_type
= playereffects
.effect_types
[effect_type_id
]
477 if(playereffects
.use_hud
== true and effect_type
.hidden
== false) then
479 if(playereffects
.effect_types
[effect_type_id
].cancel_on_death
== true) then
484 local description
= playereffects
.effect_types
[effect_type_id
].description
485 if(repeat_interval_time_left
~= nil) then
486 text
= description
.. " ("..tostring(time_left
).."/"..tostring(repeat_interval_time_left
) .. "s )"
488 text
= description
.. " ("..tostring(time_left
).." s)"
490 text_id
= player
:hud_add({
491 hud_elem_type
= "text",
492 position
= { x
= 1, y
= 0.3 },
493 name
= "effect_"..effect_type_id
,
495 scale
= { x
= 170, y
= 20},
496 alignment
= { x
= -1, y
= 0 },
499 offset
= { x
= -5, y
= pos
*20 }
501 if(playereffects
.effect_types
[effect_type_id
].icon
~= nil) then
502 icon_id
= player
:hud_add({
503 hud_elem_type
= "image",
504 scale
= { x
= 1, y
= 1 },
505 position
= { x
= 1, y
= 0.3 },
506 name
= "effect_icon_"..effect_type_id
,
507 text
= playereffects
.effect_types
[effect_type_id
].icon
,
508 alignment
= { x
= -1, y
=0 },
510 offset
= { x
= -186, y
= pos
*20 },
517 return text_id
, icon_id
522 if(playereffects
.use_examples
== true) then
523 dofile(minetest
.get_modpath(minetest
.get_current_modname()).."/examples.lua")