Getting Started - NoWordz/AtomChat-Mod GitHub Wiki

Getting Started

Requirements

Item Requirement
Minecraft 1.21.1 (Fabric / NeoForge builds) or 1.20.1 (Forge build)
Fabric build Fabric Loader 0.16.0+ and Fabric API
NeoForge build NeoForge 21.1+
Forge build Forge 47+ (1.20.1)
Java 21+ for the 1.21.1 builds, 17 for the Forge 1.20.1 build
OS Windows x64 (the bundled Skija native is Windows x64 only)

Install

  1. Download the jar for your loader from Releases: atomchat-Fabric-1.21.1-*.jar, atomchat-NeoForge-1.21.1-*.jar or atomchat-Forge-1.20.1-*.jar. For Forge, use the jar without the -slim suffix.
  2. Drop it into .minecraft/mods/ (or the instance's mods/ folder).
  3. Optional: put the same jar into your server's mods/ to enable server-side media hosting and avatar sync.
  4. Launch the game.

Open the panel

  • Press your chat key (default T or /): the vanilla chat screen is replaced by the AtomChat panel.
  • Press Y (default, rebindable under Controls → AtomChat) to open the panel directly and return to the page you were last on.
  • Esc closes the panel with its close animation.

First steps

  1. The top card is the shell header (page title, back arrow, clock). Below it sits the message list; at the bottom, the composer.
  2. Type and press Enter to send. When your draft wraps to a second line the composer grows; Up/Down move the caret between lines.
  3. Send an image in three ways: the image button (system file picker), drag a file into the window, or Ctrl+V after copying one. The upload inserts a CICode into your draft.
  4. Left-click a loaded image to open the full-size preview; close it with the X below the picture, a click on the dimmed backdrop, or Esc.
  5. Right-click a message for copy / quote / save / @ / whisper / teleport / block. Click an avatar for the player profile, double-click to poke, right-click for the avatar menu.
  6. The bottom tab bar (root pages) switches Chat / Profile / Settings.