> ## Documentation Index
> Fetch the complete documentation index at: https://docs.astrobirb.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Infractions

> A practical tool for documenting staff rule violations.

> Use the **Infractions** module to track staff rule violations efficiently and keep all logs centralized in one place.

<Tabs>
  <Tab title="Infraction Types">
    | Type                        | Action                                                                |
    | --------------------------- | --------------------------------------------------------------------- |
    | Add Role                    | Adds a Discord role to the infracted user.                            |
    | Remove Role                 | Removes a Discord role from the infracted user.                       |
    | Channel                     | Sends the infraction log to a different channel.                      |
    | Removal From Staff Database | Removes the user from the **Staff Database** module.                  |
    | Remove From Group           | Removes the user from a Roblox group. *(Requires Roblox Integration)* |
    | Change Group Role           | Changes the user's Roblox group role. *(Requires Roblox Integration)* |
  </Tab>

  <Tab title="Expiration">
    Using the `expiration` parameter on the `/infraction` command, infractions can automatically expire after a specified duration.
  </Tab>
</Tabs>

<AccordionGroup>
  <Accordion title="Commands">
    * **/infraction issue**: Issues an infraction to a user
    * **/infraction view**: View and manage an infraction
    * **/infraction list**: View infractions for a user or the server
    * **/infraction multiple**: Infract multiple users at once [Premium Feature](https://patreon.com/astrobirb)
  </Accordion>
</AccordionGroup>

## Options

These options control where infractions are logged, how users are notified, and how infractions are categorized.

| Option             | Description                                                         |
| ------------------ | ------------------------------------------------------------------- |
| Infraction Channel | The channel where infracted staff members are notified.             |
| Audit Log Channel  | The channel where administrators can review infraction logs.        |
| Types              | Custom infraction types that define available actions.              |
| Reasons            | Predefined reasons that can be selected when issuing an infraction. |

## Configuration

<AccordionGroup>
  <Accordion title="Infraction Approval">
    Requires administrators or designated roles to approve or deny infractions before they are finalized.\
    Approvals and denials take place in a predefined review channel.
  </Accordion>

  <Accordion title="Preferences">
    * **Infraction User Button**: Displays *Issued by \[User]* beneath the infraction embed
    * **Notify on Void**: Notifies the staff member when their infraction is voided
    * **Show Issuer**: Hides the issuer from the infraction embed
      * Does not affect `/infractions`
      * Does not apply to customized embeds
    * **Infraction Confirmation**: Enables confirmation prompts before issuing infractions
    * **Direct Messages**: Sends infractions directly to staff members via direct messages
  </Accordion>

  <Accordion title="Customize Embed">
    Allows full customization of the infraction embed, including text, fields, and layout to your liking.
  </Accordion>

  <Accordion title="Preset Reasons">
    Create a list of predefined reasons that can be selected when issuing an infraction.
  </Accordion>
</AccordionGroup>
