DutySync Documentation

Complete guide to setting up and using DutySync for your Discord server

Quick Navigation

Getting Started

1. Invite the Bot

Add DutySync to your server using our invite link.

2. Required Permissions

DutySync needs the following permissions to function properly:

  • Manage Roles - To assign and remove LOA roles
  • Send Messages - To send confirmations and logs
  • Use Slash Commands - For all bot interactions
  • View Channels - To access server channels
  • Manage Messages - For command cleanup

3. Initial Setup

Run the setup command to configure your server:

/setup

This will guide you through configuring log channels and staff roles.

Commands

LOA Commands

/loa - Request a Leave of Absence

/return - Return from LOA early

Management Commands

/setup - Configure bot settings

/roster - View staff roster

/addmember - Add new staff member

/resign - Handle staff resignations

Activity Commands

/activitycheck - Check staff activity

/announce - Make staff announcements

/plans - View subscription plans

LOA Management

How LOA Works

When a staff member requests LOA, DutySync:

  1. Removes their current staff roles
  2. Assigns a temporary LOA role
  3. Saves their original roles for restoration
  4. Logs the request with duration and reason
  5. Automatically restores roles when LOA expires

LOA Duration Limits

  • Free Trial: Up to 30 days
  • Basic Plan: Up to 30 days
  • Premium Plan: Unlimited duration

Role Preservation

DutySync automatically identifies and preserves important roles like:

  • Staff roles (Manager, Admin, Moderator, etc.)
  • Department roles
  • Custom roles marked for preservation

Activity Tracking

Voice Channel Tracking

DutySync automatically tracks time spent in voice channels for activity monitoring.

Ticket Response Tracking

Integration with popular ticket bots to track response times and activity.

Activity Reports

Generate comprehensive activity reports using:

/activitycheck [member] [timeframe]

Permissions

Command Permissions

Most DutySync commands require specific permissions:

  • LOA requests: Any staff member
  • Management commands: Administrator or Manage Server
  • Setup commands: Administrator only

Role Hierarchy

DutySync respects Discord's role hierarchy. Make sure the bot's role is positioned above any roles it needs to manage.

Troubleshooting

Common Issues

Bot not responding to commands

  • Check if the bot is online
  • Verify slash commands are enabled
  • Ensure proper permissions

Cannot manage roles

  • Check bot's role position in hierarchy
  • Verify "Manage Roles" permission
  • Ensure target roles are below bot's role

LOA not working

  • Run /setup to configure properly
  • Check log channel permissions
  • Verify staff roles are configured

Getting Help

If you're still experiencing issues: