ClaimCycle

ClaimCycle est un plugin de récompenses quotidiennes conçu pour permettre aux serveurs Minecraft de proposer facilement des récompenses configurables à leurs joueurs.

Le plugin permet notamment de gérer différents délais, des récompenses adaptées aux grades, des conditions de temps de jeu et une interface simple accessible directement en jeu.

Présentation

Fonctionnalités principales

ClaimCycle propose notamment :

• Récompenses quotidiennes configurables
• Plusieurs récompenses différentes
• Délais personnalisables
• Interface graphique avec /daily
• Récompenses différentes selon les grades
• Compatibilité avec les systèmes de permissions comme LuckPerms
• Conditions basées sur le temps de jeu
• Gestion du temps de jeu cumulable ou continu selon la configuration
• Quantités configurables
• Récompenses exécutées via des commandes serveur
• Icônes configurables dans l'interface
• Français et anglais
• Temps restant affiché avant la prochaine récompense
• Possibilité de réserver certaines récompenses à certains joueurs ou grades

Compatibilité

Version actuelle

ClaimCycle : 1.0.0

Minecraft

Version actuellement publiée :

• 1.21.1

Plateformes

ClaimCycle est prévu pour fonctionner avec :

• Paper
• Spigot
• Purpur

Il est recommandé d'utiliser Paper ou Purpur pour bénéficier d'un environnement serveur moderne et performant.

Installation

1. Télécharger ClaimCycle

Télécharge le fichier :

ClaimCycle-1.0.0.jar

depuis la page officielle du plugin.

2. Installer le plugin

Arrête complètement ton serveur Minecraft.

Place ensuite :

ClaimCycle-1.0.0.jar

dans le dossier :

plugins/

de ton serveur.

3. Démarrer le serveur

Redémarre normalement ton serveur.

ClaimCycle chargera automatiquement ses fichiers et sa configuration.

4. Vérifier l'installation

Une fois connecté au serveur, utilise :

/daily

Si l'interface ClaimCycle apparaît, l'installation est fonctionnelle.

Commandes

/daily

Commande principale de ClaimCycle.

Elle permet d'ouvrir l'interface des récompenses.

Exemple :

/daily

Depuis cette interface, le joueur peut consulter ses récompenses et récupérer celles auxquelles il a accès.

/daily lang

Permet de gérer la langue utilisée par ClaimCycle pour le joueur.

Exemple :

/daily lang

ClaimCycle prend actuellement en charge :

• Français
• Anglais

La langue choisie est enregistrée pour le joueur.

Interface des récompenses

L'interface /daily permet aux joueurs de visualiser rapidement leurs récompenses.

Selon la configuration du serveur, une récompense peut apparaître comme :

• disponible ;
• encore en attente ;
• verrouillée par une permission ;
• verrouillée par une condition ;
• indisponible tant que le temps de jeu requis n'est pas atteint.

Chaque récompense peut également utiliser une icône différente afin de rendre l'interface plus lisible.

Récompenses

Les récompenses de ClaimCycle sont configurables.

Un serveur peut par exemple proposer :

• des objets ;
• de la monnaie ;
• des clés ;
• des points ;
• des commandes ;
• des récompenses provenant d'autres plugins ;
• des avantages liés à un grade.

ClaimCycle peut exécuter des commandes serveur lors de la récupération d'une récompense.

Cela permet de l'intégrer avec de nombreux autres plugins.

Exemple de récompense quotidienne

Un serveur peut par exemple proposer une récompense disponible toutes les 24 heures.

Récompense :

• quelques ressources ;
• de l'argent ;
• une clé ;
• ou une autre récompense configurée par l'administrateur.

Le joueur ouvre :

/daily

puis récupère sa récompense lorsqu'elle est disponible.

Une fois récupérée, le délai recommence.

Délais

Chaque récompense peut avoir son propre délai.

Exemples :

• 30 minutes
• 1 heure
• 6 heures
• 12 heures
• 24 heures
• 2 jours
• 7 jours

ClaimCycle peut utiliser différentes unités de temps dans sa configuration.

Le joueur peut voir le temps restant avant de pouvoir récupérer de nouveau une récompense.

Temps de jeu

ClaimCycle peut prendre en compte le temps de jeu du joueur.

Cela permet de créer des récompenses qui ne deviennent accessibles qu'après une certaine durée de jeu.

Exemples :

• récompense après 30 minutes ;
• récompense après 1 heure ;
• récompense après plusieurs heures de jeu ;
• récompense nécessitant une activité régulière.

