Riferimento dell'integrazione Skript

Con Verité e Skript entrambi installati, Verité registra automaticamente un addon Skript e la sua sintassi diventa disponibile senza alcuna configurazione. Ogni elemento delega alla stessa superficie pubblica teacommontea.api documentata nel Riferimento dell'API per sviluppatori, così uno script vede esattamente ciò che il plugin applica.

Questa pagina elenca ogni condizione, effetto, espressione, evento e valore di evento registrato, raggruppati per tipo, con il pattern effettivamente registrato per ciascuno. Le parti opzionali appaiono in [parentesi quadre] e le scelte in (a|b), seguendo la grammatica dei pattern di Skript. Un - iniziale su un tipo (per esempio %-player%) segna quell'argomento come opzionale.

Due argomenti hanno guide dedicate che mostrano questi elementi in un gestore di chat funzionante:

• Filtrare il contenuto della chat: Integrazione della chat personalizzata.
• Applicare mute, slowmode e freeze: Applicazione della moderazione personalizzata.

Condizioni

Mutato, bannato, invisibile, in captcha

Queste sono condizioni di proprietà del giocatore, quindi supportano la grammatica standard is / is not di Skript e i bersagli plurali.

%players% (is|are) muted
%players% (is|are) banned by verite
%players% (is|are) vanished in verite
%players% (is|are) in a captcha

on chat:
    if player is in a captcha:
        cancel event

Freeze della chat e slowmode

chat is frozen [for %-player%]
%player% is rate limited
%player% is on slowmode

is rate limited e is on slowmode sono due formulazioni dello stesso controllo dello slowmode. Tutte e tre si mappano ai gate di moderazione e inviano al giocatore un avviso come effetto collaterale, quindi usale in un gestore di chat dove intendi fermare il messaggio, non solo per leggere lo stato. chat is frozen si mappa a VeriteModeration.chatMuteGate; le formulazioni dello slowmode si mappano a VeriteModeration.slowmodeGate.

on chat:
    if chat is frozen for player:
        cancel event
    else if player is on slowmode:
        cancel event

Testo bloccato dal filtro

