[Plugin] LinkedChest (Coffres liés)

Coffre collectifs

Ghomerr en avait déjà parlé, il y a un certain temps. L'idée est de lier des coffres entre eux pour qu'ils partagent leur contenu.

Idées d'application
- Mise à disposition de bouffe pour toutes les auberges (elles sont ainsi toute achalandées, même si on ne passe pas les alimenter)
- Mise à dispo d'équipement pour le nether, et les postes avancés
- Mise à dispo de potions sur les routes
- Mise en place d'un système de poste fonctionnel

Principe
Le principe se base sur des coffres maîtres et des coffres esclaves. Chaque coffre maître est indépendant et a plusieurs coffres esclaves. Un coffre esclave n'est lié qu'à un seule maître. Le coffre où sont réellement les objets est toujours le maître. Les coffres esclaves sont toujours vides. Ainsi si le plugin est abandonné ou sujet à un problème de config, on aura ni duplication, ni disparition d'objet.

L'accès est simple : quand un joueur accède à un coffre esclave, il accède en réalité au maître. A voir s'il est possible d'accéder à un coffre depuis un autre monde.
Le principe serait applicable aux coffres simples, doubles coffres et éventuellement dispensers

Contrainte au niveau des logs. Idéalement, si on accède à un coffre esclave, il faudrait réussir à tracer ce qui est pris dans le coffre maître. Il faut donc étudier comment ce plugins va interagir avec les plugins de surveillance.
Attention au risque lié à l'accès concurrentiel (1 items pris par deux personnes en même temps ne doit pas dupliquer l'item)

