yStoreRecompensas de TOP
Configure as recompensas automáticas para jogadores que alcançarem posições no ranking.
Exemplo completo de configuração
Aqui está um exemplo de como configurar recompensas automáticas de TOP:
tops:
money_1_weekly:
top-type: 'VAULT'
# Posição do TOP que será recompensada
position: 1
# Período da recompensa
# WEEKLY = semanal
# MONTHLY = mensal
period: 'WEEKLY'
# Recompensas que serão dadas
# chance,recompensa (da rewards.yml)
rewards:
- '100.0,reward1'TOP-TYPE DISPONÍVEIS: Veja a lista completa na seção de Placeholders.
PLACEHOLDERS DISPONÍVEIS: {index}, {player_<index>}, {value_<index>}, {value_formatted_<index>}, {value_time_<index>}, {value_kdr_<index>}
Opções disponíveis na configuração
Estrutura principal
Cada configuração de recompensa de TOP deve ter um identificador único (ex: money_1_weekly, kills_3_monthly, etc.).
Exemplo:
tops:
money_1_weekly:Recomendamos usar o formato <tipo>_<posição>_<período> para facilitar a identificação.
top-type
Define o tipo de ranking para o qual a recompensa será dada.
Exemplo:
top-type: 'VAULT'Consulte a lista completa de TOP-TYPE disponíveis na página de Placeholders.
position
Define a posição do ranking que receberá a recompensa (1 a 10).
Exemplo:
position: 1period
Define o período de distribuição das recompensas.
Valores possíveis:
WEEKLY- Recompensa semanalMONTHLY- Recompensa mensal
Exemplo:
period: 'WEEKLY'As recompensas semanais são distribuídas toda segunda-feira, e as mensais no primeiro dia de cada mês.
rewards
Lista de recompensas que serão dadas ao jogador. O formato é 'CHANCE,ID_RECOMPENSA'.
Exemplo:
rewards:
- '100.0,reward1'
- '50.0,reward2'
- '25.0,reward3'- A chance é um valor decimal onde 100.0 = 100% de chance
- O ID da recompensa deve corresponder a uma recompensa configurada no arquivo
rewards.yml - Múltiplas recompensas podem ser configuradas com diferentes chances
Exemplos de configurações
TOP 1 Semanal - Money
tops:
money_1_weekly:
top-type: 'VAULT'
position: 1
period: 'WEEKLY'
rewards:
- '100.0,kit_vip'
- '100.0,money_reward'TOP 3 Mensal - Kills
tops:
kills_3_monthly:
top-type: 'YKILLSYSTEM_KILLS'
position: 3
period: 'MONTHLY'
rewards:
- '100.0,espada_especial'
- '50.0,diamantes'TOP 1, 2 e 3 - McMMO
tops:
mcmmo_1_weekly:
top-type: 'MCMMO_TODOS'
position: 1
period: 'WEEKLY'
rewards:
- '100.0,kit_mcmmo_ouro'
- '100.0,money_reward'
mcmmo_2_weekly:
top-type: 'MCMMO_TODOS'
position: 2
period: 'WEEKLY'
rewards:
- '100.0,kit_mcmmo_prata'
- '50.0,diamantes'
mcmmo_3_weekly:
top-type: 'MCMMO_TODOS'
position: 3
period: 'WEEKLY'
rewards:
- '100.0,kit_mcmmo_bronze'Recompensas com sistema de sorte
tops:
money_1_monthly:
top-type: 'VAULT'
position: 1
period: 'MONTHLY'
rewards:
- '100.0,reward_garantida'
- '50.0,reward_rara'
- '10.0,reward_muito_rara'
- '1.0,reward_lendaria'No exemplo acima:
reward_garantidasempre será dada (100%)reward_raratem 50% de chancereward_muito_raratem 10% de chancereward_lendariatem apenas 1% de chance
Sistema de distribuição automática
Recompensas semanais (WEEKLY)
As recompensas semanais são distribuídas automaticamente toda segunda-feira à meia-noite (00:00).
Exemplo de cronograma:
- Segunda-feira 00:00 - Recompensas distribuídas
- Terça a domingo - Jogadores competem
- Segunda-feira 00:00 - Nova distribuição
Recompensas mensais (MONTHLY)
As recompensas mensais são distribuídas automaticamente no primeiro dia de cada mês à meia-noite (00:00).
Exemplo de cronograma:
- 1º de Janeiro 00:00 - Recompensas distribuídas
- Janeiro inteiro - Jogadores competem
- 1º de Fevereiro 00:00 - Nova distribuição
Forçar distribuição de recompensas
Se você precisar distribuir as recompensas manualmente, use o comando:
/ytops forcerewards <weekly|monthly>Exemplos:
/ytops forcerewards weekly
/ytops forcerewards monthlyEste comando deve ser usado apenas em situações especiais, como testes ou correções. O sistema de distribuição automática é o método recomendado.
Criando seu primeiro sistema de recompensas de TOP
Crie as recompensas
Primeiro, configure as recompensas no arquivo rewards.yml:
rewards:
premio_primeiro_lugar:
preview:
material: 'GOLD_BLOCK:0'
name: '&6Prêmio 1º Lugar'
amount: 1
lore: [ '&eParabéns campeão!' ]
enchants: []
# ... resto da configuraçãoConfigure as recompensas de TOP
No arquivo top_rewards.yml, configure quem recebe o quê:
tops:
money_1_weekly:
top-type: 'VAULT'
position: 1
period: 'WEEKLY'
rewards:
- '100.0,premio_primeiro_lugar'Defina múltiplas posições
Crie recompensas para diferentes posições:
tops:
money_1_weekly:
top-type: 'VAULT'
position: 1
period: 'WEEKLY'
rewards:
- '100.0,premio_ouro'
money_2_weekly:
top-type: 'VAULT'
position: 2
period: 'WEEKLY'
rewards:
- '100.0,premio_prata'
money_3_weekly:
top-type: 'VAULT'
position: 3
period: 'WEEKLY'
rewards:
- '100.0,premio_bronze'Reinicie o servidor
Reinicie o servidor para aplicar as configurações.
Teste a distribuição (opcional)
Use o comando para testar:
/ytops forcerewards weeklyDicas e truques
Recompensas balanceadas: Crie recompensas progressivamente melhores para as posições mais altas (1º > 2º > 3º).
Sistema de sorte: Use chances diferentes para criar um sistema de recompensas com itens raros e comuns.
Múltiplos tipos de TOP: Você pode criar recompensas para diferentes tipos de ranking no mesmo período.
IDs únicos: Cada configuração de recompensa de TOP precisa ter um identificador único no arquivo.
Recompensas existentes: Certifique-se de que os IDs de recompensa referenciados existem no arquivo rewards.yml.
Sistema de armazenamento
Se o inventário do jogador estiver cheio quando as recompensas forem distribuídas, elas serão automaticamente armazenadas e poderão ser coletadas através do menu /tops quando o jogador tiver espaço disponível.
O limite de recompensas armazenadas pode ser configurado na seção limit do arquivo config.yml.