CinnamonClient

A modular and performance-focused Minecraft 1.21.6+ client mod for Fabric. Built entirely in Kotlin for clarity, extensibility, and real-time control.

🌟 Overview

CinnamonClient is a next-generation Minecraft client mod that combines lightweight architecture with powerful customization. Designed for users who demand both performance and flexibility, it offers a clean, customizable HUD system, modern UI framework, and advanced developer utilities—all built with a focus on clarity and extensibility.

✨ Key Highlights

🚀 Lightweight & Modular - Minimal performance impact with toggleable modules
🎨 Fully Customizable HUD - Live editing with drag-and-drop repositioning
🔧 Modern UI Framework - Polished screens and intuitive controls
📡 Packet-Level Integration - Advanced networking utilities and controls
💎 Clean Kotlin Codebase - Minimal dependencies, maximum maintainability

🧩 Core Modules

All modules are toggleable and configurable through the in-game GUI, giving you complete control over your experience.

📊 HUD Elements

Module	Description	Features
🎮 Keystrokes	Visualizes input (WASD, mouse buttons)	Layout customization, key remapping, color control
📈 FPS Display	Shows current frames per second	Configurable format, color, and positioning
📡 Ping Display	Displays latency to server or localhost	Adjustable style and scaling options
🛡️ Armor HUD	Renders armor icons and durability	Fully customizable layout and positioning
🗺️ Coordinates HUD	Shows player's X, Y, Z coordinates	Axis labeling, formatting, and screen placement
🎵 Spotify HUD	Displays current Spotify track info and playback status	Song title, artist, progress bar, configurable colors and position

🔧 Utility Modules

Module	Description	Features
✏️ HUD Edit Mode	Drag-and-drop HUD repositioning	Snapping helpers, alignment guides, scaling
💡 Fullbright	Maximum brightness override	Toggle-based lighting control
🖱️ Simple Auto Clicker	Automates mouse clicks at configurable intervals	Adjustable CPS (clicks per second), toggle keybind, visual feedback
📦 Packet Handler	Packet-layer utilities	Powers internal UI interactions

🎨 Customization

🖱️ Live HUD Editing

Activate HUD Edit Mode through the main menu to transform your interface in real-time:

Drag & Drop - Move elements anywhere on screen
Precision Alignment - Edge snapping and alignment guides
Dynamic Scaling - Resize elements to your preference
Visual Feedback - See changes instantly as you edit

⚙️ Per-Module Configuration

Each module includes dedicated settings accessible via the GUI:

🎯 Scaling - Adjust size for optimal visibility
🎨 Color Customization - Personalize your aesthetic
📍 Screen Positioning - Place elements exactly where you want them
🕹️ Keybinds & Behavior (Auto Clicker) - Set toggle keys and click speed

🔨 Development

CinnamonClient leverages cutting-edge technologies for optimal performance and maintainability:

🛠️ Tech Stack

Kotlin — Clean syntax and expressive language features
Fabric — Lightweight and widely supported modding framework
Mixin — Powerful method injection for low-level control

🏗️ Architecture

Modular Design - Easy module creation and management
Clean Separation - UI logic clearly separated from game logic
Extensible Framework - Built for future enhancements and community contributions

🚀 Installation

Prerequisites

Minecraft Java Edition 1.21.6 or 1.21.7
Fabric Loader (latest version)
Java 21 or higher

Installation Steps

Download the latest version from Releases
Install Fabric Loader for Minecraft 1.21.6 or 1.21.7
Place the CinnamonClient .jar file in your mods folder
Launch Minecraft with the Fabric profile
Access the mod through the in-game menu

📞 Support & Contact

Author: Cinnamonpuma

GitHub: Issues & Discussions

📝 License

This project is licensed under the (CC BY-NC-SA 4.0). See the LICENSE file for details.

Built with ❤️ and ☕ by Cinnamonpuma

Enhancing your Minecraft experience, one module at a time.

Cinnamon Client