Documentation

Home

Table of Contents

Introduction

Kastleton Janitor is a specialized Discord bot focused on enhancing the guild experience for T&L players. Unlike general-purpose Discord bots, it's specifically designed for tracking and managing in-game activities.

Key Features

  • •Real-time Tracking: Monitors day/night cycles and server status updates automatically
  • •Event Management: Comprehensive tools for organizing and coordinating guild activities
  • •Customizable Notifications: Set up alerts for specific in-game events and server status changes

Getting Started

To start using the bot, follow these steps:

  1. Invite the bot to your server
  2. Set up appropriate permissions
  3. Configure basic settings
  4. Ready to use!

Commands

Server Status Commands

/server status

Checks the status of a specific server

Arguments:

  • server_name:Name of the server to check

/server track

Starts tracking server status

Arguments:

  • server_name:Name of the server to track

Note:

Notifications will be sent to the Discord channel where you execute this command.

/server untrack

Stops tracking server status

Arguments:

  • server_name:Name of the server to stop tracking

/server tracked

Shows all tracked servers

Day/Night Commands

/daytime

Shows current and next day/night time for selected region

Arguments:

  • region:Game region to check (optional)

Event Commands

/create

Creates a new event through an interactive process in private messages with the bot. After using this command, the bot will guide you through the event creation process step by step.

/quick_create

Quickly creates an event with given parameters

Arguments:

  • event_type:Type of event (e.g., "Weekly Boss Activity")
  • description:Description of the event
  • event_date:Date of the event (format: DD-MM-YYYY, e.g., "15-10-2024")
  • event_time:Time of the event in 24-hour format (HH:MM, e.g., "20:00")

Profile Commands

/profile edit

Edits user profile on the server

Arguments:

  • char_class:Your character class (Tank, DPS, Healer)
  • main_hand:Your main hand weapon
  • off_hand:Your off hand weapon

/profile view

Shows user profile on the server

Settings Commands

/settings status_notifications

Set server notification preferences for server status through an interactive interface.

Features:

  • •Interactive GUI with toggle buttons for different notification types
  • •Available notification types:
    • - Online/Maintenance status changes
    • - Server going Online
    • - Server becoming Busy
    • - Server becoming Full
    • - Server entering Maintenance
  • •Each status can be individually toggled ON/OFF

/settings edit_preference_limit

Set the limit of preferred items for guild members.

Arguments:

  • limit:Maximum number of items a guild member can prefer

/settings manage_allowed_role

Add or remove roles that are allowed to use bot commands.

Arguments:

  • action:add/remove
  • role:Discord role to add/remove

/settings manage_blocked_items

Add or remove items from the blocked (HR) list for guild members.

Arguments:

  • action:Choose 'block' to block an item or 'unblock' to unblock an item
  • item:Name of the item to block/unblock

/settings set_timezone

Set the server's timezone

Arguments:

  • timezone:Timezone (e.g., Europe/Warsaw, America/New_York)

/settings add_notification_roles

Command to add notification roles to the server.

/settings remove_notification_roles

Command to remove notification roles from the server.