ChatHistory

ChatHistory

A VRising plugin that enhances chat functionality by allowing players to navigate and manage their chat history.

Features

• Message History Navigation: Browse through previously sent messages using arrow keys
• Auto-completion: Complete messages from your chat history with a single keypress
• Custom KeyBinds: Configure navigation keys to your preference
• History Persistence: Save the history entries locally

Installation

• Install BepInEx
• Extract ChatHistory.dll into (VRising client folder)/BepInEx/plugins

Usage

While the chat open and focused:

• Press Up Arrow to navigate up through your message history
• Press Down Arrow to navigate down through your message history
• Press Right Arrow to complete the currently suggested message

Breaking Changes

Update from 1.0.0 to 1.1.0:

• The chat history format has changed from base64 encoding to URL-escaped strings.
• To convert your old history file:
• On Windows: Download and drag your old history file onto convert.bat.
• On Unix/Linux: Download and drag your old history file onto convert.bash.
• The new history file location is:

/BepInEx/config/ChatHistory/chat.history

Configuration

After running the plugin once, a configuration file will be created at:

/BepInEx/config/ChatHistory.cfg

[0.⚙️ Settings]

The maximum number of messages to keep in the chat history. If the number of messages exceeds this value, the oldest messages will be removed. If set to <= 0, the history will not be limited (use with caution).

Setting type: Int32

Default value: 50

MaximumHistorySize = 50

If true, the chat history will be saved and loaded on restart. If false, the chat history will be lost on restart.

Setting type: Boolean

Default value: true

PersistOnRestart = true

Down Arrow Key to scroll down the chat history.

Setting type: KeyCode

Default value: DownArrow

DownHistoryKey = DownArrow

Up Arrow Key to scroll up the chat history.

Setting type: KeyCode

Default value: UpArrow

UpHistoryKey = UpArrow

The key to complete the current chat message.

Setting type: KeyCode

Default value: RightArrow

CompleteHistoryKey = RightArrow

KeyCodes

| KeyCodes | KeyCodes | KeyCodes | KeyCodes | KeyCodes | KeyCodes | KeyCodes |

| ------------ | ----------------- | ------------ | ----------------- | ----------------- | ----------------- | ----------------- |

| None | D | Insert | JoystickButton0 | Joystick2Button7 | Joystick4Button15 | Joystick7Button0 |

| Backspace | E | Home | JoystickButton1 | Joystick2Button8 | Joystick4Button16 | Joystick7Button1 |

| Tab | F | End | JoystickButton2 | Joystick2Button9 | Joystick4Button17 | Joystick7Button2 |

| Clear | G | PageUp | JoystickButton3 | Joystick2Button10 | Joystick4Button18 | Joystick7Button3 |

| Return | H | PageDown | JoystickButton4 | Joystick2Button11 | Joystick4Button19 | Joystick7Button4 |

| Pause | I | F1 | JoystickButton5 | Joystick2Button12 | Joystick5Button0 | Joystick7Button5 |

| Escape | J | F2 | JoystickButton6 | Joystick2Button13 | Joystick5Button1 | Joystick7Button6 |

| Space | K | F3 | JoystickButton7 | Joystick2Button14 | Joystick5Button2 | Joystick7Button7 |

| Exclaim | L | F4 | JoystickButton8 | Joystick2Button15 | Joystick5Button3 | Joystick7Button8 |

| DoubleQuote | M | F5 | JoystickButton9 | Joystick2Button16 | Joystick5Button4 | Joystick7Button9 |

| Hash | N | F6 | JoystickButton10 | Joystick2Button17 | Joystick5Button5 | Joystick7Button10 |

| Dollar | O | F7 | JoystickButton11 | Joystick2Button18 | Joystick5Button6 | Joystick7Button11 |

| Percent | P | F8 | JoystickButton12 | Joystick2Button19 | Joystick5Button7 | Joystick7Button12 |

| Ampersand | Q | F9 | JoystickButton13 | Joystick3Button0 | Joystick5Button8 | Joystick7Button13 |

| Quote | R | F10 | JoystickButton14 | Joystick3Button1 | Joystick5Button9 | Joystick7Button14 |

| LeftParen | S | F11 | JoystickButton15 | Joystick3Button2 | Joystick5Button10 | Joystick7Button15 |

| RightParen | T | F12 | JoystickButton16 | Joystick3Button3 | Joystick5Button11 | Joystick7Button16 |