Skip to content

Cinnamonpuma/CinnamonClient

Repository files navigation

CinnamonClient

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.

Minecraft Minecraft Fabric Kotlin

🌟 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

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

📞 Support & Contact

Author: Cinnamonpuma


📝 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.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors