Hiob : création

2026-02-14T13:36:59Z

création

Nouvelle page

{{SHORTDESC:Affiche des images et GIF sur des cartes Minecraft, avec cadres, overlay et marqueurs}}
{{Infobox Plugin
| nom = ImageFrame
| image = No_Logo.png
| legende = Logo d’ImageFrame
| type = Cosmétique
| dev = LOOHP
| status = installé
| grade = [[Pérégrin]]
| spigot = 
| modrinth = imageframe
| website = https://modrinth.com/plugin/imageframe
| hangar =
| docs = https://modrinth.com/plugin/imageframe 
| sources = https://github.com/LOOHP/ImageFrame 
| dépendance = 
| compatibilité=
}}

== Présentation ==
'''ImageFrame''' permet d’afficher des images (et GIF animés) depuis une URL sur des '''cartes Minecraft''' et dans des '''cadres item frame'''. Il gère:
* la '''sélection''' de cadres pour poser une image en un clic,
* les '''images combinées''' (un seul item qui représente l’ensemble de cartes),
* les '''overlays''' au‑dessus d’une carte vanilla existante,
* la '''lecture/pauses/jump''' d’animations,
* des '''marqueurs''' (icônes + légendes) superposés à la carte,
* la '''gestion d’accès''' à vos cartes et la modération.

== Légende et portée des arguments ==
; Accéder aux cartes d’un autre joueur
Pour les arguments « <code><name></code> » / « <code><image_name></code> », vous pouvez viser la ressource d’un autre joueur (si vous avez la permission) avec la syntaxe :
<code><joueur>:<name></code>
Exemple : <code>/if get LOOHP:map combined</code>

== Démarrage rapide ==
# Placez vos '''cadres''' au mur dans la taille voulue (ex. 3×2).
# Faites <code>/imageframe select</code> puis cliquez tous les cadres à remplir (clic droit) ; terminez par Sneak + clic pour valider.
# Créez et posez d’un coup :
<code>/imageframe create affiche https://exemple/img.png selection</code>
# Pour une grille précise sans sélection :
<code>/imageframe create affiche https://exemple/img.png 3 2</code>
# Pour récupérer l’item combiné à poser plus tard :
<code>/imageframe create affiche https://exemple/img.png 3 2 combined</code>

== Commandes ==
=== Administration ===
{| class="wikitable"
! Commande !! Description
|-
| <code>/imageframe reload</code> || Recharge la configuration du plugin.
|-
| <code>/imageframe update</code> || Vérifie s’il existe une mise à jour.
|-
| <code>/imageframe storagemigrate</code> || Migre les données vers un autre backend de stockage.
|}

=== Joueur ===
{| class="wikitable sortable"
! Commande !! Effet
|-
| <code>/imageframe select</code> || Passe en mode sélection pour choisir des cadres où poser l’image.
|-
| <code>/imageframe create <name> <url> <width> <height></code> || Crée une nouvelle ImageMap avec dimensions en cartes (largeur × hauteur).
|-
| <code>/imageframe create <name> <url> selection</code> || Crée et pose directement l’image dans la '''sélection''' en cours.
|-
| <code>/imageframe create <name> <url> <width> <height> combined</code> || Crée l’image et vous donne l’'''item combiné''' associé.
|-
| <code>/imageframe overlay <name> <url></code> || Crée un '''overlay''' par‑dessus la carte '''vanilla''' tenue en main.
|-
| <code>/imageframe overlay <name> <url> selection</code> || Idem, mais pour les cartes '''dans votre sélection'''.
|-
| <code>/imageframe clone <name> <new_name></code> || Duplique une de vos ImageMaps.
|-
| <code>/imageframe clone <name> <new_name> selection</code> || Duplique puis pose dans la sélection.
|-
| <code>/imageframe clone <name> <new_name> combined</code> || Duplique puis donne l’item combiné.
|-
| <code>/imageframe playback <name> pause</code> || Bascule '''pause/lecture''' pour une image animée.
|-
| <code>/imageframe playback <name> jumpto <seconds></code> || Saute à une seconde précise d’une animation.
|-
| <code>/imageframe refresh [image_name] [new_url]</code> || Rafraîchit depuis la source. Peut aussi mettre à jour l’URL.
|-
| <code>/imageframe info</code> || Donne les infos de l’image '''tenue en main'''.
|-
| <code>/imageframe get <name></code> || Récupère une ImageMap que vous avez déjà créée.
|-
| <code>/imageframe get <name> selection</code> || Pose directement cette ImageMap dans la sélection.
|-
| <code>/imageframe get <name> combined</code> || Donne la version '''Combined ImageMap'''.
|-
| <code>/imageframe delete <name></code> || Supprime l’une de vos ImageMaps.
|-
| <code>/imageframe rename <name> <new_name></code> || Renomme une ImageMap existante.
|-
| <code>/imageframe list</code> || Liste vos ImageMaps existantes.
|-
| <code>/imageframe marker add <image_name> <marker_name> <direction:0-15> <marker_type> [caption]</code> || Ajoute un '''marqueur''' (orientation 0–15, type d’icône, légende optionnelle).
|-
| <code>/imageframe marker remove <image_name> <marker_name></code> || Supprime un marqueur par son nom.
|-
| <code>/imageframe marker clear <image_name></code> || Efface '''tous''' les marqueurs de l’image.
|-
| <code>/imageframe setaccess <name> <player> <permission></code> || Donne à un joueur un droit spécifique sur '''votre''' ImageMap.
|}

