Emojis

Emojis are a way to send custom emoticons or Emojis in chat, You can also lock them to specific Groups/Ranks!

Emoji Settings can be configured in config.yml :

# Emoji settings
# Configure how emojis work in chat
emoji:
  # Whether tab completion is enabled for emojis
  tab_completion_enabled: true
  # Whether emoji permissions are checked
  permissions_enabled: true
  # Message shown when a player doesn't have permission to use an emoji
  no_permission_message: "<red>You don't have permission to use this emoji.</red>"

Actual Emojis and additions are provided in emojis.yml :

# EasyChat Emoji Configuration
# 
# Format:
# emoji_id:
#   shortcuts: [":shortcut1:", ":shortcut2:"]  # Multiple shortcuts in list format
#   unicode: "⭐"             # The unicode character to display (optional if font is used)
#   font: "default"           # The font to use for this emoji (optional)
#   permission: "easychat.emoji.example"  # Permission required to use this emoji (optional)
#
# You can use either unicode characters directly or custom fonts with resource packs

emojis:
  # Basic emoticons
  smile:
    shortcuts: [":)", ":smile:", ":happy:"]
    unicode: "☺"
    permission: "easychat.emoji.basic"
  
  sad:
    shortcuts: [":(", ":sad:", ":unhappy:"]
    unicode: "☹"
    permission: "easychat.emoji.basic"
    
  heart:
    shortcuts: [":heart:", "<3", ":love:"]
    unicode: "❤"
    permission: "easychat.emoji.basic"
    
  star:
    shortcuts: [":star:"]
    unicode: "⭐"
    permission: "easychat.emoji.basic"
    
  check:
    shortcuts: [":check:", ":tick:"]
    unicode: "✓"
    permission: "easychat.emoji.basic"
    
  cross:
    shortcuts: [":cross:", ":x:"]
    unicode: "✗"
    permission: "easychat.emoji.basic"
  
  # Shrug emoji (example with longer sequence)
  shrug:
    shortcuts: [":shrug:"]
    unicode: "¯\\_(ツ)_/¯"
    permission: "easychat.emoji.basic"
    
  # Advanced emojis with custom font (requires resource pack)
  diamond:
    shortcuts: [":diamond:"]
    unicode: "⌘"  # This character would be replaced with custom glyph in resource pack
    font: "minecraft:custom"
    permission: "easychat.emoji.advanced"
    
  sword:
    shortcuts: [":sword:"]
    unicode: "⚔"
    font: "minecraft:custom"
    permission: "easychat.emoji.advanced"
    
  # Special emojis with higher permission requirements
  rainbow:
    shortcuts: [":rainbow:"]
    unicode: "🌈"
    permission: "easychat.emoji.special"
    
  fire:
    shortcuts: [":fire:", ":flame:"]
    unicode: "🔥"
    permission: "easychat.emoji.special"

---

When Players want to view ALL available emojis they can do /emoji in chat, you can change how its displayed in emoji_display.yml This Feature MAY OR MAY NOT CHANGE IN THE FUTURE

# EasyChat Emoji Display Configuration
# This file controls how the emoji list is displayed to players

# Layout settings
layout:
  # Header shown at the top of the emoji list
  header: "<gold>Available Emojis:</gold>"
  
  # Message shown when no emojis are available
  no_emojis_message: "<yellow>No emojis available.</yellow>"
  
  # Message shown when a category has no emojis
  empty_category_message: "<gray>No emojis in this category.</gray>"
  
  # Category header format (use {category} as placeholder)
  category_header: "<gray>― {category} ―</gray>"
  
  # Locked category header format (use {category} as placeholder)
  locked_category_header: "<red>― {category} [LOCKED] ―</red>"
  
  # Message shown under locked categories
  locked_category_message: "<gray>You don't have access to these emojis. Unlock with permissions.</gray>"
  
  # Number of emojis per line
  emojis_per_line: 8
  
  # Spacer between emojis
  emoji_spacer: " "
  
  # Hover text format (use {shortcuts} as placeholder for comma-separated shortcuts)
  hover_format: "<yellow>{shortcuts}</yellow>"
  
  # Hover text format for locked emojis (use {permission} as placeholder for required permission)
  locked_hover_format: "<red>Locked: Requires {permission}</red>"
  
  # Separator used between shortcuts in hover text
  shortcut_separator: "</yellow><gray>, </gray><yellow>"

# Category settings
categories:
  # Whether to show categories
  show_categories: true
  
  # Default category name (for emojis without a category)
  default_category_name: "GENERAL"
  
  # Category display names (custom category -> display name)
  display_names:
    "faces": "FACES"
    "symbols": "SYMBOLS"
    "animals": "ANIMALS"
    "food": "FOOD"
    "special": "SPECIAL"
  
  # Category order (lower numbers first)
  order:
    "general": 0
    "faces": 10
    "symbols": 20
    "animals": 30
    "food": 40
    "special": 50
  
  # Whether to show empty categories
  show_empty_categories: false
  
  # Categories to hide (list of category names)
  hidden_categories:
    - "hidden"
    
  # Format for emojis in locked categories
  locked_emoji_format: "<red>{emoji}</red>"

# Custom emoji categories
# Define which emojis belong to which category using emoji IDs
emoji_categories:
  # Default category for any emoji not assigned to a specific category
  default_category: "general"
  
  # Map of category name to list of emoji IDs
  mappings:
    "faces":
      - "smile"
      - "sad"
      - "wink"
      - "cool"
    "symbols":
      - "heart"
      - "star"
      - "music"
    "animals":
      - "dog"
      - "cat"
      - "penguin"
    "food":
      - "pizza"
      - "cake"
    "special":
      - "rainbow"
      - "unicorn"

# Filter settings
filters:
  # List of emoji IDs to hide from display
  hidden_emojis:
    - "hidden_emoji1"
    - "hidden_emoji2"
  
  # Whether to show emojis the player doesn't have permission for
  show_locked_emojis: true
  
  # Whether to show emojis in locked categories
  show_locked_categories: true