Aaron Suen 5a0220f2ee Return hints to shuffle instead of sort
- The sorting actually only worked in English, and
  not in any translated languages.
- The ordering would bias players towards focusing
  on alphabetically-first hints, which are not
  necessarily the best to try.  Shuffling instead
  should suggest alternative options each time the
  tab is brought up.
- The ordering-bias effect is probably worse for
  non-English where it's less obvious that there's
  a mundane and non-meaningful reason why they
  are in a particular order.

In theory we're losing the ability to quickly check
for a hint with known text is in one of the lists on
the tab for English speakers but this is not really
a core intended use-case for hints.
2021-06-23 00:49:37 -04:00

61 lines
1.7 KiB
Lua

-- LUALOCALS < ---------------------------------------------------------
local math, minetest, nodecore, pairs, table
= math, minetest, nodecore, pairs, table
local math_floor, math_random, table_insert
= math.floor, math.random, table.insert
-- LUALOCALS > ---------------------------------------------------------
local pcache = {}
local strings = {
progress = "Progress: @1 complete, @2 current, @3 future",
explore = "Not all game content is covered by hints. Explore!",
hint = "- @1",
done = "- DONE: @1"
}
for k, v in pairs(strings) do
nodecore.translate_inform(v)
strings[k] = function(...) return nodecore.translate(v, ...) end
end
local function shuffle(t)
for i = #t, 2, -1 do
local j = math_random(1, i)
t[i], t[j] = t[j], t[i]
end
end
local function gethint(player)
local pname = player:get_player_name()
local now = math_floor(minetest.get_us_time() / 1000000)
local cached = pcache[pname]
if cached and cached.time == now then return cached.found end
local found, done = nodecore.hint_state(pname)
for k, v in pairs(found) do found[k] = strings.hint(v.text) end
shuffle(found)
for k, v in pairs(done) do done[k] = strings.done(v.text) end
shuffle(done)
local prog = #found
local left = #(nodecore.hints) - prog - #done
table_insert(found, 1, "")
table_insert(found, 1, strings.progress(#done, prog, left))
found[#found + 1] = ""
found[#found + 1] = strings.explore()
found[#found + 1] = ""
for i = 1, #done do found[#found + 1] = done[i] end
pcache[pname] = {time = now, found = found}
return found
end
nodecore.register_inventory_tab({
title = "Hints",
visible = function() return not nodecore.hints_disabled() end,
content = gethint
})