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:
采用创新的三层嵌套光环设计，层次分明，信息清晰：

Layer 层级	Function 功能	Features 特性
Outer (Largest) 外层（最大）	Cast Progress Ring 施法进度环	Shows current casting/channeling progress, supports class color or white 显示当前施法/引导进度，支持职业色或白色
Middle 中层	Cursor Core Halo 鼠标核心光环	Dynamic rainbow or minimal white, changes size based on cursor movement speed 动态彩虹色或极简白色，随鼠标移动速度变化大小
Inner (Smallest) 内层（最小）	GCD Cooldown Ring GCD冷却环	Displays global cooldown progress, white ADD blend mode 显示全局冷却进度，白色ADD混合模式

🌈 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模型拖尾效果，鼠标移动时留下炫酷轨迹：

ID	Name 名称	Style Description 风格描述
1	Thunderfury (Long) 风剑(长)	Thunderfury, Blessed Blade of the Windseeker 雷霆之怒，逐风者的祝福之剑
2	Thunderfury 风剑	Classic Thunderfury effect 经典风剑特效
3	Fel 邪能	Green fel flames 绿色邪能火焰
4	Bloodthirst 嗜血	Red bloody aura 红色血腥气息
5	Aurora 极光	Dreamy aurora effect 梦幻极光效果
6	Holy Light 圣光	Golden holy light shine 金色圣光闪耀
7	Rainbow 彩虹	Colorful rainbow trail 七彩彩虹轨迹
8	Fire 火焰	Intense fire effect 炽热火焰特效
9	Stars 星辰	Starry particle effect 星空粒子效果
10	Arcane 奥术	Arcane missile trail 奥术飞弹轨迹
11	Magic 魔法	Mysterious magic runes 神秘魔法符文
12	Shadow 暗影	Purple shadow energy 紫色暗影能量
13	Void 虚空	Dark void effect 黑暗虚空特效

🎨 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 客户端（推荐）

Download and install CurseForge App
下载并安装 CurseForge App
Search for "CursorHappy"
搜索 "CursorHappy" 或 "鼠标开心"
Click Install for automatic updates
点击安装，自动更新

Manual Installation 手动安装

Download the latest release zip file
下载最新版本压缩包
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\
Ensure the folder name is CursorHappy
确保文件夹名为 CursorHappy
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 许可证

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

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