/// PIMPMYRUST PLUGIN

Raid Time Protection

Guide des réglages de Raid Time Protection pour cette version. Vérifiez la fiche du plugin avant de l'utiliser sur votre serveur.

Version: 2.1.0
Framework: oxide, carbon
Fichier principal: oxide/config/RaidTimeProtection.json

Configurer →Fiche du plugin →

Préparer votre fichier

Vérifiez la version installée
Ce guide décrit Raid Time Protection 2.1.0. Le configurateur doit utiliser cette même version.
Récupérez les réglages
Cliquez sur Importer, puis Depuis mon serveur. Choisissez les fichiers et confirmez leur chargement. Sélectionner un serveur ne remplace pas le document ouvert. Vous pouvez aussi importer des fichiers de cet appareil ou une configuration depuis Mes projets.
Modifiez et envoyez
Ajustez les réglages, corrigez les erreurs, puis utilisez Envoyer pour transmettre les fichiers au serveur choisi. Un conflit bloque l’envoi jusqu’à votre décision. Vous pouvez toujours exporter seulement les fichiers dont vous avez besoin.

Les envois au serveur disposent de sauvegardes privées. Enregistrer conserve votre travail dans Mes projets ; cette action n’envoie rien au serveur. Un téléchargement permet aussi de reprendre sans connexion.

Réglages de cette version

Général 3

Version du format

Choix · obligatoire

Repère interne du format de configuration. Conservez la valeur fournie pour cette version du plugin.

Chemin JSON

Schema Version

Valeurs possibles : 2

Décalage fixe par rapport à UTC (minutes)

Nombre entier · obligatoire

Décalage fixe de l’horaire de protection par rapport à UTC, en minutes. Exemple : 120 = UTC+2. Il ne suit pas automatiquement le changement d’heure été/hiver.

Chemin JSON

UTC Offset Minutes

Minimum : -840 · Maximum : 840

Protection après wipe (heures)

Nombre · obligatoire

Durée de protection depuis le début du wipe, en heures. Pendant cette période, elle prime sur les créneaux de raid hebdomadaires, si la protection globale est activée.

Chemin JSON

Wipe Protection Time (in hours)

Minimum : 0 · Maximum : 720

Préavis 4

Activer les préavis: Activé / désactivé
Les préavis sont désactivés par défaut.
Chemin JSON
Advance warnings → Enabled
Dans le chat: Activé / désactivé
Envoie le préavis dans la langue de chaque joueur.
Chemin JSON
Advance warnings → Chat
À l’écran: Activé / désactivé
Affiche une notification graphique avant la transition.
Chemin JSON
Advance warnings → Graphic
Délais · minutes avant: Liste
Jusqu’à 16 délais distincts, de 1 à 1 440 minutes. Les anciens préavis ne sont pas rejoués au rechargement.
Chemin JSON
Advance warnings → Minutes

Protection et planning hebdomadaire 4

Activer la protection globale: Activé / désactivé · obligatoire
Bloquer les dégâts de raid des joueurs sur les entités possédées couvertes par un privilège de construction pendant la protection. Les joueurs autorisés au TC restent exemptés. Désactiver retire les règles de wipe et d’horaires, pas les règles normales de dégâts de Rust.
Chemin JSON
Global Protection → Enabled
Annoncer les changements dans le chat: Activé / désactivé · obligatoire
Annoncer dans le chat les changements d’état de protection. Malgré le nom historique du champ, le plugin Notify n’est pas nécessaire dans cette version.
Chemin JSON
Global Protection → Show Alert (recquires Notify plugin)
Zones exclues de la protection: Valeur JSON · obligatoire
Identifiants des zones ZoneManager où la protection doit être exclue. ZoneManager est nécessaire pour cette exclusion ; son absence ne désactive pas la protection ailleurs.
Chemin JSON
Global Protection → (ZoneManager) Disabled protection zones
Entités exclues de la protection: Valeur JSON · obligatoire
Noms de prefabs à exclure de la protection. Ces entités pourront subir des dégâts même pendant une période protégée ; laissez la liste vide sans exclusion voulue.
Chemin JSON
Global Protection → Disable protection prefabs (optional)

