Action Logger

Action Logger logs actions your character makes to disk in a programmatically accessible format. These actions intend to make debugging quest helpers easier.

The files are stored in your RuneLite folder under the actionlogger directory. At each start, a file is created with the current unix timestamp (e.g. 1724499647864-logs.txt).
Each new line contains an action defined in a JSON format

Types of actions logged

DIALOGUE_STARTED

Fires when a dialogue is opened

{
  "tick": 95,
  "ts": "2024-08-25T08:59:42Z",
  "type": "DIALOGUE_STARTED",
  "data": {
    "actorName": "pajdenk",
    "lastInteractedName": "Lumbridge Guide",
    "lastInteractedID": 306,
    "lastInteractedPosition": {
      "x": 3238,
      "y": 3220,
      "plane": 0
    },
    "playerPosition": {
      "x": 3237,
      "y": 3220,
      "plane": 0
    },
    "dialogueText": "",
    "dialogueOptions": [
      "Select an option",
      "Where can I find a quest to go on?",
      "What monsters should I fight?",
      "Where can I make money?",
      "Where can I find more information?",
      "More options..."
    ]
  }
}

DIALOGUE_ENDED

Fires when a dialogue ends, either by the user selecting an option or leaving the dialogue

Where possible, the dialogueOptionChosen will be filled in with information about which of the dialogue options was chosen, -1 meaning they didn't chose an option or they chose "Continue" which usually isn't included in the dialogueOptions key

{
  "tick": 101,
  "ts": "2024-08-25T08:59:42Z",
  "type": "DIALOGUE_ENDED",
  "data": {
    "actorName": "pajdenk",
    "lastInteractedName": "Lumbridge Guide",
    "lastInteractedID": 306,
    "lastInteractedPosition": {
      "x": 3238,
      "y": 3220,
      "plane": 0
    },
    "playerPosition": {
      "x": 3237,
      "y": 3220,
      "plane": 0
    },
    "dialogueText": "",
    "dialogueOptions": [
      "Select an option",
      "Where can I find a quest to go on?",
      "What monsters should I fight?",
      "Where can I make money?",
      "Where can I find more information?",
      "More options..."
    ],
    "dialogueOptionChosen": -1
  }
}

VARBIT_CHANGED

Fires when a Varbit value changes

You can Inspect the Varbit in Chisel, e.g. https://chisel.weirdgloop.org/varbs/display?varbit=10060

{
  "tick": 104,
  "ts": "2024-08-25T08:59:42Z",
  "type": "VARBIT_CHANGED",
  "data": {
    // ID of the Varbit being changed
    "id": 10060,
    "oldValue": 0,
    "newValue": 2
  }
}

VARPLAYER_CHANGED

Fires when a Varplayer value changes

You can Inspect the Varplayer in Chisel, e.g. https://chisel.weirdgloop.org/varbs/display?varplayer=3803

{
  "tick": 0,
  "ts": "2024-08-25T08:59:42Z",
  "type": "VARPLAYER_CHANGED",
  "data": {
    // ID of the Varplayer being changed
    "id": 3803,
    "oldValue": 0,
    "newValue": 20000
  }
}

INVENTORY_CHANGED

Fires when the player's inventory changes

User picked up a cabbage into the first slot

{
  "tick": 0,
  "ts": "2024-08-25T08:59:42Z",
  "type": "INVENTORY_CHANGED",
  "data": {
    "oldInventory": [
      -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
      -1, -1, -1, -1, -1, -1, -1, -1, -1, -1
    ],
    "oldQuantities": [
      0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
      0, 0, 0
    ],
    "newInventory": [
      1965, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
      -1, -1, -1, -1, -1, -1, -1, -1, -1, -1
    ],
    "newQuantities": [
      1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
      0, 0, 0
    ]
  }
}

User moved the cabbage from the first slot to the last slot

{
  "tick": 0,
  "ts": "2024-08-25T08:59:42Z",
  "type": "INVENTORY_CHANGED",
  "data": {
    "oldInventory": [
      1965, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
      -1, -1, -1, -1, -1, -1, -1, -1, -1, -1
    ],
    "oldQuantities": [
      1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
      0, 0, 0
    ],
    "newInventory": [
      -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
      -1, -1, -1, -1, -1, -1, -1, -1, -1, 1965
    ],
    "newQuantities": [
      0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
      0, 0, 1
    ]
  }
}

Chat commands

There are various helpful chat commands available when the Action Logger plugin is installed.

To invoke a command, type ::ActionLogger <COMMAND> or ::ActLog <COMMAND> with a command listed below

Restart

Ends the logging of the current file and starts logging to a new file.

Example: ::actlog restart

Dump

Dumps all nearby objects, ground items, and npcs to the Action Logger file. Coordinates are all scene-relative

To dump everything: ::actlog dump To dump NPCs only: ::actlog dump npcs To dump NPCs and ground items only: ::actlog dump npcs grounditems

Example output:

{
  "tick": 26,
  "ts": "2025-07-12T14:43:21Z",
  "type": "DUMP",
  "data": {
    "scene": {
      "baseX": 3184,
      "baseY": 3168,
      "isInstance": false
    },
    "worldViewPlane": 0,
    "groundItems": [
      {
        "x": 24,
        "y": 46,
        "z": 0,
        "id": 1923,
        "name": "Bowl",
        "quantity": 1
      }
    ],
    "decorativeObjects": [
      {
        "x": 7,
        "y": 102,
        "z": 0,
        "id": 3474
      }
    ],
    "wallObjects": [
      {
        "x": 1,
        "y": 38,
        "z": 0,
        "id": 980
      }
    ],
    "gameObjects": [
      {
        "x": 1,
        "y": 9,
        "z": 0,
        "id": 1162
      }
    ],
    "groundObjects": [
      {
        "x": 1,
        "y": 10,
        "z": 0,
        "id": 1272
      }
    ],
    "npcs": [
      {
        "x": 60,
        "y": 52,
        "z": 0,
        "id": 1838,
        "name": "Duck"
      }
    ]
  }
}