GroupeZ Docs
Modules

AutoMessage Module

Automatic broadcast messages at configurable intervals

File: modules/automessage/config.yml

The AutoMessage module broadcasts automated messages to all online players at a configurable interval. It is ideal for server announcements, tips, rule reminders, event promotions, or any recurring information you want players to see regularly. Messages can be sent sequentially or in random order.

Source Configuration

enable: true
interval: 300
random-order: false
messages:
  - lines:
      - ""
      - "#ffd353ℹ ᴀɴɴᴏᴜɴᴄᴇᴍᴇɴᴛ"
      - "&7Welcome to our server! Type &f/rules &7for server rules."
      - ""
  - lines:
      - ""
      - "#ffd353ℹ ᴀɴɴᴏᴜɴᴄᴇᴍᴇɴᴛ"
      - "&7Join our Discord: &f/discord"
      - ""

Options

OptionTypeDefaultDescription
enableBooleantrueEnable or disable the AutoMessage module
intervalInteger300Time in seconds between each automatic broadcast. 300 = 5 minutes
random-orderBooleanfalseIf true, messages are selected randomly each interval. If false, messages cycle sequentially from top to bottom
messagesList(see above)The list of message entries to broadcast. Each entry contains a lines list
messages[].linesList of Strings-The individual lines of text sent for a single broadcast. Each line is sent as a separate chat line to all players

Each message entry is a multi-line block. Empty strings ("") produce blank lines in chat, which is useful for visual spacing around your announcements.

Messages support both legacy color codes (& prefix), hex colors (#ffd353), and MiniMessage formatting. You can also use PlaceholderAPI placeholders within messages for dynamic content such as player counts or server information.

How It Works

  1. When the module is enabled, a repeating task is scheduled at the configured interval (in seconds).
  2. Each time the task runs, the next message is selected from the messages list:
    • In sequential mode (random-order: false), messages are sent in order from the first to the last, then the cycle repeats.
    • In random mode (random-order: true), a message is picked randomly from the list each interval.
  3. All lines within the selected message entry are sent to every online player.

The AutoMessage module does not register any specific commands. To modify auto messages, edit the modules/automessage/config.yml file and restart the server or reload the plugin configuration.

For the full command list, see Commands & Permissions.

The AutoMessage module does not provide any specific placeholders. However, you can use any registered PlaceholderAPI placeholder inside your message lines.

For the full placeholder list, see Placeholders.

Examples

Tips Rotation

Broadcast helpful tips to players every 3 minutes:

enable: true
interval: 180
random-order: true
messages:
  - lines:
      - ""
      - "#ffd353ℹ ᴛɪᴘ"
      - "&7Use &f/sethome &7to save your current location!"
      - ""
  - lines:
      - ""
      - "#ffd353ℹ ᴛɪᴘ"
      - "&7You can trade items safely with &f/pay &7and &f/mail&7."
      - ""
  - lines:
      - ""
      - "#ffd353ℹ ᴛɪᴘ"
      - "&7Vote daily with &f/vote &7to earn rewards!"
      - ""

Event Announcement

Promote an ongoing event with a single repeating message:

enable: true
interval: 600
random-order: false
messages:
  - lines:
      - ""
      - "&6&l⚔ EVENT &eDouble XP Weekend is active!"
      - "&7Enjoy double experience until Sunday at midnight."
      - "&7Use &f/warp event &7to join the event area."
      - ""

Setting the interval too low (e.g., under 60 seconds) may annoy players with frequent broadcasts. A value between 180 and 600 seconds is generally recommended.

AFK Module

Away From Keyboard detection and kick system

Chat Module

Complete chat formatting, moderation, placeholders, and interactive features

On this page

Source ConfigurationOptionsHow It WorksRelated CommandsRelated PlaceholdersExamplesTips RotationEvent Announcement
GroupeZ MCP

Documentation in your AI

MCP lets your AI search GroupeZ documentation and read current examples to help you configure your plugins.

Read-only · No documentation API key needed

1. Copy the server URL

Transport: HTTP (Streamable HTTP). Authentication: none. Your tool uses its own model and subscription limits.

  1. Open Plugins in ChatGPT on the web, then + → Add custom MCP server.
  2. Name it ‘GroupeZ Documentation’, paste the URL above and choose ‘No authentication’. Create and install the plugin.
  3. In a conversation, type @ and select the plugin before asking. If needed, enable search, get_page and list_pages in its settings.
Official setup guide

3. Ask a question

Use GroupeZ MCP to help me create a zMenu inventory. Search relevant pages, read the examples and cite your sources.
Other clients and troubleshooting

For clients using mcpServers, adapt this example to their format:

{
  "mcpServers": {
    "groupez-docs": {
      "url": ""
    }
  }
}

Available tools are search, get_page and list_pages. Refresh the connector’s tools after updates. If your AI cannot access them, check that the connector is enabled in the conversation and your account allows custom MCP servers. Opening the URL in a browser is not an MCP test.