Interface joueur 17

Afficher l’interface

Activé / désactivé

Active l’interface sans modifier les règles de protection.

Chemin JSON

Interface → Enabled

Indicateur à l’écran

Activé / désactivé

Affiche l’état horaire global et la prochaine transition.

Chemin JSON

Interface → HUD

Planning hebdomadaire

Activé / désactivé

Permet aux joueurs d’ouvrir le planning avec /raid.

Chemin JSON

Interface → Planning

Notification de raid bloqué

Activé / désactivé

Affiche une notification quand le plugin bloque un raid.

Chemin JSON

Interface → Blocked notice

Moteur d’affichage

Choix

Natif par défaut. Le mode PimpMyCUI demande un package compatible ; sinon le plugin revient au natif.

Chemin JSON

Interface → Renderer

Valeurs possibles : native, pimpmycui

Disposition

Choix

Bastion : panneau industriel ; Signal : console ; Gazette : bulletin. Classic, Compact et Contrast sont leurs anciens noms.

Chemin JSON

Interface → Template

Valeurs possibles : bastion, signal, gazette, classic, compact, contrast

Package PimpMyCUI

Texte

Nom du package installé et approuvé pour le mode PimpMyCUI.

Chemin JSON

Interface → PimpMyCUI package

Position horizontale

Nombre

Position normalisée du repère supérieur droit du HUD : de 0 à 1.

Chemin JSON

Interface → Position X

Minimum : 0 · Maximum : 1

Position verticale

Nombre

Position normalisée du repère supérieur droit du HUD : de 0 à 1.

Chemin JSON

Interface → Position Y

Minimum : 0 · Maximum : 1

Échelle

Nombre

Taille du HUD de 0,6 à 1,5. Le planning est limité à 1,1 pour rester à l’écran.

Chemin JSON

Interface → Scale

Minimum : 0.6 · Maximum : 1.5

Opacité

Nombre

Opacité du fond, de 0,2 à 1.

Chemin JSON

Interface → Opacity

Minimum : 0.2 · Maximum : 1

Fond

Texte

Couleur RGB du fond. Gazette utilise cette couleur pour son encre.

Chemin JSON

Interface → Background color

Raids bloqués

Texte

Couleur de l’état protégé.

Chemin JSON

Interface → Protected color

Raids autorisés

Texte

Couleur de l’état où les horaires autorisent les raids.

Chemin JSON

Interface → Allowed color

Texte

Couleur RGB du texte. Gazette l’utilise aussi pour son papier.

Chemin JSON

Interface → Text color

Durée des notifications · secondes

Nombre entier

Durée d’affichage des notifications, de 2 à 30 secondes.

Chemin JSON

Interface → Notice seconds

Minimum : 2 · Maximum : 30

Actualisation · secondes

Nombre entier

Actualise le compte à rebours toutes les 1 à 60 secondes. Une transition est affichée immédiatement.

Chemin JSON

Interface → Refresh seconds

Minimum : 1 · Maximum : 60

Vendredi 3

Début des raids autorisés : heure

Nombre entier · obligatoire

Heure de début du créneau où les raids sont autorisés ce jour-là (0 à 23), selon le décalage UTC choisi. Hors de ce créneau, la protection reste active.

Chemin JSON

Global Protection → Friday → Stop Protection Hours

Minimum : 0 · Maximum : 23

Début des raids autorisés : minute

Nombre entier · obligatoire

Minutes de l’heure de début du créneau de raid (0 à 59). Par exemple, heure 22 et minutes 30 donnent un début à 22:30.

Chemin JSON

Global Protection → Friday → Stop Protection Minutes

Minimum : 0 · Maximum : 59

Durée des raids autorisés (minutes)

Nombre entier · obligatoire

Durée du créneau de raid autorisé, en minutes. Il peut traverser minuit ; 0 ne crée aucun créneau pour ce jour. La protection de wipe reste prioritaire.

Chemin JSON

Global Protection → Friday → Stop Protection Duration (in minutes)

