Permissões

Exemplo completo de configuração

O arquivo permissions.yml permite configurar as permissões que cada cargo pode ter no clan.

# Sistema de permissões
permissions:
  kick-players:
    display-name: 'Kickar jogadores'
    item:
      material: 'e79add3e5936a382a8f7fdc37fd6fa96653d5104ebcadb0d4f7e9d4a6efc454'
      name: '&b{permission}'
      lore: ['', '&7Permitido: &f{state}', '']
  access-chest:
    display-name: 'Acessar baú'
    item:
      material: 'e79add3e5936a382a8f7fdc37fd6fa96653d5104ebcadb0d4f7e9d4a6efc454'
      name: '&b{permission}'
      lore: ['', '&7Permitido: &f{state}', '']

Estrutura de uma permissão

Cada permissão possui dois componentes principais:

display-name

O nome amigável da permissão que será exibido nos menus.

display-name: 'Kickar jogadores'

item

O item que representa esta permissão no menu de gerenciamento.

item:
  material: 'e79add3e5936a382a8f7fdc37fd6fa96653d5104ebcadb0d4f7e9d4a6efc454'
  name: '&b{permission}'
  lore: ['', '&7Permitido: &f{state}', '']

Permissões disponíveis

O plugin possui as seguintes permissões configuráveis para os cargos:

Permissão	Nome de Exibição	Descrição
kick-players	Kickar jogadores	Permite expulsar membros do clan
access-chest	Acessar baú	Permite abrir o baú do clan
deposit-money	Depositar coins	Permite depositar dinheiro no banco
withdraw-money	Sacar coins	Permite sacar dinheiro do banco
home-go	Teleportar à base	Permite ir até a base do clan
home-set	Setar o local da base	Permite definir o local da base
home-delete	Deletar o local da base	Permite remover a base
invite-members	Convidar jogadores	Permite enviar convites para jogadores
ally-add	Adicionar aliados	Permite criar alianças
ally-remove	Remover aliados	Permite desfazer alianças
rival-add	Adicionar rivais	Permite criar rivalidades
rival-remove	Remover rivais	Permite remover rivalidades
newsletter-add	Adicionar boletins	Permite criar boletins
ff-member-change	Alternar FF dos Membros	Permite alterar fogo amigo entre membros
ff-ally-change	Alternar FF dos Aliados	Permite alterar fogo amigo com aliados
custom-tag-change	Modificar custom tag	Permite alterar tags customizadas de membros

Placeholders disponíveis

Você pode usar os seguintes placeholders nas configurações das permissões:

Placeholder	Descrição
`{permission}`	Nome da permissão
`{state}`	Estado atual da permissão (Ativo/Inativo)

Como funcionam as permissões

As permissões são atribuídas aos cargos do clan:

Líder: Tem todas as permissões por padrão
Capitão: Permissões configuráveis
Confiável: Permissões configuráveis
Membro: Permissões configuráveis

Os líderes de clan podem alterar as permissões dos cargos através do menu de gerenciamento usando o comando /clan roleperm.

Personalizando permissões

Para personalizar as permissões, edite o arquivo permissions.yml:

Altere o display-name para mudar o nome exibido
Modifique o material do item para mudar o ícone
Customize o name e lore do item

Exemplo:

permissions:
  kick-players:
    display-name: 'Expulsar Membros'
    item:
      material: 'DIAMOND_SWORD'
      name: '&c{permission}'
      lore: 
        - ''
        - '&7Esta permissão permite expulsar'
        - '&7membros do clan.'
        - ''
        - '&7Status: &f{state}'
        - ''

Adicionando novas permissões

Este é um recurso avançado. Adicionar novas permissões requer modificações no código do plugin através da API. As permissões listadas no arquivo são as únicas que funcionam por padrão.

Para desenvolvedores que desejam adicionar novas permissões através da API:

Adicione a permissão no arquivo permissions.yml
Implemente a verificação da permissão no código usando a API do yClans
Registre a permissão no sistema de permissões

Permissões especiais do líder

O cargo de Líder possui permissões exclusivas que não podem ser removidas:

Transferir liderança
Desfazer o clan
Modificar nome do clan
Modificar descrição do clan
Modificar tag do clan
Modificar banner do clan
Gerenciar cargos e permissões

Essas permissões são hardcoded e não aparecem no menu de gerenciamento de permissões.

Nesta página