Selon la configuration utilisée, le système peut prendre en compte différentes méthodes de suivi du temps de jeu.

Grades et permissions

ClaimCycle peut proposer des récompenses différentes selon les permissions du joueur.

Cela permet par exemple de créer :

• une récompense standard ;
• une récompense VIP ;
• une récompense VIP+ ;
• une récompense réservée à un grade précis ;
• une récompense réservée à un événement ou à un groupe particulier.

Cette fonctionnalité permet d'intégrer ClaimCycle avec un gestionnaire de permissions comme LuckPerms.

Exemple avec plusieurs grades

Un serveur peut par exemple proposer :

Joueur

Récompense quotidienne standard.

VIP

Récompense standard + récompense VIP supplémentaire.

VIP+

Récompense standard + récompense VIP + récompense VIP+.

Les permissions permettent donc d'ajouter des avantages supplémentaires sans retirer les récompenses normales.

Quantités

Les quantités distribuées sont configurables.

Exemples :

• 1 objet
• 8 objets
• 16 objets
• 32 objets
• 64 objets

Les quantités peuvent être adaptées aux besoins du serveur et au type de récompense.

Récompenses via commandes

ClaimCycle peut utiliser des commandes serveur comme récompenses.

Cela permet de fonctionner avec de nombreux autres plugins.

Exemples d'utilisation possibles :

• donner de l'argent avec un plugin d'économie ;
• donner une clé ;
• attribuer des points ;
• donner un objet personnalisé ;
• exécuter une commande provenant d'un autre plugin ;
• attribuer un avantage lié à un grade.

Les commandes réellement disponibles dépendent des plugins installés sur ton serveur.

Icônes

Les récompenses affichées dans le menu peuvent utiliser différentes icônes.

Cela permet de représenter visuellement chaque récompense.

Par exemple :

• un diamant pour une récompense importante ;
• un coffre pour une récompense quotidienne ;
• un lingot pour une récompense économique ;
• un objet particulier représentant un grade.

Les icônes sont définies dans la configuration du plugin.

Langues

ClaimCycle prend en charge plusieurs langues.

Actuellement :

• Français
• Anglais

Les joueurs peuvent gérer leur langue avec :

/daily lang

Le choix de langue permet d'utiliser ClaimCycle sur des serveurs accueillant plusieurs communautés.

Configuration

ClaimCycle génère ses fichiers de configuration lors de son installation.

Les fichiers de configuration permettent notamment de gérer :

• les récompenses ;
• les délais ;
• les quantités ;
• les icônes ;
• les commandes exécutées ;
• les permissions ;
• les conditions ;
• les paramètres liés au temps de jeu.

Avant toute modification importante, il est recommandé de faire une copie de sauvegarde de la configuration.

Modifier une récompense

Pour modifier une récompense :

1. Arrête le serveur ou assure-toi que la méthode utilisée permet une modification sûre.
2. Ouvre les fichiers de configuration de ClaimCycle.
3. Modifie uniquement les valeurs nécessaires.
4. Enregistre le fichier.
5. Redémarre ou recharge le plugin selon la méthode supportée par ta version.
6. Vérifie la console pour détecter une éventuelle erreur de configuration.

Bonnes pratiques

Sauvegardes

Avant une grosse modification :

• sauvegarde la configuration ;
• sauvegarde les données importantes du serveur ;
• conserve l'ancienne version du plugin pendant quelque temps.

Tests

Pour une modification importante, il est recommandé de tester d'abord la configuration sur un serveur de test.

Cela évite de perturber les joueurs du serveur principal.

Mise à jour de ClaimCycle

Pour mettre ClaimCycle à jour :

1. Arrête complètement le serveur.
2. Sauvegarde le dossier de configuration de ClaimCycle.
3. Conserve une copie de l'ancien fichier .jar.
4. Remplace l'ancien .jar par la nouvelle version.
5. Redémarre le serveur.
6. Vérifie la console.
7. Vérifie que /daily fonctionne correctement.
8. Vérifie les récompenses existantes.

Ne supprime pas automatiquement la configuration lors d'une mise à jour.

Problèmes fréquents

/daily ne fonctionne pas

Vérifie :

• que ClaimCycle apparaît bien dans le dossier plugins/ ;
• que le fichier .jar est valide ;
• que la version du serveur est compatible ;
• qu'aucune erreur ClaimCycle n'apparaît dans la console.

