A simple RuneLite plugin to dump in-game chat to JSON
If you have read blog posts I have previously written… you will know that I am a big fan of OSRS, programming, and data! This post combines all these. I wanted to do some data analysis of in-game chat - stay tuned for the next post which crunches some chat data looking at spam filtering and sentiment analysis!
Before that can be done, the first thing is to write a program that can grab chat data from the game. This is pretty essential… and I am not going to manually copy and paste every chat message that appears on world 1 at the Grand Exchange. Instead, I needed some type of program to dump the chat messages to a specific structure so that it is easy to process and analyze. The solution - like usual is a simple RuneLite plugin.
We probably all know the Chat Interface in OSRS all too well. Lots of stuff ends up there: spam messages, expensive monster drops, game events, etc. The visual example provided below - just in case you don’t know what this thing is:
The information provided in the chat is pretty extensive. Especially when you include the additional functionality provided by a couple of sweet RuneLite plugins.
So why dump chat data? I can think of several reasons. Wiki devs might want to dump chat to see the examine messages to update the wiki - when you right-click examine an item, NPC, or object. You might want to keep a record of all the amazing messages you send to your friends?! Ok - on a serious note, I wanted to dump chat to perform some text analysis. I stumbled across an old post of the /r/2007scape subreddit called Data Analysis: 4000 World 1 G.E. Messages. The user Rprrr
dumped 4000 chat messages a did a simple content analysis. I wanted to do something similar.
Since RuneLite has such extensive API functions and there are so many examples of different plugins - it makes writing something like a chat dumper plugin easy. This section goes into some discussion of writing the chat dumper. If you would just rather see the code, have a look at the ChatDumper
plugin on my GitHub repo.
Like I said, this plugin was based on a variety of other, similar chat plugins. Reviewing other code (which has got the tick from the RuneLite devs) makes writing this sort of thing super easy. The two plugins I mainly used were:
chathistory
plugin which saves the chat history between sessions (logging in and out, or world-hopping)chatfilter
plugin which provides the ability to filter messages in the chat interface - commonly used to filter spamLooking at both of these plugins, they used the ChatMessage
event - which provides an event to listen to.
import net.runelite.api.events.ChatMessage;
The ChatMessage
event is the key here. Whenever a chat message is received (displayed in the chatbox) an event is triggered by the client. We can just hook into this event and do something with the chat message. A simple example is provided below:
For each chat message, the data is provided in a MessageNode
object. Have a look at the RuneLite API docs on the MessageNode, and you will see you can get stuff like:
From here, the rest of the plugin development is pretty easy - as RuneLite does all the heavy lifting already. I wrote a very simple class the store the data I was interested in for each chat message. Below is a little snippet of the setters for the class.
Also, I added a simple function to convert the passed MessageNode
object argument to something more JSON friendly. This involved converting objects (such as the Enum type object to a string).
Each returned message is saved into a simple ArrayList
called messages
. As a side note, instead of rolling a custom class I could have used the QueuedMessage
class, but it didn’t have exact data I wanted - as I wanted to add the world the chat message was dumped from. If you are interested, have a look at the QueuedMessage
class.
The last thing to do is save the messages to a JSON file. I have messaged around with a couple of different JSON libraries for Java. The best is GSON - something I should have used from the start.
So, as a little summary… the plugin operation is super simple:
ChatMessage
event to get each chat messageArrayList
To provide some context of what data you will get with this plugin, I have provided an example below.
Pretty sweet! Couple notes here. The timestamp
property is an epoch - which is easy to convert in most programming languages. The type
property is really useful, and indicates the type of message - the types are explained in the ChatMessageType
class. You could filter specific messages in the plugin - and I added a specific config to demonstrate this. But I wanted all the chat, and can easily filter during analysis.
As I briefly mentioned, the ChatDumper
plugin source code is on my GitHub repo. To use this, you need to have an environment set up to build RuneLite from the source. Once you have that, just copy the chatdumper
folder to your RuneLite plugins folder, compile the project, and run. This sort of plugin is not exactly useful to many people, and not something that should even be in the RuneLite Plugin Hub - but might be useful to other data-geeks or devs.
Given the crazy plugins that people in the OSRS community are producing - this is not groundbreaking stuff. I am writing stuff like this to document my developer journey, keen notes for myself, and (hopefully) help out other people who may not have as much programming experience or knowledge of the RuneLite client.
The whole purpose of this project was to get some chat data to perform some analysis. So far I have dumper about 10k chat messages, and will hopefully get some time to crunch some data soon! Until next time… Happy scaping everyone!