VCChat

<details> <summary>En</summary> # VCChat A **Paper / Purpur** plugin (Minecraft, API `1.21`) that adds **local chat** (radius around the player) and **global chat** (message prefix), formatting via **Vault** and **PlaceholderAPI**, player mentions, custom join/quit messages, optional **GigaChatPlugin** integration, and forwarding GigaChat bot replies to **Discord** via **DiscordSRV**. --- ## Features - **Local chat** — only players within a configurable **radius** in the same world hear you. - **Global chat** — message starts with a configurable prefix (default `!`); everyone online sees it. - **Formats** for local and global: `{prefix}`, `{suffix}`, `{displayname}`, `{message}`, PlaceholderAPI (`%...%`). - **Vault** — prefix/suffix from your permissions plugin (LuckPerms, etc.) when Vault is installed. - **`@player` mentions** — highlight and sound for the mentioned player. - Configurable **join** / **quit** messages (can be disabled). - **GigaChat** — address the bot by alias (e.g. `@gigachat question`); the reply goes to the same channel (local or global) as the question. - Optional suppression of the “nobody heard you” message when talking to GigaChat in an empty local radius. - **DiscordSRV** — optional forwarding of **GigaChat reply text** to a Discord channel (global and/or local questions — separate flags). --- ## Requirements - **Paper** or **Purpur** with a current 1.21 API branch (see `build.gradle`). - **Java** compatible with your server build (usually 21+). ### Optional plugins | Plugin | Purpose | |--------|---------| | **PlaceholderAPI** | Extra placeholders in chat and join/quit formats | | **Vault** + permissions plugin | Prefix/suffix in messages | | **GigaChatPlugin** | GigaChat requests via Bukkit service | | **DiscordSRV** | Forward bot replies to Discord | VCChat **does not require** these; without them some features are disabled or simplified (e.g. empty prefixes without Vault). --- ## Installation 1. Use **Paper/Purpur** — not bare Spigot without the APIs this plugin needs (`AsyncChatEvent`). 2. Copy **`VCChat-*.jar`** into **`plugins`**. 3. For GigaChat and/or Discord, install **GigaChatPlugin** and/or **DiscordSRV** (install **before** or alongside VCChat; load order is usually not critical). 4. **Fully restart** the server. 5. Edit **`plugins/VCChat/config.yml`** for your server (see below). 6. Run **`/vcchat reload`** or restart again to apply config. --- ## Configuring `config.yml` Created on first run: **`plugins/VCChat/config.yml`**. ### Local and global chat | Key | Description | |-----|-------------| | `local-chat.radius` | Radius in blocks; recipients are in the same world within that sphere | | `global-prefix` | Prefix at the start of a message for global (the prefix itself is stripped from chat text) | | `formats.local`, `formats.global` | Message templates (see comments in the bundled config) | | `no-one-heard` | Message to the player in local chat when nobody else is in range | ### Permissions | Permission | Purpose | Default | |------------|---------|---------| | `vcchat.local` | Use local chat | true | | `vcchat.global` | Use global chat (with prefix) | true | | `vcchat.admin.reload` | `/vcchat reload` | op | ### Mentions and join/quit Sections **`mention`**, **`join`**, **`quit`** — colours, sounds, text; join/quit support PAPI placeholders. ### GigaChat integration (`gigachat`) Enable with **`gigachat.enabled: true`**. | Option | Meaning | |--------|---------| | `alias` | Trigger in text, e.g. `@gigachat` | | `bot-name`, `bot-prefix` | Bot display when using “reply like player” mode | | `reply-like-player` | Format the reply like a player message | | `reply-like-player-local-format` / `reply-like-player-global-format` | Separate formats without clan placeholders | | `thinking-enabled` / `thinking-message` | Private “request sent…” message | | `format`, `error-format`, `scope-tag-*` | Reply and error appearance | | `suppress-no-one-heard` | Hide “nobody heard you” when addressing GigaChat | | `alias-color` | Highlight colour for the alias in the player’s message | **Important:** in **GigaChatPlugin** `config.yml`, set **`chat-listener-enabled: false`**, otherwise you may get **two** replies. ### Forwarding replies to Discord (`gigachat.discord`) Requires **DiscordSRV** with channels configured in its `config.yml` (**Channels** section). | Option | Description | |--------|-------------| | `enabled` | Master switch for forwarding | | `channel` | Game channel name from DiscordSRV (often `global`) | | `send-global` | Forward replies to questions asked in **global** chat | | `send-local` | Forward replies to questions asked in **local** chat | | `format` | Discord message string; **`{player}`**, **`{answer}`** | --- <details> <summary>Spoiler</summary> </details> ## Working with GigaChatPlugin 1. Install **GigaChatPlugin**, configure **`gigachat.yml`** (API keys, model, TLS if needed). 2. In GigaChatPlugin: **`chat-listener-enabled: