Référence de l’intégration Skript

Avec Verité et Skript tous deux installés, Verité enregistre automatiquement un addon Skript et sa syntaxe devient disponible sans configuration. Chaque élément délègue à la même surface publique teacommontea.api documentée dans la Référence de l’API développeur, de sorte qu’un script voit exactement ce que le plugin applique.

Cette page liste chaque condition, effet, expression, événement et valeur d’événement enregistrés, regroupés par type, avec le motif réellement enregistré pour chacun. Les parties facultatives apparaissent entre [crochets] et les choix entre (a|b), conformément à la grammaire de motifs propre à Skript. Un - en tête d’un type (par exemple %-player%) marque cet argument comme facultatif.

Deux sujets ont des guides dédiés qui montrent ces éléments dans un gestionnaire de chat fonctionnel :

• Filtrer le contenu du chat : Intégration d’un chat personnalisé.
• Appliquer les sourdines, le mode lent et le gel : Application de la modération personnalisée.

Conditions

Réduit au silence, banni, invisible, en captcha

Ce sont des conditions de propriété de joueur, elles prennent donc en charge la grammaire standard is / is not de Skript et les cibles au pluriel.

%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

Gel du chat et mode lent

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

is rate limited et is on slowmode sont deux formulations de la même vérification de mode lent. Les trois correspondent aux barrières de modération et envoient un avis au joueur en effet de bord, alors utilisez-les dans un gestionnaire de chat où vous comptez arrêter le message, et non simplement pour lire l’état. chat is frozen correspond à VeriteModeration.chatMuteGate ; les formulations de mode lent correspondent à VeriteModeration.slowmodeGate.

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

Texte bloqué par le filtre

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

Sans joueur, il s’agit d’une classification pure qui n’enregistre rien, sûre pour analyser des panneaux, des titres de livres ou des renommages d’enclume. Avec for %player%, il enregistre aussi le signalement contre ce joueur, à l’image du filtrage de chat en direct. Ceci indique seulement si le texte est bloqué ; utilisez l’expression de résultat de filtre ci-dessous pour distinguer les grossièretés de l’automutilation ou de l’abus. Soutenu par VeriteFilter. Voir Intégration d’un chat personnalisé.

Sanction émise ou retirée

Utilisable à l’intérieur de l’événement verite punishment pour distinguer une émission d’un retrait.

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

Lit l’indicateur de retrait de l’événement en cours. En dehors de l’événement, il vaut toujours faux.

Effets

Émettre une sanction

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 intervalle de temps rend un bannissement ou une sourdine temporaire ; l’omettre le rend permanent. Le kick et le warn ne prennent pas d’intervalle de temps. by %player% définit l’exécuteur ; omis, la sanction est émise en tant que console. Le silently final active l’indicateur silencieux afin que la sanction ne soit pas diffusée. La cible doit être un joueur en ligne, puisque l’effet en résout l’uuid et le nom. Soutenu par VeriteModeration.ban / mute / kick / warn.

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

Lever une sanction

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% enregistre qui l’a levée ; omis, c’est enregistré en tant que console. La cible doit être en ligne. Soutenu par VeriteModeration.unban / unmute / unwarn.

Analyser un texte et enregistrer le signalement

check %string% for %player%

Fait passer un message par le filtre et enregistre tout signalement contre le joueur, exactement comme le fait le filtrage de chat en direct, sans renvoyer le verdict. C’est le compagnon « lance et oublie » de la condition « blocked » et de l’expression de résultat de filtre. Soutenu par VeriteFilter.check.

Émettre un captcha

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

Démarre immédiatement un captcha standard ou détaillé, étiqueté avec une source facultative enregistrant la raison de son ouverture. L’étiquette prend une valeur générique par défaut lorsqu’elle est omise. Soutenu par VeriteCaptcha.challengeStandard / challengeDetailed.

Verrouillage du serveur

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

