CursorHappy 鼠标开心

Make Your Cursor Happy!
让你的鼠标更清晰、更好看、更有个性！

📖 Overview 简介

CursorHappy is a mouse visual enhancement addon designed specifically for World of Warcraft.
鼠标开心是一款专为魔兽世界设计的鼠标视觉效果增强插件。

With dynamic halos, cast progress rings, GCD indicators, and gorgeous cursor trail effects, it helps you track your cursor position clearly during intense combat while adding a unique visual style to your game interface.
它通过动态光环、施法进度环、GCD指示器和华丽的鼠标拖尾特效，让你在激烈的战斗中也能清晰地追踪鼠标位置，同时为你的游戏界面增添独特的视觉风格。

✨ Core Features 核心功能

🔥 Triple-Ring Architecture System 三环架构视觉系统

An innovative three-layer nested halo design with clear hierarchy and information:
采用创新的三层嵌套光环设计，层次分明，信息清晰：

🌈 Dynamic Cursor Halo 动态鼠标光环

• Speed-Responsive Size 速度响应式大小: The faster you move your mouse, the larger the halo becomes, helping you locate the cursor during rapid movement
  鼠标移动越快，光环越大，帮助你在快速移动中定位光标

• Rainbow Breathing Light 彩虹呼吸灯: Automatically switches to an elegant breathing effect when stationary, with smooth color gradients
  静止时自动切换为优雅的呼吸灯效果，色彩渐变流畅

• Minimal Mode 极简模式: Optional fixed white halo for a clean, simple look
  可选固定白色光环，简洁不花哨

⚡ Cast Progress Visualization 施法进度可视化

• Real-time Cast Ring 实时施法环: Outer ring displays casting progress when casting or channeling
  开始施法或引导时，外环显示施法进度

• Class Color Support 职业色支持: Choose between class representative color or pure white
  可选择使用职业代表色或纯净白色

• Combat-Only Option 战斗模式可选: Can be set to display only during combat for a cleaner look out of combat
  可设置为仅在战斗中显示，非战斗状态保持简洁

⏱️ GCD Cooldown Indicator GCD冷却指示

• Smart GCD Detection 智能GCD检测: Automatically detects and displays global cooldown progress
  自动检测并显示全局冷却进度

• Inner Ring Cooldown Animation 内环冷却动画: White cooldown ring displays in the inner layer without affecting other visual effects
  白色冷却环在内层显示，不影响其他视觉效果

• Combat-Only Option 战斗模式可选: Can be set to display only during combat
  可设置为仅在战斗中显示

👆 Click Effects 点击特效

• Click Ripple Effect 点击涟漪效果: Produces a spreading halo effect with each mouse click
  每次点击鼠标时产生扩散光环特效

• Color Synchronization 颜色同步: Effect color matches the current cursor halo color
  特效颜色与当前鼠标光环颜色保持一致

✨ Cursor Trail Effects (CursorFX) 鼠标拖尾特效

Built-in 13 gorgeous 3D model trail effects that leave cool trails as you move your mouse:
内置13种华丽的3D模型拖尾效果，鼠标移动时留下炫酷轨迹：

🎨 Multiple Texture Styles 多种纹理样式

Supports 6 cursor halo textures, switch at will:
支持6种鼠标光环纹理，随心切换：

• Ring (Default) 圆环（默认） - Classic circular halo 经典圆形光环
• Starburst 星爆 - Four-pointed star glow 四角星形光芒
• Heart 爱心 - Cute heart shape 可爱心形
• For the Horde 为了部落 - Horde symbol 部落标志
• For the Alliance 为了联盟 - Alliance symbol 联盟标志
• Hexagram 六芒星 - Mysterious hexagram 神秘六芒星

⚙️ Configuration Options 配置选项

🖱️ Cursor Effect Style 鼠标效果样式

• ✅ Enable/Disable cursor style 启用/禁用鼠标样式
• ✅ Minimal Mode (white fixed size) 极简模式（白色固定大小）
• ✅ Enable only in combat 仅在战斗中启用
• ✅ Halo size adjustment (48-128 pixels) 光环大小调节（48-128像素）
• ✅ Click effect toggle 点击特效开关

🔮 Cast Halo Settings 施法光环设置

