Ver código fonte para Permissions/pt

Cada nó de comando do DragonMineZ é registrado pela <code>PermissionAPI</code> do Forge, então donos de servidores que usam um mod de permissões (LuckPerms, PermissionsEx e similares) podem conceder acesso detalhado em vez de depender do status geral de operador. Sem um mod de permissões, o DMZ recorre aos níveis de operador vanilla.

Os nós são definidos em <code>DMZPermissions.java</code>. Cada um é registrado no namespace <code>dragonminez</code>, então o nome completo é <code>dragonminez.&lt;node&gt;</code>, por exemplo <code>dragonminez.admin</code> ou <code>dragonminez.dmzstats.set.self</code>. Para saber o que cada comando faz, veja [[Special:MyLanguage/Commands|Comandos]].

<span id="How_a_permission_check_resolves"></span>
== Como uma verificação de permissão é resolvida ==
Em cada comando protegido por uma permissão do DMZ, a verificação passa se '''qualquer''' uma destas condições for verdadeira:

# O jogador tem '''o nó específico''' daquela ação.
# O jogador tem '''<code>dragonminez.admin</code>''', que concede todas as permissões do DMZ de uma vez.
# O jogador é '''operador vanilla de nível 2 ou superior''' (<code>player.hasPermissions(2)</code>).

Comandos executados pelo '''console do servidor ou por blocos de comando''' (qualquer coisa que não seja um jogador) sempre passam nas verificações de permissão do DMZ.

<syntaxhighlight lang="java">
return PermissionAPI.getPermission(player, node) || PermissionAPI.getPermission(player, ADMIN) || player.hasPermissions(2);
</syntaxhighlight>

<span id="Commands_gated_by_vanilla_operator_level"></span>
=== Comandos protegidos pelo nível de operador vanilla ===
Alguns comandos não usam nós do DMZ: eles simplesmente exigem '''operador de nível 2''' e não são afetados por <code>dragonminez.admin</code>.

{| class="wikitable"
! Comando !! Observação
|-
| {{Command|/dmzraid}} || Todos os subcomandos (veja [[Special:MyLanguage/Raids|Incursões]]).
|-
| {{Command|/dmzworldboss}} || Todos os subcomandos '''exceto <code>results</code>''', que qualquer um pode usar (veja [[Special:MyLanguage/World Bosses|Chefes de mundo]]).
|-
| {{Command|/dmztournament}} || Todos os subcomandos (veja [[Special:MyLanguage/Tournaments|Torneios]]).
|-
| {{Command|/dmzquest questnpc}} || Os subcomandos que geram NPCs de missões (o resto do <code>/dmzquest</code> usa nós).
|}

<code>/dmzracial reply accept|reject</code> (responder a um pedido de assimilação namekuseijin) não precisa de nenhuma permissão.

<span id="Without_a_permissions_mod"></span>
== Sem um mod de permissões ==
Sem LuckPerms, PermissionsEx ou um mod parecido cuidando desses nós, cada nó usa seu valor padrão. Na prática, só operadores de nível 2 ou superior podem usar o que for protegido por um nó cujo padrão é <code>false</code>. Todos os outros recebem apenas o punhado de nós cujo padrão é <code>true</code> (veja as tabelas abaixo), que na maioria são "ver ou listar suas próprias coisas".

<span id="Granting_nodes_with_a_permissions_mod"></span>
== Conceder nós com um mod de permissões ==
Exemplo com a sintaxe do LuckPerms (adapte ao mod que você usa):

<syntaxhighlight lang="text">
/lp user <player> permission set dragonminez.dmzstats.set.self true
/lp group <group> permission set dragonminez.dmzquest.list.others true
/lp user <player> permission set dragonminez.admin true
</syntaxhighlight>

O DMZ não traz um comando próprio para conceder ou revogar: o gerenciamento de nós fica inteiramente a cargo do seu mod de permissões.