Minimum : 0 · Maximum : 1440

Lundi 3

Début des raids autorisés : heure

Nombre entier · obligatoire

Heure de début du créneau où les raids sont autorisés ce jour-là (0 à 23), selon le décalage UTC choisi. Hors de ce créneau, la protection reste active.

Chemin JSON

Global Protection → Monday → Stop Protection Hours

Minimum : 0 · Maximum : 23

Début des raids autorisés : minute

Nombre entier · obligatoire

Minutes de l’heure de début du créneau de raid (0 à 59). Par exemple, heure 22 et minutes 30 donnent un début à 22:30.

Chemin JSON

Global Protection → Monday → Stop Protection Minutes

Minimum : 0 · Maximum : 59

Durée des raids autorisés (minutes)

Nombre entier · obligatoire

Durée du créneau de raid autorisé, en minutes. Il peut traverser minuit ; 0 ne crée aucun créneau pour ce jour. La protection de wipe reste prioritaire.

Chemin JSON

Global Protection → Monday → Stop Protection Duration (in minutes)

Minimum : 0 · Maximum : 1440

Samedi 3

Début des raids autorisés : heure

Nombre entier · obligatoire

Heure de début du créneau où les raids sont autorisés ce jour-là (0 à 23), selon le décalage UTC choisi. Hors de ce créneau, la protection reste active.

Chemin JSON

Global Protection → Saturday → Stop Protection Hours

Minimum : 0 · Maximum : 23

Début des raids autorisés : minute

Nombre entier · obligatoire

Minutes de l’heure de début du créneau de raid (0 à 59). Par exemple, heure 22 et minutes 30 donnent un début à 22:30.

Chemin JSON

Global Protection → Saturday → Stop Protection Minutes

Minimum : 0 · Maximum : 59

Durée des raids autorisés (minutes)

Nombre entier · obligatoire

Durée du créneau de raid autorisé, en minutes. Il peut traverser minuit ; 0 ne crée aucun créneau pour ce jour. La protection de wipe reste prioritaire.

Chemin JSON

Global Protection → Saturday → Stop Protection Duration (in minutes)

Minimum : 0 · Maximum : 1440

Dimanche 3

Début des raids autorisés : heure

Nombre entier · obligatoire

Heure de début du créneau où les raids sont autorisés ce jour-là (0 à 23), selon le décalage UTC choisi. Hors de ce créneau, la protection reste active.

Chemin JSON

Global Protection → Sunday → Stop Protection Hours

Minimum : 0 · Maximum : 23

Début des raids autorisés : minute

Nombre entier · obligatoire

Minutes de l’heure de début du créneau de raid (0 à 59). Par exemple, heure 22 et minutes 30 donnent un début à 22:30.

Chemin JSON

Global Protection → Sunday → Stop Protection Minutes

Minimum : 0 · Maximum : 59

Durée des raids autorisés (minutes)

Nombre entier · obligatoire

Durée du créneau de raid autorisé, en minutes. Il peut traverser minuit ; 0 ne crée aucun créneau pour ce jour. La protection de wipe reste prioritaire.

Chemin JSON

Global Protection → Sunday → Stop Protection Duration (in minutes)

Minimum : 0 · Maximum : 1440

Jeudi 3

Début des raids autorisés : heure

Nombre entier · obligatoire

Heure de début du créneau où les raids sont autorisés ce jour-là (0 à 23), selon le décalage UTC choisi. Hors de ce créneau, la protection reste active.

Chemin JSON

Global Protection → Thursday → Stop Protection Hours

Minimum : 0 · Maximum : 23

Début des raids autorisés : minute

Nombre entier · obligatoire

Minutes de l’heure de début du créneau de raid (0 à 59). Par exemple, heure 22 et minutes 30 donnent un début à 22:30.

Chemin JSON

Global Protection → Thursday → Stop Protection Minutes

Minimum : 0 · Maximum : 59

Durée des raids autorisés (minutes)

Nombre entier · obligatoire

Durée du créneau de raid autorisé, en minutes. Il peut traverser minuit ; 0 ne crée aucun créneau pour ce jour. La protection de wipe reste prioritaire.

