Riferimento della configurazione

Questa pagina documenta ogni chiave nel config.yml di Verité. I valori predefiniti mostrati sono quelli con cui Verité viene distribuito. Le chiavi di configurazione, i valori e il codice appaiono esattamente come sono scritti nel file (ASCII), mentre la prosa utilizza il nome accentato Verité.

La configurazione di Verité è raggruppata in moduli:

  • general: impostazioni valide per l'intero plugin.
  • chat.filter: il filtro chat, Veritédoux.
  • moderation: il sistema di moderazione, Veritésauver.
  • invsee: visualizzazione dell'inventario.
  • vanish: il sistema di vanish, Veritévoiler.

Modificare i flag da gioco

Molte di queste chiavi possono essere lette e modificate da gioco con /verite config, che aggiorna la singola chiave su disco e mantiene ogni commento nel file. Questo comando è protetto dal permesso veritedoux.flag. Ogni chiave vero o falso e ogni chiave numerica in config.yml può essere modificata in questo modo, usando il nome breve o il percorso completo con i punti. Le chiavi di testo libero, gli elenchi dell’albero delle sanzioni e config.language non sono modificabili così; cambiale nel file o dal pannello web. Esegui /verite config senza argomenti per elencare tutte le chiavi modificabili. La maggior parte delle modifiche si applica in tempo reale; i gate dei moduli (chat.filter.enabled, moderation.enabled, vanish.enabled) e i due flag di aggiornamento automatico richiedono un riavvio per avere effetto.

General

La sezione general contiene le impostazioni valide per l'intero plugin.

general:
  prefix: "<#808080>[<#B1C7F0>Verité<#808080>]<reset>"
  auto.update.config: true
  dashboard.url: "https://verite.gg"
Chiave Predefinito Controlla
general.prefix <#808080>[<#B1C7F0>Verité<#808080>]<reset> Il prefisso pubblico su ogni messaggio di Verité, nel formato di tag Verite.
general.auto.update.config true Aggiunge automaticamente le nuove chiavi alla configurazione quando il plugin viene aggiornato. Non aggira gli aggiornamenti del tokenizer. Modificabile con /verite config come auto.update.config, ma richiede un riavvio per essere applicato.
general.dashboard.url https://verite.gg Dove ti manda /verite dashboard. Cambialo solo se ospiti il Pannello per conto tuo.
config.language en La lingua in cui funziona l’intero plugin. Una tra en, es, fr, it, pt o de. Cambiarla richiede un riavvio completo, non un ricaricamento.

Filtro chat (Veritédoux)

La sezione chat.filter configura il filtraggio dei messaggi.

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."
Chiave Predefinito Controlla
chat.filter.enabled true Abilita il modulo del filtro chat. Modificabile con /verite config come chat.filter.enabled, ma richiede un riavvio per essere applicato.
chat.filter.auto.update.eve false Aggiorna automaticamente i file di configurazione .eve quando vengono aggiunte nuove voci. Quando è abilitato, le voci personalizzate vengono sovrascritte o scartate quando i file .eve vengono sostituiti con versioni aggiornate. Modificabile con /verite config come auto.update.eve, ma richiede un riavvio per essere applicato.
chat.filter.block.message @prefix Your message wasn't sent. Please keep chat friendly. L'avviso mostrato quando un messaggio viene bloccato dal filtro. Supporta i codici & e l'esadecimale &#RRGGBB. Usa @prefix per inserire il prefisso scelto.
chat.filter.repeat.message @prefix You've already sent that message. Please wait a moment before repeating yourself. L'avviso mostrato quando un messaggio viene bloccato come ripetizione. Supporta i codici &, l'esadecimale &#RRGGBB e @prefix.

Messaggio di autolesionismo

Il messaggio di blocco per l'autolesionismo non può essere modificato. Questo garantisce che agli utenti venga sempre offerta la giusta guida e il giusto supporto quando si tratta di contenuti relativi all'autolesionismo.

Lingue

Il blocco chat.filter.general.lang sceglie quali lingue vengono controllate a livello di contenuto e quali categorie di rilevamento sono attive per ciascuna. Il rilevamento delle parolacce è disabilitato per impostazione predefinita, così che i server che permettono un turpiloquio informale non ne siano influenzati. Regolale in base alla tolleranza del tuo server.

Ogni blocco di lingua supporta queste chiavi:

Chiave Predefinito Controlla
allowed true Se la lingua è consentita in chat.
self.harm.detection true Rileva i contenuti relativi all'autolesionismo in questa lingua.
abuse.detection true Rileva i contenuti offensivi in questa lingua.
slur.detection true Rileva gli insulti in questa lingua.

Le chiavi delle parolacce sono per lingua. Ciascuna è false per impostazione predefinita. Imposta una su true per segnalare le parolacce di quel dialetto o di quella regione.

