Referência de configuração
Esta página documenta todas as chaves do config.yml do Verité. As predefinições mostradas são os valores com que o Verité vem de origem. As chaves de configuração, os valores e o código aparecem exatamente como estão escritos no ficheiro (ASCII), enquanto o texto usa o nome acentuado Verité.
A configuração do Verité está agrupada em módulos:
general: definições de todo o plugin.chat.filter: o filtro de chat, Veritédoux.moderation: o sistema de moderação, Veritésauver.invsee: visualização de inventário.vanish: o sistema de vanish, Veritévoiler.
Editar flags no jogo
Muitas destas chaves podem ser lidas e alteradas a partir do jogo com /verite config, que corrige a chave individual no disco e mantém todos os comentários do ficheiro. Este comando está protegido pela permissão veritedoux.flag. Todas as chaves verdadeiro ou falso e todas as chaves numéricas em config.yml podem ser editadas assim, usando o nome curto ou o caminho completo com pontos. As chaves de texto livre, as listas da árvore de sanções e config.language não são editáveis assim; altere-as no ficheiro ou a partir do painel web. Execute /verite config sem argumentos para listar todas as chaves editáveis. A maioria das edições aplica-se em tempo real; as portas dos módulos (chat.filter.enabled, moderation.enabled, vanish.enabled) e as duas flags de atualização automática requerem um reinício para produzir efeito.
General
A secção general contém as definições de todo o plugin.
general:
prefix: "<#808080>[<#B1C7F0>Verité<#808080>]<reset>"
auto.update.config: true
dashboard.url: "https://verite.gg"| Chave | Predefinição | Controla |
|---|---|---|
general.prefix |
<#808080>[<#B1C7F0>Verité<#808080>]<reset> |
O prefixo visível ao público em todas as mensagens do Verité, no formato de etiquetas do Verite. |
general.auto.update.config |
true |
Acrescenta automaticamente novas chaves à configuração quando o plugin é atualizado. Não ignora as atualizações do tokenizer. Editável com /verite config como auto.update.config, mas requer um reinício para aplicar. |
general.dashboard.url |
https://verite.gg |
Para onde o /verite dashboard te envia. Só o alteres se alojares o Painel por tua conta. |
config.language |
en |
O idioma em que todo o plugin funciona. Um de en, es, fr, it, pt ou de. Alterá-lo requer um reinício completo, não um recarregamento. |
Filtro de chat (Veritédoux)
A secção chat.filter configura a filtragem de mensagens.
chat.filter:
enabled: true
auto.update.eve: false
block.message: "@prefix Your message wasn't sent. Please keep chat friendly."
repeat.message: "@prefix You've already sent that message. Please wait a moment before repeating yourself."| Chave | Predefinição | Controla |
|---|---|---|
chat.filter.enabled |
true |
Ativa o módulo de filtro de chat. Editável com /verite config como chat.filter.enabled, mas requer um reinício para aplicar. |
chat.filter.auto.update.eve |
false |
Atualiza automaticamente os ficheiros de configuração .eve quando novas entradas são adicionadas. Quando ativado, as entradas personalizadas são substituídas ou descartadas quando os ficheiros .eve são substituídos por versões atualizadas. Editável com /verite config como auto.update.eve, mas requer um reinício para aplicar. |
chat.filter.block.message |
@prefix Your message wasn't sent. Please keep chat friendly. |
O aviso mostrado quando uma mensagem é bloqueada pelo filtro. Suporta &-códigos e &#RRGGBB hex. Use @prefix para inserir o prefixo escolhido. |
chat.filter.repeat.message |
@prefix You've already sent that message. Please wait a moment before repeating yourself. |
O aviso mostrado quando uma mensagem é bloqueada por ser repetida. Suporta &-códigos e &#RRGGBB hex, e @prefix. |
Mensagem de automutilação
A mensagem de bloqueio de automutilação não pode ser alterada. Isto garante que os utilizadores recebem sempre a orientação e o apoio adequados ao lidar com conteúdo relacionado com automutilação.
Idiomas
O bloco chat.filter.general.lang escolhe que idiomas têm o conteúdo verificado e que categorias de deteção são executadas para cada um. A deteção de palavrões está desativada por predefinição para que os servidores que permitem palavrões casuais não sejam afetados. Ajuste-as para corresponder à tolerância do seu servidor.
Cada bloco de idioma suporta estas chaves:
| Chave | Predefinição | Controla |
|---|---|---|
allowed |
true |
Se o idioma é permitido no chat. |
self.harm.detection |
true |
Deteta conteúdo relacionado com automutilação neste idioma. |
abuse.detection |
true |
Deteta conteúdo abusivo neste idioma. |
slur.detection |
true |
Deteta insultos neste idioma. |
As chaves de palavrões são por idioma. Cada uma predefine-se para false. Defina uma como true para sinalizar palavrões desse dialeto ou região.
| Idioma | Chaves de palavrões (todas predefinem false) |
|---|---|
english |
profanity.global |
spanish |
profanity.spain, profanity.argentinian, profanity.chilean, profanity.colombian, profanity.mexican, profanity.peruvian, profanity.venezuelan, profanity.uruguayan, profanity.cuban, profanity.dominican, profanity.panamanian, profanity.global |
french |
profanity.france, profanity.canadian |
portuguese |
profanity.european, profanity.brazilian |
german |
profanity.global |
italian |
profanity.global |
Duas entradas adicionais cobrem texto cujo idioma não pôde ser resolvido:
| Chave | Predefinição | Controla |
|---|---|---|
chat.filter.general.lang.unknown.lang.allowed |
true |
Se as mensagens num idioma que o Verité não reconhece são permitidas. |
chat.filter.general.lang.undeterminable.allowed |
true |
Se as mensagens cujo idioma não pode ser determinado são permitidas. |
Um exemplo de bloco de idioma:
chat.filter:
general.lang:
english:
allowed: true
self.harm.detection: true
abuse.detection: true
slur.detection: true
profanity.global: falseAvançado
O bloco chat.filter.advanced contém os ajustes para legibilidade, spam e deteção de repetições.
chat.filter:
advanced:
keep.chat.readable: false
block.possible.spam: false
block.repeat.messages: false
block.repeat.exact: true
block.repeat.near: true
block.repeat.history.size: 5
block.repeat.window.ms: 5000
block.repeat.similarity.threshold: 0.85
block.unsupported.languages: false| Chave | Predefinição | Controla |
|---|---|---|
keep.chat.readable |
false |
Bloqueia mensagens que possam tornar o chat ilegível, como substituições de fontes decorativas, mesmo quando a mensagem passaria de outra forma no filtro. Os emojis não são bloqueados. Editável com /verite config como keep.chat.readable. |
block.possible.spam |
false |
Utiliza o tokenizer do Verité para detetar e bloquear possível spam e anúncios. Editável com /verite config como block.possible.spam. |
block.repeat.messages |
false |
Ativa a deteção de mensagens repetidas. Todas as chaves abaixo só se aplicam quando esta estiver ativada. |
block.repeat.exact |
true |
Bloqueia uma mensagem idêntica a uma recente do mesmo utilizador. A comparação ignora maiúsculas, acentos e letras repetidas, por isso HELLO, hello e helllo contam todas como a mesma. |
block.repeat.near |
true |
Bloqueia uma mensagem que seja semelhante (mas não idêntica) a uma recente do mesmo utilizador. O grau de semelhança que conta como correspondência é definido por block.repeat.similarity.threshold. |
block.repeat.history.size |
5 |
Quantas das mensagens mais recentes de cada utilizador são recordadas e verificadas quanto a repetições. Defina como -1 para recordar todas as mensagens, ou 0 para desativar totalmente a deteção de repetições. |
block.repeat.window.ms |
5000 |
Até que ponto no tempo (milissegundos) uma mensagem recordada ainda conta como repetição. As mensagens mais antigas do que isto são ignoradas. Defina como -1 para ignorar o tempo e recordar as mensagens indefinidamente, ou 0 para desativar totalmente a deteção de repetições. |
block.repeat.similarity.threshold |
0.85 |
Para a correspondência de quase repetições, o grau de semelhança que duas mensagens têm de ter para contar como repetição. Um valor entre 0 e 1, onde 1 significa idêntico. Mais alto é mais rigoroso (menos bloqueios); mais baixo é mais agressivo. |
block.unsupported.languages |
false |
Bloqueia idiomas que o Verité ainda não suporta. Os idiomas suportados são inglês, espanhol, francês, italiano, português e alemão. Todos os outros idiomas são bloqueados quando isto estiver ativado. Editável com /verite config como block.unsupported.languages. |
Pesos de deteção de idioma
O bloco chat.filter.advanced.language ajusta a forma como o Verité atribui um idioma a cada palavra de uma mensagem.
chat.filter:
advanced:
language:
known.word.weight: 50
unknown.word.weight: 0.1| Chave | Predefinição | Controla |
|---|---|---|
known.word.weight |
50 |
Peso para uma palavra que o dicionário de um idioma conhece mas que a tabela de taxas não lista. Mais alto significa que a pertença ao dicionário conta mais. |
unknown.word.weight |
0.1 |
Peso mínimo para uma palavra que nenhum dicionário conhece e que a tabela de taxas omite. |
Passagens de evasão
O bloco chat.filter.advanced.evasion alterna as passagens que desfazem as tentativas de fazer passar conteúdo pelo filtro. Cada uma predefine-se para true. Desativar passagens pode reduzir ligeiramente a latência.
chat.filter:
advanced:
evasion:
homoglyph: true
entity: true
deobfuscate: true
segmentation: true
fingerprint: true| Chave | Predefinição | Controla |
|---|---|---|
homoglyph |
true |
Reconverte para ASCII as falsificações de letras de largura total, cirílicas e math-bold. Editável com /verite config como evasion.homoglyph. |
entity |
true |
Remove entidades HTML e codificações semelhantes. Editável com /verite config como evasion.entity. |
deobfuscate |
true |
Reverte a ofuscação com caracteres inseridos e letras espaçadas. Editável com /verite config como evasion.deobfuscate. |
segmentation |
true |
Divide palavras coladas de novo em palavras separadas. Editável com /verite config como evasion.segmentation. |
fingerprint |
true |
Apanha grafias com letras trocadas. Editável com /verite config como evasion.fingerprint. |
Confiança de palavrões
O bloco chat.filter.advanced.use.profanity.confidence define a confiança mínima antes de uma mensagem ser tratada como palavrão.
chat.filter:
advanced:
use.profanity.confidence:
enabled: true
profanity.confidence.threshold: 0.30| Chave | Predefinição | Controla |
|---|---|---|
enabled |
true |
Ativa o limiar de confiança de palavrões. Editável com /verite config como use.profanity.confidence.enabled. |
profanity.confidence.threshold |
0.30 |
A confiança mínima necessária para considerar uma mensagem como palavrão. Editável com /verite config como use.profanity.confidence.profanity.confidence.threshold. |
Moderação (Veritésauver)
A secção moderation configura o sistema de moderação.
moderation:
enabled: true
use.rank.weights: true
auto.ban.alts: false
expire.warns.after: 7d
shared.ip.scan.limit: 20| Chave | Predefinição | Controla |
|---|---|---|
moderation.enabled |
true |
Ativa o módulo de moderação. Editável com /verite config como moderation.enabled, mas requer um reinício para aplicar. |
moderation.use.rank.weights |
true |
Compara o peso do grupo do LuckPerms para que o pessoal não possa castigar cargos iguais ou superiores. Os operadores são sempre tratados como o cargo mais alto, independentemente do peso do LuckPerms. |
moderation.auto.ban.alts |
false |
Bane automaticamente as alts de um jogador banido, independentemente de o jogador ter sido banido por IP. Desaconselhado em servidores que partilham endereços IP entre utilizadores distintos. Editável com /verite config como moderation.auto.ban.alts. |
moderation.expire.warns.after |
7d |
Durante quanto tempo um aviso conta como ativo antes de caducar. |
moderation.shared.ip.scan.limit |
20 |
O número máximo de contas mostradas numa análise de IP duplicado. Editável com /verite config como moderation.shared.ip.scan.limit. |
Lista negra de comandos de silenciados
moderation.muted.command.blacklist lista os comandos que um jogador silenciado não pode utilizar.
Injeção por proxy
Numa rede com injeção por proxy, estes comandos podem não ser bloqueados pelo Verité, o que significa que um utilizador silenciado poderia ainda utilizá-los.
A lista fornecida é:
moderation:
muted.command.blacklist:
- "me"
- "say"
- "tell"
- "whisper"
- "reply"
- "pm"
- "message"
- "msg"
- "msgall"
- "tellall"
- "speak"
- "emsg"
- "epm"
- "etell"
- "ewhisper"
- "w"
- "m"
- "t"
- "r"
- "mail"Isenção
O bloco moderation.exempt controla como as comparações de peso de cargo tratam alvos de peso igual.
moderation:
exempt:
use.group.weights: false
permit.same.weight: true| Chave | Predefinição | Controla |
|---|---|---|
use.group.weights |
false |
Permite atuar sobre um alvo de peso igual quando os pesos de grupo estão em uso. Editável com /verite config como moderation.exempt.use.group.weights. |
permit.same.weight |
true |
Permite atuar sobre um alvo do mesmo peso. Editável com /verite config como moderation.exempt.permit.same.weight. |
Modelos de mensagens de castigo
moderation.punish.message.templates define o texto mostrado aos jogadores castigados e ao pessoal. Os modelos suportam \n (nova linha) e os quantificadores @duration, @enforcer, @target, @reason, @punishment, @total.warns e @remaining. Se nenhum motivo tiver sido definido, @reason é substituído por No reason provided.
moderation:
punish.message.templates:
ban.template.temporary: {You have been banned for @duration.\n@reason}
ban.template.permanent: {You have been permanently banned.\n@reason}
mute.template.temporary: {You have been muted by @enforcer for @duration.\n@reason}
mute.template.permanent: {You have been muted by @enforcer.\n@reason}
mute.notice: {You are muted. Time remaining: @remaining}
mute.notice.permanent: {You are muted.}
warn.template: {You have been warned by @enforcer. Active warnings: @total.warns\n@reason}
kick.template: {You have been kicked by @enforcer.\n@reason}
admin.receipt.template: {@target was @punishment by @enforcer.\n@reason}| Chave | Predefinição |
|---|---|
ban.template.temporary |
{You have been banned for @duration.\n@reason} |
ban.template.permanent |
{You have been permanently banned.\n@reason} |
mute.template.temporary |
{You have been muted by @enforcer for @duration.\n@reason} |
mute.template.permanent |
{You have been muted by @enforcer.\n@reason} |
mute.notice |
{You are muted. Time remaining: @remaining} |
mute.notice.permanent |
{You are muted.} |
warn.template |
{You have been warned by @enforcer. Active warnings: @total.warns\n@reason} |
kick.template |
{You have been kicked by @enforcer.\n@reason} |
admin.receipt.template |
{@target was @punishment by @enforcer.\n@reason} |
Árvore de castigos
O bloco moderation.tree define as categorias de castigo, os passos de escalada dentro de cada categoria e que grupos do pessoal podem aplicar que categorias. Cada categoria aplica os seus castigos por ordem. Os tipos de castigo suportados são warn, mute, kick e ban. Uma duração após dois pontos (por exemplo ban: 14d) torna esse passo temporário; o mesmo tipo sem duração é permanente. A entrada final minecraft: de cada categoria é o item mostrado para essa categoria na GUI de castigos.
moderation:
tree:
enabled: true
use.fields: true| Chave | Predefinição | Controla |
|---|---|---|
moderation.tree.enabled |
true |
Ativa a árvore de castigos. |
moderation.use.fields |
true |
Utiliza os Fields do Minecraft 1.21.7+ para a conclusão do castigo em vez do chat. |
Permissões
moderation.tree.permissions.luckperms mapeia nomes de grupos do LuckPerms para as categorias que podem aplicar. A hierarquia é suportada de cima para baixo: se os seus grupos forem helper, depois mod, depois admin, o admin herda as categorias de mod e helper, e o mod herda as categorias de helper. Substitua os nomes dos grupos pelos seus.
moderation:
tree:
permissions:
luckperms:
helper: {harassment, threats, spam, advertising, macroing, misinformation, inappropriate.content}
mod: {exploiting, discrimination, impersonation}
admin: {hacking, fraud, evading.punishment, inappropriate.username, inappropriate.skin, griefing}| Grupo | Categorias concedidas |
|---|---|
helper |
harassment, threats, spam, advertising, macroing, misinformation, inappropriate.content |
mod |
exploiting, discrimination, impersonation |
admin |
hacking, fraud, evading.punishment, inappropriate.username, inappropriate.skin, griefing |
Categorias
moderation.tree.categories lista cada categoria e os seus passos de escalada ordenados.
moderation:
tree:
categories:
harassment: {kick, ban: 14d, ban, minecraft:nether_star}
threats: {mute: 5h, ban: 14d, ban, minecraft:tnt}
spam: {warn, mute: 10m, mute: 1h, ban: 3d, ban, minecraft:cactus}
advertising: {mute: 1d, ban: 3d, ban, minecraft:redstone_block}
macroing: {warn, kick, ban: 7d, ban: 31d, ban, minecraft:redstone_torch}
misinformation: {warn, mute: 20m, mute: 1h, ban: 3d, ban, minecraft:paper}
inappropriate.content: {warn, mute: 1h, mute: 7h, ban: 7d, ban, minecraft:book}
exploiting: {warn, warn, warn, ban: 2d, ban, minecraft:lever}
discrimination: {ban: 31d, ban, minecraft:iron_sword}
impersonation: {ban: 7d, ban, minecraft:player_head}
hacking: {ban: 31d, ban, minecraft:diamond_sword}
fraud: {ban: 31d, ban, minecraft:gold_ingot}
evading.punishment: {ban: 31d, ban, minecraft:ender_pearl}
inappropriate.username: {ban, minecraft:name_tag}
inappropriate.skin: {ban, minecraft:leather_chestplate}
griefing: {ban: 7d, ban, minecraft:stone_pickaxe}
staff.disruption: {warn, kick, ban: 7d, minecraft:bottle_o_enchanting}
chat.violation: {warn, mute: 1h, ban: 3d, minecraft:book_and_quill}| Categoria | Passos de escalada | Item da GUI |
|---|---|---|
harassment |
kick, ban: 14d, ban |
minecraft:nether_star |
threats |
mute: 5h, ban: 14d, ban |
minecraft:tnt |
spam |
warn, mute: 10m, mute: 1h, ban: 3d, ban |
minecraft:cactus |
advertising |
mute: 1d, ban: 3d, ban |
minecraft:redstone_block |
macroing |
warn, kick, ban: 7d, ban: 31d, ban |
minecraft:redstone_torch |
misinformation |
warn, mute: 20m, mute: 1h, ban: 3d, ban |
minecraft:paper |
inappropriate.content |
warn, mute: 1h, mute: 7h, ban: 7d, ban |
minecraft:book |
exploiting |
warn, warn, warn, ban: 2d, ban |
minecraft:lever |
discrimination |
ban: 31d, ban |
minecraft:iron_sword |
impersonation |
ban: 7d, ban |
minecraft:player_head |
hacking |
ban: 31d, ban |
minecraft:diamond_sword |
fraud |
ban: 31d, ban |
minecraft:gold_ingot |
evading.punishment |
ban: 31d, ban |
minecraft:ender_pearl |
inappropriate.username |
ban |
minecraft:name_tag |
inappropriate.skin |
ban |
minecraft:leather_chestplate |
griefing |
ban: 7d, ban |
minecraft:stone_pickaxe |
staff.disruption |
warn, kick, ban: 7d |
minecraft:bottle_o_enchanting |
chat.violation |
warn, mute: 1h, ban: 3d |
minecraft:book_and_quill |
Invsee
A secção invsee controla a visualização de inventário.
invsee:
enable-offline-player-support: true
enable-unknown-player-support: true
tabcomplete-offline-players: true| Chave | Predefinição | Controla |
|---|---|---|
invsee.enable-offline-player-support |
true |
Permite ver o inventário de jogadores offline. |
invsee.enable-unknown-player-support |
true |
Permite ver o inventário de jogadores que nunca foram vistos antes. |
invsee.tabcomplete-offline-players |
true |
Inclui jogadores offline na conclusão por tabulação. |
Vanish (Veritévoiler)
A secção vanish configura o sistema de vanish. O bloco vanish.features alterna comportamentos individuais, cada um predefinido para true. Cada chave de funcionalidade é editável com /verite config como vanish.features.<name>.
vanish:
enabled: true
features:
fake.message: true
actionbar: true
self.view: true
fly: true
invulnerability: true
effects: true
gamemode: true
ride.entity: true
silent.container: true
inventory.inspect: true
server.ping: true
ghost: true
prevent.chat: true
prevent.pickup: true
prevent.drop: true
prevent.interact: true
prevent.block.break: true
prevent.block.place: true
prevent.target: true
prevent.damage: true
prevent.food: true
prevent.buckets: true
prevent.advancement: true
prevent.projectiles: true
muffle.sounds: true
muffle.particles: true| Chave | Predefinição | Controla |
|---|---|---|
vanish.enabled |
true |
Ativa o módulo de vanish. Editável com /verite config como vanish.enabled, mas requer um reinício para aplicar. |
vanish.features.fake.message |
true |
Mostra uma mensagem falsa de entrada ou saída ao entrar ou sair do vanish. |
vanish.features.actionbar |
true |
Mostra um lembrete persistente na action bar enquanto está em vanish. |
vanish.features.self.view |
true |
Permite que o jogador em vanish continue a ver-se a si próprio. |
vanish.features.fly |
true |
Concede voo enquanto está em vanish. |
vanish.features.invulnerability |
true |
Torna o jogador em vanish invulnerável. |
vanish.features.effects |
true |
Aplica os efeitos de poção relacionados com o vanish. |
vanish.features.gamemode |
true |
Gere o modo de jogo do jogador enquanto está em vanish. |
vanish.features.ride.entity |
true |
Permite que o jogador em vanish monte entidades. |
vanish.features.silent.container |
true |
Abre contentores silenciosamente enquanto está em vanish. |
vanish.features.inventory.inspect |
true |
Permite inspecionar inventários enquanto está em vanish. |
vanish.features.server.ping |
true |
Ajusta a contribuição do jogador para a lista de ping do servidor enquanto está em vanish. |
vanish.features.ghost |
true |
Oculta o jogador em vanish como um fantasma para que passe despercebido. |
vanish.features.prevent.chat |
true |
Impede que o jogador em vanish envie mensagens no chat. |
vanish.features.prevent.pickup |
true |
Impede que o jogador em vanish apanhe itens. |
vanish.features.prevent.drop |
true |
Impede que o jogador em vanish largue itens. |
vanish.features.prevent.interact |
true |
Impede que o jogador em vanish interaja com o mundo. |
vanish.features.prevent.block.break |
true |
Impede que o jogador em vanish parta blocos. |
vanish.features.prevent.block.place |
true |
Impede que o jogador em vanish coloque blocos. |
vanish.features.prevent.target |
true |
Impede que os mobs tenham como alvo o jogador em vanish. |
vanish.features.prevent.damage |
true |
Impede que o jogador em vanish inflija ou receba dano. |
vanish.features.prevent.food |
true |
Impede que o nível de fome do jogador em vanish mude. |
vanish.features.prevent.buckets |
true |
Impede que o jogador em vanish utilize baldes. |
vanish.features.prevent.advancement |
true |
Impede que o jogador em vanish obtenha progressos. |
vanish.features.prevent.projectiles |
true |
Impede que o jogador em vanish lance projéteis. |
vanish.features.muffle.sounds |
true |
Silencia os sons que o jogador em vanish produziria de outra forma. |
vanish.features.muffle.particles |
true |
Silencia as partículas que o jogador em vanish produziria de outra forma. |
Entrada e saída falsas
A secção fake.connect configura os comandos /fakejoin e /fakeleave, que difundem uma mensagem de ligação falsa sem que ninguém entre ou saia de facto.
fake.connect:
enabled: true
join.message: "&#FFFF55%player% joined the game"
leave.message: "&#FFFF55%player% left the game"| Chave | Predefinição | Controla |
|---|---|---|
fake.connect.enabled |
true |
Ativa ou desativa os comandos /fakejoin e /fakeleave. Quando desativado, ambos os comandos recusam de forma educada. |
fake.connect.join.message |
&#FFFF55%player% joined the game |
A mensagem difundida por /fakejoin. Suporta códigos & e hexadecimal &#RRGGBB. %player% é substituído pelo nome do jogador escolhido. |
fake.connect.leave.message |
&#FFFF55%player% left the game |
A mensagem difundida por /fakeleave. Suporta códigos & e hexadecimal &#RRGGBB. %player% é substituído pelo nome do jogador escolhido. |