# ModLog Configuration

Lightning's mod logging supports multiple modlog channels with any number of events. This allows to customize your server's mod logs any way you want!

To start setting up the modlog, use the `modlog` command. Use the reference below if you are confused about anything.

## Events

Lightning's modlog currently supports the following events:

| Event              | Description                                                           | Audit Log Integration |
| ------------------ | --------------------------------------------------------------------- | --------------------- |
| Warn               | Logs when the warn command is used.                                   | Not Applicable        |
| Kick               | Logs when a member is kicked.                                         | ✅                     |
| Ban                | Logs when a member is banned.                                         | ✅                     |
| Mute               | Logs when the mute or timemute command is used.                       | Not Applicable        |
| Unmute             | Logs when the unmute command is used.                                 | Not Applicable        |
| Unban              | Logs when a user is unbanned.                                         | ✅                     |
| Member Join        | Logs when a member joins a server.                                    | Not Applicable        |
| Member Leave       | Logs when a member leaves a server.                                   | Not Applicable        |
| Member Role Add    | Logs when roles are added to a member                                 | ✅                     |
| Member Role Remove | Logs when roles are removed from a member                             | ✅                     |
| Member Nick Change | Logs when a nickname is added/changed/removed from a member           | ✅                     |
| Infraction Update  | Logs when either the reason or moderator is updated for an infraction | Not Applicable        |

## Logging Formats

Lightning includes 4 formats in which you can receive logs.

{% tabs %}
{% tab title="Minimalistic with Timestamp (default)" %}
A simple, minimal format.

![Example Image](/files/z5s7r6DKD9AYPIXp5rsZ)
{% endtab %}

{% tab title="Minimalistic without Timestamp" %}
Same as minimalistic except it doesn't include a timestamp.

![Example Image](/files/JpeCL2NGHf4gVMhd3NsE)
{% endtab %}

{% tab title="Embed" %}
An embedded format aiming to be simple and without useless clutter.

![Example Image](/files/9oUZQjX6Xg8FLpYyWll0)
{% endtab %}

{% tab title="Emoji" %}
A format based on an emoji style of logging.

![Example Image](/files/CFeYcMHehKupOmof1o2f)
{% endtab %}
{% endtabs %}

To configure the format, use `.modlog` and follow the prompts.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://lightning.lightsage.dev/guide/modlog.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.