FAQ's

View All Frequently Asked Questions BEFORE ASKING QUESTIONS!!!!!!!

Q: What server versions does EasyChat support?

A: EasyChat supports Paper 1.21+ (recommended) and Spigot 1.21+. Paper is highly recommended for better performance and modern features.

Q: Do I need any dependencies?

A: EasyChat works standalone, but these plugins enhance functionality:

LuckPerms (highly recommended) - Advanced permission management
PlaceholderAPI (optional) - Dynamic placeholders
Vault (optional) - Economy and permission integration

Q: How do I reload the configuration without restarting?

A: Use /ec reload to reload all configuration files without restarting the server.

Q: Where are the configuration files located?

A: All config files are in plugins/EasyChat/:

config.yml - Main configuration
ai_moderation.yml - AI moderation settings
emojis.yml - Emoji definitions
layout.yml - Punishment layouts
player_tags.yml - Player tags
banned_words.yml - Word filter
disabled_commands.yml - Command blocking

Q: How do I set different chat formats for different ranks?

A: Edit config.yml under chat_format::

chat_format:
  default: '{player}: {message}'
  vip: '<gradient:green:aqua>{player}</gradient>: {message}'
  admin: '<red>ADMIN</red> {player}: {message}'

Q: How do I disable a feature I don't want?

A: Most features can be disabled in their respective config files:

AI Moderation: Set enabled: false in ai_moderation.yml
Word Filter: Set enabled: false in banned_words.yml
Emojis: Remove emoji permissions from groups

Q: How do I create hover and click effects?

A: Configure in config.yml under hover_n_click::

hover_n_click:
  1:
    click:
      action: SUGGEST_COMMAND
      value: /msg {player}
    hover:
      - 'Click to message {player}'

Then use {hnc_1}text{/hnc_1} in your chat format. You could Also use MiniMessages Hover and Click Formats But This Is Another Way!

Q: How do mentions work?

A: Players type @username in chat to mention others. The mentioned player receives a sound notification and sees highlighted text.

Q: Mentions aren't working. What's wrong?

A: Check:

Player has easychat.mention permission
Target player is online (unless offline mentions are enabled)
Mention settings are configured in config.yml
No typos in the username

Q: How do I configure @everyone mentions?

A: Edit config.yml:

mention_everyone:
  enabled: true
  permission: admin  # Only admins can use @everyone

Q: Can I customize mention sounds per group?

A: Yes! Configure different sounds per group in config.yml:

mentions:
  vip:
    sound:
      enabled: true
      sound: minecraft:block.note_block.chime
      volume: 1.0
      pitch: 1.5

Q: How do I use emojis in chat?

A: Type emoji shortcuts like :smile:, :heart:, :fire: in chat. Use Tab completion to see available emojis.

Q: How do I add custom emojis?

A: Edit emojis.yml:

emojis:
  my_custom:
    shortcuts: [":custom:", ":mine:"]
    unicode: "⭐"
    permission: "easychat.emoji.custom"

Q: How do I restrict emoji usage by rank?

A: Set permissions in the emoji configuration:

emojis:
  diamond:
    shortcuts: [":diamond:"]
    unicode: "💎"
    permission: "easychat.emoji.vip"  # Only VIPs can use

Q: How do I set up AI moderation?

Get an OpenAI API key from https://platform.openai.com/
Add it to ai_moderation.yml:

openai:
  api_key: 'your-actual-api-key-here'

A more detailed guide is on the AI Moderation Page

Q: How much does AI moderation cost?

A: OpenAI's Moderation API is free to use. You only pay for other OpenAI services if you use them.'

Q: What types of content can AI moderation detect?

A: The AI can detect:

Harassment and threatening behavior
Hate speech
Self-harm content
Sexual content (including minors)
Violence and graphic content

Q: AI moderation is blocking innocent messages. What do I do?

Adjust category settings in ai_moderation.yml
Change action from BLOCK to WARN or NOTHING
Add bypass permissions for trusted players
Review flagged messages in moderation/flagged.yml

MORE SETTING WILL COME SOON TO AVOID THIS!

Q: AI moderation is slow. How can I speed it up?

Enable caching in ai_moderation.yml
Increase timeout values
Use faster internet connection

Q: How do I set up Discord integration?

Create a Discord bot at https://discord.com/developers/applications
Get the bot token and add it to your Discord configuration
Invite the bot to your Discord server with appropriate permissions
Configure channel mappings between Minecraft and Discord

MORE DETAILED GUIDE ON THE DISCORD PAGE