Aller au contenu
← Toute la documentation

/// 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.

Préparer votre fichier

  1. Vérifiez la version installée

    Ce guide décrit Raid Time Protection 2.0.0. Le configurateur doit utiliser cette même version.

  2. Importez votre configuration

    Ouvrez le configurateur et importez le JSON actuel. Pour une nouvelle installation, vous pouvez partir de l’exemple proposé.

  3. Modifiez et téléchargez

    Ajustez les réglages, corrigez les erreurs signalées et téléchargez le JSON. Gardez une copie de votre ancien fichier avant de le remplacer.

Votre configuration n’est pas sauvegardée sur le site. Conservez le fichier exporté ; il permet aussi de reprendre plus tard.

Réglages de cette version

Général 3
Schema Version
Choix · obligatoire

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

Chemin JSONSchema Version

Valeurs possibles : 2

UTC Offset 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 JSONUTC Offset Minutes

Minimum : -840 · Maximum : 840

Wipe Protection Time (in hours)
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 JSONWipe Protection Time (in hours)

Minimum : 0 · Maximum : 720

Global Protection 4
Enabled
Activé / désactivé · obligatoire

Activer les règles de protection globale pour les entités concernées. Désactivé, le plugin n’applique ni la protection de wipe ni les créneaux hebdomadaires.

Chemin JSONGlobal Protection → Enabled
Show Alert (recquires Notify plugin)
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 JSONGlobal Protection → Show Alert (recquires Notify plugin)
(ZoneManager) Disabled protection zones
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 JSONGlobal Protection → (ZoneManager) Disabled protection zones
Disable protection prefabs (optional)
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 JSONGlobal Protection → Disable protection prefabs (optional)
Friday 3
Stop Protection Hours
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 JSONGlobal Protection → Friday → Stop Protection Hours

Minimum : 0 · Maximum : 23

Stop Protection Minutes
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 JSONGlobal Protection → Friday → Stop Protection Minutes

Minimum : 0 · Maximum : 59

Stop Protection Duration (in 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 JSONGlobal Protection → Friday → Stop Protection Duration (in minutes)

Minimum : 0 · Maximum : 1440

Monday 3
Stop Protection Hours
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 JSONGlobal Protection → Monday → Stop Protection Hours

Minimum : 0 · Maximum : 23

Stop Protection Minutes
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 JSONGlobal Protection → Monday → Stop Protection Minutes

Minimum : 0 · Maximum : 59

Stop Protection Duration (in 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 JSONGlobal Protection → Monday → Stop Protection Duration (in minutes)

Minimum : 0 · Maximum : 1440

Saturday 3
Stop Protection Hours
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 JSONGlobal Protection → Saturday → Stop Protection Hours

Minimum : 0 · Maximum : 23

Stop Protection Minutes
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 JSONGlobal Protection → Saturday → Stop Protection Minutes

Minimum : 0 · Maximum : 59

Stop Protection Duration (in 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 JSONGlobal Protection → Saturday → Stop Protection Duration (in minutes)

Minimum : 0 · Maximum : 1440

Sunday 3
Stop Protection Hours
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 JSONGlobal Protection → Sunday → Stop Protection Hours

Minimum : 0 · Maximum : 23

Stop Protection Minutes
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 JSONGlobal Protection → Sunday → Stop Protection Minutes

Minimum : 0 · Maximum : 59

Stop Protection Duration (in 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 JSONGlobal Protection → Sunday → Stop Protection Duration (in minutes)

Minimum : 0 · Maximum : 1440

Thursday 3
Stop Protection Hours
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 JSONGlobal Protection → Thursday → Stop Protection Hours

Minimum : 0 · Maximum : 23

Stop Protection Minutes
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 JSONGlobal Protection → Thursday → Stop Protection Minutes

Minimum : 0 · Maximum : 59

Stop Protection Duration (in 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 JSONGlobal Protection → Thursday → Stop Protection Duration (in minutes)

Minimum : 0 · Maximum : 1440

Tuesday 3
Stop Protection Hours
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 JSONGlobal Protection → Tuesday → Stop Protection Hours

Minimum : 0 · Maximum : 23

Stop Protection Minutes
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 JSONGlobal Protection → Tuesday → Stop Protection Minutes

Minimum : 0 · Maximum : 59

Stop Protection Duration (in 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 JSONGlobal Protection → Tuesday → Stop Protection Duration (in minutes)

Minimum : 0 · Maximum : 1440

Wednesday 3
Stop Protection Hours
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 JSONGlobal Protection → Wednesday → Stop Protection Hours

Minimum : 0 · Maximum : 23

Stop Protection Minutes
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 JSONGlobal Protection → Wednesday → Stop Protection Minutes

Minimum : 0 · Maximum : 59

Stop Protection Duration (in 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 JSONGlobal Protection → Wednesday → Stop Protection Duration (in minutes)

Minimum : 0 · Maximum : 1440

Instructions du plugin

Raid Time Protection 2.0.0 — guide

Ce guide concerne la version Codefling 2.0.0 et le schéma de configuration 2.

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. Un export ne l’installe pas automatiquement.

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.

Installer le fichier

Après avoir conservé une copie de l’ancien fichier, placez le JSON exporté à cet emplacement sur votre serveur :

oxide/config/RaidTimeProtection.json

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