• ✅ Enable/Disable cast halo 启用/禁用施法光环
• ✅ Show only in combat 仅在战斗中显示
• ✅ Use class color / White 使用职业色 / 白色

⏱️ GCD Settings GCD设置

• ✅ Enable/Disable GCD display 启用/禁用GCD显示
• ✅ Show only in combat 仅在战斗中显示

Cursor Trail Settings 鼠标拖尾设置

• ✅ Enable/Disable trail effects 启用/禁用拖尾特效
• ✅ 13 effect style choices 13种特效样式选择
• ✅ Trail size scaling (0.5x - 2.0x) 拖尾大小缩放（0.5x - 2.0x）

🔄 Compatibility 兼容性

• WoW Versions 魔兽世界版本: Retail 正式服 | Classic 怀旧服 | Classic Era 经典旧世
• Interface Versions 界面版本: Supports 11.x / 12.x / 1.15.x / 3.4.x / 4.4.x
• Addon Compatibility 插件兼容性: Conflict-free design, works with all major addons
  无冲突设计，可与所有主流插件同时使用

📦 Installation 安装说明

💾 Via CurseForge Client (Recommended) 通过 CurseForge 客户端（推荐）

1. Download and install CurseForge App
   下载并安装 CurseForge App

2. Search for "CursorHappy"
   搜索 "CursorHappy" 或 "鼠标开心"

3. Click Install for automatic updates
   点击安装，自动更新

Manual Installation 手动安装

1. Download the latest release zip file
   下载最新版本压缩包

2. Extract to: 解压到：

   • Retail: World of Warcraft\_retail_\Interface\AddOns\
   • Classic: World of Warcraft\_classic_\Interface\AddOns\
   • Classic Era: World of Warcraft\_classic_era_\Interface\AddOns\

3. Ensure the folder name is CursorHappy
   确保文件夹名为 CursorHappy

4. Restart game or click "AddOns" button at character selection screen to enable
   重启游戏或在角色选择界面点击"插件"按钮启用

🎮 Usage 使用方法

Opening the Settings Panel 打开设置面板

• In-game press ESC → Interface → AddOns → CursorHappy
  游戏内按 ESC → 界面 → 插件 → 鼠标开心

• Or use command: /cursorhappy or /chp
  或使用命令：/cursorhappy 或 /chp

Quick Adjustments 快速调整

All settings can be previewed in real-time without needing to reload the interface!
所有设置都可以实时预览，无需重载界面即可生效！

❓ FAQ 常见问题

Q: Will this addon affect game performance?
插件会影响游戏性能吗？
A: No. CursorHappy uses efficient rendering methods with very low CPU usage, causing no lag even during raid encounters.
不会。CursorHappy 采用高效的渲染方式，CPU占用极低，即使在团本战斗中也不会造成卡顿。

Q: Can I show it only during combat?
可以只在战斗中显示吗？
A: Yes! Check "Enable only in combat" in the settings.
可以！在设置中勾选"仅在战斗中启用"即可。

Q: Do cast rings and GCD rings support all textures?
施法环和GCD环支持所有纹理吗？
A: Cast rings and GCD rings only support ring textures (default ring). Other textures will automatically disable cooldown animations to ensure visual quality.
施法环和GCD环仅支持环形纹理（默认圆环），其他纹理会自动禁用冷却动画以保证视觉效果。

Q: How do I disable cursor trail effects?
如何关闭鼠标拖尾特效？
A: Find "Cursor Trail Settings" in the settings panel and uncheck "Enable cursor trail".
在设置面板中找到"鼠标拖尾设置"，取消勾选"启用鼠标拖尾"即可。

👤 Author Information 作者信息

• Author 作者: huchang47
• Feedback 反馈: Please submit Issues on the CurseForge page
  请在 CurseForge 页面提交 Issue
• Donate 捐赠: If you like this addon, consider donating on the CurseForge page to support development
  如果您喜欢这个插件，可以在 CurseForge 页面捐赠支持开发

📜 License 许可证

All Rights Reserved. 保留所有权利。

Redistribution, modification, or commercial use without the author's written permission is prohibited.
未经作者书面许可，禁止重新分发、修改或用于商业用途。

Enjoy your happy cursor! 🎮✨
祝您游戏愉快！ 🎮✨