Lingua Chiavi delle parolacce (tutte predefinite 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

Due voci aggiuntive coprono il testo la cui lingua non può essere risolta:

Chiave Predefinito Controlla
chat.filter.general.lang.unknown.lang.allowed true Se i messaggi in una lingua che Verité non riconosce sono consentiti.
chat.filter.general.lang.undeterminable.allowed true Se i messaggi la cui lingua non può essere determinata sono consentiti.

Un esempio di blocco di lingua:

chat.filter:
  general.lang:
    english:
      allowed: true
      self.harm.detection: true
      abuse.detection: true
      slur.detection: true
      profanity.global: false

Avanzate

Il blocco chat.filter.advanced contiene la regolazione per la leggibilità, lo spam e il rilevamento delle ripetizioni.

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
Chiave Predefinito Controlla
keep.chat.readable false Blocca i messaggi che potrebbero rendere la chat illeggibile, come le sostituzioni con font decorativi, anche quando il messaggio supererebbe altrimenti il filtro. Gli emoji non vengono bloccati. Modificabile con /verite config come keep.chat.readable.
block.possible.spam false Usa il tokenizer di Verité per rilevare e bloccare possibili spam e pubblicità. Modificabile con /verite config come block.possible.spam.
block.repeat.messages false Abilita il rilevamento dei messaggi ripetuti. Ogni chiave sottostante si applica solo quando questo è abilitato.
block.repeat.exact true Blocca un messaggio identico a uno recente dello stesso utente. Il confronto ignora maiuscole, accenti e lettere ripetute, così HELLO, hello e helllo contano tutti come lo stesso messaggio.
block.repeat.near true Blocca un messaggio simile (ma non identico) a uno recente dello stesso utente. Quanto simile debba essere per contare come corrispondenza è impostato da block.repeat.similarity.threshold.
block.repeat.history.size 5 Quanti dei messaggi più recenti di ciascun utente vengono ricordati e controllati per le ripetizioni. Imposta a -1 per ricordare tutti i messaggi, oppure a 0 per disabilitare del tutto il rilevamento delle ripetizioni.
block.repeat.window.ms 5000 Fino a quanto indietro nel tempo (millisecondi) un messaggio ricordato conta ancora come ripetizione. I messaggi più vecchi di questo valore vengono ignorati. Imposta a -1 per ignorare il tempo e ricordare i messaggi a tempo indeterminato, oppure a 0 per disabilitare del tutto il rilevamento delle ripetizioni.
block.repeat.similarity.threshold 0.85 Per la corrispondenza delle quasi-ripetizioni, quanto due messaggi devono essere simili per contare come ripetizione. Un valore tra 0 e 1, dove 1 significa identici. Più alto è più rigoroso (meno blocchi); più basso è più aggressivo.
block.unsupported.languages false Blocca le lingue che Verité non supporta ancora. Le lingue supportate sono inglese, spagnolo, francese, italiano, portoghese e tedesco. Tutte le altre lingue vengono bloccate quando questo è abilitato. Modificabile con /verite config come block.unsupported.languages.

Pesi di rilevamento della lingua

Il blocco chat.filter.advanced.language regola il modo in cui Verité assegna una lingua a ciascuna parola di un messaggio.

chat.filter:
  advanced:
    language:
      known.word.weight: 50
      unknown.word.weight: 0.1
Chiave Predefinito Controlla
known.word.weight 50 Peso per una parola che il dizionario di una lingua conosce ma che la tabella dei tassi non elenca. Più alto significa che l'appartenenza al dizionario conta di più.
unknown.word.weight 0.1 Peso minimo per una parola che nessun dizionario conosce e che la tabella dei tassi omette.

Passaggi anti-evasione

Il blocco chat.filter.advanced.evasion attiva o disattiva i passaggi che annullano i tentativi di far passare contenuti oltre il filtro. Ciascuno è true per impostazione predefinita. Disabilitare i passaggi può ridurre leggermente la latenza.

chat.filter:
  advanced:
    evasion:
      homoglyph: true
      entity: true
      deobfuscate: true
      segmentation: true
      fingerprint: true
Chiave Predefinito Controlla
homoglyph true Ripiega su ASCII le contraffazioni con lettere a larghezza intera, cirilliche e in grassetto matematico. Modificabile con /verite config come evasion.homoglyph.
entity true Rimuove le entità HTML e codifiche simili. Modificabile con /verite config come evasion.entity.
deobfuscate true Inverte l'offuscamento con caratteri inseriti e lettere spaziate. Modificabile con /verite config come evasion.deobfuscate.
segmentation true Separa nuovamente le parole unite in parole distinte. Modificabile con /verite config come evasion.segmentation.
fingerprint true Individua le grafie con lettere trasposte. Modificabile con /verite config come evasion.fingerprint.

Confidenza sulle parolacce

Il blocco chat.filter.advanced.use.profanity.confidence imposta la confidenza minima prima che un messaggio venga trattato come volgare.

chat.filter:
  advanced:
    use.profanity.confidence:
      enabled: true
      profanity.confidence.threshold: 0.30
Chiave Predefinito Controlla
enabled true Abilita la soglia di confidenza sulle parolacce. Modificabile con /verite config come use.profanity.confidence.enabled.
profanity.confidence.threshold 0.30 La confidenza minima richiesta per considerare un messaggio volgare. Modificabile con /verite config come use.profanity.confidence.profanity.confidence.threshold.

Moderazione (Veritésauver)

La sezione moderation configura il sistema di moderazione.

moderation:
  enabled: true
  use.rank.weights: true
  auto.ban.alts: false
  expire.warns.after: 7d
  shared.ip.scan.limit: 20
Chiave Predefinito Controlla
moderation.enabled true Abilita il modulo di moderazione. Modificabile con /verite config come moderation.enabled, ma richiede un riavvio per essere applicato.
moderation.use.rank.weights true Confronta il peso del gruppo LuckPerms così lo staff non può punire ranghi uguali o superiori. Gli operatori sono sempre trattati come il rango più alto, a prescindere dal peso LuckPerms.
moderation.auto.ban.alts false Banna automaticamente gli alt di un giocatore bannato, a prescindere dal fatto che il giocatore sia stato bannato per IP. Sconsigliato sui server che condividono indirizzi IP tra utenti distinti. Modificabile con /verite config come moderation.auto.ban.alts.
moderation.expire.warns.after 7d Per quanto tempo un avvertimento conta come attivo prima di decadere.
moderation.shared.ip.scan.limit 20 Il numero massimo di account mostrati in una scansione degli IP duplicati. Modificabile con /verite config come moderation.shared.ip.scan.limit.

Blacklist dei comandi in mute

moderation.muted.command.blacklist elenca i comandi che un giocatore mutato non può usare.

Injection del proxy

Su una rete con injection del proxy, questi comandi potrebbero non essere bloccati da Verité, il che significa che un utente mutato potrebbe comunque usarli.

L'elenco distribuito è:

moderation:
  muted.command.blacklist:
    - "me"
    - "say"
    - "tell"
    - "whisper"
    - "reply"
    - "pm"
    - "message"
    - "msg"
    - "msgall"
    - "tellall"
    - "speak"
    - "emsg"
    - "epm"
    - "etell"
    - "ewhisper"
    - "w"
    - "m"
    - "t"
    - "r"
    - "mail"

Exempt

Il blocco moderation.exempt controlla come i confronti tra i pesi dei ranghi trattano i bersagli di pari peso.

moderation:
  exempt:
    use.group.weights: false
    permit.same.weight: true
Chiave Predefinito Controlla
use.group.weights false Consente di agire su un bersaglio di pari peso quando sono in uso i pesi dei gruppi. Modificabile con /verite config come moderation.exempt.use.group.weights.
permit.same.weight true Permette di agire su un bersaglio dello stesso peso. Modificabile con /verite config come moderation.exempt.permit.same.weight.

Modelli dei messaggi di punizione

moderation.punish.message.templates imposta il testo mostrato ai giocatori puniti e allo staff. I modelli supportano \n (a capo) e i quantificatori @duration, @enforcer, @target, @reason, @punishment, @total.warns e @remaining. Se non è stato impostato alcun motivo, @reason viene sostituito con 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}
Chiave Predefinito
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}

