Taxas

Exemplo completo de configuração

Aqui está um exemplo de como configurar taxas customizadas via API:

taxes:
  # Identificador único para a API econômica
  custom1:
    # Slot no menu de taxas
    slot: 12
    # Ícones nos menus
    icons:
      public:
        material: '2215bdc7ffd061d8414fdab89ebb81b61088740db636218333e12bb53873fea7'
        name: '&6Taxa Customizada'
        lore:
          - '&8Alterado há: {time_since_update}'
          - ''
          - ' &7O servidor recolhe como'
          - ' &7imposto &a{tax}%&7 dos ganhos'
          - ' &7obtidos a partir deste meio.'
          - ''
          - ''
      president:
        material: '2215bdc7ffd061d8414fdab89ebb81b61088740db636218333e12bb53873fea7'
        name: '&6Taxa Customizada'
        lore:
          - '&8Alterado há: {time_since_update}'
          - ''
          - ' &7O servidor recolhe como'
          - ' &7imposto &a{tax}%&7 dos ganhos'
          - ' &7obtidos a partir deste meio.'
          - ''
          - '&aClique para alterar.'

Criando taxas customizadas

O plugin permite criar taxas de impostos customizadas que podem ser integradas através da API por outros plugins.

Estrutura básica

Cada taxa customizada possui as seguintes configurações:

Identificador

O identificador único da taxa (usado na API).

Exemplo:

taxes:
  custom1:  # Este é o identificador

O identificador deve ser único e não pode conter espaços ou caracteres especiais.

slot

Define em qual slot do menu de taxas este item aparecerá.

Exemplo:

custom1:
  slot: 12

Ícones

Cada taxa possui dois ícones: um para visualização pública e outro para o presidente.

public

Ícone exibido para jogadores comuns (sem permissão de editar).

Exemplo:

icons:
  public:
    material: '2215bdc7ffd061d8414fdab89ebb81b61088740db636218333e12bb53873fea7'
    name: '&6Taxa Customizada'
    lore:
      - '&8Alterado há: {time_since_update}'
      - ''
      - ' &7O servidor recolhe como'
      - ' &7imposto &a{tax}%&7 dos ganhos'
      - ' &7obtidos a partir deste meio.'
      - ''

Placeholders disponíveis: {time_since_update} - Tempo desde a última alteração, {tax} - Taxa atual

president

Ícone exibido para o presidente (com permissão de editar).

Exemplo:

icons:
  president:
    material: '2215bdc7ffd061d8414fdab89ebb81b61088740db636218333e12bb53873fea7'
    name: '&6Taxa Customizada'
    lore:
      - '&8Alterado há: {time_since_update}'
      - ''
      - ' &7O servidor recolhe como'
      - ' &7imposto &a{tax}%&7 dos ganhos'
      - ' &7obtidos a partir deste meio.'
      - ''
      - '&aClique para alterar.'

Taxas padrão

O plugin já vem com três taxas integradas aos plugins do yStore:

spawner

Taxa de imposto sobre ganhos de spawners (requer ySpawners).

farm

Taxa de imposto sobre ganhos de farms (requer yPlantacoes).

mine

Taxa de imposto sobre ganhos de mineração (requer yMinas ou yMinasPackets).

Estas taxas não precisam ser configuradas no arquivo taxes.yml, pois já estão integradas no arquivo menus.yml.

Integrando com a API

Para desenvolvedores que desejam integrar suas taxas customizadas com o yPresidente:

Crie a taxa no arquivo

Adicione a configuração da taxa no arquivo taxes.yml com um identificador único.

Use a API do plugin

Utilize a API do yPresidente para recuperar a taxa atual e aplicá-la no seu plugin.

Envie o valor arrecadado

Quando houver arrecadação de impostos, envie o valor para o cofre do governo através da API.

Consulte a documentação da API do plugin para mais detalhes sobre como integrar taxas customizadas.

Exemplos de uso

Taxa para sistema de lojas

taxes:
  shop_tax:
    slot: 13
    icons:
      public:
        material: 'EMERALD'
        name: '&6Taxa de Lojas'
        lore:
          - '&8Alterado há: {time_since_update}'
          - ''
          - ' &7O servidor recolhe como'
          - ' &7imposto &a{tax}%&7 das vendas'
          - ' &7realizadas nas lojas.'
          - ''
      president:
        material: 'EMERALD'
        name: '&6Taxa de Lojas'
        lore:
          - '&8Alterado há: {time_since_update}'
          - ''
          - ' &7O servidor recolhe como'
          - ' &7imposto &a{tax}%&7 das vendas'
          - ' &7realizadas nas lojas.'
          - ''
          - '&aClique para alterar.'

Taxa para sistema de trabalhos

taxes:
  jobs_tax:
    slot: 14
    icons:
      public:
        material: 'IRON_PICKAXE'
        name: '&6Taxa de Trabalhos'
        lore:
          - '&8Alterado há: {time_since_update}'
          - ''
          - ' &7O servidor recolhe como'
          - ' &7imposto &a{tax}%&7 dos ganhos'
          - ' &7obtidos através de trabalhos.'
          - ''
      president:
        material: 'IRON_PICKAXE'
        name: '&6Taxa de Trabalhos'
        lore:
          - '&8Alterado há: {time_since_update}'
          - ''
          - ' &7O servidor recolhe como'
          - ' &7imposto &a{tax}%&7 dos ganhos'
          - ' &7obtidos através de trabalhos.'
          - ''
          - '&aClique para alterar.'

Personalizando taxas

Escolha um identificador

Defina um identificador único para sua taxa customizada.

Configure o slot

Escolha um slot vazio no menu de taxas (verifique os slots já utilizados).

Defina os ícones

Configure os ícones para visualização pública e do presidente.

Adicione placeholders

Use os placeholders disponíveis para tornar a taxa dinâmica.

Teste no servidor

Recarregue o plugin e verifique se a taxa aparece corretamente no menu.

As taxas customizadas aparecem automaticamente no menu de taxas quando configuradas corretamente.

Nesta página