# FAQ's

#### **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:`:

```yaml
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:`:

```yaml
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`:

```yaml
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`:

```yaml
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`:

```yaml
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:

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

***

**Q: How do I set up AI moderation?**

**A:**

1. Get an OpenAI API key from <https://platform.openai.com/>
2. Add it to `ai_moderation.yml`:

```yaml
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?**

**A:**

* 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?**

**A:**

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

***

**Q: How do I set up Discord integration?**

**A:**

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

MORE DETAILED GUIDE ON THE DISCORD PAGE

{% hint style="danger" %}
This feature is removed and will be re-written.
{% endhint %}

***

**Q: Messages aren't syncing between Discord and Minecraft. Why?**

**A:** Check:

* Bot has correct permissions in Discord channels
* Bot token is correct and not expired
* Channel IDs are configured correctly
* No firewall blocking the connection
* Check console for error messages

{% hint style="danger" %}
This feature is removed and will be re-written.
{% endhint %}

***

**Q: How do I link my Minecraft account to Discord?**

**A:** Use `/discord link` in-game and follow the instructions provided by the bot.

{% hint style="danger" %}
This feature is removed and will be re-written.
{% endhint %}

***

**Q: Can I sync roles between Discord and Minecraft?**

**A:** Yes! Configure role synchronization in the Discord settings to automatically assign Minecraft permissions based on Discord roles.

{% hint style="danger" %}
This feature is removed and will be re-written.
{% endhint %}

***

**Q: Discord bot shows as offline. What's wrong?**

**A:**

* Check bot token validity
* Ensure bot has proper permissions
* Check internet connectivity
* Look for error messages in console
* Verify Discord API status

{% hint style="danger" %}
This feature is removed and will be re-written.
{% endhint %}

***

**Q: How do I ban/mute players?**

**A:** Use punishment commands:

```bash
/ban PlayerName 7d Griefing
/mute PlayerName 30m Spamming
/warn PlayerName Follow server rules
/kick PlayerName Inappropriate behavior
```

***

**Q: What are punishment layouts?**

**A:** Layouts are predefined reasons and durations. Use them with `@` or `#`:

```bash
/ban PlayerName @griefing      # Uses predefined reason
/tempban PlayerName #spam      # Uses escalating duration template
```

***

**Q: How do I view a player's punishment history?**

**A:** Use `/history PlayerName` to see all past punishments for a player.

***

**Q: Can I make punishments escalate automatically?**

**A:** Yes! Configure time layouts in `layout.yml`:

```yaml
time:
  spam:
    durations:
      - "30m"   # First offense
      - "2h"    # Second offense
      - "12h"   # Third offense
      - "1d"    # Fourth offense
```

{% hint style="warning" %}
This is experimental and may or may not work
{% endhint %}

***

**Q: How do I do silent punishments?**

**A:** Add the `-s` flag to any punishment command:

```bash
/ban -s PlayerName Cheating  # Silent ban - no public announcement
```

***

**Q: Chat messages appear twice. Why?**

**A:**

* Another chat plugin is conflicting
* Multiple chat event handlers are active
* Check for duplicate plugins

***

**Q: Can I use EasyChat with EssentialsX Chat?**

**A:** It's not recommended to run both simultaneously as they both handle chat formatting. Choose one or the other.

***

## Need More Help? Check <a href="support" class="button primary" data-icon="heart-circle-plus">Support!</a>