Albero delle punizioni

Il blocco moderation.tree definisce le categorie di punizione, i passaggi di escalation all'interno di ciascuna categoria e quali gruppi dello staff possono applicare quali categorie. Ogni categoria applica le sue punizioni in ordine. I tipi di punizione supportati sono warn, mute, kick e ban. Una durata dopo i due punti (per esempio ban: 14d) rende quel passaggio temporaneo; lo stesso tipo senza durata è permanente. La voce finale minecraft: in ogni categoria è l'oggetto mostrato per quella categoria nella GUI delle punizioni.

moderation:
  tree:
    enabled: true
    use.fields: true
Chiave Predefinito Controlla
moderation.tree.enabled true Abilita l'albero delle punizioni.
moderation.use.fields true Usa i Fields di Minecraft 1.21.7+ per il completamento della punizione anziché la chat.

Permessi

moderation.tree.permissions.luckperms mappa i nomi dei gruppi LuckPerms alle categorie che possono applicare. La gerarchia è supportata dall'alto verso il basso: se i tuoi gruppi sono helper poi mod poi admin, admin eredita le categorie di mod e helper, e mod eredita le categorie di helper. Sostituisci i nomi dei gruppi con i tuoi.

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}
Gruppo Categorie concesse
helper harassment, threats, spam, advertising, macroing, misinformation, inappropriate.content
mod exploiting, discrimination, impersonation
admin hacking, fraud, evading.punishment, inappropriate.username, inappropriate.skin, griefing

