You are viewing a potentially older version of this package. View all versions.
Marioalexsan-ChatMacros-1.2.0 icon

ChatMacros

Bind messages and commands to buttons.

Date uploaded a week ago
Version 1.2.0
Download link Marioalexsan-ChatMacros-1.2.0.zip
Downloads 257
Dependency string Marioalexsan-ChatMacros-1.2.0

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100
Nessie-EasySettings-1.2.1 icon
Nessie-EasySettings

A mod API for easily adding options to the settings menu.

Preferred version: 1.2.1

README

ChatMacros

Allows you to bind text to buttons that can be sent as chat messages or chat commands by pressing the button.

Configuration options

These options are available under BepInEx/config/Marioalexsan.ChatMacros.cfg or under EasySettings's mod tab, if available.

There are 9 macro buttons that can be configured, numbered from 1 to 9 as indicated by the N letter. For example, Macro1Button = 1st button's keycode, Macro2 = 2nd button's text, etc.

Each Macro can be optionally combined with Alt and Ctrl if EnableAltMacros and EnableCtrlMacros is enabled, allowing for up to 27 commands total.

Multiple commands can be sent together by separating them with "&&". Each command in a sequence is queued and sent at 100ms intervals. For example, /dance && CONGA TIME LADS would make your character both dance and say "CONGA TIME LADS".

If you need to send consecutive "&&" as part of the actual text without having it be interpreted as separate commands, you can do so by using "&" as an escape sequence instead. For example, /sit && Eepy && silly would make your character sit and say "Eepy && silly".

Setting Description Acceptable Values Default Value
Enabled Enable or disable the key bindings for the chat macros true / false true
EnableAltMacros Enables usage of Alt + Macro combinations true / false false
EnableCtrlMacros Enables usage of Ctrl + Macro combinations true / false false
MacroNButton The button to use for the Nth macro any key code Keypad N
MacroN The text to send in chat when the Nth macro is triggered any text (up to 125 characters for vanilla) <empty>
MacroNAlt The text to send in chat when the Nth macro is triggered with Alt any text (up to 125 characters for vanilla) <empty>
MacroNCtrl The text to send in chat when the Nth macro is triggered with Ctrl any text (up to 125 characters for vanilla) <empty>

Mod Compatibility

ChatMacros targets the following game versions and mods:

  • ATLYSS 112025.a4
  • Nessie's EasySettings v1.2.1 (optional dependency used for configuration)

Compatibility with other game versions and mods is not guaranteed, especially for updates with major changes.

CHANGELOG

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.2.0] - 2025-Dec-10

Added

  • Multiple commands can now be sequenced as part of a single macro by separating them with &&
    • For example, /dance && CONGA TIME LADS would make your character both dance and say "CONGA TIME LADS"
    • Successive commands are sent at 100ms intervals
    • Literal & characters can be escaped using &amp;, so you can send && using &amp;&amp; without having it be interpreted as separate commands

Fixed

  • Macros no longer trigger while any event system text inputs are selected, such as the Host Console's command input

[1.1.0] - 2025-Dec-05

Added

  • Alt and Ctrl Macro combinations can now be used, raising the total number from 9 to 27
  • Added MacroNAlt options to configure Alt behaviour for macros
  • Added MacroNCtrl options to configure Ctrl behaviour for macros
  • Added EnableAltMacros and EnableCtrlMacros options to control whenever Alt and Ctrl macros are active

[1.0.1] - 2025-Dec-04

Fixed

  • Macros no longer trigger while the chat window or the in-game settings menu is open

[1.0.0] - 2025-Dec-03

Changed

Initial mod release