Skip to content

v1.0.0

Latest

Choose a tag to compare

@Tim0x0 Tim0x0 released this 03 Sep 17:08

🎉 首个版本发布!

为 Halo 提供用户装饰、身份标识与前台展示能力的社区互动增强插件。站长管理勋章 / 头像框 / 称号 / 名片背景 / 昵称样式并授予用户,用户在个人中心佩戴,主题与其他插件可在前台展示。

在线演示作者页(用户卡 + 装扮墙)

✨ 功能特性

  • 装饰资产管理:5 类装饰(勋章、头像框、称号、名片背景、昵称样式),草稿 / 启用 / 停用 / 归档全生命周期,卡片 / 列表双视图,身份行与用户卡双场景实时预览
  • 分类 / 标签 / 稀有度:自定义元数据组织装饰;首次启动自动创建 5 档稀有度(普通 / 稀有 / 史诗 / 传说 / 限定)
  • 授予与撤销:单 / 多用户授予、按 Halo 角色快照批量授予、设有效期、续期(只延长不缩短)、撤销、保留历史;多来源并存(后台 / 角色快照 / 外部插件各自独立记账,持有 = 并集)
  • 个人中心装扮:佩戴头像框 / 称号 / 主勋章 / 展示勋章(≤8)/ 名片背景 / 昵称样式,右侧实时预览;支持用户投稿;公开装扮墙可关
  • 身份标识:把 Halo 角色映射成前台身份标牌(文字牌 / 图标 / 图片三选一 + 优先级),不进库存、不占佩戴槽
  • 前台展示hip-* Web Component + Finder API + 公开 HTTP API,供主题或插件前台页在评论区 / 作者行 / 装饰墙展示(不自动注入页面
  • 自定义模板:站长可贴 HTML / CSS 完全接管三个组件的渲染(仅超级管理员)
  • 对外插件 API:发奖(DecorationGrantApi)/ 身份查询(PublicIdentityQueryApi)/ 统计贡献扩展点(UserStatContributor),可选依赖、缺席自动降级
  • 站内通知:获得 / 撤销装饰、投稿通过 / 驳回、批量授予完成(发给操作者),走 Halo 原生通知

📋 环境要求

  • Halo >= 2.25.0
  • JDK 21

📦 安装方式

下载 plugin-interaction-plus-1.0.0.jar,在 Halo 后台 → 插件 → 安装 → 上传并启用。启用后左侧出现「互动」分组。

🔧 配置说明

  1. 互动 → 装饰 → 资产:创建装饰、上传素材、启用(新建默认是草稿,未启用不能授予)
  2. 互动 → 装饰 → 授予:选装饰 + 用户(或按角色快照),设有效期 / 原因
  3. 被授予的用户到 用户中心 → 装扮 → 我的装扮 佩戴并保存,前台才会显示
  4. 主题或评论插件需引入 Runtime 并写入 hip-* 标签,评论区 / 作者行才会出现装扮

⚠️ 注意事项

  • 插件不会自动往主题页面塞任何东西。 装上之后后台就能管装饰,但评论区要出现头像框 / 身份行,需要主题(或评论插件)写入 hip-* 标签
  • 授予 ≠ 佩戴。 授予只进库存,用户要自己到「我的装扮」里佩戴,前台才会显示
  • 身份标识 ≠ 装饰。 身份标识按角色映射,无需授予、不进库存
  • 首次启动会自动创建 5 个默认稀有度;删掉后重启不会重建
  • 自定义组件只有超级管理员能进

📚 文档

反馈:BBS · 互动增强