Economias

O arquivo economies.yml permite configurar quais sistemas de economia podem ser usados como pagamento para os upgrades da mochila.

Estrutura

#  _____                                  _
# | ____| ___  ___  _ __   ___  _ __ ___ (_) ___  ___
# |  _|  / __|/ _ \| '_ \ / _ \| '_ ` _ \| |/ _ \/ __|
# | |___| (__| (_) | | | | (_) | | | | | | |  __/\__ \
# |_____|\___|\___/|_| |_|\___/|_| |_| |_|_|\___||___/

# Providers disponíveis:
#
#   AtlasEconomiaSecundaria, AtlasMinas, AtlasMinasV2,
#   JH_Shop, LegendaryEconomy, NextCash, PlayerPoints,
#   StormEconomiaSecundaria, StormMinas, TGCash,
#   yAlmas, yPoints, yRankup,
#   Vault
#

economies:
  money:
    # Coloque o nome do plugin
    # Para money deixe Money
    provider: 'Money'
    # Formato inteiro
    display: 'Dinheiro'
    # Formato abreviado
    abbreviated: 'coins'
    # Permitir que comercializem na loja com o jogador offline
    allow-offline: true
    # Permissão para o usuário conseguir definir esta economia
    permission: 'ycratesvirtuaismochilasaddon.provider.money'

Providers disponíveis

O plugin suporta diversos sistemas de economia. Abaixo está a lista completa de providers disponíveis:

Plugins de Economia

AtlasEconomiaSecundaria - Economia secundária do AtlasMC
AtlasMinas - Sistema de dinheiro do AtlasMinas
AtlasMinasV2 - Sistema de dinheiro do AtlasMinas V2
JH_Shop - Economia do JH_Shop
LegendaryEconomy - Plugin LegendaryEconomy
NextCash - Sistema NextCash
PlayerPoints - Plugin PlayerPoints (pontos)
StormEconomiaSecundaria - Economia secundária do Storm
StormMinas - Sistema de dinheiro do StormMinas
TGCash - Sistema TGCash
yAlmas - Sistema de almas do yAlmas
yPoints - Sistema de pontos do yPoints
yRankup - Economia do yRankup
Vault - Qualquer economia compatível com Vault (recomendado usar "Money")

Para usar economia padrão do servidor (através do Vault), use o provider Money conforme o exemplo padrão.

Configuração de Economia

Parâmetros

Cada economia configurada possui os seguintes parâmetros:

economies:
  identificador:
    provider: 'PROVIDER_NAME'
    display: 'Nome Completo'
    abbreviated: 'abrev'
    allow-offline: true
    permission: 'permissao.para.usar'

Detalhamento:

identificador: ID único da economia (usado em config.yml nos upgrades)
- Exemplo: money, pontos, cash
provider: Nome do sistema de economia a ser usado
- Deve ser um dos providers listados acima
- Para economia padrão do servidor, use Money
display: Nome completo da economia exibido nas mensagens
- Exemplo: Dinheiro, Pontos, Cash
abbreviated: Forma abreviada da economia
- Usado em alguns placeholders
- Exemplo: coins, pts, $
allow-offline: Permite transações com jogadores offline
- true - Permite (recomendado)
- false - Não permite
permission: Permissão necessária para usar esta economia
- Jogadores sem esta permissão não poderão fazer upgrades com esta economia
- Use '' (vazio) para não exigir permissão

Exemplos

Economia padrão (Money)

economies:
  money:
    provider: 'Money'
    display: 'Dinheiro'
    abbreviated: 'coins'
    allow-offline: true
    permission: ''

PlayerPoints

economies:
  pontos:
    provider: 'PlayerPoints'
    display: 'Pontos'
    abbreviated: 'pts'
    allow-offline: true
    permission: 'ycratesvirtuaismochilasaddon.provider.pontos'

yAlmas

economies:
  almas:
    provider: 'yAlmas'
    display: 'Almas'
    abbreviated: 'souls'
    allow-offline: true
    permission: 'ycratesvirtuaismochilasaddon.provider.almas'

Múltiplas economias

economies:
  money:
    provider: 'Money'
    display: 'Dinheiro'
    abbreviated: 'coins'
    allow-offline: true
    permission: ''
  
  pontos:
    provider: 'PlayerPoints'
    display: 'Pontos'
    abbreviated: 'pts'
    allow-offline: true
    permission: ''
  
  cash:
    provider: 'NextCash'
    display: 'Cash'
    abbreviated: 'cash'
    allow-offline: true
    permission: 'ycratesvirtuaismochilasaddon.provider.cash'

Você pode criar quantas economias quiser e usá-las nos upgrades da mochila configurados em config.yml.

Uso em Upgrades

Após configurar uma economia aqui, você pode usá-la nos upgrades em config.yml:

# Em config.yml
upgrades:
  storage-limit:
    prices-per-upgrade:
      price1:
        provider: 'money'  # Usa a economia 'money' configurada em economies.yml
        amount: 200.0

Múltiplas economias por upgrade

# Em config.yml
upgrades:
  storage-limit:
    prices-per-upgrade:
      price1:
        provider: 'money'
        amount: 1000.0
      price2:
        provider: 'pontos'
        amount: 50.0

Neste exemplo, cada upgrade custará 1000 de Dinheiro e 50 Pontos simultaneamente.

O jogador deve ter saldo suficiente em todas as economias configuradas no upgrade para conseguir evoluir a mochila.

Solução de problemas

Economia não funciona

Verifique se o provider está instalado no servidor
Confirme que o nome do provider está correto (case-sensitive)
Para economia Vault, use Money ao invés de Vault
Verifique se o jogador tem permissão configurada (se aplicável)

Mensagem de saldo insuficiente incorreta

Verifique o campo display - é ele que aparece nas mensagens
O campo abbreviated é usado apenas em alguns placeholders específicos

Para testar se uma economia está funcionando, tente fazer um upgrade de mochila após configurá-la. O plugin mostrará mensagens de erro detalhadas no console se houver problemas.

Nesta página