This plugin allows logging chat messages from different channels to individual files. Currently, the plugin supports public, group, game, private and clan channels and each can be toggled on/off individually. The log file rotation happens on a daily basis and up to 30 log files are kept. However, this can be changed from the plugin's settings.
The logs can be found at RuneLite's home folder under the chatlogs directory. To find runelite's home navigate to %userprofile%\.runelite on Windows or $HOME/.runelite on Linux and macOS.
The plugin uses the following directory structure:
.runelite/
└── chatlogs/
├── friends/
├── private/
├── public/
├── group/
├── game/
└── clan/
Note that the friends folder contains the clan chat logs and the private folder contains private messages from friends.
This plugins allows you to configure submission of your clan chat messages to a remote endpoint. To enable it the user must configure an endpoint and tick the box on the plugin's configuration.
The plugin submits chat messages every 5 seconds, multiple chat entries can be submitted at once up to a max of 30 entries. It also uses a circuit breaker to avoid making requests to a non-functional endpoint. The circuit breaker opens if more than 3 requests fail within 30 seconds and will switch to half-open after 5 minutes.
It is also worth nothing that multiple clients may submit the same message, deduplication should be done server side!
The plugin uses the following structure to submit messages:
[
{
"id": 1417339442575,
"timestamp": "2021-01-01T00:00:00.000000000Z",
"chatType": "FRIENDS",
"chatName": "player name",
"sender": "player name",
"rank": -1,
"message": "Dasdasd"
}
]| field | description |
|---|---|
| id | A message identifier that can be used to de-dupe incoming messages from multiple sources |
| timestamp | An ISO-8601 compatible UTC timestamp of when the message was received by the client |
| chatType | The type of the chat that the message was sent in, possible values FRIENDS or CLAN (includes guest clan) |
| chatName | The name of the chat that the message was sent in |
| sender | The player that sent the message |
| rank | The ordinal representation of the sender's rank. (see Clan Rank and Friends Chat Rank) |
| message | The message |
The plugin will also always submit an Authorization header, the value none will be submitted if nothing is configured by the user.
This header should be used for user authentication.
- Fixed incorrect folder mapping for game log output.
- Fix compatibility with the latest client changes. The behaviour of the
rankfield might change with this update.
- Fixes private logs containing clan messages
- Friends/Clan rank added to remote submission
- Clan chat system support
- Remote submission of clan chat messages
- Added from/to to private message logs
- Added remote submission of friends chat messages
- The storage directory has been changed from
clanchatlogstochatlogs - The plugin is now capable of logging public & private chat channels. Each chat channel has its own directory inside the
chatlogsdirectory - Each individual chat channel logging can be toggled on/off