Chemin JSON

Global Protection → Thursday → Stop Protection Duration (in minutes)

Minimum : 0 · Maximum : 1440

Mardi 3

Début des raids autorisés : heure

Nombre entier · obligatoire

Heure de début du créneau où les raids sont autorisés ce jour-là (0 à 23), selon le décalage UTC choisi. Hors de ce créneau, la protection reste active.

Chemin JSON

Global Protection → Tuesday → Stop Protection Hours

Minimum : 0 · Maximum : 23

Début des raids autorisés : minute

Nombre entier · obligatoire

Minutes de l’heure de début du créneau de raid (0 à 59). Par exemple, heure 22 et minutes 30 donnent un début à 22:30.

Chemin JSON

Global Protection → Tuesday → Stop Protection Minutes

Minimum : 0 · Maximum : 59

Durée des raids autorisés (minutes)

Nombre entier · obligatoire

Durée du créneau de raid autorisé, en minutes. Il peut traverser minuit ; 0 ne crée aucun créneau pour ce jour. La protection de wipe reste prioritaire.

Chemin JSON

Global Protection → Tuesday → Stop Protection Duration (in minutes)

Minimum : 0 · Maximum : 1440

Mercredi 3

Début des raids autorisés : heure

Nombre entier · obligatoire

Heure de début du créneau où les raids sont autorisés ce jour-là (0 à 23), selon le décalage UTC choisi. Hors de ce créneau, la protection reste active.

Chemin JSON

Global Protection → Wednesday → Stop Protection Hours

Minimum : 0 · Maximum : 23

Début des raids autorisés : minute

Nombre entier · obligatoire

Minutes de l’heure de début du créneau de raid (0 à 59). Par exemple, heure 22 et minutes 30 donnent un début à 22:30.

Chemin JSON

Global Protection → Wednesday → Stop Protection Minutes

Minimum : 0 · Maximum : 59

Durée des raids autorisés (minutes)

Nombre entier · obligatoire

Durée du créneau de raid autorisé, en minutes. Il peut traverser minuit ; 0 ne crée aucun créneau pour ce jour. La protection de wipe reste prioritaire.

Chemin JSON

Global Protection → Wednesday → Stop Protection Duration (in minutes)

Minimum : 0 · Maximum : 1440

Instructions du plugin

Raid Time Protection 2.1.0 — guide

Bêta 2.1.0. La version LTS publiée sur Codefling reste la 2.0.0. Le téléchargement du plugin nécessite une connexion et un droit vérifié pour la version demandée. Consultez sa fiche pour les accès disponibles. Les exports de configuration restent accessibles sans achat du plugin.

Ce guide concerne la bêta 2.1.0 et le format de configuration 2. La version publiée sur Codefling reste la 2.0.0.

Installation et export

Sauvegardez RaidTimeProtection.json, installez RaidTimeProtection.cs dans le dossier plugins du framework, puis vérifiez la configuration générée. Le configurateur exporte RaidTimeProtection.json, à installer dans oxide/config/RaidTimeProtection.json (ou le dossier config Carbon), puis rechargez le plugin. Vous pouvez aussi connecter votre serveur au Hub pour appliquer la configuration par SFTP et recharger le plugin par RCON.

Une configuration historique lisible peut être migrée ; conservez le fichier .v1.bak jusqu’à vérification du planning.

Planning

Chaque jour définit l’heure où le raid devient autorisé et sa durée en minutes. UTC Offset Minutes est un décalage fixe : le passage heure d’été/hiver ne le modifie pas automatiquement.

Exemple : vendredi à 22:00, durée 360 minutes, autorise le raid jusqu’au samedi à 04:00. Le début est inclus, la fin exclue. Configurez la durée complète sur le jour du début, même si la fenêtre dépasse minuit.

Quand la protection globale est activée, la protection après wipe s’applique en priorité ; ensuite les raids sont autorisés dans les plages et protégés en dehors. Une désactivation explicite dans une configuration saine autorise les dégâts. Une configuration illisible ou invalide ne désactive pas la protection.