Categorie

moderation.tree.categories elenca ciascuna categoria e i suoi passaggi di escalation ordinati.

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 Passaggi di escalation Oggetto 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

La sezione invsee controlla la visualizzazione dell'inventario.

invsee:
  enable-offline-player-support: true
  enable-unknown-player-support: true
  tabcomplete-offline-players: true
Chiave Predefinito Controlla
invsee.enable-offline-player-support true Consente di visualizzare l'inventario dei giocatori offline.
invsee.enable-unknown-player-support true Consente di visualizzare l'inventario dei giocatori mai visti prima.
invsee.tabcomplete-offline-players true Include i giocatori offline nel completamento con tab.

Vanish (Veritévoiler)

La sezione vanish configura il sistema di vanish. Il blocco vanish.features attiva o disattiva i singoli comportamenti, ciascuno true per impostazione predefinita. Ogni chiave di funzionalità è modificabile con /verite config come 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
Chiave Predefinito Controlla
vanish.enabled true Abilita il modulo di vanish. Modificabile con /verite config come vanish.enabled, ma richiede un riavvio per essere applicato.
vanish.features.fake.message true Mostra un falso messaggio di entrata o uscita quando si entra o si esce dal vanish.
vanish.features.actionbar true Mostra un promemoria persistente nella action bar mentre si è invisibili.
vanish.features.self.view true Permette al giocatore invisibile di vedere comunque se stesso.
vanish.features.fly true Concede il volo mentre si è invisibili.
vanish.features.invulnerability true Rende invulnerabile il giocatore invisibile.
vanish.features.effects true Applica gli effetti pozione relativi al vanish.
vanish.features.gamemode true Gestisce la modalità di gioco del giocatore mentre è invisibile.
vanish.features.ride.entity true Consente al giocatore invisibile di cavalcare le entità.
vanish.features.silent.container true Apre i contenitori in silenzio mentre si è invisibili.
vanish.features.inventory.inspect true Consente di ispezionare gli inventari mentre si è invisibili.
vanish.features.server.ping true Regola il contributo del giocatore alla lista del ping del server mentre è invisibile.
vanish.features.ghost true Nasconde il giocatore invisibile come un fantasma così da passare inosservato.
vanish.features.prevent.chat true Impedisce al giocatore invisibile di inviare messaggi in chat.
vanish.features.prevent.pickup true Impedisce al giocatore invisibile di raccogliere oggetti.
vanish.features.prevent.drop true Impedisce al giocatore invisibile di lasciare cadere oggetti.
vanish.features.prevent.interact true Impedisce al giocatore invisibile di interagire con il mondo.
vanish.features.prevent.block.break true Impedisce al giocatore invisibile di rompere blocchi.
vanish.features.prevent.block.place true Impedisce al giocatore invisibile di posizionare blocchi.
vanish.features.prevent.target true Impedisce ai mob di prendere di mira il giocatore invisibile.
vanish.features.prevent.damage true Impedisce al giocatore invisibile di infliggere o subire danni.
vanish.features.prevent.food true Impedisce che il livello di fame del giocatore invisibile cambi.
vanish.features.prevent.buckets true Impedisce al giocatore invisibile di usare i secchi.
vanish.features.prevent.advancement true Impedisce al giocatore invisibile di ottenere progressi.
vanish.features.prevent.projectiles true Impedisce al giocatore invisibile di lanciare proiettili.
vanish.features.muffle.sounds true Attutisce i suoni che il giocatore invisibile produrrebbe altrimenti.
vanish.features.muffle.particles true Attutisce le particelle che il giocatore invisibile produrrebbe altrimenti.

Ingresso e uscita falsi

La sezione fake.connect configura i comandi /fakejoin e /fakeleave, che trasmettono un falso messaggio di connessione senza che nessuno entri o esca davvero.

fake.connect:
  enabled: true
  join.message: "&#FFFF55%player% joined the game"
  leave.message: "&#FFFF55%player% left the game"
Chiave Predefinito Controlla
fake.connect.enabled true Attiva o disattiva i comandi /fakejoin e /fakeleave. Quando è disattivato, entrambi i comandi rifiutano cortesemente.
fake.connect.join.message &#FFFF55%player% joined the game Il messaggio trasmesso da /fakejoin. Supporta i codici & e l'esadecimale &#RRGGBB. %player% viene sostituito con il nome del giocatore scelto.
fake.connect.leave.message &#FFFF55%player% left the game Il messaggio trasmesso da /fakeleave. Supporta i codici & e l'esadecimale &#RRGGBB. %player% viene sostituito con il nome del giocatore scelto.