<span id="Node_reference"></span>
== Referência de nós ==
Os nós têm <code>false</code> como padrão (só operadores e administradores), a menos que a tabela diga <code>true</code>. As linhas escritas como <code>….self</code> / <code>.others</code> são dois nós: um para usar o comando em você mesmo e outro para usá-lo em outros jogadores.

<span id="Admin"></span>
=== Administrador ===
{| class="wikitable"
! Nó !! Padrão !! Concede
|-
| <code>dragonminez.admin</code> || <code>false</code> || <span class="mw-translate-fuzzy">Todas as permissões do DMZ de uma vez. Também é necessário (ou o nível de operador 2) para <code>/dmzconfig</code>, <code>/dmzrestoreupdate</code> e <code>/dmzdebug</code>.</span>
|}

<span id="Stats"></span>
=== Estatísticas ===
Nós de <code>StatsCommand</code> (<code>/dmzstats</code>).

{| class="wikitable"
! Nó !! Padrão !! Concede
|-
| <code>dragonminez.dmzstats.set.self</code> || <code>false</code> || Definir suas próprias estatísticas.
|-
| <code>dragonminez.dmzstats.set.others</code> || <code>false</code> || Definir as estatísticas de outro jogador.
|-
| <code>dragonminez.dmzstats.add.self</code> || <code>false</code> || Somar ou subtrair das suas próprias estatísticas (<code>add</code> e <code>remove</code>).
|-
| <code>dragonminez.dmzstats.add.others</code> || <code>false</code> || Somar ou subtrair das estatísticas de outro jogador.
|-
| <code>dragonminez.dmzstats.info.self</code> || <code>true</code> || Ver suas próprias estatísticas.
|-
| <code>dragonminez.dmzstats.info.others</code> || <code>false</code> || Ver as estatísticas de outro jogador.
|-
| <code>dragonminez.dmzstats.reset.self</code> || <code>false</code> || Resetar ou redistribuir suas próprias estatísticas.
|-
| <code>dragonminez.dmzstats.reset.others</code> || <code>false</code> || Resetar ou redistribuir as estatísticas de outro jogador.
|}

<span id="Skills"></span>
=== Habilidades ===
Nós de <code>SkillsCommand</code> (<code>/dmzskill</code>).

{| class="wikitable"
! Nó !! Padrão !! Concede
|-
| <code>dragonminez.dmzskill.set.self</code> / <code>.others</code> || <code>false</code> || Definir níveis de habilidades.
|-
| <code>dragonminez.dmzskill.add.self</code> / <code>.others</code> || <code>false</code> || Adicionar uma habilidade.
|-
| <code>dragonminez.dmzskill.remove.self</code> / <code>.others</code> || <code>false</code> || Remover uma habilidade.
|-
| <code>dragonminez.dmzskill.list.self</code> || <code>true</code> || Listar suas próprias habilidades.
|-
| <code>dragonminez.dmzskill.list.others</code> || <code>false</code> || Listar as habilidades de outro jogador.
|}

<span id="Techniques"></span>
=== Técnicas ===
Nós de <code>TechCommand</code> (<code>/dmztech</code>).

{| class="wikitable"
! Nó !! Padrão !! Concede
|-
| <code>dragonminez.dmztech.add.self</code> / <code>.others</code> || <code>false</code> || Conceder uma técnica de ki.
|-
| <code>dragonminez.dmztech.remove.self</code> / <code>.others</code> || <code>false</code> || Remover uma técnica de ki.
|-
| <code>dragonminez.dmztech.list.self</code> || <code>true</code> || Listar suas próprias técnicas.
|-
| <code>dragonminez.dmztech.list.others</code> || <code>false</code> || Listar as técnicas de outro jogador.
|-
| <code>dragonminez.dmztech.experience.self</code> / <code>.others</code> || <code>false</code> || Alterar a experiência das técnicas.
|}

<span id="Technique_cooldowns"></span>
=== Recargas de técnicas ===
Nós de <code>CooldownsCommand</code> (<code>/dmzcooldowns</code>).

