==================================================
聊天插件安装
==================================================

本节介绍群组服环境下的聊天插件选型、安装、权限配置、命令冲突解决与常见问题，适用于所有分区。

插件简介
==================================================
群组服每个分区都是独立进程，通过 Proxy 代理，默认聊天无法跨区。需要专门的聊天插件实现全服/跨服聊天。

常用聊天插件对比
==================================================
.. csv-table:: Minecraft聊天插件对比
   :header: "插件名称", "是否免费", "核心功能", "格式美化", "权限控制", "多频道支持", "兼容性", "备注"
   :widths: 15, 10, 20, 12, 12, 12, 15, 14

   "VentureChat", "是", "多频道管理、跨服聊天", "高", "细粒度", "是", "Spigot/Paper/BungeeCord", "功能全面，支持自定义过滤器"
   "TrChat", "是", "聊天格式化、防刷屏", "中", "基础", "是", "Spigot/Paper", "轻量型，配置简单"
   "DeluxeChat", "否（付费）", "高级格式化、气泡聊天", "极高", "细粒度", "是", "Spigot/Paper", "付费插件，支持GUI配置和动画效果"
   "VaultChatFormatter", "是", "基础聊天格式化", "中", "基础", "否", "依赖Vault", "仅专注格式美化，需配合其他插件使用"
   "EssentialsX Chat", "是", "基础聊天管理、前缀后缀", "低", "基础", "是", "EssentialsX生态", "适合简单需求，依赖EssentialsX核心"
   "ChatEx", "是", "扩展格式化、聊天日志", "中", "中等", "是", "Spigot/Paper", "支持JSON格式消息，适合技术型配置"
   "Stylizer", "是", "文本样式美化、符号替换", "高", "低", "否", "Spigot/Paper", "专注文本样式，支持Unicode字符美化"
   "DisplayFormatter", "是", "玩家名/聊天格式统一管理", "中", "基础", "否", "Spigot/Paper", "轻量，适合统一显示风格"
   "CarbonChat (beta)", "是（测试版）", "现代聊天系统、跨平台支持", "高", "细粒度", "是", "Spigot/Paper/Velocity", "beta版，支持1.19+新特性"
   "ChatControl", "否（付费）", "反垃圾信息、聊天监控", "中", "高", "是", "Spigot/Paper/BungeeCord", "付费插件，侧重聊天安全和过滤"
   "CMI", "否（付费）", "全能型插件含聊天模块", "高", "极高", "是", "Spigot/Paper", "付费全能插件，聊天功能只是其中一部分"

推荐选择项
==================================================
- **CarbonChat**：现代化、跨平台、支持群组服跨服聊天，免费且功能全面。
- **VentureChat**：多频道、兼容性强，适合需要复杂聊天管理的服务器。
- 其他插件可根据特殊需求选用。

CarbonChat简介
==================================================
- 文档介绍: https://github.com/Hexaoxide/Carbon/wiki
- 下载地址: https://modrinth.com/plugin/carbon

安装步骤
==================================================
1. 下载 CarbonChat 插件 jar 包
2. 放到所有分区的 plugins 目录
3. 重启所有服务端

.. code-block:: bash

    wget https://cdn.modrinth.com/data/QzooIsZI/versions/2ptKcv94/carbonchat-paper-3.0.0-beta.32.jar
    cp carbonchat-paper-3.0.0-beta.32.jar /home/mc/instances/dl1/plugins/
    cp carbonchat-paper-3.0.0-beta.32.jar /home/mc/instances/dp1/plugins/
    cp carbonchat-paper-3.0.0-beta.32.jar /home/mc/instances/sc1/plugins/
    cp carbonchat-paper-3.0.0-beta.32.jar /home/mc/instances/sc2/plugins/
    systemctl restart mc_dl1 mc_dp1 mc_sc1 mc_sc2

权限设置
==================================================
通过 LuckPerms 授权 CarbonChat 相关权限。

.. code-block:: bash

    # 创建一个普通的carbot权限组。
    /lp creategroup g_carbot 0  g_carbot
    # 让默认组继承carbot组
    /lp group default parent add g_carbot

    # 给carbot普通组安排权限（参考官方文档）
    /lp group g_carbot permission set   carbon.channel.global.* true 
    /lp group g_carbot permission set   carbon.whisper.* true  
    /lp group g_carbot permission set   carbon.nickname.* true 
    /lp group g_carbot permission set   carbon.messagetags true 
    /lp group g_carbot permission set   carbon.ignore true 
    /lp group g_carbot permission set   carbon.join true 
    /lp group g_carbot permission set   carbon.help true 
    /lp group g_carbot permission set   carbon.leave true 
    /lp group g_carbot permission set   carbon.crossserver true 
    /lp group g_carbot permission set   carbon.nickname.self true  
    /lp group g_carbot permission set   carbon.nickname true 
    /lp group g_carbot permission set   carbon.whisper true  
    /lp group g_carbot permission set   carbon.whisper.* true 
    /lp group g_carbot permission set   carbon.chatlinks true  
    /lp group g_carbot permission set   carbon.itemlink true 

命令冲突解决
==================================================
EssentialsX 默认的 tell/msg/r/reply 等命令会与 CarbonChat 冲突，需禁用 EssentialsX 的相关命令。

.. code-block:: yaml

    # EssentialsX config.yml 找到 disabled-commands，设置如下内容
    disabled-commands:
    - tell
    - msg
    - r
    - reply
    - message
    - whisper
    - pm

常见问题 QA
==================================================
:Q1: 安装后跨服聊天无效？  
:A1: 检查所有分区是否都安装 CarbonChat，Proxy 是否支持，权限是否已授权。

:Q2: 部分聊天命令无权限？  
:A2: 检查 LuckPerms 权限配置，确认已授权 carbon.* 相关权限。

:Q3: 聊天命令冲突？  
:A3: EssentialsX 的 tell/msg/reply 等需禁用，避免与 CarbonChat 冲突。

:Q4: 聊天格式不美观？  
:A4: 修改 CarbonChat 配置文件，支持自定义格式和频道设置。