local Commands = require 'expcore.commands' local Global = require 'utils.global' require 'config.expcore-commands.parse_general' local results_per_page = 5 local search_cache = {} Global.register(search_cache,function(tbl) search_cache = tbl end) Commands.new_command('chelp','Searches for a keyword in all commands you are allowed to use.') :add_param('keyword',true) -- the keyword that will be looked for :add_param('page',true,'integer') -- the keyword that will be looked for :set_defaults{keyword='',page=1} :register(function(player,keyword,page,raw) local player_index = player and player.index or 0 -- if keyword is a number then treat it as page number if tonumber(keyword) then page = math.floor(tonumber(keyword)) keyword = '' end -- gets a value for pages, might have result in cache local pages local found = 0 if search_cache[player_index] and search_cache[player_index].keyword == keyword:lower() then pages = search_cache[player_index].pages found = search_cache[player_index].found else pages = {{}} local current_page = 1 local page_count = 0 local commands = Commands.search(keyword,player) -- loops other all commands returned by search, includes game commands for _,command_data in pairs(commands) do -- if the number of results if greater than the number already added then it moves onto a new page if page_count >= results_per_page then page_count = 0 current_page = current_page + 1 table.insert(pages,{}) end -- adds the new command to the page page_count = page_count + 1 found = found + 1 local alias_format = #command_data.aliases > 0 and {'expcom-chelp.alias',table.concat(command_data.aliases,', ')} or '' table.insert(pages[current_page],{ 'expcom-chelp.format', command_data.name, command_data.description, command_data.help, alias_format }) end -- adds the result to the cache search_cache[player_index] = { keyword=keyword:lower(), pages=pages, found=found } end -- print the requested page keyword = keyword == '' and '' or keyword Commands.print({'expcom-chelp.title',keyword},'cyan') if pages[page] then for _,command in pairs(pages[page]) do Commands.print(command) end Commands.print({'expcom-chelp.footer',found,page,#pages},'cyan') else Commands.print({'expcom-chelp.footer',found,page,#pages},'cyan') return Commands.error{'expcom-chelp.out-of-range',page} end -- blocks command complete message return Commands.success end) -- way to access global return search_cache