AutoMeow+

🚀 AutoMeow+ v1.0 - Initial Release

A tiny mod to automatically meow back to your fellow catsies in server chat! Enhanced from the original concept with tons of new features.

🎯 Core Features

Smart Auto-Reply System

• Intelligent detection - Responds when "meow" is detected in chat
• Anti-spam protection - Message cooldowns and requirements prevent chat flooding
• Channel detection - Automatically works in guild, party, coop, and all chat (Hypixel)
• Echo prevention - Smart quiet windows prevent infinite reply loops

Customizable Experience

Complete control over your cat sounds:

• Custom replies - Add, remove, or reset reply variations (mrow, purr, nya, etc.)
• 13 built-in variations - Default cute cat sounds out of the box
• Achievement system - Track your meow count with milestone celebrations (10, 25, 50, 100+ meows)
• Persistent stats - Your meow count saves between sessions

Audio & Visual Effects

Immersive cat interactions:

• Cat sound effects - Authentic meows with randomized pitch and volume
• Heart particles - Spawns hearts around players who meow
• Smart detection - Plays sounds for all cat-like sounds (mer, mrrp, nya)
• Configurable volume/pitch - Adjust base values and jitter amounts

✨ Configuration Options

In-Game Commands

Full command-line control:

• /automeow - Display current status
• /automeow toggle / on / off - Enable/disable the mod
• /automeow messages <0-10> - Set message requirement before auto-replying
• /automeow cooldown <0-30> - Configure quiet period (seconds)
• /automeow addreply <text> - Add custom reply (max 50 characters)
• /automeow removereply <text> - Remove a custom reply
• /automeow listreplies - View all current replies
• /automeow resetreplies - Reset to 13 default replies
• /automeow sound [on|off] - Toggle cat sound effects
• /automeow hearts [on|off] - Toggle heart particle effects
• /automeow chroma - Toggle chroma badge (requires Aaron-mod)
• /automeow meows - View your total meow count

Mod Menu Integration

GUI configuration screen (requires Mod Menu + Cloth Config):

• Visual toggle switches for all features
• Slider controls for message requirements
• Number input for cooldown timing
• Real-time preview of settings

Aaron-mod Chroma Support

Optional animated rainbow badge:

• Integrates with Aaron-mod's chroma_text pack
• Animated [AutoMeow+] prefix in chat
• Automatic detection and fallback to pastel pink

🔧 Technical Details

Clean Code Architecture

• Modular event handlers (chat, commands, tick events)
• Separated command builders (toggle, effects, config, replies, stats)
• Reduced cyclomatic complexity with extracted methods
• Follows checkstyle guidelines (one statement per line)

Performance Optimized

• Client-side only - no server installation needed
• Event-driven architecture for efficiency
• Minimal performance impact
• Config auto-saves on game close

Smart Detection System

• Pattern matching for "meow" and cat sounds (mer, mrrp, nya, mraow, mreow, mew)
• Hypixel channel detection (guild, party, coop chat)
• Player resolution with distance-based nearest match
• UUID-based self-message filtering

📥 Installation

Required Dependencies:

1. Fabric Loader ≥0.17.3
2. Fabric API (any version)
3. Minecraft 1.21.10+

Optional for GUI:

• Mod Menu (for settings button)
• Cloth Config (for visual config screen)

Optional for Chroma:

• Aaron-mod (for animated rainbow badge)

Download AutoMeow+-1.0.jar and place it in your .minecraft/mods/ folder.

🎮 First-Time Setup

1. Join any server or singleplayer world
2. Type /automeow to see current status
3. Configure your preferences with commands or Mod Menu
4. Start meowing! :3

💾 Configuration File

Settings automatically save to config/automeow.json:

{
  "enabled": true,
  "chroma": false,
  "playSound": true,
  "heartsEffect": true,
  "messagesRequired": 3,
  "quietAfterSendMs": 3500,
  "customReplies": ["mroww", "purr", "meow :3", ...],
  "meowCount": 0
}

🌟 Why AutoMeow+?

• ✅ Highly configurable - 15+ in-game commands and GUI options
• ✅ Feature-rich - Sounds, particles, achievements, custom replies
• ✅ Lightweight - Client-side only, minimal performance impact
• ✅ Smart - Anti-spam, channel detection, echo prevention
• ✅ Privacy-focused - All data stored locally

🐱 Credits

Developer: Knabbiii

Original Concept: Rhynohowl - Original AutoMeow

Enhanced with customizable replies, achievement tracking, improved channel detection, sound effects, particle effects, and comprehensive configuration options.

---

---