ShadowConfigDocs

Group Logs

Track Roblox group member joins, rank changes, and leaves with automatic Discord notifications and role pings.

Overview

The Group Logs system monitors your Roblox groups and sends notifications to Discord when members join, leave, or change ranks. This is perfect for keeping track of staff promotions, member activity, and group changes without manually checking the group.

Plan Limits

Free Plan

  • 1 Roblox Group
  • 1,000 members per group
  • 15-minute polling interval

Pro Plan

  • 5 Roblox Groups
  • 1,000 members per group
  • 10-minute polling interval

Developer Plan

  • 10 Roblox Groups
  • 1,000 members per group
  • 5-minute polling interval

Setup Instructions

  1. Open the Dashboard - Navigate to your game dashboard and select the "Group Logs" tab
  2. Add a Group - Enter your Roblox Group ID and configure the settings
  3. Configure Discord Channel - Enter the Discord channel ID where you want logs to appear
  4. Enable Logging Options - Choose which events to track (joins, rank changes, leaves)
  5. Set Up Role Pings - Optionally configure role pings for important rank changes

Configuration Options

Discord Channel ID
The Discord channel where group logs will be sent. Right-click the channel in Discord with Developer Mode enabled to copy the ID.
Log Joins
Send notifications when new members join the group
Log Rank Changes
Send notifications when members are promoted or demoted
Log Leaves
Send notifications when members leave the group
Ping on Promotion
Ping the configured role when a member is promoted above the threshold rank
Ping on Demotion
Ping the configured role when a member is demoted below the threshold rank
Ping on Leave Rank
Ping the configured role when a member leaves while holding the threshold rank
Ping Role ID
The Discord role to ping for rank change notifications
Ping Threshold Rank ID
The Roblox group rank ID that triggers role pings when crossed

Log Message Format

Group logs are sent as formatted Discord embeds with a timestamp and a "Group Logs System" footer. The player name links to their Roblox profile and the group name links to the group page. When role pings are triggered, the role mention appears as plain content above the embed.

👋 Member Joined

Member Joined
Player: PlayerName
Group: GroupName
Rank: Member

👤 Member Left

Member Left
Player: PlayerName
Group: GroupName
Previous Rank: Moderator
<@&RoleID> (if "Ping on Leave Rank" is enabled and this rank matches the threshold rank)

⬆️ Rank Promotion

Rank Promotion
Player: PlayerName
Group: GroupName
Old Rank: Member
New Rank: Moderator
<@&RoleID> (if the new rank crosses the threshold rank from below)

⬇️ Rank Demotion

Rank Demotion
Player: PlayerName
Group: GroupName
Old Rank: Moderator
New Rank: Member
<@&RoleID> (if the new rank drops below the threshold rank from above)

↔️ Rank Change

Rank Change
Player: PlayerName
Group: GroupName
Old Rank: Guest
New Rank: Member

Sent when a member's rank ID changes but doesn't clearly resolve to a promotion or demotion. This case is never eligible for role pings.

Role pings for promotions and demotions only fire when the change crosses the configured threshold rank — a promotion from rank 1 to rank 2 won't ping if the threshold is rank 5, but rank 4 to rank 6 will.

Member Count Limits

Each group has a maximum of 1,000 members per plan. If a group exceeds this limit:

  • Logging will be automatically paused for that group
  • The dashboard will show a "⚠️ Limit Exceeded" status
  • You'll need to either upgrade your plan or remove members to resume logging

Troubleshooting

Logs not appearing in Discord

  • Verify the Discord channel ID is correct
  • Ensure the bot has permission to send messages in that channel
  • Check that the group member count is under 1,000
  • Confirm the group is enabled in the dashboard

Role pings not working

  • Verify the ping role ID is correct
  • Ensure the threshold rank ID is set properly
  • Check that the bot has permission to mention roles
  • Confirm the relevant ping options are enabled

Group shows "Limit Exceeded"

  • The group has over 1,000 members
  • Logging is paused to prevent performance issues
  • Consider upgrading your plan or managing group membership