PinChat

A Minecraft mod that enhances chat functionality with message pinning, grouping, and a moveable chat screen. Works on both Fabric and Forge mod loaders!

✨ Features

📌 Pin Chat Messages

• Right-click on any chat message to pin/unpin it
• Pinned messages are displayed persistently on your HUD
• Create multiple message groups to organize your pinned messages
• Drag and drop groups anywhere on your screen
• Configurable maximum number of pinned messages
• Adjustable text width for pinned messages

📂 Message Groups

• Organize pinned messages into separate groups
• Each group can be positioned independently on the screen
• Collapse/expand groups with a single click
• Create new groups on the fly when pinning a message
• Rename groups to keep things organized

🎮 Moveable Chat Screen

• Open a special chat mode where you can move while typing (default: U)
• Look around freely with your mouse while the chat is open
• Smooth movement transitions — no abrupt stops when opening/closing chat
• Configurable mouse sensitivity for chat mode

⚙️ Flexible Configuration

PinChat works standalone, but also integrates with popular configuration mods for enhanced settings experience:

All dependencies are optional! The mod works perfectly without any of them.

📦 Installation

Requirements

• Minecraft: 1.21.11
• Java: 21 or higher
• Mod Loader: Fabric or Forge (choose one)

For Fabric

1. Install Fabric Loader (0.18.1+)
2. Download Fabric API
3. Download PinChat for Fabric from Releases
4. Place all mods in your .minecraft/mods folder

For Forge

1. Install Forge (1.21.11-61.0.2+)
2. Download PinChat for Forge from Releases
3. Place the mod in your .minecraft/mods folder

Optional Mods (Fabric only)

For enhanced configuration UI, you can optionally install:

• Cloth Config — Config GUI
• YACL — Alternative config GUI
• MaLiLib — Advanced hotkey configuration
• ModMenu — Access settings from mod list

🎮 Usage

Pinning Messages

1. Open the chat (T or /)
2. Right-click on any message to open the pin menu
3. Select Pin to [Group Name] or Create New Group
4. Right-click on a pinned message header to unpin or manage the group

Managing Groups

• Left-click and drag the group header to move it on screen
• Click the collapse button to minimize a group
• Right-click for more options (rename, delete, etc.)

Moveable Chat

1. Press U (or your configured key) to open moveable chat
2. Type your message while moving and looking around
3. Press U again or ESC to close

Configuration

Access settings through one of these methods:

• Command: /pinchat config
• ModMenu: Click the settings icon next to PinChat in the mod list
• In-game: Use the keybind if configured

Available Settings

🛠️ Building from Source

git clone https://github.com/ivanmikhaylov1/pinchat-mod.git
cd pinchat-mod

# Build both Fabric and Forge versions
./gradlew buildAll

# Build only Fabric
./gradlew :fabric:build

# Build only Forge
./gradlew :forge:build

# Run tests
./gradlew :fabric:test

Compiled JARs will be in:

• Fabric: fabric/build/libs/
• Forge: forge/build/libs/

📁 Project Structure

pinchat-mod/
├── common/          # Shared code (configuration, data classes)
├── fabric/          # Fabric-specific implementation
├── forge/           # Forge-specific implementation
├── gradle/          # Gradle wrapper files
└── .github/         # GitHub Actions workflows

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

🙏 Credits

• Built with Fabric and Forge
• Uses Architectury Loom for multi-platform builds
• Optional integration with Cloth Config, YACL, and MaLiLib

❓ Support

If you encounter any issues or have suggestions:

• Open an Issue
• Make sure to include your Minecraft version, mod loader, and any crash logs

Made with ❤️ by Sfafy

PinChat

Keep the messages that matter in view.

Coordinates to your next base. A friend's instructions. Your server's next objective. PinChat keeps useful chat messages on your HUD, so you can get back to playing without scrolling through chat.

Pin messages · Organize groups · Move and resize · Move while chatting

Download PinChat · Source code · Report a bug

Your chat, where you need it

• Keep important messages visible. Right-click a message in normal chat to pin it; right-click again to unpin.
• Make room for different tasks. Shift + right-click creates a new group. Keep coordinates, reminders, and conversations together in their own groups.
• Arrange your HUD. Drag groups into position and use the ↘ handle to resize them. Collapse a group with its header, rename it with [R], or delete it with [X].
• Keep moving with chat open. Press F9 to open the special chat mode with movement, then F9 or Esc to close it.
• Pick up where you left off. Groups and their positions are saved in config/pinchat.json.

Choose your version

The current release is PinChat 3.2.0.

Choose the Minecraft version and loader you actually use on the Versions tab. Install one matching PinChat JAR.

The 26.1, 26.1.1, and 26.1.2 downloads share the same binary for each loader. Quilt uses the Fabric-compatible binary. Forge 26.x is not supported. Minecraft 26.3 requires its dedicated JAR and Java 25; NeoForge for 26.3 is currently beta.

Get started

1. Install your chosen mod loader for the matching Minecraft version.
2. Download PinChat from the Versions tab and put its JAR in your game profile's mods folder.
3. Fabric and Quilt: also install Fabric API for your exact Minecraft version. Forge and NeoForge: no additional mods are needed.
4. Launch Minecraft, open normal chat with T or /, and right-click a message to pin it.

Client only: install PinChat on your own game client; it does not require installation on the server.

Controls at a glance

Upgrading? Existing profiles retain saved key bindings. Assign F8 for settings and F9 for special chat, or reset those two actions individually in Minecraft's Controls → PinChat.

Simple settings

The built-in settings screen has a single switch for chat with movement. No configuration mod is required. ModMenu can also open this screen on Fabric.

The default limit is 5 messages per group. PinChat saves its data in config/pinchat.json. Controls and settings in older releases may differ; check the changelog for your download.

Need a hand?

Open an issue with your Minecraft version, loader, PinChat version, and any relevant logs.

Release notes · GitHub releases · MIT license