ClaimCycle apparaît en erreur au démarrage

Regarde la console du serveur.

Cherche les lignes contenant :

ClaimCycle

Une erreur de configuration, une version incompatible ou une dépendance serveur peut empêcher le chargement du plugin.

Une récompense n'apparaît pas

Vérifie :

• sa configuration ;
• les permissions du joueur ;
• les conditions définies ;
• le délai ;
• le temps de jeu demandé ;
• les erreurs dans la console.

Une récompense reste verrouillée

Vérifie si elle possède :

• une permission particulière ;
• un grade requis ;
• une condition de temps de jeu ;
• un délai encore actif.

Une commande de récompense ne fonctionne pas

Teste la commande directement dans la console du serveur.

Si elle ne fonctionne pas dans la console, le problème vient probablement de la commande ou du plugin auquel elle appartient.

Si elle fonctionne dans la console mais pas avec ClaimCycle, vérifie sa configuration dans ClaimCycle.

LuckPerms

ClaimCycle peut être utilisé avec LuckPerms afin de gérer l'accès aux récompenses selon les grades.

Cela permet par exemple de donner certaines permissions à :

• default ;
• VIP ;
• VIP+ ;
• MVP ;
• staff ;
• ou tout autre groupe personnalisé.

Les permissions précises doivent correspondre à celles configurées pour les récompenses utilisées sur ton serveur.

Exemple d'organisation

Un serveur peut organiser ClaimCycle comme ceci :

Récompense 1

Disponible pour tous les joueurs.

Délai :

24 heures

Récompense 2

Disponible uniquement aux VIP.

Délai :

24 heures

Récompense 3

Disponible après une certaine durée de jeu.

Récompense 4

Disponible uniquement à un grade supérieur.

Cette organisation permet d'avoir un système progressif sans compliquer l'utilisation pour les joueurs.

Sécurité

Évite d'utiliser dans les récompenses des commandes donnant des permissions dangereuses ou des accès administrateur.

Vérifie toujours les commandes utilisées avant de rendre une récompense accessible publiquement.

Une mauvaise commande serveur peut donner à un joueur davantage de permissions que prévu.

Performances

ClaimCycle est conçu pour gérer les récompenses sans nécessiter d'action permanente de la part des joueurs.

Pour conserver de bonnes performances :

• évite de créer inutilement un très grand nombre de récompenses identiques ;
• vérifie régulièrement les erreurs de console ;
• garde ton serveur et tes plugins à jour ;
• utilise une version de Java adaptée à ta version de Minecraft.

Sauvegarde

Avant :

• une mise à jour ;
• une modification majeure ;
• un changement important de configuration ;

conserve une sauvegarde.

Cela permet de revenir rapidement à une configuration fonctionnelle en cas de problème.

Désinstallation

Si tu veux retirer ClaimCycle :

1. Arrête le serveur.
2. Retire le fichier ClaimCycle-1.0.0.jar du dossier plugins/.
3. Conserve éventuellement le dossier de configuration en sauvegarde.
4. Redémarre le serveur.

Ne supprime le dossier de configuration que si tu es certain de ne plus avoir besoin de ses données.

Informations utiles pour demander de l'aide

Lorsque tu signales un problème, indique au minimum :

• version de ClaimCycle ;
• version de Minecraft ;
• plateforme serveur ;
• version de Java ;
• message d'erreur complet ;
• étapes permettant de reproduire le problème.

Exemple :

ClaimCycle : 1.0.0

Minecraft : 1.21.1

Serveur : Paper

Problème :

La récompense ne peut pas être récupérée.

Erreur console :

Copie ici le message d'erreur complet.

Support

Si tu rencontres un problème avec ClaimCycle, utilise les moyens de support indiqués sur la page officielle du plugin.

Pour faciliter le diagnostic, évite les captures partielles de console et privilégie le message d'erreur complet.

Résumé

ClaimCycle permet de mettre en place un système de récompenses quotidiennes configurable tout en restant simple pour les joueurs.

Avec /daily, les joueurs disposent d'une interface unique permettant de consulter leurs récompenses, tandis que les administrateurs peuvent adapter :

• délais ;
• récompenses ;
• quantités ;
• permissions ;
• grades ;
• commandes ;
• icônes ;
• conditions de temps de jeu ;
• langues.

Version actuelle : 1.0.0

Minecraft : 1.21.1

Plateformes :

• Paper
• Spigot
• Purpurdocumentation de ton plugin.