TinyEssentials
Vue d'ensemble
TinyEssentials est la couche « essentials » d'un serveur BTC, inspirée d'EssentialsX et construite sur TypeWriter. Elle apporte 29 commandes pour joueurs et staff (homes, demandes de téléportation, messages, vol, vanish, soin...), un formateur de chat, des objets de connexion, une pénalité de mort (« scavenger »), un gestionnaire de tablist, de scoreboard et de bossbar, une durée de jour personnalisée avec un calendrier, un menu de voyage rapide et un wiki en jeu.
Tout se configure dans le panel web. Chaque commande est sa propre entrée : vous choisissez son nom et sa permission et vous n'ajoutez que les commandes voulues. Les messages sont partagés dans une seule entrée de configuration Tiny Essentials, et les fonctionnalités plus importantes (homes, chat, tab, calendrier) ont chacune leur propre entrée.
Les menus (homes, calendrier, voyage rapide, wiki) sont affichés avec l'extension GUI et la disposition que vous dessinez sur une page.
Fonctionnalités
- 29 entrées de commandes — fly, god, feed, heal, vanish, speed, gamemode, repair, back, TPA, messages, homes et plus encore, chacune avec un nom et une permission configurables.
- Homes — homes par joueur avec limites basées sur les permissions, délais de recharge, un menu paginé avec un éditeur (renommer, icône, supprimer) et un stockage enregistré.
- Demandes de téléportation —
/tpaet/tpahereavec délai d'expiration, bascule, et un historique/back. - Messages privés —
/msg,/replyet/msgtoggleavec codes de couleur neutralisés. - Format du chat — formats MiniMessage choisis par permission et priorité, partagés entre serveurs via Redis lorsque MySQL fonctionne en mode partagé.
- Tablist, scoreboard, bossbar — en-tête/pied de page, formatage des noms, tri, disposition de 80 emplacements, conditions et animations.
- Objets de connexion — objets donnés à la connexion ou à la réapparition avec commandes au clic et flags de protection.
- Scavenger — perte en pourcentage d'objets et d'expérience à la mort, objets protégés et pénalités basées sur des placeholders.
- Temps personnalisé et calendrier — durée du jour, calendrier avec mois, jours de la semaine et événements, menu de calendrier, facts, un filtre d'audience et placeholders.
- Voyage rapide et wiki — menu de voyage par région avec critères de verrouillage, et un guide en jeu composé de sections et d'articles.
Installation
- Installez PacketEvents, requis par les fonctionnalités de tablist.
- Installez l'extension MySQL, que TinyEssentials déclare comme dépendance (Redis est utilisé pour le chat inter-serveurs et la liste des joueurs du tab), et l'extension GUI pour les menus.
- Facultatif : installez Translate pour traduire le chat réseau pour les joueurs des autres serveurs.
- Placez le JAR de TinyEssentials dans
plugins/Typewriter/extensions/et redémarrez le serveur. - Accordez les permissions des commandes (voir le tableau des permissions) avec votre plugin de permissions. Les fonctionnalités de tab basées sur les groupes lisent des permissions nommées
group.<name>.
Premiers pas
- Dans le panel web TypeWriter, ouvrez une page static et ajoutez une entrée Tiny Essentials. Sans elle, chaque commande répond que TinyEssentials n'est pas configuré. Ajustez
defaultTeleportCooldown,tpaTimeoutSeconds,backBufferSizeet les messages. - Ajoutez les entrées de commandes voulues, par exemple /fly, /tpa et /back. Conservez ou modifiez
commandNameetpermission. - Pour les homes, ajoutez un Artifact Home et un Home Manager qui le référence dans
artifact, puis ajoutez /home et les autres commandes de homes. - Pour un format de chat, ajoutez un Chat Format avec des
groupstels queowner(permissiongroup.owner,priority10,format<gold>[Owner] <player><white>: <message>) et unfallbackFormat. - Publiez, accordez les permissions et testez avec un joueur.
Les messages de Tiny Essentials et de Home Manager utilisent des codes de couleur & et des jetons de type {player}. Les formats de chat, la tablist et les menus utilisent MiniMessage.
Fonctionnement
Chaque entrée de fonctionnalité est lue au moment où elle est nécessaire. Utilisez une seule entrée de chaque type (un Tiny Essentials, un Home Manager, un Chat Format, un Join Item, un Scavenger) : l'extension prend la première qu'elle trouve.
Configuration
Outre les entrées, TinyEssentials s'appuie sur ces règles d'exécution.
- Délai de recharge de téléportation —
/backet/tpaattendentdefaultTeleportCooldownsecondes, ou le plus grandcooldownSecondsparmi lescooldownRulesdont le joueur possède la permission. Sauf siallowMovementest activé, bouger annule la téléportation. Les téléportations vers l'atterrissage d'une perle de l'Ender ou d'un fruit de chorus ne sont pas conservées dans l'historique de/back. - Vanish et bascules — les états de vanish,
/msgtoggleet/tpatogglesont stockés sur le joueur : ils survivent donc aux redémarrages et aux reconnexions. - Fonctionnalités réseau — le chat et la liste des joueurs du tab utilisent Redis lorsque l'extension MySQL fonctionne avec une portée partagée ; sinon, ils restent locaux.
- Champs obsolètes dans Tiny Essentials — les champs de noms
...Command(msgCommand,flyCommand...) etbasePermissionne sont pas appliqués : les noms de commandes et les permissions se trouvent sur les entrées de commandes. Ces champs de noms n'apparaissent que dans les messages d'utilisation. Les champs de tabbossbarToggleCommandetscoreboardToggleCommandne sont pas non plus enregistrés comme commandes.
Menus
TinyEssentials fournit des types de boutons pour les pages construites avec l'extension GUI.
| Menu | Entrée | Types de boutons |
|---|---|---|
| Homes | Home Manager (menus configurés dans l'entrée elle-même) | Aucun : la disposition est définie dans homesMenu et homeEditorMenu. |
| Calendrier | Calendar Menu | calendar_button:DAY, WEEKDAY, EVENT, CALENDAR_SUMMARY, MONTH_NAV |
| Voyage rapide | Fast Travel Menu | travel_button:REGION_TAB, DESTINATION, REGION_SUMMARY |
| Wiki | Wiki Menu | wiki_button:SECTION_TAB, ARTICLE, PAGE_NAV |
Les menus de calendrier, de voyage rapide et de wiki utilisent la même approche : un châssis open_gui partagé (baseMenuId), un pool de dispositions et des vues. Les boutons indexés comme DAY ou DESTINATION sont remplis dans l'ordre à partir des données (la grille est un plafond d'affichage, les emplacements en trop restent vides).
Le menu des homes est paginé avec des boutons précédent, suivant et fermer, un objet de remplissage, un objet pour les emplacements de homes vides, et un éditeur ouvert en cliquant sur un home : téléportation, renommage dans le chat (saisissez cancel pour annuler), définition de l'icône à partir de l'objet tenu, réinitialisation de l'icône et suppression.
Commandes
Toutes les commandes sont des commandes brigadier enregistrées par des entrées : les clients bénéficient donc de l'autocomplétion. Aucune commande n'a d'alias. Sans la bonne permission, la commande est masquée. Les commandes ciblant un joueur acceptent un sélecteur de joueur ; agir sur quelqu'un d'autre nécessite la permission .others correspondante, vérifiée à l'exécution de la commande.
Commandes personnelles et du staff
| Commande | Description | Permission |
|---|---|---|
/fly [player] | Active ou désactive le vol. | tinyessentials.fly (autres : tinyessentials.fly.others) |
/god [player] | Active ou désactive l'invulnérabilité. | tinyessentials.god (autres : .god.others) |
/feed [player] | Restaure la faim et la saturation. | tinyessentials.feed (autres : .feed.others) |
/heal [player] | Restaure la santé, la faim, l'air et éteint le feu et le gel. | tinyessentials.heal (autres : .heal.others) |
/vanish [player] | Active ou désactive l'invisibilité pour les autres joueurs ; conservée après reconnexion. | tinyessentials.vanish (autres : .vanish.others) |
/gamemode <survival|creative|adventure|spectator> [player] | Change le mode de jeu. | tinyessentials.gamemode (autres : .gamemode.others) |
/speed <value> [walk|fly|sneak] [player] et /speed reset [walk|fly|sneak] | Définit la vitesse de -20 à 20. Ne fonctionne qu'en mode créatif. Sans type, les joueurs qui volent reçoivent la vitesse de vol, les autres la vitesse de marche. Changer la vitesse d'un autre joueur nécessite .speed.others. | tinyessentials.speed (autres : .speed.others) |
/suicide | Vous tue. | tinyessentials.suicide |
/repair | Répare l'outil, l'arme ou l'armure tenu (pas les blocs, pas les objets incassables). | tinyessentials.repair |
/invsee <player> | Ouvre l'inventaire d'un autre joueur. Le modifier nécessite tinyessentials.inventory.edit. | tinyessentials.inventory (cible : .inventory.others) |
/pocketmenu <type> [--consume] | Ouvre un menu vanilla : workbench, enchanting, anvil, smithing, grindstone, cartography, stonecutter, loom ou brewing. --consume fait consommer des niveaux à la table d'enchantement. | tinyessentials.pocketmenu |
Commandes de téléportation
| Commande | Description | Permission |
|---|---|---|
/back | Vous ramène à votre position précédente, avec délai de recharge. | tinyessentials.back |
/tpa <player> | Demande à se téléporter vers un joueur. | tinyessentials.tpa |
/tpahere <player> | Demande à un joueur de se téléporter vers vous. | tinyessentials.tpahere |
/tpaccept [player] | Accepte la dernière demande, ou celle du joueur nommé. | tinyessentials.tpaccept |
/tpadeny [player] | Refuse la dernière demande, ou celle du joueur nommé. | tinyessentials.tpadeny |
/tpatoggle | Arrête ou reprend la réception des demandes. | tinyessentials.tpatoggle |
/tppos <x> <y> [z] | Vous téléporte à des coordonnées. | tinyessentials.tppos |
/tpall | Téléporte tous les joueurs en ligne vers vous. | tinyessentials.tpall |
/getpos | Affiche votre position, votre rotation et votre monde. | tinyessentials.getpos |
Messages
| Commande | Description | Permission |
|---|---|---|
/msg <player> <message> | Envoie un message privé. | tinyessentials.msg |
/reply <message> | Répond à la dernière conversation. | tinyessentials.reply |
/msgtoggle | Arrête ou reprend la réception des messages privés. | tinyessentials.msgtoggle |
Homes — ils nécessitent aussi le basePermission du Home Manager si vous en définissez un.
| Commande | Description | Permission |
|---|---|---|
/home [name] | Vous téléporte vers un home ; sans nom, le home appelé home. | tinyessentials.homes.teleport |
/home list (ou ls) | Ouvre le menu des homes. | tinyessentials.homes.list |
/home set|add|create|save [name] | Enregistre un home à votre position. | tinyessentials.homes.set |
/home delete|del|remove|rm [name] | Supprime un home. | tinyessentials.homes.delete |
/sethome [name] | Enregistre un home. | tinyessentials.homes.set |
/delhome [name] | Supprime un home. | tinyessentials.homes.delete |
/homes | Ouvre le menu des homes. | tinyessentials.homes.list |
Calendrier
| Commande | Description | Permission |
|---|---|---|
/calendar | Ouvre le calendrier sur le mois en cours. /calendar month <prev|next|current> <player> est utilisé par les boutons de menu. | tinyessentials.calendar (laissez vide pour aucune) |
/timefact | Affiche les lignes de l'entrée Time Fact liée. | tinyessentials.timefact (laissez vide pour aucune) |
Le champ permission de chaque entrée de commande correspond par défaut à la permission des tableaux ci-dessus. Changez le nom de la commande avec commandName.
Permissions
| Permission | Autorise |
|---|---|
tinyessentials.<command> | L'utilisation de la commande, comme listé ci-dessus (valeurs par défaut du champ permission). |
tinyessentials.fly.others, god.others, feed.others, heal.others, vanish.others, gamemode.others, speed.others | Appliquer la commande à un autre joueur. |
tinyessentials.inventory.others | Ouvrir l'inventaire d'un autre joueur avec /invsee. |
tinyessentials.inventory.edit | Déplacer des objets dans l'inventaire inspecté. |
tinyessentials.homes.bypass (bypassPermission) | Ignorer les limites de homes et les délais de recharge de téléportation. |
tab.staff | Comptée par <tab_staffonline>. |
group.<name> | Sélectionne le groupe du tab et le tri par groupe. |
Champs tels que generalPermission, permission, cooldownRules, permissionLimits | Permissions que vous choisissez dans les entrées. |
Placeholders
TinyEssentials enregistre deux extensions MiniPlaceholders, utilisables comme balises MiniMessage.
| Placeholder | Renvoie |
|---|---|
<tab_online> | Joueurs en ligne. |
<tab_staffonline> | Joueurs en ligne ayant tab.staff. |
<tab_worldonline> | Joueurs dans le monde du spectateur. |
<tab_memory_used> / <tab_memory_max> | Mémoire utilisée et maximale en Mo. |
<tab_tps> | TPS du serveur (1 minute) avec deux décimales. |
<tab_date> / <tab_time> | Date (dd.MM.yyyy) et heure (HH:mm:ss) réelles de la machine. |
<tab_animation:name> | Image actuelle d'une animation de Tab Configuration. |
<calendar_date> | Date du calendrier, par exemple 3 Spring, an 12. |
<calendar_time> / <calendar_time_12h> | Heure en jeu sur une horloge de 24 ou 12 heures. |
<calendar_day>, <calendar_month>, <calendar_month_index>, <calendar_year>, <calendar_weekday> | Éléments de la date du calendrier. |
<calendar_day_of_year>, <calendar_total_day> | Numéro du jour dans l'année et depuis le début. |
<calendar_event> | Titre du premier événement du jour, vide s'il n'y en a pas. |
<calendar_next_event>, <calendar_next_event_days> | Titre du prochain événement et nombre de jours restants. |
Chaque placeholder calendar accepte en argument l'identifiant d'une entrée Minecraft Time, par exemple <calendar_date:my_calendar_id> ; sans lui, le premier calendrier est utilisé. Ils renvoient un texte vide lorsqu'aucune entrée Minecraft Time n'existe.
Les champs de texte du Home Manager utilisent {home}, {limit}, {cooldown}, {count}, {world} et des jetons similaires indiqués dans l'aide de chaque champ ; les textes de TPA et de messages utilisent {player}, {time}, {sender}, {receiver} et {message}.
Entrées
50 entrées, générées depuis la source de l'extension.
Actions3
- BTC Calendar MenuBTC Calendar Menu
- BTC Fast Travel MenuBTC Fast Travel Menu
- BTC Wiki MenuBTC Wiki Menu
Faits3
- Calendar Event FactCheck calendar events
- Is Day FactCheck calendar day/night phases
- Time Period FactCheck if the time is inside a range
Audiences1
- Time Window AudienceFilter players using the TinyEssentials calendar
Commandes29
- Tinyessentials Back CommandCommande /back
- Tinyessentials Calendar CommandCommande d'ouverture du calendrier
- Tinyessentials Delhome CommandCommande /delhome
- Tinyessentials Feed CommandCommande /feed
- Tinyessentials Fly CommandCommande /fly
- Tinyessentials Gamemode CommandCommande /gamemode
- Tinyessentials Getpos CommandCommande /getpos
- Tinyessentials God CommandCommande /god
- Tinyessentials Heal CommandCommande /heal
- Tinyessentials Home CommandCommande /home
- Tinyessentials Homes CommandCommande /homes
- Tinyessentials Invsee CommandCommande /invsee
- Tinyessentials Msg CommandCommande /msg
- Tinyessentials Msgtoggle CommandCommande /msgtoggle
- Tinyessentials Pocketmenu CommandCommande /pocketmenu
- Tinyessentials Repair CommandCommande /repair
- Tinyessentials Reply CommandCommande /reply
- Tinyessentials Sethome CommandCommande /sethome
- Tinyessentials Speed CommandCommande /speed
- Tinyessentials Suicide CommandCommande /suicide
- Tinyessentials Timefact CommandCommande d'affichage de la date
- Tinyessentials Tpa CommandCommande /tpa
- Tinyessentials Tpaccept CommandCommande /tpaccept
- Tinyessentials Tpadeny CommandCommande /tpadeny
- Tinyessentials Tpahere CommandCommande /tpahere
- Tinyessentials Tpall CommandCommande /tpall
- Tinyessentials Tpatoggle CommandCommande /tpatoggle
- Tinyessentials Tppos CommandCommande /tppos
- Tinyessentials Vanish CommandCommande /vanish
Placeholders1
- Minecraft TimeCustomise the length of days and manage a calendar
Artefacts2
- Artifact CalendarPersistent anchor for the custom calendar
- Artifact HomePersistent storage for player homes
Manifestes11
- Chat FormatFormat chat messages based on player groups
- FactProvide time related facts based on the minecraft_time entry
- Fast Travel DestinationDestination de voyage rapide
- Fast Travel RegionRegion de voyage rapide
- Home ManagerManage player homes with permissions and cooldowns
- Join ItemGive players custom items when they join
- ScavengerSave inventory and experience with penalties
- Tab ConfigurationConfigure TAB features for tablist, scoreboard, bossbar and more
- Tiny EssentialsEssential commands with configurable messages and cooldowns
- Wiki ArticleArticle du guide en jeu
- Wiki SectionSection du guide en jeu
Dépannage
TinyEssentials n'est pas configure : ajoutez une entree 'tiny_essentials' a une page. Une commande s'est exécutée sans entrée Tiny Essentials publiée. Ajoutez-en une à une page static et publiez.
Une commande n'existe pas ou est masquée. Chaque commande est une entrée : ajoutez l'entrée tinyessentials_..._command correspondante, publiez, et donnez au joueur sa permission. Un nom de commande modifié dans commandName remplace l'ancien.
Les maisons ne sont pas configurees. Il n'y a pas d'entrée Home Manager. Pour les erreurs de stockage (stockage des homes est indisponible), vérifiez que l'artifact du Home Manager pointe vers un Artifact Home.
Les joueurs ne peuvent pas du tout discuter. generalPermission de l'entrée Chat Format est définie et le joueur ne la possède pas : le message de chat est annulé. Laissez-la vide ou accordez la permission.
/back indique qu'il n'y a pas de position précédente. Seules les téléportations effectuées par des commandes et des plugins sont enregistrées. Les perles de l'Ender et les fruits de chorus sont ignorés, et l'historique conserve les backBufferSize derniers endroits.
/speed indique qu'il n'est disponible qu'en mode créatif. La commande est volontairement limitée au mode créatif pour ne pas entrer en conflit avec les statistiques RPG.
Les fonctionnalités de tablist ne font rien. PacketEvents doit être installé. tablistFormattingEnabled, layoutEnabled, bossbarEnabled et scoreboardEnabled sont des interrupteurs distincts, et les trois derniers sont désactivés par défaut.
Les placeholders du calendrier sont vides. Aucune entrée Minecraft Time n'est publiée, ou l'argument ne correspond à aucun identifiant d'entrée existant. Un menu ou une commande de calendrier a aussi besoin de son lien minecraft_time.