P_TopJogadores

# P_TopJogadores Top-player ranking plugin for Paper, with support for PlaceholderAPI, Citizens, and DecentHolograms. ## What it does - Calculates category-based rankings using placeholders. - Exposes rankings through PlaceholderAPI. - Creates Citizens NPCs by ranking position. - Creates DecentHolograms holograms. - Displays an automatic hologram above the NPC with `title` and `subtitle`. - Supports NPC click commands executed as `console` or `player`. - Supports compact values such as `k`, `m`, `b`, and `t`. ## Requirements - Paper 1.21+ - PlaceholderAPI - Citizens - DecentHolograms ## Commands ### Main command ```text /ptop /ptop reload /ptop recalcular /ptop npc criar <category> <position> /ptop npc remover <category> /ptop holograma criar <category> /ptop holograma remover <category> ``` ### Permissions - `ptop.admin` - `ptop.reload` - `ptop.recalcular` - `ptop.npc` - `ptop.holograma` ## PlaceholderAPI The expansion identifier is `p_topjogadores`. ### Category ranking ```text %p_topjogadores_top_<position>_<category>_<field>% ``` Available fields: - `nome` - `valor` - `uuid` - `posicao` Examples: ```text %p_topjogadores_top_1_kills_nome% %p_topjogadores_top_1_kills_valor% %p_topjogadores_top_1_kills_uuid% %p_topjogadores_top_1_kills_posicao% ``` ### Player data in a category ```text %p_topjogadores_jogador_<category>_<field>% ``` Available fields: - `posicao` - `valor` Examples: ```text %p_topjogadores_jogador_kills_posicao% %p_topjogadores_jogador_kills_valor% ``` ### Category data ```text %p_topjogadores_categoria_<category>_<field>% ``` Available fields: - `titulo` - `placeholder` - `limite` Examples: ```text %p_topjogadores_categoria_kills_titulo% %p_topjogadores_categoria_kills_placeholder% %p_topjogadores_categoria_kills_limite% ``` ## Category configuration Each category is defined in `categorias.yml`. Example: ```yml categorias: kills: habilitada: true placeholder: '%statistic_player_kills%' titulo: '&cTop Kills' formato-valor: '#,##0' formato-compacto: false ordem-decrescente: true npc-holograma: habilitado: true altura: 2.35 titulo: '&cTop %posicao%' subtitulo: '&f%nome% &7- &f%valor%' limite: 10 mundo-especifico: false mundos-permitidos: linhas: - '&8--------------------' - '&f1. &e%top_1_nome% &7- &f%top_1_valor%' - '&f2. &e%top_2_nome% &7- &f%top_2_valor%' - '&8--------------------' comandos-clique: esquerdo: direito: - ' msg %player% &aYou clicked the kills ranking NPC!' ``` ## NPC hologram The automatic hologram above the NPC uses: - `npc-holograma.habilitado` - `npc-holograma.altura` - `npc-holograma.titulo` - `npc-holograma.subtitulo` These values support the plugin placeholders: - `%categoria%` - `%posicao%` - `%nome%` - `%valor%` `titulo` and `subtitulo` support `\n` for line breaks. ## Manual ranking hologram The command `/ptop holograma criar <category> ` creates the ranking hologram at the chosen location. Global hologram settings: - `holograma.altura-padrao` - `holograma.espaco-entre-linhas` - `holograma.deslocamento-extra` ## NPC clicks In `comandos-clique.direito` and `comandos-clique.esquerdo`, each line can start with: - `` to run as console - `` to run as the player who clicked If no prefix is provided, the default is `console`. Example: ```yml comandos-clique: direito: - ' give %player% diamond 1' - ' spawn' ``` ## Global configuration File: `config.yml` ```yml geral: prefixo: '&8 ' debug: false casas-decimais-padrao: 2 placeholder-vazio: '&7Ninguem' valor-vazio: '0' atualizacao: ranking-segundos: 120 visual-segundos: 20 atualizar-ao-entrar: true atualizar-no-enable: true max-jogadores-por-ciclo: 5000 performance: cache-placeholders-segundos: 60 ignorar-jogadores-sem-dado: true ignorar-valor-zero: false integracoes: placeholderapi-obrigatorio-para-rankings: true citizens: true decentholograms: true holograma: altura-padrao: 2.3 espaco-entre-linhas: 0.28 deslocamento-extra: 0.8 ``` ## Notes - If `placeholderapi-obrigatorio-para-rankings` is `true`, rankings only recalculate when PlaceholderAPI is available. - If `formato-compacto` is `true`, the category value is displayed as `k/m/b/t`. - The NPC uses the ranking player's skin when possible. - If no NPC or hologram exists at the requested position during removal, the plugin reports that instead of pretending it was removed. # P_TopJogadores Plugin de ranking/top jogadores para Paper, com suporte a PlaceholderAPI, Citizens e DecentHolograms. ## O que o plugin faz - Calcula rankings por categoria usando placeholders. - Exibe rankings via PlaceholderAPI. - Cria NPCs do Citizens por posicao do ranking. - Cria hologramas do DecentHolograms. - Exibe um holograma automatico acima do NPC com `titulo`