{| class="wikitable"
! Nó !! Padrão !! Concede
|-
| <code>dragonminez.dmzcooldowns.self</code> || <code>false</code> || Alterar as recargas das suas próprias técnicas de ki e de golpe.
|-
| <code>dragonminez.dmzcooldowns.others</code> || <code>false</code> || Alterar as recargas das técnicas de ki e de golpe de outro jogador.
|}

<span id="Bonus_stats"></span>
=== Estatísticas bônus ===
Nós de <code>BonusCommand</code> (<code>/dmzbonus</code>).

{| class="wikitable"
! Nó !! Padrão !! Concede
|-
| <code>dragonminez.dmzbonus.add.self</code> / <code>.others</code> || <code>false</code> || Adicionar estatísticas bônus.
|-
| <code>dragonminez.dmzbonus.clear.self</code> / <code>.others</code> || <code>false</code> || Remover ou limpar estatísticas bônus (<code>remove</code> e <code>clear</code>).
|}

<span id="Effects"></span>
=== Efeitos ===
Nós de <code>EffectsCommand</code> (<code>/dmzeffect</code>).

{| class="wikitable"
! Nó !! Padrão !! Concede
|-
| <code>dragonminez.dmzeffect.give.self</code> / <code>.others</code> || <code>false</code> || Dar um efeito de status.
|-
| <code>dragonminez.dmzeffect.remove.self</code> / <code>.others</code> || <code>false</code> || Remover um efeito de status.
|-
| <code>dragonminez.dmzeffect.clear.self</code> / <code>.others</code> || <code>false</code> || Limpar todos os efeitos.
|-
| <code>dragonminez.dmzeffect.list.self</code> || <code>true</code> || Listar seus próprios efeitos.
|-
| <code>dragonminez.dmzeffect.list.others</code> || <code>false</code> || Listar os efeitos de outro jogador.
|}

<span id="Points"></span>
=== Pontos ===
Nós de <code>PointsCommand</code> (<code>/dmzpoints</code>).

{| class="wikitable"
! Nó !! Padrão !! Concede
|-
| <code>dragonminez.dmzpoints.set.self</code> / <code>.others</code> || <code>false</code> || Definir pontos.
|-
| <code>dragonminez.dmzpoints.add.self</code> / <code>.others</code> || <code>false</code> || Adicionar pontos.
|-
| <code>dragonminez.dmzpoints.remove.self</code> / <code>.others</code> || <code>false</code> || Remover pontos.
|-
| <code>dragonminez.dmzpoints.info.self</code> || <code>true</code> || Ver seus próprios pontos.
|-
| <code>dragonminez.dmzpoints.info.others</code> || <code>false</code> || Ver os pontos de outro jogador.
|}

<span id="Quests_and_sagas"></span>
=== Missões e sagas ===
Nós de <code>StoryCommand</code> (<code>/dmzquest</code>).

