**ChatMod - Advanced Server Messaging & Info** **Transform your server's communication with ChatMod!** This powerful server-side Fabric mod for Minecraft 1.21.5 enhances server interaction through highly customizable broadcast messages, dynamic MOTD (Message of the Day), user-definable info commands, player tagging, and more. It provides server administrators with robust tools to engage players, deliver announcements, and manage server information efficiently. --- **Key Features:** * **Dynamic Message of the Day (MOTD):** * Greet players with personalized welcome messages upon joining. * Utilize a rich set of placeholders like player name, playtime, last login, and server stats. * Fully customizable message content with Minecraft color codes, hex colors, text formatting, and interactive elements (hover/click). * Enable or disable the MOTD system easily via `chatmod.json`. * **Scheduled & Ad-Hoc Global Broadcasts:** * **Multiple Broadcast Types:** Send messages as standard chat, action bar text, prominent titles/subtitles, or even dynamic boss bars with custom colors and styles. * **Predefined Broadcasts:** Create named broadcast templates (e.g., "vote\_reminder", "event\_soon") in `predefined_broadcasts.json` for easy reuse. * Control visibility with optional permission nodes per predefined broadcast. * **Ad-Hoc Broadcasts:** Send one-off global messages directly with `/chatmod bcnow "your message"`. * **Advanced Scheduling (`/chatmod time ...`):** * **Delayed Single Broadcast:** Send a predefined or ad-hoc message once after a specified delay (e.g., `/chatmod time 10m bc promo_event`). If the command is run by a player, they receive a preview of the message and confirmation of when it will be sent globally. * **Repeating Broadcasts:** Schedule broadcasts to repeat a set number of times over a total duration. * Example: `/chatmod time 30m often 5 bc event_promo` - sends "event\_promo" globally immediately, then 4 more times, with the entire sequence spread over 30 minutes (last message at the 30-minute mark). * Example: `/chatmod time 1h often 0 bcnow "Server restarting in 1 hour!"` - sends the message globally immediately and then again once after 1 hour. * Supports time units: `s` (seconds), `m` (minutes), `h` (hours), `d` (days). * **Placeholder Support:** Broadcasts can use placeholders like `%online_players%`, `%time%`, `%date%`, `%countdown%` (for scheduled sequences), and more. * **Legacy Cycling Broadcasts:** Includes a traditional cycling broadcast system configurable in `chatmod.json` (interval, messages, type). * **Customizable Info Commands (e.g., `/rules`, `/help`):** * Create unlimited custom commands that display text from dedicated JSON files stored in `config/chatmod_info/`. * **Rich Content:** Info files support multiple pages, full Minecraft text formatting (colors, styles, hex codes), clickable actions (run command, suggest command, open URL, copy to clipboard), hover text, and placeholders. * **Easy Creation & Management:** * `/chatmod create `: Generates a new info file (e.g., `name.json`) and its corresponding command (`/name`). * `/chatmod list`: Lists all available custom info commands. * **Per-Command Configuration (in each info file, managed via commands):** * Toggle command functionality on/off (`/ work`). * Set permission requirements (`/ permission` and `/ permission set `). * Add/remove command aliases (`/ alias add/remove `). * **Built-in `/help` and `/example`:** Comes with pre-configured `help.json` and `example.json` to demonstrate features and provide a starting point. * **Predefined Items & Chat Display:** * **Placeholders in Chat:** * `[item]`: If a player has `chatmod.chatitem` permission, this shows the item in their main hand when they type it in chat. * `[item:]`: If a player has `chatmod.chatitem.number` permission, this displays a predefined item from the specified admin-configured slot (1-54). * **GUI Management:** Admins with `chatmod.items.edit` (or `chatmod.items` for view-only) can manage the 54 predefined item slots via an in-game GUI using `/chatmod items`. * **Player Tagging in Chat:** * **`@PlayerName`:** Mention players using `@` followed by their name (case-insensitive matching for recognition, displays actual name). Requires `chatmod.player.tag` permission for the sender. * The tagged player's name is highlighted in **yellow** in the chat message. * The tagged player receives a ping sound. * Does not allow self-tagging. * **`@everyone`:** Notify all online players. Requires `chatmod.player.tag.everyone` permission for the sender. * Pings all online players (except the sender). * The `@everyone` text defaults to **yellow** but can be color-coded by the sender (e.g., `&c@everyone` appears red). The custom color applies only to the "@everyone" text itself. * Multiple tags are supported in a single message. * **Chat Color Permission:** * Players with the `chatmod.chat.colors` permission can use `&` style color codes (e.g., `&c`, `&#RRGGBB`) in their regular chat messages, and ChatMod will parse and display them. * **Customizable Chat Name Formatting:** * Admins can define a custom prefix and suffix around player names for messages handled by ChatMod (e.g., when `[item]` or tags are used, or colors are enabled). * Managed via `/chatmod items format ` and `/chatmod items format reset` (requires `chatmod.items.format` permission). * Defaults to ``. The prefix and suffix support color codes. Stored in `messages.json`. * **Player Data Tracking:** * Tracks player total playtime, first login time, and last login time for use in placeholders. * Data is saved persistently per world in `chatmod_playerdata.json`. * **Comprehensive Configuration:** * **`chatmod.json`**: Main mod settings (MOTD, legacy broadcasts, server timezone). * **`messages.json`**: Customizable system messages, info command headers/footers, chat name prefix/suffix. * **`predefined_broadcasts.json`**: Define reusable named broadcast messages. * **`scheduled_broadcasts.json`**: Stores data for active persistent scheduled broadcasts. * **`config/chatmod_info/*.json`**: Individual files for each custom info command. * **`predefined_items.json`**: Stores item data for the `[item:#]` placeholder. * **Reloadable:** Use `/chatmod reload` to refresh all configurations (except `scheduled_broadcasts.json` which manages active tasks) without a server restart. * **Permissions Support:** * Integrates with the Fabric Permissions API (v0). * Requires a compatible permissions manager (e.g., LuckPerms, suggested) for permission nodes to function effectively. * If no permission manager is found, most ChatMod commands default to requiring OP level 2 access (some internal UI-triggered actions default to true). --- **Commands & Operations:** The main administrative command is **`/chatmod`** (alias: **`/cm`**). User-created info commands are registered directly (e.g., **`/rules`**, **`/help`**). **`/chatmod` Help & Basic Operations:** * **`/chatmod`**: Displays the main help interface with clickable navigation. * **`/chatmod create `**: Creates a new info file (e.g., `filename.json`) and its corresponding command `/filename`. * **`/chatmod list`**: Lists all available custom info commands created by ChatMod. * **`/chatmod reload`**: Reloads all ChatMod configuration files. * **`/chatmod testmotd`**: Shows the current MOTD to the command sender (if they are a player). * **`/chatmod testbroadcast`**: Manually triggers the next legacy cycling broadcast message. **Broadcast Commands (under `/chatmod`):** * **`/chatmod bclist`** (alias `/cm bcl`): Lists names of all predefined broadcasts. * **`/chatmod bcshow `** (alias `/cm bcs `): Shows a preview of the specified predefined broadcast to you. * **`/chatmod bc `** (alias `/cm bc `): Sends the specified predefined broadcast once globally, immediately. * **`/chatmod bcnow "your message"`** (alias `/cm bcn "your message"`): Broadcasts your custom message once globally, immediately. Supports `&=` for newlines. **Scheduled Broadcast Commands (under `/chatmod time ...` or `/cm time ...`):** * **`/chatmod time bc `**: Sends the predefined broadcast `` globally once after the specified ``. The sender (if a player) receives a preview and confirmation. * **`/chatmod time bcnow "message"`**: Sends the ad-hoc `"message"` globally once after the specified ``. The sender (if a player) receives a preview and confirmation. * **`/chatmod time often bc `**: * If `count` is `0`: Sends predefined broadcast `` globally immediately, and then again once after ``. * If `count` is `>0`: Sends `` globally immediately, then `count-1` more times. The entire sequence is spread over ``, with the last message at the end of the interval. * **`/chatmod time often bcnow "message"`**: Same as above, but for an ad-hoc `"message"`. * *Interval format examples: `30s`, `10m`, `1h`, `2d`.* **Predefined Items & Formatting Commands (under `/chatmod items` or `/cm items`):** * **`/chatmod items`**: Opens the GUI for managing predefined items (slots 1-54). * **`/chatmod items format `**: Sets the prefix and suffix strings that wrap player names in ChatMod-handled messages. Supports color codes. Use `""` for empty strings. * Example: `/cm items format "&8[&c" "&8]&r"` * **`/chatmod items format reset`**: Resets the chat name prefix and suffix to default (`<` and `>`). **Info File Commands (e.g., `/rules`, `/help` - these are user-defined via `/chatmod create`):** * **`/`**: Displays the first page (usually "page1" or "main") of the info file. * **`/ [page_number_or_section_name]`**: Displays a specific page or named section of the info file. * **`/ work`**: Toggles the info command `/` on or off. (Admin) * **`/ permission`**: Toggles whether `/` requires permission to use. (Admin) * **`/ permission set `**: Sets a custom permission node for `/`. (Admin) * **`/ alias add `**: Adds an alias (e.g., `/r`) for the `/` command. (Admin) * **`/ alias remove `**: Removes an alias for the `/` command. (Admin) --- **Available Placeholders:** Placeholders can be used in MOTD messages, broadcasts, and info file content. * **Player Specific (require a player context; may default to "Server" or "N/A" in global contexts):** * `%player%`: Player's name. * `%player_uuid%`: Player's UUID. * `%player_ping%`: Player's network latency. * `%player_world%`: Identifier of the player's current world. * `%player_x%`, `%player_y%`, `%player_z%`: Player's coordinates (formatted to one decimal). * `%playtime%`: Player's total playtime (e.g., "1d 2h 30m 5s"). * `%last_play_time%`: Date/time of player's previous login (uses server timezone). * `%player_first_joined%`: Date/time of player's first server join (uses server timezone). * **Server Specific:** * `%server_name%`: Server's MOTD (often from `server.properties`). * `%online_players%`: Current number of online players. * `%max_players%`: Maximum player capacity. * `%server_tps%`: Currently displays "N/A" (direct TPS measurement not built-in). * **Date & Time (Uses `serverTimezone` from `chatmod.json`):** * `%date%`: Current server date (e.g., "2025-06-04"). * `%time%`: Current server time (e.g., "02:57:48"). * `%datetime%`: Current server date and time with timezone (e.g., "2025-06-04 02:57:48 CEST"). * `%timezone%`: Short display name of the server's configured timezone (e.g., "CEST"). * **Scheduled Broadcast Specific:** * `%countdown%`: Time remaining until the final broadcast in a sequence (e.g., "15m 30s left"). * `%scheduled_end_time%`: Wall-clock time of the final broadcast in a sequence (server timezone). * `%scheduled_end_datetime%`: Full date and time of the final broadcast in a sequence (server timezone). --- **Full Permissions List:** * `chatmod.modinfo`: Allows access to the base `/chatmod` help command. * `chatmod.create`: Allows usage of `/chatmod create`. * `chatmod.list`: Allows usage of `/chatmod list`. * `chatmod.name.modify`: Allows modifying info files via `/ work/permission/alias` subcommands. * `chatmod.testmotd`: Allows usage of `/chatmod testmotd`. * `chatmod.testbroadcast`: Allows usage of `/chatmod testbroadcast` (for legacy cycling broadcasts). * `chatmod.reload`: Allows usage of `/chatmod reload`. * `chatmod.bc.list`: Allows usage of `/chatmod bclist`. * `chatmod.bc.sendnamed`: Allows sending/scheduling predefined broadcasts via `/chatmod bc` and `/chatmod time ... bc`. * `chatmod.bc.now`: Allows sending/scheduling ad-hoc broadcasts via `/chatmod bcnow` and `/chatmod time ... bcnow`. * `chatmod.bc.show`: Allows previewing predefined broadcasts via `/chatmod bcshow`. * `chatmod.items`: Allows viewing predefined items via `/chatmod items` (GUI access). * `chatmod.items.edit`: Allows managing predefined items via `/chatmod items` (GUI edit access). * `chatmod.items.format`: Allows customizing the chat name prefix/suffix via `/chatmod items format`. * `chatmod.chatitem`: Allows a player to use the `[item]` placeholder in chat. * `chatmod.chatitem.number`: Allows a player to use the `[item:#]` placeholder in chat. * `chatmod.chat.colors`: Allows players to use `&` style color codes in their chat messages. * `chatmod.player.tag`: Allows tagging individual players using `@PlayerName`. * `chatmod.player.tag.everyone`: Allows tagging `@everyone`. * `chatmod.info.`: Permission for specific info files if `permissionRequired` is true (e.g., `chatmod.info.rules`). The node is often auto-generated as `chatmod.info.` but can be customized. * `chatmod.broadcast.`: Permission for specific predefined broadcasts if `permission_required` is true (e.g., `chatmod.broadcast.event_soon`). * `chatmod.*`: Grants all permissions for ChatMod. --- **Server Timezone Configuration (`serverTimezone` in `chatmod.json`):** The `serverTimezone` setting in `chatmod.json` affects how date/time placeholders like `%time%`, `%date%`, `%datetime%`, and the contextual `%scheduled_end_time%` are displayed. It is crucial for accurate time information if your server community is spread across different regions or if you want consistency. Use IANA timezone database names. If an invalid timezone is set, the mod will default to the server's system timezone. **Europe:** * `Europe/London` * `Europe/Paris` * `Europe/Berlin` * `Europe/Moscow` * `Europe/Brussels` **America (North & South):** * `America/New_York` (Eastern Time) * `America/Chicago` (Central Time) * `America/Denver` (Mountain Time) * `America/Los_Angeles` (Pacific Time) * `America/Toronto` * `America/Vancouver` * `America/Sao_Paulo` * `America/Mexico_City` **Asia:** * `Asia/Tokyo` * `Asia/Shanghai` * `Asia/Kolkata` * `Asia/Dubai` * `Asia/Singapore` **Australia:** * `Australia/Sydney` * `Australia/Melbourne` * `Australia/Perth` **Africa:** * `Africa/Cairo` * `Africa/Johannesburg` * `Africa/Nairobi` --- **Modpack Policy:** * You **ARE PERMITTED** to include ChatMod in any modpack. * Credit is appreciated but not strictly required. * Please do not modify the mod's JAR file directly. * The modpack itself, or access to this mod within the modpack, **must not be sold**.

official.andy

official.andy

Disable Structures by choice