Exclusions et dépendances

Le plugin vise les DecayEntity possédées avec privilège de construction et les dégâts attribués à un joueur. Les joueurs autorisés au TC peuvent endommager la cible. Certaines zones et certains prefabs peuvent être exclus. Les dégâts de dégradation, électriques, NPC, Bradley et CH47 sont exclus de cette politique. Les dégâts indirects sans joueur attribuable ne sont pas annoncés comme protégés.

ZoneManager est facultatif. Si absent ou si sa réponse est invalide, aucune exclusion de zone ne s’applique. Les identifiants vont dans (ZoneManager) Disabled protection zones. Notify n’est pas requis : les alertes utilisent le chat intégré, malgré le nom historique du champ JSON.

Commande et messages

/raid_date est publique, en lecture seule, sans permission. Elle indique l’état de protection et la prochaine transition en UTC. Le planning est donc une information publique.

Les messages peuvent être traduits via les fichiers du framework : BuildingProtected, ProtectionActivated, ProtectionDeactivated, StatusProtected, StatusAllowed, StatusNoTransition, ActiveWord et InactiveWord. Conservez les placeholders tels que {0}.

Dépannage et limites

Planning décalé : vérifier le décalage UTC et la politique d’heure d’été.
Fenêtre nocturne incorrecte : placer la durée complète sur son jour de début.
Zone ignorée : vérifier son identifiant et l’installation de ZoneManager.
Protection après wipe trop longue : vérifier les heures et la date du wipe.

La compilation ne prouve pas toutes les voies de dégâts actuelles de Rust. Rockets, feu, MLRS, véhicules, portes et autres cibles doivent être testés dans votre environnement avant de promettre une couverture générale.

Interface et préavis

L’onglet Apparence règle l’indicateur de protection, le planning et les notifications. Le rendu natif fonctionne sans PimpMyCUI ni ImageLibrary. Choisissez Bastion, Signal ou Gazette ; Classic, Compact et Contrast sont leurs anciens noms, toujours acceptés à l’import.

Les joueurs ouvrent le planning avec /raid, masquent leur indicateur avec /raid hud et consultent l’état en chat avec /raid_date. Le HUD donne l’état horaire global : les conditions de propriétaire, de privilège TC et les exclusions restent applicables.

Les positions X/Y utilisent un repère normalisé de 0 à 1 en haut à droite du HUD. L’échelle va de 0,6 à 1,5, avec un plafond de 1,1 pour le planning. Les couleurs conservent trois composantes RGB ; l’opacité se règle séparément.

L’onglet Préavis permet des annonces en chat et à l’écran avant les transitions. Les préavis sont désactivés par défaut. Vous pouvez saisir jusqu’à 16 délais distincts, de 1 à 1 440 minutes. Le plugin tient compte de la protection après wipe et ne rejoue pas les anciens préavis lors d’un rechargement.

Les configurations 2.0.0 restent lisibles : les sections d’interface sont facultatives et leurs valeurs natives s’appliquent lorsqu’elles sont absentes. Le mode PimpMyCUI demande un package compatible approuvé sur le serveur ; en son absence, le rendu natif est utilisé.

Position du HUD et versions

Par défaut, la version 2.1.0 place le HUD en X=0.985, Y=0.985. Si vous aviez choisi une autre position, conservez vos valeurs. /raid et /raid_date affichent les horaires et l’état de la protection.

Installer les fichiers

Avec un serveur connecté, cliquez sur Envoyer dans le configurateur. Le résultat indique si les fichiers ont été envoyés et si le plugin a été rechargé. Sans RCON, rechargez le plugin depuis votre panneau serveur après l’envoi.

Sans serveur connecté : Conservez une copie des fichiers actuels. Placez chaque fichier exporté dans le dossier indiqué avant l’export, ou reprenez les chemins du ZIP. Ne placez pas les données ou les traductions dans le dossier config.

Suivez les instructions du plugin ci-dessus pour ses dépendances et son rechargement. L’export ne connecte pas le site à votre serveur.

Guide de configuration et d’envoi →