{| class="wikitable"
! Nó !! Padrão !! Concede
|-
| <code>dragonminez.dmzquest.list.self</code> || <code>true</code> || Listar seu próprio progresso de missões.
|-
| <code>dragonminez.dmzquest.list.others</code> || <code>false</code> || Listar o progresso de missões de outro jogador.
|-
| <code>dragonminez.dmzquest.info</code> || <code>true</code> || Ver os metadados de uma missão.
|-
| <code>dragonminez.dmzquest.start.self</code> / <code>.others</code> || <code>false</code> || Forçar o início de uma missão.
|-
| <code>dragonminez.dmzquest.finish.self</code> / <code>.others</code> || <code>false</code> || Forçar a conclusão de uma missão.
|-
| <code>dragonminez.dmzquest.fail.self</code> / <code>.others</code> || <code>false</code> || Forçar a falha de uma missão.
|-
| <code>dragonminez.dmzquest.reset.self</code> / <code>.others</code> || <code>false</code> || Resetar uma missão.
|-
| <code>dragonminez.dmzquest.track.self</code> || <code>true</code> || Definir sua própria missão rastreada.
|-
| <code>dragonminez.dmzquest.track.others</code> || <code>false</code> || Definir a missão rastreada de outro jogador.
|-
| <code>dragonminez.dmzquest.startsaga.self</code> / <code>.others</code> || <code>false</code> || Forçar o início de todas as missões de uma saga.
|-
| <code>dragonminez.dmzquest.finishsaga.self</code> / <code>.others</code> || <code>false</code> || Forçar a conclusão de todas as missões de uma saga.
|-
| <code>dragonminez.dmzquest.resetsaga.self</code> / <code>.others</code> || <code>false</code> || Resetar uma saga inteira.
|-
| <code>dragonminez.dmzquest.difficulty.self</code> || <code>false</code> || Ver ou alterar sua própria dificuldade da história (<code>/dmzquest difficulty</code>).
|-
| <code>dragonminez.dmzquest.difficulty.others</code> || <code>false</code> || Alterar a dificuldade da história de outros jogadores.
|}