Scelle le serveur derrière un verrouillage avec une raison facultative, ou le lève. La raison prend une étiquette générique par défaut. Soutenu par VeriteLockdown.begin / end. Voir Application de la modération personnalisée.

Expressions

Résultat de filtre d’un message

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

Renvoie la classification du filtre sous forme de chaîne en minuscules : clean, block, profanity, self_harm ou abuse. C’est la seule syntaxe de filtre qui préserve la distinction entre un contenu bloqué ordinaire et un locuteur qui pourrait être en crise ou victime, alors dirigez self_harm et abuse vers une réponse d’accompagnement plutôt que vers une sanction. Sans joueur, elle n’enregistre rien ; avec for %player%, elle enregistre aussi le signalement. Soutenu par VeriteFilter.check et 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

Message de blocage du filtre

block message

Renvoie le message configuré affiché lorsqu’un message de chat est bloqué. Soutenu par VeriteFilter.blockMessage.

Nombre de signalements du filtre

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

Renvoie combien de fois le filtre a signalé un joueur. Renvoie 0 pour un joueur sans dossier. Soutenu par VeriteFilter.count.

Détails d’un bannissement ou d’une sourdine actifs

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

Sans with reason, l’expression renvoie le temps restant en millisecondes, ou -1 pour une sanction permanente. Avec with reason, elle renvoie le texte de la raison de la sanction. Ne renvoie rien lorsqu’il n’y a aucune sanction active de ce type. Soutenu par VeriteModeration.activeBan / activeMute.

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

Champs d’une valeur de sanction

[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%

Lit un champ d’une valeur de sanction Verité, surtout utile à l’intérieur de l’événement verite punishment. type est le type de sanction en minuscules (ban, mute, warning, kick). target uuid est l’uuid du joueur affecté sous forme de chaîne, ou rien pour une sanction portée sur une ip. length est la durée totale en millisecondes, ou -1 pour une sanction permanente. Soutenu par les accesseurs publics de Punishment.

État d’invisibilité

Une propriété booléenne modifiable.

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

La lecture renvoie si le joueur est invisible. Régler sur true le rend invisible, false le rend de nouveau visible. Seul le mode de modification par affectation est pris en charge. Soutenu par VeriteVanish.isVanished / vanish / unvanish.

set vanish state of player to true

Recherches de nom et d’uuid connus

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

name of renvoie le dernier nom d’utilisateur connu que Verité a enregistré pour un joueur. uuid of résout un nom d’utilisateur en l’uuid que Verité a enregistré en dernier pour lui (sous forme de chaîne), ce qui fonctionne pour les noms hors ligne ou jamais connectés dans l’annuaire de Verité. Les deux ne renvoient rien lorsqu’ils sont inconnus. Soutenu par VeritePlayerData.nameOf / uuidByName.

Pays GeoIP

[get] country of %string%

Renvoie le nom du pays que Verité résout pour une chaîne d’ip, ou rien lorsque l’ip ne peut pas être résolue, que la base de données est indisponible, ou que l’adresse est privée. Soutenu par VeriteGeoIp.country.

Temps élégant

[get] fancy time of %number%

Formate un décompte en millisecondes en une durée lisible par un humain, dans le style propre à Verité, correspondant à la formulation que le plugin utilise pour les durées de sanction et les temps restants. Soutenu par VeriteFormat.fancyTime.

Événement

Verité enregistre un événement Bukkit afin que les scripts puissent réagir aux sanctions.

on verite punishment:

L’événement se déclenche lorsqu’une sanction est émise et lorsqu’une est levée, graciée ou expirée. Utilisez la condition verite punishment was removed / was issued pour distinguer les deux, et les expressions de champs de sanction pour lire l’enregistrement.

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

Valeurs d’événement

À l’intérieur de l’événement verite punishment, la sanction est exposée comme valeur d’événement.

Le type Verite Punishment est enregistré sous le motif (verite ?)?punishments?, de sorte que punishment et verite punishment le nomment tous deux. Lisez ses champs avec les expressions de champs de sanction ci-dessus.