TinyEssentials
Descripción general
TinyEssentials es la capa de "essentials" de un servidor BTC, inspirada en EssentialsX y construida sobre TypeWriter. Aporta 29 comandos de jugador y de staff (homes, solicitudes de teletransporte, mensajes, vuelo, vanish, curar...), un formateador de chat, items de entrada, una penalización por muerte ("scavenger"), un gestor de tablist, scoreboard y bossbar, una duración de día personalizada con un calendario, un menú de viaje rápido y una wiki dentro del juego.
Todo se configura en el panel web. Cada comando es su propia entrada, así que eliges su nombre y su permiso y solo añades los comandos que quieres. Los mensajes se comparten en una única entrada de configuración Tiny Essentials, y las funciones mayores (homes, chat, tab, calendario) tienen cada una su propia entrada.
Los menús (homes, calendario, viaje rápido, wiki) se renderizan con la extensión GUI y el layout que dibujas en una página.
Características
- 29 entradas de comando — volar, god, alimentar, curar, vanish, velocidad, modo de juego, reparar, back, TPA, mensajes, homes y más, cada una con un nombre y un permiso configurables.
- Homes — homes por jugador con límites basados en permisos, enfriamientos, un menú paginado con un editor (renombrar, icono, eliminar) y almacenamiento guardado.
- Solicitudes de teletransporte —
/tpay/tpaherecon tiempo de espera, alternancia y un historial de/back. - Mensajes privados —
/msg,/replyy/msgtogglecon los códigos de color neutralizados. - Formato de chat — formatos MiniMessage elegidos por permiso y prioridad, compartidos entre servidores mediante Redis cuando MySQL funciona en modo compartido.
- Tablist, scoreboard, bossbar — cabecera/pie, formato de nombres, ordenación, disposición de 80 ranuras, condiciones y animaciones.
- Items de entrada — items entregados al conectarse o reaparecer con comandos de clic y flags de protección.
- Scavenger — pérdida porcentual de objetos y experiencia al morir, objetos protegidos y penalizaciones basadas en placeholders.
- Hora personalizada y calendario — duración del día, calendario con meses, días de la semana y eventos, menú de calendario, facts, un filtro de audiencia y placeholders.
- Viaje rápido y wiki — un menú de viaje por regiones con criterios de bloqueo, y una guía dentro del juego hecha de secciones y artículos.
Instalación
- Instala PacketEvents, necesario para las funciones de tablist.
- Instala la extensión MySQL, que TinyEssentials declara como dependencia (Redis se usa para el chat entre servidores y la lista de la tab), y la extensión GUI para los menús.
- Opcionalmente, instala Translate para traducir el chat de la red a los jugadores de otros servidores.
- Coloca el JAR de TinyEssentials en
plugins/Typewriter/extensions/y reinicia el servidor. - Da los permisos de los comandos (consulta la tabla de Permisos) con tu plugin de permisos. Las funciones de tab basadas en grupos leen permisos llamados
group.<name>.
Primeros pasos
- En el panel web de TypeWriter, abre una página static y añade una entrada Tiny Essentials. Sin ella, todos los comandos responden que TinyEssentials no está configurado. Ajusta
defaultTeleportCooldown,tpaTimeoutSeconds,backBufferSizey los mensajes. - Añade las entradas de comando que quieras, por ejemplo /fly, /tpa y /back. Mantén o cambia
commandNameypermission. - Para los homes, añade un Artifact Home y un Home Manager que lo referencie en
artifact, y luego añade /home y los demás comandos de homes. - Para un formato de chat, añade un Chat Format con
groupscomoowner(permisogroup.owner,priority10,format<gold>[Owner] <player><white>: <message>) y unfallbackFormat. - Publica, concede los permisos y prueba con un jugador.
Los mensajes de Tiny Essentials y Home Manager usan códigos de color & y tokens del estilo {player}. Los formatos de chat, la tablist y los menús usan MiniMessage.
Cómo funciona
Cada entrada de función se lee cuando se necesita. Usa una única entrada de cada tipo (una Tiny Essentials, un Home Manager, un Chat Format, un Join Item, un Scavenger): la extensión toma la primera que encuentra.
Configuración
Además de las entradas, TinyEssentials se apoya en estas reglas de ejecución.
- Enfriamiento de teletransporte —
/backy/tpaesperandefaultTeleportCooldownsegundos, o el mayorcooldownSecondsentre lascooldownRulescuyo permiso tenga el jugador. Salvo queallowMovementesté activado, moverse cancela el teletransporte. Los teletransportes por perla de ender o por aterrizaje de fruta de coro no se guardan en el historial de/back. - Vanish y alternancias — los estados de vanish,
/msgtoggley/tpatogglese almacenan en el jugador, así que sobreviven a reinicios y reconexiones. - Funciones de red — el chat y la lista de la tab usan Redis cuando la extensión MySQL funciona con un ámbito compartido; si no, se quedan locales.
- Campos obsoletos en Tiny Essentials — los campos de nombre
...Command(msgCommand,flyCommand...) ybasePermissionno se aplican: los nombres y permisos de los comandos viven en las entradas de comando. Esos campos de nombre solo aparecen en los mensajes de uso. Los campos de tabbossbarToggleCommandyscoreboardToggleCommandtampoco se registran como comandos.
Menús
TinyEssentials aporta tipos de botón para las páginas construidas con la extensión GUI.
| Menú | Entrada | Tipos de botón |
|---|---|---|
| Homes | Home Manager (menús configurados en la propia entrada) | Ninguno: el layout se establece en homesMenu y homeEditorMenu. |
| Calendario | Calendar Menu | calendar_button:DAY, WEEKDAY, EVENT, CALENDAR_SUMMARY, MONTH_NAV |
| Viaje rápido | Fast Travel Menu | travel_button:REGION_TAB, DESTINATION, REGION_SUMMARY |
| Wiki | Wiki Menu | wiki_button:SECTION_TAB, ARTICLE, PAGE_NAV |
Los menús de calendario, viaje rápido y wiki usan el mismo enfoque: un chasis open_gui compartido (baseMenuId), un conjunto de layouts y vistas. Los botones indexados como DAY o DESTINATION se rellenan en orden a partir de los datos (la cuadrícula es un techo de visualización, las ranuras sobrantes quedan vacías).
El menú de homes está paginado con botones de anterior, siguiente y cerrar, un item de relleno, un item para las ranuras de home vacías y un editor que se abre al hacer clic en un home: teletransportar, renombrar en el chat (escribe cancel para cancelar), establecer el icono a partir del objeto sostenido, restablecer el icono y eliminar.
Comandos
Todos los comandos son comandos brigadier registrados por entradas, así que los clientes obtienen autocompletado. Ningún comando tiene alias. Sin el permiso adecuado, el comando está oculto. Los comandos que apuntan a jugadores aceptan un selector de jugadores; actuar sobre otra persona necesita el permiso .others correspondiente, que se comprueba cuando se ejecuta el comando.
Comandos propios y de staff
| Comando | Descripción | Permiso |
|---|---|---|
/fly [player] | Alterna el vuelo. | tinyessentials.fly (otros: tinyessentials.fly.others) |
/god [player] | Alterna la invulnerabilidad. | tinyessentials.god (otros: .god.others) |
/feed [player] | Restaura el hambre y la saturación. | tinyessentials.feed (otros: .feed.others) |
/heal [player] | Restaura la salud, el hambre, el aire y apaga el fuego y la congelación. | tinyessentials.heal (otros: .heal.others) |
/vanish [player] | Alterna la invisibilidad ante otros jugadores; se mantiene tras reconectar. | tinyessentials.vanish (otros: .vanish.others) |
/gamemode <survival|creative|adventure|spectator> [player] | Cambia el modo de juego. | tinyessentials.gamemode (otros: .gamemode.others) |
/speed <value> [walk|fly|sneak] [player] y /speed reset [walk|fly|sneak] | Establece la velocidad de -20 a 20. Solo funciona en modo creativo. Sin un tipo, los jugadores que vuelan reciben velocidad de vuelo y los demás velocidad de caminar. Cambiar la velocidad de otro jugador necesita .speed.others. | tinyessentials.speed (otros: .speed.others) |
/suicide | Te mata. | tinyessentials.suicide |
/repair | Repara la herramienta, arma o armadura sostenida (no bloques ni objetos irrompibles). | tinyessentials.repair |
/invsee <player> | Abre el inventario de otro jugador. Editarlo necesita tinyessentials.inventory.edit. | tinyessentials.inventory (objetivo: .inventory.others) |
/pocketmenu <type> [--consume] | Abre un menú de vanilla: workbench, enchanting, anvil, smithing, grindstone, cartography, stonecutter, loom o brewing. --consume hace que la mesa de encantamientos consuma niveles. | tinyessentials.pocketmenu |
Comandos de teletransporte
| Comando | Descripción | Permiso |
|---|---|---|
/back | Vuelve a tu ubicación anterior, con enfriamiento. | tinyessentials.back |
/tpa <player> | Pide teletransportarte a un jugador. | tinyessentials.tpa |
/tpahere <player> | Pide a un jugador que se teletransporte a ti. | tinyessentials.tpahere |
/tpaccept [player] | Acepta la última solicitud, o la del jugador indicado. | tinyessentials.tpaccept |
/tpadeny [player] | Rechaza la última solicitud, o la del jugador indicado. | tinyessentials.tpadeny |
/tpatoggle | Deja de recibir solicitudes o las reanuda. | tinyessentials.tpatoggle |
/tppos <x> <y> [z] | Teletransporta a unas coordenadas. | tinyessentials.tppos |
/tpall | Teletransporta a todos los jugadores conectados hacia ti. | tinyessentials.tpall |
/getpos | Muestra tu posición, rotación y mundo. | tinyessentials.getpos |
Mensajes
| Comando | Descripción | Permiso |
|---|---|---|
/msg <player> <message> | Envía un mensaje privado. | tinyessentials.msg |
/reply <message> | Responde a la última conversación. | tinyessentials.reply |
/msgtoggle | Deja de recibir mensajes privados o los reanuda. | tinyessentials.msgtoggle |
Homes — requieren también el basePermission del Home Manager si estableces uno.
| Comando | Descripción | Permiso |
|---|---|---|
/home [name] | Teletransporta a un home; sin nombre, al home llamado home. | tinyessentials.homes.teleport |
/home list (o ls) | Abre el menú de homes. | tinyessentials.homes.list |
/home set|add|create|save [name] | Guarda un home en tu posición. | tinyessentials.homes.set |
/home delete|del|remove|rm [name] | Elimina un home. | tinyessentials.homes.delete |
/sethome [name] | Guarda un home. | tinyessentials.homes.set |
/delhome [name] | Elimina un home. | tinyessentials.homes.delete |
/homes | Abre el menú de homes. | tinyessentials.homes.list |
Calendario
| Comando | Descripción | Permiso |
|---|---|---|
/calendar | Abre el calendario en el mes actual. /calendar month <prev|next|current> <player> lo usan los botones del menú. | tinyessentials.calendar (déjalo vacío para ninguno) |
/timefact | Imprime las líneas de la entrada Time Fact enlazada. | tinyessentials.timefact (déjalo vacío para ninguno) |
El campo permission de cada entrada de comando es por defecto el permiso de las tablas anteriores. Cambia el nombre del comando con commandName.
Permisos
| Permiso | Concede |
|---|---|
tinyessentials.<command> | Uso del comando, como se lista arriba (valores por defecto del campo permission). |
tinyessentials.fly.others, god.others, feed.others, heal.others, vanish.others, gamemode.others, speed.others | Aplicar el comando a otro jugador. |
tinyessentials.inventory.others | Abrir el inventario de otro jugador con /invsee. |
tinyessentials.inventory.edit | Mover objetos en el inventario inspeccionado. |
tinyessentials.homes.bypass (bypassPermission) | Ignorar los límites de homes y los enfriamientos de teletransporte. |
tab.staff | Contado por <tab_staffonline>. |
group.<name> | Selecciona el grupo de la tab y la ordenación por grupo. |
Campos como generalPermission, permission, cooldownRules, permissionLimits | Permisos que eliges en las entradas. |
Placeholders
TinyEssentials registra dos expansiones de MiniPlaceholders, utilizables como etiquetas MiniMessage.
| Placeholder | Devuelve |
|---|---|
<tab_online> | Jugadores conectados. |
<tab_staffonline> | Jugadores conectados con tab.staff. |
<tab_worldonline> | Jugadores en el mundo del espectador. |
<tab_memory_used> / <tab_memory_max> | Memoria usada y máxima en MB. |
<tab_tps> | TPS del servidor (1 minuto) con dos decimales. |
<tab_date> / <tab_time> | Fecha (dd.MM.yyyy) y hora (HH:mm:ss) reales de la máquina. |
<tab_animation:name> | Fotograma actual de una animación de Tab Configuration. |
<calendar_date> | Fecha del calendario, por ejemplo 3 Spring, an 12. |
<calendar_time> / <calendar_time_12h> | Hora del juego en reloj de 24 o 12 horas. |
<calendar_day>, <calendar_month>, <calendar_month_index>, <calendar_year>, <calendar_weekday> | Partes de la fecha del calendario. |
<calendar_day_of_year>, <calendar_total_day> | Número de día en el año y desde el inicio. |
<calendar_event> | Título del primer evento de hoy, vacío si no hay ninguno. |
<calendar_next_event>, <calendar_next_event_days> | Título del próximo evento y días que faltan. |
Cada placeholder calendar acepta como argumento el id de una entrada Minecraft Time, por ejemplo <calendar_date:my_calendar_id>; sin él se usa el primer calendario. Devuelven un texto vacío cuando no existe ninguna entrada Minecraft Time.
Los campos de texto del Home Manager usan {home}, {limit}, {cooldown}, {count}, {world} y tokens similares indicados en la ayuda de cada campo; los textos de TPA y de mensajes usan {player}, {time}, {sender}, {receiver} y {message}.
Entradas
50 entradas, generadas a partir del código fuente de la extensión.
Acciones3
- BTC Calendar MenuBTC Calendar Menu
- BTC Fast Travel MenuBTC Fast Travel Menu
- BTC Wiki MenuBTC Wiki Menu
Hechos3
- Calendar Event FactCheck calendar events
- Is Day FactCheck calendar day/night phases
- Time Period FactCheck if the time is inside a range
Audiencias1
- Time Window AudienceFilter players using the TinyEssentials calendar
Comandos29
- 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
Artefactos2
- Artifact CalendarPersistent anchor for the custom calendar
- Artifact HomePersistent storage for player homes
Manifiestos11
- 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
Solución de problemas
TinyEssentials n'est pas configure : ajoutez une entree 'tiny_essentials' a une page. Se ejecutó un comando sin una entrada Tiny Essentials publicada. Añade una a una página static y publica.
Un comando no existe o está oculto. Cada comando es una entrada: añade la entrada tinyessentials_..._command correspondiente, publica y da al jugador su permission. Un nombre de comando cambiado en commandName sustituye al antiguo.
Les maisons ne sont pas configurees. No hay ninguna entrada Home Manager. Para los errores de almacenamiento (stockage des homes est indisponible), comprueba que el artifact del Home Manager apunta a un Artifact Home.
Los jugadores no pueden chatear en absoluto. generalPermission de la entrada Chat Format está establecido y el jugador no lo tiene: el mensaje de chat se cancela. Déjalo vacío o concede el permiso.
/back dice que no hay ubicación anterior. Solo se registran los teletransportes hechos por comandos y plugins. Las perlas de ender y las frutas de coro se ignoran, y el historial conserva los últimos backBufferSize lugares.
/speed dice que solo está disponible en modo creativo. El comando está restringido deliberadamente al modo creativo para que no choque con las estadísticas de RPG.
Las funciones de tablist no hacen nada. PacketEvents debe estar instalado. tablistFormattingEnabled, layoutEnabled, bossbarEnabled y scoreboardEnabled son interruptores independientes, y los tres últimos están desactivados por defecto.
Los placeholders del calendario están vacíos. No hay ninguna entrada Minecraft Time publicada, o el argumento no coincide con el id de una entrada existente. Un menú o comando de calendario necesita también su enlace minecraft_time.