Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ni5arga/loggerica
A powerful self-hostable Discord bot to keep logs in your server of moderator actions, invites, deleted/edited messages and many more!
https://github.com/ni5arga/loggerica
discord-bot discord-js discordjs-v14 logger logging typescript
Last synced: 3 months ago
JSON representation
A powerful self-hostable Discord bot to keep logs in your server of moderator actions, invites, deleted/edited messages and many more!
- Host: GitHub
- URL: https://github.com/ni5arga/loggerica
- Owner: ni5arga
- License: gpl-3.0
- Created: 2023-11-29T19:46:21.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2023-12-22T21:55:49.000Z (about 1 year ago)
- Last Synced: 2024-05-01T13:37:32.454Z (9 months ago)
- Topics: discord-bot, discord-js, discordjs-v14, logger, logging, typescript
- Language: TypeScript
- Homepage:
- Size: 111 KB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: contributing.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Loggerica
Loggerica is a powerful Discord bot designed to keep logs in your server. Whether it's tracking moderator actions, member events, message activities, or voice channel movements, Loggerica is here to provide comprehensive logging for your Discord server.
## Self Hosting Instructions
1. **Clone the Repository**
```bash
git clone https://github.com/ni5arga/Loggerica.git
```
2. **Change Directory & Install Dependencies**
```bash
cd Loggerica
npm install
```
3. **Configuring the Bot**
Create a `config.json` file in the root directory with the following structure and replace them with your own values :
```json
{
"token": "YOUR_DISCORD_BOT_TOKEN",
"prefix": "YOUR_BOT_PREFIX",
"modLogChannelID": "YOUR_MOD_LOG_CHANNEL_ID",
"messageLogChannelID": "YOUR_MESSAGE_LOG_CHANNEL_ID",
"voiceLogChannelID": "YOUR_VOICE_LOG_CHANNEL_ID",
"joinLeaveLogChannelID": "YOUR_JOIN_LEAVE_LOG_CHANNEL_ID"
}
```
4. **Build and Run the Bot**
```bash
npm run build
npm start
```
## Logs the bot can keep
> **Moderator Log**
| Event | Event Description |
|----------------------|-----------------------------------------------------------|
| roleCreate | Role created |
| roleDelete | Role deleted |
| channelCreate | Channel created |
| channelDelete | Channel deleted |
| channelUpdate | Channel permissions updated |
| serverUpdate | Server name/logo change |
| channelPinsUpdate | Channel pins updated |
| serverBanAdd | User banned from the server |
| serverBanRemove | User unbanned from the server |
| serverIntegrationsUpdate | Server integrations updated |
| stickerCreate | Sticker created |
| stickerDelete | Sticker deleted |
| stickerUpdate | Sticker updated |
| emojiCreate | Emoji created |
| emojiDelete | Emoji deleted |
| emojiUpdate | Emoji updated |
| inviteCreate | Invite created |
| inviteDelete | Invite deleted |
| threadCreate | Thread created |
| threadDelete | Thread deleted |
| threadUpdate | Thread updated |
| stageInstanceCreate | Stage instance created |
| stageInstanceUpdate | Stage instance updated |
| stageInstanceDelete | Stage instance deleted |
> **Member Joining Server & Leaving Server**
| Event | Event Description |
|----------------------|-----------------------------------------------------------|
| memberJoin | Member joined |
| memberLeave | Member left |
> **Message Events**
| Event | Event Description |
|----------------------|-----------------------------------------------------------|
| messageDelete | Message deleted |
| messageUpdate | Message edited |
| messageReactionAdd | Reaction added to a message |
| messageReactionRemove| Reaction removed from a message |
| messageDeleteBulk | Multiple messages deleted at once |
| messageReactionRemoveAll | All reactions removed from a message |
> **Voice Channel Events**
| Event | Event Description |
|----------------------|-----------------------------------------------------------|
| voiceStateUpdate | User joined/left/switched voice channel |
# Contributing
If you'd like to contribute to Loggerica, feel free to open an issue or submit a pull request on the GitHub repository. Any improvements are welcomed!