Files
factorio-scenario-ExpCluster/exp_scenario/module/commands/roles.lua
T
bbassieandClaude Fable 5 8a15745cf8 Address review on the role lookups
- player_has_any_permission and player_has_all_permission, matching the
  account checks the web ui has.
- Roles are no longer sorted on the way out of every lookup. get_ordered_roles
  and the public sort_roles cover the two guis and the command which present
  roles in order, and the highest role is found with a single scan.
- get_held_role_ids returns the list and the set it already built, rather than
  a second function rebuilding the set from the list.
- get_player_names collects into a set before listing, so a player holding the
  role in both the synced and the local list is counted once.
- The role metatable is registered directly under the plugin name, dropping
  the storage import.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-20 22:02:51 +00:00

62 lines
2.6 KiB
Lua

--[[-- Commands - Roles
Adds a commands that allow interaction with the role system
]]
local Commands = require("modules/exp_commands")
local format_player_name = Commands.format_player_name_locale
local format_text = Commands.format_rich_text_color_locale
local Roles = require("modules/exp_roles")
local get_ordered_roles = Roles.get_ordered_roles
local get_player_roles = Roles.get_player_roles
--- Assigns a role to a player
Commands.new("assign-role", { "exp-commands_roles.description-assign" })
:argument("player", { "exp-commands_roles.arg-player-assign" }, Commands.types.lower_role_player)
:argument("role", { "exp-commands_roles.arg-role-assign" }, Commands.types.lower_role)
:add_aliases{ "assign" }
:add_flags{ "admin_only" }
:register(function(player, other_player, role)
--- @cast other_player LuaPlayer
--- @cast role ExpRoles.Role
role:assign(other_player, { by_player_name = player.name })
end)
--- Unassigns a role to a player
Commands.new("unassign-role", { "exp-commands_roles.description-unassign" })
:argument("player", { "exp-commands_roles.arg-player-unassign" }, Commands.types.lower_role_player)
:argument("role", { "exp-commands_roles.arg-role-unassign" }, Commands.types.lower_role)
:add_aliases{ "unassign" }
:add_flags{ "admin_only" }
:register(function(player, other_player, role)
--- @cast other_player LuaPlayer
--- @cast role ExpRoles.Role
role:unassign(other_player, { by_player_name = player.name })
end)
--- Lists all roles in they correct order
Commands.new("get-roles", { "exp-commands_roles.description-get" })
:optional("player", { "exp-commands_roles.arg-player-get" }, Commands.types.player)
:add_aliases{ "roles" }
:register(function(player, other_player)
--- @cast other_player LuaPlayer?
local roles = get_ordered_roles()
local roles_formatted = { "" } --- @type LocalisedString
local response = { "exp-commands_roles.list-roles", roles_formatted } --[[@as LocalisedString]]
if other_player then
roles = Roles.sort_roles(get_player_roles(other_player))
response[1] = "exp-commands_roles.list-player"
response[3] = format_player_name(other_player)
end
for index, role in ipairs(roles) do
local role_name = format_text(role.name, role.color or Commands.color.white)
roles_formatted[index + 1] = { "exp-commands_roles.list-element", role_name }
end
local last = #roles_formatted
roles_formatted[last] = assert(roles_formatted[last])[2]
return Commands.status.success(response)
end)