<span id="Other_commands"></span>
=== Outros comandos ===
{| class="wikitable"
! Nó !! Padrão !! Concede !! Classe do comando
|-
| <code>dragonminez.dmzlocate</code> || <code>false</code> || Localizar estruturas especiais. || <code>LocateCommand</code>
|-
| <code>dragonminez.dmzstructure</code> || <code>false</code> || Ler coordenadas locais de estruturas e os NPCs das estruturas (<code>/dmzstructure</code>). || <code>StructureCommand</code>
|-
| <code>dragonminez.dmzdragonballs.status</code> || <code>false</code> || Ver onde cada conjunto de Esferas do Dragão está sendo rastreado (<code>/dmzdragonballs status</code>). || <code>DragonBallsCommand</code>
|-
| <code>dragonminez.dmzdragonballs.regenerate</code> || <code>false</code> || Completar um conjunto de Esferas do Dragão até as cópias configuradas (<code>/dmzdragonballs regenerate</code>). || <code>DragonBallsCommand</code>
|-
| <code>dragonminez.dmzrevive.self</code> / <code>.others</code> || <code>false</code> || Reviver um jogador. || <code>ReviveCommand</code>
|-
| <code>dragonminez.dmzparty.use</code> || <code>true</code> || Convidar, aceitar e recusar convites, expulsar, desfazer e ligar ou desligar o PvP de grupo, com <code>/dmzparty</code> ou a aba Grupo. Listar seu grupo (<code>/dmzparty</code>, <code>/dmzparty list</code>) e sair dele não precisam disso. || <code>PartyCommand</code>
|-
| <code>dragonminez.dmzmastery.set</code> / <code>.add</code> || <code>false</code> || Definir ou adicionar domínio de transformação. || <code>MasteryCommand</code>
|-
| <code>dragonminez.dmz.reload</code> || <code>false</code> || Executar <code>/dmzreload</code> (veja [[Special:MyLanguage/Reloading and Updating Changes|Recarregar e atualizar mudanças]]). || <code>ReloadCommand</code>
|-
| <code>dragonminez.dmzform.set.self</code> / <code>.others</code> || <code>false</code> || Definir uma forma. || <code>FormsCommand</code>
|-
| <code>dragonminez.dmzform.add.self</code> / <code>.others</code> || <code>false</code> || Conceder uma forma. || <code>FormsCommand</code>
|-
| <code>dragonminez.dmzform.remove.self</code> / <code>.others</code> || <code>false</code> || Remover uma forma. || <code>FormsCommand</code>
|-
| <code>dragonminez.dmzform.list.self</code> || <code>true</code> || Listar suas próprias formas. || <code>FormsCommand</code>
|-
| <code>dragonminez.dmzform.list.others</code> || <code>false</code> || Listar as formas de outro jogador. || <code>FormsCommand</code>
|-
| <code>dragonminez.dmzracial.reset.self</code> / <code>.others</code> || <code>false</code> || Resetar as habilidades raciais. || <code>RacialSkillCommand</code>
|-
| <code>dragonminez.dmzweight.give</code> || <code>false</code> || Dar itens de treino com peso. || <code>WeightCommand</code>
|-
| <code>dragonminez.dmzalignment.set.self</code> / <code>.others</code> || <code>false</code> || Definir a índole. || <code>AlignmentCommand</code>
|-
| <code>dragonminez.dmzalignment.add.self</code> / <code>.others</code> || <code>false</code> || Adicionar índole. || <code>AlignmentCommand</code>
|-
| <code>dragonminez.dmzalignment.remove.self</code> / <code>.others</code> || <code>false</code> || Remover índole. || <code>AlignmentCommand</code>
|-
| <code>dragonminez.dmzalignment.info.self</code> || <code>true</code> || Ver sua própria índole. || <code>AlignmentCommand</code>
|-
| <code>dragonminez.dmzalignment.info.others</code> || <code>false</code> || Ver a índole de outro jogador. || <code>AlignmentCommand</code>
|-
| <code>dragonminez.dmztail.self</code> || <code>true</code> || Fazer crescer ou cortar sua própria cauda. || <code>TailCommand</code>
|-
| <code>dragonminez.dmztail.others</code> || <code>false</code> || Fazer crescer ou cortar a cauda de outro jogador. || <code>TailCommand</code>
|-
| <code>dragonminez.dmzminigame.self</code> || <code>false</code> || Abrir ou aprender minijogos de treinamento para você com <code>/dmzminigame</code>. || <code>MinigameCommand</code>
|-
| <code>dragonminez.dmzminigame.others</code> || <code>false</code> || Abrir ou ensinar minijogos de treinamento para outros jogadores. || <code>MinigameCommand</code>
|-
| <code>dragonminez.dmzhalo.self</code> / <code>.others</code> || <code>false</code> || Ligar ou desligar uma auréola. || <code>HaloCommand</code>
|-
| <code>dragonminez.dmzhair.self</code> || <code>true</code> || Ressincronizar ou resetar seu próprio cabelo. || <code>HairCommand</code>
|-
| <code>dragonminez.dmzhair.others</code> || <code>false</code> || Ressincronizar ou resetar o cabelo de outro jogador. || <code>HairCommand</code>
|-
| <code>dragonminez.dmzclass.set.self</code> || <code>false</code> || Alterar sua própria classe. || <code>ClassCommand</code>
|-
| <code>dragonminez.dmzclass.set.others</code> || <code>false</code> || Alterar a classe de outro jogador. || <code>ClassCommand</code>
|-
| <code>dragonminez.dmztrigger.self</code> || <code>false</code> || <span lang="en" dir="ltr" class="mw-content-ltr">Trigger test forms, racial skills and states on yourself with <code>/dmztrigger</code>.</span> || <code>TriggerCommand</code>
|-
| <code>dragonminez.dmztrigger.others</code> || <code>false</code> || <span lang="en" dir="ltr" class="mw-content-ltr">The same, on another player.</span> || <code>TriggerCommand</code>
|-
| <code>dragonminez.admin</code> || <code>false</code> || <span class="mw-translate-fuzzy">Também é necessário (ou o nível de operador 2) para <code>/dmzconfig</code>, <code>/dmzrestoreupdate</code> e <code>/dmzdebug</code>.</span> || <code>ConfigCommand</code>, <code>RestoreCommand</code>, <code>DebugCommand</code>
|}

<span id="Applying_changes"></span>
== Aplicar mudanças ==
Os nós são registrados quando o mod inicia e não precisam de um recarregamento como o da configuração: as mudanças de concessão e revogação valem assim que seu mod de permissões as aplica (o LuckPerms, por exemplo, aplica a maioria das mudanças na hora).

{{Navbox Configuration}}