LilsInfo

A lightweight Paper plugin that adds interactive information sharing directly to Minecraft chat.

Share items, inventories, coordinates, biomes, and ping using simple chat tags without replacing or taking over your existing chat system.

Features

• Share your held item with [item]
• Share your offhand item with [offhand]
• Share a clickable snapshot of your inventory with [inventory]
• Share clickable coordinates with [coords]
• Share your current biome with [biome]
• Share your current ping with [ping]
• Configurable aliases for every tag
• Configurable maximum tags per message
• Coordinate sharing world blacklist
• Runtime configuration reload
• Case-insensitive tags
• Adventure-powered interactive components
• No database, repeating tasks, or persistent player tracking

Chat Tags

[item]

Shares the item currently held in your main hand.

Alias:

[hand]

The shared item includes its actual Minecraft hover tooltip, including custom names, lore, enchantments, and other item information.

[offhand]

Shares the item currently held in your offhand.

The shared item also includes its normal Minecraft hover tooltip.

[inventory]

Shares a read-only snapshot of your inventory.

Alias:

[inv]

Clicking the chat component opens a showcase containing:

• Main inventory
• Hotbar
• Armour
• Offhand

The showcase represents the inventory at the moment the message was sent and cannot be modified by viewers.

Inventory showcase callbacks expire automatically after a limited period.

[coords]

Shares your current block coordinates.

Alias:

[pos]

Coordinates can be clicked to copy them to the clipboard.

Hover information can optionally include:

• World
• Biome

Coordinate sharing can also be disabled in configured worlds.

[biome]

Shares your current biome with a readable display name.

The raw namespaced biome key is available on hover.

[ping]

Shares your current connection latency in milliseconds.

Commands

Command	Description	Permission
/info	Shows available LilsInfo tags	None
/info reload	Reloads the configuration	lilsinfo.admin
/lilsinfo	Alias of /info	None
/linfo	Alias of /info	None

Configuration

tags:

  item:
    enabled: true
    aliases:
      - item
      - hand

  offhand:
    enabled: true
    aliases:
      - offhand

  inventory:
    enabled: true
    aliases:
      - inventory
      - inv

  coords:
    enabled: true
    aliases:
      - coords
      - pos

  biome:
    enabled: true
    aliases:
      - biome

  ping:
    enabled: true
    aliases:
      - ping

coords:
  include-world: true
  include-biome: true
  disabled-worlds: []

limits:
  max-tags-per-message: 5

Configuration can be reloaded without restarting the server:

/info reload

Compatibility

LilsInfo modifies only supported information tags inside chat messages.

It does not provide or replace:

• Chat formatting
• Player prefixes or suffixes
• Chat channels
• Moderation
• Permissions management

This allows it to remain lightweight and coexist with existing chat systems.

Performance

LilsInfo is designed to perform practically no work for ordinary chat messages.

Messages without recognised information tags are immediately ignored.

Player information is captured only when required by a tag, and only the information required by the tags in that particular message is captured.

The plugin uses:

• No database
• No repeating scheduler
• No persistent inventory snapshots
• No per-tick processing
• No player tracking

Requirements

• Paper 26.2+
• Java 25

Building

Clone the repository and run:

./gradlew build

On Windows:

.\gradlew.bat build

The compiled plugin will be available in:

build/libs/

License

LilsInfo is licensed under the MIT License.