Proposition de commandes
- Add <nom du maître>
Ajout du coffre visé comme coffre maître (si le nom n'existe pas déjà)
- Delete <nom du maître>
Suppression d'un coffre maître et de tous ses esclaves
- Info
Indique si le coffre visé est maître ou esclave. De plus, il donne le nom du maître et tous les esclaves qui lui sont liés.
- Link <nom du maître> <nom de l'esclave>
Lie le coffre visé un esclave à un maître. Si le coffre est déjà lié à un autre : le message d'erreur. Si le coffre n'est pas vide : message d'erreur.
- Unlink
Détacher le coffre visé de son maître.

Permissions : 2 niveaux
- Gestion des coffres maîtres (admins only par défaut)
- Gestion des coffres esclaves (admins only par défaut)
- L'accès aux coffres n'est pas sujet à permission.

Application sur Rodwin.fr

Il n'est pas question que chacun se fasse son coffre esclave sur le coffre des halles ou de la banque de rodville, quoi que les halles et la banque pourraient être liées, à voir... L'idée est surtout de permettre à certaines personnes ou guildes de maintenir une activité qui puisse toucher toute la carte. Par exemple, la guilde des explorateurs pourrait maintenir 1 ou 2 coffres maîtres avec de l'équipement au sein de leur guilde, tout en ayant des coffres esclaves dans chaque avant poste. La maintenance de ces avant postes serait alors possible, le pillage tracé dans les logs.

La poste pourrait être une application envisageable surtout qu'elle reste chère à Cola qui n'a jamais trouvé de système réellement applicable. Un bâtiments central à Rodville et/ou New Rodville avec un coffre maitre par lieu. Les coffres esclaves seraient alors dans chaque lieu. On pourrait ainsi envoyer rapidement du matériel depuis et vers les 2 villes principales. A la demande, des postes locales pourrait être implantées pour permettre les transferts décentralisés. Il y a du potentiel.

Les auberges sont aussi souvent un moyen de rendre un lieu plus vivant. Malheureusement, à part Rodville, elles sont toutes abandonnées. Leur gestion pourrait être rendue beaucoup plus simple.

La mise en place de coffres maîtres et esclaves serait réservée aux admins.

On peut aussi trouver d'autres applications :
- Du matériel pour réparer les voies dans chaque station liées à des coffres à la guilde de rodville.
- Des bateaux pour prendre la mer sur des pontons dispersés partout.
- Les coffres de graines ou de production de la guilde des paysans accessibles plus facilement depuis les ambassades locales.
- Mise en place d'un système d'échange d'objets magiques


Plugins existant.

J'ai trouvé un plugin Craftbukkit mais celui-ci utiliser une synchro régulière. En pratique les objets sont dupliqués, ce qui parrait dangeureux. De plus, le comportement n'est pas clair quand on arrète d'utiliser le plugin. Or le jeu sait déjà gérer les accès concurrentiels à un coffre. Les objets disparaissent en temps réel. Il faut juste voir si on peut substituer le contenu d'un coffre à celui qu'on a sous les yeux.


Technique

Bon, je connais pas grand chose à Java, mais je touche un peu en objet et je sais lire une doc en anglais. Ca aide.

En regardant 2 minutes la doc de bukkit, je trouve dans l'objet Chest (une interface en réalité) une fonction GetInventory. La fonction revoie un Inventory (une autre interface) qui semble gérer les ajouts, suppression, stacks et compagnie, y compris la liste des joueurs qui accèdent à l'inventaire à un moment donné. Comme l'inventaire est géré à part et pas directement dans le bloc, on doit pouvoir contourner le principe de manière plutôt transparente. L'idée serait donc de surcharger cette fonction GetInventory pour qu'elle revoie un autre inventaire que celui du coffre qu'on a sous les yeux, en utilisant une mini base de données. Ca semble très simple, un peu trop pour être vrai d'ailleurs...

Ghomerr, si tu peux me relire avec tes yeux de développeur de plugin, ça pourra faire avancer le bazare.

Code:

@EventHandler
   public void onInventoryOpenEven(final InventoryOpenEvent event)
   {
      final Player player = (Player) event.getPlayer();
      final Block block = player.getTargetBlock(null, 6);
      
      if (block != null && block.getType() == Material.CHEST)
      {
         final InventoryView view = event.getView();
         final Inventory topInv = view.getTopInventory();
         
         if (plugin.content != null && plugin.content.length > 0)
         {
            topInv.setContents(plugin.content);
         }
      }
   }
   
   @EventHandler
   public void onInventoryCloseEvent(final InventoryCloseEvent event)
   {
      final Player player = (Player) event.getPlayer();
      final Block block = player.getTargetBlock(null, 6);
      
      if (block != null && block.getType() == Material.CHEST)
      {
         final InventoryView view = event.getView();
         final Inventory topInv = view.getTopInventory();
      
         plugin.content = topInv.getContents();
      }
   }

• A l'aide d'une commande, on ajoute un coffre maître dont on va sauvegarder le contenu.
  
• A chaque ouverture de ce coffre, le contenu mémorisé sera rafraîchit.
  
• Je ne sais pas encore comment serait repéré un coffre Maître. Je vais voir si je peux faire cela intelligemment.
  
• On définit un coffre esclave par rapport à un coffre maître avec une commande comme l'a proposé Warzouz (/link maître esclave).
  
• Chaque ouverture d'un coffre esclave fera que son contenu sera remplacé par le contenu du coffre maître auquel il est lié.
  
• La fermeture de ce coffre mettra à jour le contenu du coffre maître.
  
• L'idée est de synchroniser l'accès au contenu maître, en Java pur, par exemple (instruction synchronized).
  
• Et le tour est joué !

• Ajouter un coffre
  
• Lier un coffre
  
• Gérer la concurrence

Spoiler:

• Coffres maîtres indestructibles (check location)
  
• Sauvegarder/Charger Location des coffres maîtres (à partir d'un fichier)
  
• Charger l'inventaire à la première ouverture d'un coffre esclave ou maître
  
• Coffres admins
  
• Ouvrir coffre à distance
  
• Supprimer un coffre (pas le coffre original)
  
• Si coffre maître : pas de panneau (inventaire primaire prioritaire)
  
• Test: afficher Location d'un coffre

• Commande pour savoir si coffre maître ou non
  
• Message multi-langues
  
• Permissions (coffres admins, autorisation de créer un panneau de coffre lié)

• J'utilise la dernière version sortie et recommandée, à savoir la 1.1-R8.
  
• Les coffres fonctionnent dans des mondes différents
  
• Je n'ai pas eu le cas où le coffre maître était dans un chunk non chargé. Dans la mesure où j'ai en mémoire l'inventaire du coffre, qu'il soit chargé ou pas, je pense que ça fonctionnera quand même. Cela fonctionne même si on détruit le coffre, en fait.
  
• J'ai choisi d'empêcher de détruire un coffre parce que lorsque l'on ajoute un coffre maître, l'inventaire original du coffre est conservé. Quand on détruit le coffre, les objets sont droppés mais l'inventaire virtuel existe toujours. Il y a donc potentiellement des duplicats d'objets. Je ne peux pas nettoyer l'inventaire puisque ça risque (je pense, je n'ai pas testé) de nettoyer aussi l'inventaire virtuel. Donc pour détruire un coffre maître, il faut au préalable supprimer l'inventaire virtuel, détruire le coffre maître, récupérer les loots originaux. Certes, c'est contraignant. Je pense que je vais voir si je peux améliorer cela...
  
• Oui, on peut empiler les coffres. Même si le coffre ne peut être ouvert, ça fonctionnera. Le plugin fonctionne sur le clic-droit sur une coffre, qu'il soit ouvrable ou non. Les pancartes sont cherchées tout autour du coffre dans un premier temps, puis le bloc sous le bloc sur lequel est posé le coffre (2 blocs sous le coffres donc, pour pouvoir le cacher), sur le bloc au-dessus du coffre et tout autour (sauf diagonales). Donc si tu mets un panneau sur le mur à côté du coffre, le panneau se trouve sur une diagonale autour du coffre, donc ça marche. L'algorithme de recherche s'arrête au premier panneau qu'il trouve (d'ailleurs, faut que je vérifie que c'est le premier panneau "valide" et non le premier panneau). Donc en théorie, s'il y a des panneaux partout, le premier valide trouvé sera celui qui sera appliqué. Les autres, mêmes valides, seront ignorés.