Floating Particles

✨ Floating Particles

🧑‍💻 开发者碎碎念(๑•̀ㅂ•́)و✧

我是wangxinyangヽ(✿ﾟ▽ﾟ)ノ，一个只会依靠AI写代码的编程小白🥺，这个插件全程借助Codex辅助开发✨。
这个小插件也许还不是那么完善，大家也可以自己魔改或者去俺的博客留言板提建议哈～
插件Github开源地址：https://github.com/WXY-333/halo-floating-particles
俺的博客地址：https://wangxinyang.top/ 欢迎互换友链或互访哦～(σ≧︎▽︎≦︎)σ

Floating Particles 是一个 Halo 前台动效插件，可以为博客页面添加粒子漂浮、鼠标交互动效和个性化鼠标样式。插件所有功能都可以在 Halo 后台配置，不需要修改主题代码。🍁

当前版本：1.0.9 🚀

后台设置

🚀 功能亮点

⚙️ 前台动效开关：支持在 Halo 后台一键开启或关闭前台动效。
🧩 独立配置：页面粒子效果、鼠标动效、鼠标样式分开配置，互不干扰。
📱 移动端优化：支持移动端专属开关，适合按站点性能和阅读体验自行调整。
🎯 精准控制：支持按页面启用或禁用粒子效果，可自由填写包含路径或排除路径。
🎛️ 高度自定义：支持调整粒子数量、动效颜色、透明度、速度和动效层级（z-index）。
🖱️ 个性化光标：支持内置鼠标光标模板，也支持从 Halo 附件库选择自定义鼠标文件。
📦 本地化部署：Three.js 已打包到插件本地静态资源，完全不依赖外部 CDN。
🧼 绿色无残留：关闭或卸载插件后，不会修改主题模板，也不会在主题中留下任何冗余代码。

❄️ 页面粒子效果

插件内置多种页面粒子效果，适合不同类型的博客页面、个人站点和活动页面。🎨

❄️ 雪花飘落
✨ 星空漂浮
🫧 气泡上升
🌟 萤火闪烁
🌸 樱花飘落
🌊 水波涟漪
🌠 流星雨
🍂 落叶飘落
🕸️ 粒子连线
🌌 星尘漂浮
🎉 彩纸飘落
🌧️ 细雨
🌾 蒲公英飘散
🪶 羽毛飘落
🔮 极光流动
🔯 星座连线
🎵 漂浮音符
🔆 光斑漂浮
🪰 萤火虫聚散

页面粒子效果

🖱️ 鼠标动效

鼠标动效用于增强访问者在前台页面中的交互体验，可以选择安静轻量的光环、拖尾，也可以选择更明显的点击礼花、点击爱心等效果。💥

🎆 点击礼花
🌊 水波涟漪
✨ 拖尾光点
⭐ 跟随小星星
🌟 光标星星跟随
❤️ 点击爱心
⭕ 鼠标光环
💫 WebGL 光标尾巴
🫧 点击气泡
🌸 点击小花
🌈 鼠标彩虹拖尾
🧲 鼠标磁吸粒子

鼠标动效

🎨 鼠标样式

插件支持开启个性化鼠标样式。开启后，鼠标样式默认全站使用，不受“粒子效果页面生效范围”影响。⭐

内置鼠标模板包括：

🐷 粉色小猪
🐱 猫咪老师
🎤 Miku
🎤 Miku BLZ
🥜 阿尼亚
🎸 孤独摇滚 - 伊地知虹夏
🎸 孤独摇滚 - 后藤独
🎸 孤独摇滚 - 山田凉
🏀 黑子哲也
🐾 罗小黑
🎤 洛天依
💙 蕾姆
✨ 流荧

13种鼠标样式可供选择

💡 自定义鼠标图片建议上传 CUR 或 GIF 鼠标样式文件。

📖 使用说明

📥 在 Halo 后台进入插件管理页面。
🆙 上传并启用 Floating Particles 插件。
⚙️ 进入插件设置页面。
🟢 打开 开启前台动效 开关。
🌌 在 粒子效果 中选择满意的页面动效。
🖱️ 在 鼠标动效 中选择鼠标交互动效。
🎨 如需更换光标，打开 启用鼠标样式 并选择内置模板或自定义鼠标文件。
🎛️ 按需调整数量、颜色、透明度、速度和动效层级。
💾 保存设置后，刷新前台页面即可查看惊艳效果！

🌐 页面生效范围

粒子效果支持三种页面生效方式：

🗺️ 全站启用
📌 仅指定路径启用
🚫 排除指定路径

路径每行填写一个，例如：

/
/about
/archives

⚠️ 注意：鼠标样式默认全站使用，不受粒子效果页面生效范围影响。

💡 推荐配置
如果希望长期默认开启，建议选择更轻量、不会遮挡阅读内容的组合，以保证最佳的阅读体验：

🌌 页面粒子效果：星尘漂浮、星空漂浮、萤火闪烁、光斑漂浮

🖱️ 鼠标动效：拖尾光点、鼠标光环、跟随小星星

🏁 透明度：0.35 到 0.65

🔢 粒子数量：60 到 100

📝 提示：如果页面文字较多，建议适当降低透明度，避免同时开启彩纸、流星雨、水波等视觉存在感较强的效果，以免分散读者注意力。

🔧 兼容性
🟢 支持 Halo >=2.23.0

🌐 支持现代桌面端和移动端浏览器

⚡ WebGL 光标尾巴和水波涟漪需要浏览器支持 WebGL

🧩 如果主题启用了 PJAX、页面缓存、静态缓存或自定义渲染机制，插件保存配置后可能不会立刻在前台显示最新效果。遇到这种情况时，可以先清理主题缓存、浏览器缓存，或使用 Ctrl + Shift + R 强制刷新页面。

❓ 常见问题
❓ 是否需要修改主题代码？
答：不需要。插件通过 Halo 插件机制向前台自动注入动效脚本，启用后即可直接使用，简单快捷。

❓ 保存设置后前台没有立刻生效怎么办？
答：请先确认插件已启用并保存配置，然后清理主题缓存、浏览器缓存，或使用 Ctrl + Shift + R 强制刷新页面。部分启用 PJAX、页面缓存或自定义渲染机制的特殊主题，可能需要刷新缓存后才会加载最新动效。

❓ 是否依赖外部 CDN？
答：不依赖。插件所需的前端脚本、鼠标资源和 Three.js 文件都已全部打包到插件本地静态资源中，加载更稳定。

❓ 会影响主题菜单、搜索框或弹窗吗？
答：动效层使用了全局 pointer-events: none 属性，正常情况下不会阻挡任何点击事件。如果主题层级比较特殊，可以在后台设置中灵活调整动效层级数值。

❓ 关闭或卸载后会有代码残留吗？
答：不会。插件采用非侵入式设计，不会修改主题模板文件。关闭或卸载插件后，前台将不再注入任何动效脚本，干净整洁。

❓ 自定义鼠标应该上传什么格式？
答：强烈建议上传标准鼠标指针格式 .cur 或动态格式 .gif 鼠标样式文件，以获得最佳兼容表现。