       _                 _                 _      _____   _____ 
      | |               | |               | |    |  __ \ / ____|
      | | ___   ___  ___| |__   ___  ___  | |    | |__) | |     
  _   | |/ _ \ / _ \/ __| '_ \ / _ \/ __| | |    |  ___/| |     
 | |__| | (_) |  __/\__ \ | | |  __/\__ \ | |____| |    | |____ 
  \____/ \___/ \___||___/_| |_|\___||___/ |______|_|     \_____|

JoehesLPC

A modern, highly-optimized LuckPerms Chat Formatter natively targeting Minecraft 1.21+

🧩 Compatibility (｀・ω・´)

Component	Target / Requirement
Minecraft Server	`1.21` and all newer versions (`1.21+`)
Supported Software	Paper (Recommended), Folia, or Spigot
Java Environment	`25+`

🔧 Requirements (◕‿◕)

LuckPerms (Required) – Core permissions and metadata provider.
PlaceholderAPI (Optional) – To integrate extra placeholder variables inside chat formats.

✅ Features (o^▽^o)

💬 Modern Chat Formatting: Full MiniMessage rendering engine with group and track formats.
👥 Social System: Interactive @Mention pings (sound/action-bar on Paper), clickable openUrl links, and configurable text-to-glyph emoji shortcuts (e.g., :heart: → ❤).

📂 Configuration & Commands (✿◠‿◠)

📂 Click to expand default config.yml

# Main chat format (MiniMessage!)
chat-format: "{prefix}{name}<dark_gray> »<reset> {message}"

# Per-group formats (optional)
group-formats:
#  default: "<gray>[User]</gray> {name}<dark_gray> »<reset> {message}"
#  admin: "<red>[Admin]</red> {name}<dark_gray> »<reset> {message}"

# Per-track formats (optional)
track-formats:
#  staff_track: "<gold>[Staff]</gold> {name}<dark_gray> »<reset> {message}"

# Enable the [item] placeholder (shows held item details on hover)
use-item-placeholder: true

# Allow <gradient> / <rainbow> for players with joeheslpc.chatcolor
allow-gradient-tags: true

# Worlds where JoehesLPC does NOT format chat
disabled-worlds: []

# Check Modrinth for updates on startup
update-checker: true

# Reload message
reload-message: "<green>Reloaded JoehesLPC configuration!"

⌨️ Click to expand Commands & Permissions

Command	Permission	Description
`/jlpc reload`	`joeheslpc.reload`	Reloads the configuration
`/jlpc version`	–	Shows the current installed version
`/jlpc help`	–	Displays available commands

Note: The command supports aliases /lpc and /joeheslpc for legacy compatibility.

🛠️ Building & Compilation (￣▽￣)

Requires JDK 25 to compile.

./gradlew shadowJar
# Compiled jar will be located at build/libs/JoehesLPC-1.21.11.jar