%string% (was|is|are) blocked [for %-player%]
%string% (wasn't|was not|isn't|is not|aren't|are not) blocked [for %-player%]

Senza un giocatore è una classificazione pura che non registra nulla, sicura per scansionare cartelli, titoli di libri o rinomine all'incudine. Con for %player% registra anche la corrispondenza a carico di quel giocatore, corrispondendo al filtraggio della chat in tempo reale. Questo riporta solo se il testo è bloccato; usa l'espressione del risultato del filtro sottostante per distinguere le parolacce dall'autolesionismo o dall'abuso. Supportato da VeriteFilter. Vedi Integrazione della chat personalizzata.

Punizione emessa o rimossa

Utilizzabile all'interno dell'evento verite punishment per distinguere un'emissione da una rimozione.

[the] verite punishment was removed
[the] verite punishment was (not removed|issued)

Legge il flag di rimozione dall'evento corrente. Al di fuori dell'evento è sempre false.

Effetti

Emettere una punizione

verite ban %player% [for %-timespan%] [(with reason|for) %-string%] [by %-player%] [silent:silently]
verite mute %player% [for %-timespan%] [(with reason|for) %-string%] [by %-player%] [silent:silently]
verite kick %player% [(with reason|for) %-string%] [by %-player%] [silent:silently]
verite warn %player% [(with reason|for) %-string%] [by %-player%] [silent:silently]

Un timespan rende un ban o un mute temporaneo; ometterlo lo rende permanente. Kick e warn non accettano un timespan. by %player% imposta l'esecutore; se omesso, la punizione viene emessa come console. Il silently finale imposta il flag silenzioso così che la punizione non venga trasmessa. Il bersaglio deve essere un giocatore online, poiché l'effetto ne risolve l'uuid e il nome. Supportato da VeriteModeration.ban / mute / kick / warn.

verite ban player for 7 days with reason "spam" by {_staff} silently
verite warn player for "first offence"

Revocare una punizione

verite unban %player% [(with reason|for) %-string%] [by %-player%]
verite unmute %player% [(with reason|for) %-string%] [by %-player%]
verite unwarn %player% [(with reason|for) %-string%] [by %-player%]

by %player% registra chi l'ha revocata; se omesso, viene registrata come console. Il bersaglio deve essere online. Supportato da VeriteModeration.unban / unmute / unwarn.

Scansionare il testo e registrare la corrispondenza

check %string% for %player%

Fa passare un messaggio attraverso il filtro e registra qualsiasi corrispondenza a carico del giocatore, esattamente come fa il filtraggio della chat in tempo reale, senza restituire il verdetto. Questa è la controparte fire-and-forget della condizione blocked e dell'espressione del risultato del filtro. Supportato da VeriteFilter.check.

Emettere una sfida captcha

challenge %player% with [a] captcha [(with reason|for|from) %-string%]
challenge %player% with [a] detailed captcha [(with reason|for|from) %-string%]

Avvia immediatamente una sfida standard o dettagliata, contrassegnata con un'etichetta di origine opzionale che registra perché è stata aperta. L'etichetta è predefinita su un valore generico se omessa. Supportato da VeriteCaptcha.challengeStandard / challengeDetailed.

Blocco del server

begin message lockdown [(with reason|for) %-string%]
end message lockdown

Sigilla il server dietro un blocco con un motivo opzionale, oppure lo revoca. Il motivo è predefinito su un'etichetta generica. Supportato da VeriteLockdown.begin / end. Vedi Applicazione della moderazione personalizzata.

Espressioni

Risultato del filtro di un messaggio

filter [the] result of %string% [for %-player%]

Restituisce la classificazione del filtro come stringa in minuscolo: clean, block, profanity, self_harm o abuse. Questa è l'unica sintassi del filtro che preserva la distinzione tra normale contenuto bloccato e un interlocutore che potrebbe essere in crisi o essere danneggiato, quindi indirizza self_harm e abuse verso una risposta di supporto anziché una punizione. Senza un giocatore non registra nulla; con for %player% registra anche la corrispondenza. Supportato da VeriteFilter.check e FilterResult.

set {_result} to filter the result of {_msg} for player
if {_result} is "self_harm" or {_result} is "abuse":
    # handle with care, do not punish
    stop
if {_result} is not "clean":
    send block message to player
    stop

Messaggio di blocco del filtro

block message

Restituisce il messaggio configurato mostrato quando un messaggio di chat viene bloccato. Supportato da VeriteFilter.blockMessage.

Conteggio delle segnalazioni del filtro

[get] message flags (for|of) %player%

Restituisce quante volte il filtro ha segnalato un giocatore. Restituisce 0 per un giocatore senza record. Supportato da VeriteFilter.count.

Dettagli del ban o del mute attivo

[get] [verite] ban status of %player% [reason:with reason]
[get] [verite] mute status of %player% [reason:with reason]

Senza with reason l'espressione restituisce il tempo rimanente in millisecondi, oppure -1 per una punizione permanente. Con with reason restituisce il testo del motivo della punizione. Non restituisce nulla quando non c'è una punizione attiva di quel tipo. Supportato da VeriteModeration.activeBan / activeMute.

set {_left} to verite ban status of player
set {_why} to verite ban status of player with reason

Campi di un valore di punizione

[get] punishment type of %veritepunishment%
[get] punishment reason of %veritepunishment%
[get] punishment target uuid of %veritepunishment%
[get] punishment target ip of %veritepunishment%
[get] punishment executor name of %veritepunishment%
[get] punishment removed by name of %veritepunishment%
[get] punishment removal reason of %veritepunishment%
[get] punishment length of %veritepunishment%

Legge un campo da un valore di punizione Verité, particolarmente utile all'interno dell'evento verite punishment. type è il tipo di punizione in minuscolo (ban, mute, warning, kick). target uuid è l'uuid del giocatore interessato come stringa, oppure nulla per una punizione con scope ip. length è la durata totale in millisecondi, oppure -1 per una punizione permanente. Supportato dagli accessori pubblici di Punishment.

Stato di vanish

Una proprietà booleana impostabile.

[the] vanish state of %players%
%players%'s vanish state

La lettura restituisce se il giocatore è invisibile. Impostare a true lo rende invisibile, false lo rende visibile. È supportata solo la modalità di modifica set. Supportato da VeriteVanish.isVanished / vanish / unvanish.

set vanish state of player to true

Ricerche di nomi e uuid noti

[get] [verite] name of %player%
[get] [verite] uuid of %string%

name of restituisce l'ultimo nome utente noto che Verité ha registrato per un giocatore. uuid of risolve un nome utente nell'uuid che Verité ha registrato per ultimo per esso (come stringa), il che funziona per nomi offline o mai stati online nella directory di Verité. Entrambi non restituiscono nulla quando sconosciuti. Supportato da VeritePlayerData.nameOf / uuidByName.

Paese GeoIP

[get] country of %string%

Restituisce il nome del paese che Verité risolve per una stringa ip, oppure nulla quando l'ip non può essere risolto, il database non è disponibile o l'indirizzo è privato. Supportato da VeriteGeoIp.country.

Fancy time

[get] fancy time of %number%

Formatta un conteggio in millisecondi come durata leggibile dall'uomo nello stile di Verité, corrispondente al modo in cui il plugin descrive le durate delle punizioni e i tempi rimanenti. Supportato da VeriteFormat.fancyTime.

Evento

Verité registra un evento Bukkit così che gli script possano reagire alle punizioni.

on verite punishment:

L'evento si attiva quando una punizione viene emessa e quando una viene revocata, perdonata o scaduta. Usa la condizione verite punishment was removed / was issued per distinguere le due, e le espressioni dei campi della punizione per leggere il record.

on verite punishment:
    if the verite punishment was issued:
        broadcast "%punishment executor name of event-punishment% punished someone"

Valori di evento

All'interno dell'evento verite punishment, la punizione è esposta come valore di evento.

Il tipo Verite Punishment è registrato sotto il pattern (verite ?)?punishments?, quindi sia punishment sia verite punishment lo nominano. Leggi i suoi campi con le espressioni dei campi della punizione sopra.