有爱设计

应用数
113
安装量
1.3万

应用圈

最后在线：: 2026-09-20
客服时间：: 工作日 9时~21时

其他应用

热门应用

3D 头像制作器V1.0

收藏分享投诉

¥99.00

统　　计:共 2 次下载
更新日期:2026-08-25
适配编码:UTF8SC
兼容版本:X3.4 X3.5 X5.0 X5.1
PHP版本:7.0 ~ 7.4 8.0 ~ 8.5
标签分类:头像上传
移动属性:该版本安装后自带手机版（触屏版）
开发方式:作者申明该应用大量使用 AI 辅助开发，请谨慎考虑

购买应用 免责声明

# OneWorks Avatar · 3D 头像制作器（hl_avatar）插件介绍

&gt; `hl_avatar` 是一个接入 Discuz! X 的浏览器端头像编辑插件。登录用户可以在页面中调整头像外观、保存多个头像方案，并将选定方案设置为当前论坛头像。

## 一、插件简介

OneWorks Avatar 将 3D 头像编辑功能放入 Discuz! 页面。用户可以从预设头像开始，对面部、材质、姿态、镜头和动画参数进行调整，并在编辑过程中查看预览效果。

插件以独立页面接入论坛，入口为 `plugin.php?id=hl_avatar`。页面使用 Discuz 当前登录状态，头像定义和已保存方案按用户 UID 保存，不同用户之间相互独立。

## 二、主要功能

- **头像编辑**：调整头像的面部、材质、姿态、镜头和动画参数。
- **预设方案**：使用内置预设开始编辑，也可以保存多个个人头像方案。
- **方案修改**：打开已保存方案后继续调整，并覆盖保存当前方案。
- **设置论坛头像**：在已保存方案中选择“头像”，将当前预览设置为 Discuz 用户头像。
- **图片导出**：支持导出 SVG、PNG 和动画 GIF 文件。
- **用户菜单**：显示当前登录用户，并提供返回论坛、查看个人空间和退出登录入口。
- **中文界面**：前台界面使用中文显示，动作名称和操作提示保持统一的中文表达。
- **响应式页面**：桌面端和 Touch 页面共用插件资源，并根据屏幕尺寸调整编辑区域布局。

## 三、使用流程

1. 登录论坛后，从导航中的“3D 头像制作器”进入插件页面。
2. 选择一个头像预设，或从当前头像定义开始编辑。
3. 在编辑面板中调整头像参数，观察画布中的预览结果。
4. 需要保留方案时，点击保存并填写方案名称。
5. 在已保存方案中点击“修改”，可以继续编辑并保存更新后的内容。
6. 点击方案中的“头像”按钮，可将该方案设置为当前 Discuz 头像。
7. 需要文件时，可在导出面板中选择 SVG、PNG 或动画 GIF。

## 四、登录与数据保存

- 未登录用户访问插件页面时，会跳转到 Discuz 登录页面。
- 保存头像定义和方案时使用 Discuz `FORMHASH` 进行请求校验。
- 头像定义保存到 `pre_hl_avatar_definition` 表，每个用户保留一份当前编辑定义。
- 头像方案保存到 `pre_hl_avatar_preset` 表，记录方案名称、参数、定义数据和预览图。
- 删除插件时会删除上述数据表及其中的数据，卸载前请根据站点需要备份数据。

## 五、头像设置兼容方式

- Discuz X5/X5.1 使用站点原生账号头像处理逻辑生成头像尺寸并保存到头像目录。
- Discuz X3.4/X3.5 保留 UCenter 兼容分支，用于适配已有的头像同步配置。
- 头像设置结果会更新 Discuz 用户的 `avatarstatus` 状态，并返回当前头像地址。

## 六、安装方法

1. 将 `hl_avatar` 目录上传到站点的 `source/plugin/` 目录。
2. 进入 Discuz 管理中心的“应用 / 插件”，安装“OneWorks Avatar 3D 头像制作器”。
3. 安装后进入管理中心的“工具 / 更新缓存”。
4. 访问 `plugin.php?id=hl_avatar`，或从论坛导航中的“3D 头像制作器”进入。

## 七、后台配置

- **功能开关**：控制插件页面是否开启。
- **页面标题**：设置浏览器标题和插件入口使用的名称。