=== Modération ===
{| class="wikitable"
! Commande !! Description
|-
| <code>/imageframe list <player></code> || Liste les ImageMaps d’un joueur.
|-
| <code>/imageframe giveinvisibleframe <glowing/regular> [amount] [player]</code> || Donne des cadres '''invisibles''' (lumineux ou non).
|-
| <code>/imageframe adminsetcreator <image_id> <player></code> || Change le créateur d’une ImageMap par ID.
|-
| <code>/imageframe adminmigrate <ImageMap/DrMap/ImageOnMap></code> || Migre les données depuis un plugin tiers pris en charge.
|}

== Permissions ==
{| class="wikitable sortable"
! Noeud !! Défaut !! Description
|-
| <code>imageframe.create</code> || OP || Autorise la création de nouvelles ImageMaps.
|-
| <code>imageframe.create.animated</code> || OP || Autorise la création d’ImageMaps '''animées'''.
|-
| <code>imageframe.create.others</code> || OP || Créer pour d’autres joueurs (inclut overlay/clone), ignore les limites de possession.
|-
| <code>imageframe.overlay</code> || OP || Autorise les overlays sur cartes vanilla.
|-
| <code>imageframe.clone</code> || OP || Dupliquer ses propres ImageMaps.
|-
| <code>imageframe.playback</code> || OP || Mettre en pause / régler la position des animations (ses propres images).
|-
| <code>imageframe.select</code> || OP || Utiliser le mode sélection de cadres.
|-
| <code>imageframe.marker</code> || OP || Ajouter/retirer des marqueurs.
|-
| <code>imageframe.marker.unlimited</code> || OP || Marqueurs illimités.
|-
| <code>imageframe.refresh</code> || OP || Rafraîchir des ImageMaps.
|-
| <code>imageframe.rename</code> || OP || Renommer des ImageMaps.
|-
| <code>imageframe.info</code> || true || Voir les informations d’une ImageMap.
|-
| <code>imageframe.list</code> || true || Lister '''ses''' ImageMaps.
|-
| <code>imageframe.list.others</code> || OP || Lister les ImageMaps d’un autre joueur.
|-
| <code>imageframe.delete</code> || OP || Supprimer '''sa''' propre ImageMap.
|-
| <code>imageframe.purge</code> || false || Purger toutes les ImageMaps d’un joueur.
|-
| <code>imageframe.purge.all</code> || false || Purger toutes les ImageMaps du serveur.
|-
| <code>imageframe.get</code> || OP || Récupérer une de '''ses''' ImageMaps.
|-
| <code>imageframe.setaccess</code> || OP || Modifier les droits d’accès sur '''ses''' ImageMaps.
|-
| <code>imageframe.adminbypass</code> || OP || Bypasser toutes les restrictions d’accès (utiliser/modifier n’importe quelle ImageMap).
|-
| <code>imageframe.adminsetcreator</code> || OP || Changer le créateur via l’ID.
|-
| <code>imageframe.admindelete</code> || OP || Supprimer n’importe quelle ImageMap via l’ID.
|-
| <code>imageframe.adminmigrate</code> || OP || Migrer depuis des plugins pris en charge.
|-
| <code>imageframe.preference</code> || true || Modifier ses préférences joueur.
|-
| <code>imageframe.preference.others</code> || OP || Modifier les préférences d’un autre joueur.
|-
| <code>imageframe.giveinvisibleframe</code> || OP || Donner des cadres invisibles (glowing/regular).
|-
| <code>imageframe.reload</code> || OP || <code>/imageframe reload</code>.
|-
| <code>imageframe.resync</code> || OP || Forcer la resynchronisation depuis le stockage.
|-
| <code>imageframe.storagemigrate</code> || OP || Migrer les données vers un autre type de stockage.
|-
| <code>imageframe.update</code> || OP || Recevoir les messages de mise à jour.
|}

== Exemples utiles ==
* Créer une affiche 2×3 :
<code>/imageframe create affiche https://static.nefald.fr/img/nefald_logo.png 2 3</code>
* Poser directement dans votre sélection :
<code>/imageframe create affiche https://static.nefald.fr/img/nefald_logo.png selection</code>
* Obtenir l’item combiné (à poser plus tard) :
<code>/imageframe create affiche https://static.nefald.fr/img/nefald_logo.png 2 3 combined</code>
* Mettre un '''overlay''' sur la carte vanilla tenue :
<code>/imageframe overlay repere https://static.nefald.fr/img/nefald_logo.png</code>
* Animation : mettre en pause puis aller à 42 s :
<code>/imageframe playback gif pause</code> puis <code>/imageframe playback gif jumpto 42</code>
* Marqueurs :
<code>/imageframe marker add affiche spawn 8 FLAG "Zone de spawn"</code>

== Dépannage rapide ==
* Rien ne se pose dans les cadres : vérifiez que vous avez bien validé la '''sélection''' et que les dimensions (L×H) correspondent au nombre de cadres.
* L’image ne se met pas à jour : utilisez <code>/imageframe refresh <name></code> (ou précisez une nouvelle URL).
* Accès refusé sur une carte d’un autre joueur : il doit d’abord vous déléguer un droit via <code>/imageframe setaccess</code>, ou vous devez avoir <code>imageframe.adminbypass</code>.

Plugin:ImageFrame - Historique des versions

Hiob : création

Hiob : création