使用文档
了解如何使用 Youni 跨服务器社交系统
🚀 快速开始
按照以下步骤快速开始使用 Youni。
- 访问注册页面，使用邮箱注册账号（需要邮箱验证码 + 设置密码 + 填写用户名）
- 登录后进入个人中心，完善你的个人资料（签名、性别、擅长领域等）
- 在皮肤工坊上传你的 Minecraft 皮肤（支持 64x64 / 64x32 PNG 格式，经典和 Slim 手臂样式）
- 在 Minecraft 服务器中输入
/youni login 连接账号
- 开始体验跨服务器聊天、好友系统、看板娘等完整社交功能
🔐 注册与登录
注册账号
访问 注册页面，需要提供以下信息：
- 邮箱地址 — 用于接收验证码和找回密码
- 用户名 — 2-32 个字符，你的唯一身份标识
- 密码 — 至少 6 位字符
- 邮箱验证码 — 点击"发送验证码"后查收邮箱
登录方式
系统支持 两种登录方式。
- 验证码登录 — 输入邮箱，接收 6 位验证码后一键登录，适合不记密码的用户
- 密码登录 — 使用邮箱（或数字 ID）和密码登录，支持“记住我”功能延长登录有效期
修改密码
在个人中心的修改密码，需要输入邮箱、接收验证码、设置新密码。
👤 个人中心
个人中心是你管理账号和角色的核心页面，包含以下功能模块：
个人资料
- 个性签名 — 最多 30 字，展示你的个人态度
- 性别 — 支持男、女、自定义三种选择
- 年龄 — 填写真实年龄（1-120 岁）
- 生日 — 选择出生日期
- 擅长领域 — 多选（如 PVP、建筑、红石、模组等），通过考核可获得领域认证
- 展示内容 — 选择他人可看到的个人信息字段
- 资料范围 — 支持公开、仅好友、同服玩家、私密四种可见级别
角色管理
- 创建角色 — 设置角色名（2-64 字符）和角色 UUID（可在线生成）
- 绑定皮肤 — 为每个角色单独绑定不同的皮肤
- 编辑 / 删除 — 灵活管理你的游戏角色
修改用户名
- 在个人中心输入新用户名即可修改（2-32 个字符）
绑定 QQ
- 输入 QQ 号，系统发送验证码到你的 QQ 邮箱
- 绑定后可查看 QQ 等级，点击刷新按钮更新等级信息
皮肤工坊（右侧面板）
- 3D 实时预览 — 拖拽旋转查看皮肤在 3D 模型上的效果
- 导入皮肤 — 支持 64x64 / 64x32 PNG 格式，拖拽或点击上传
- 手臂样式 — 经典（4px 宽）和纤细 Slim（3px 宽）两种模型
- 皮肤图库 — 网格展示所有已上传的皮肤，点击预览、选中删除
- 保存皮肤 — 将当前预览的皮肤保存到你的皮肤列表中
服务器绑定
- 创建服务器 — 填写服务器 IP 地址，生成唯一验证码
- 验证服务器 — 将验证码设为服务器 MOTD 并开服，系统自动验证
- 管理服务器 — 查看已绑定服务器，跳转到管理页面进行详细配置
- 解绑 / 管理 — 随时解绑不再使用的服务器
信誉分
- 系统根据游戏行为自动评估信誉分
- 高信誉分可解锁更多功能和权限
- 违规行为会导致信誉分降低
🎨 皮肤站
皮肤站（皮肤库）提供丰富的皮肤浏览和管理功能。
- 公开皮肤广场 — 浏览其他玩家上传的公开皮肤，发现社区热门作品
- 筛选和搜索 — 按风格、标签等条件快速找到喜欢的皮肤
- 上传分享 — 上传你自己的皮肤作品与社区分享
- 3D 预览 — 点击任意皮肤即可实时 3D 预览穿戴效果
- 收藏到衣柜 — 一键将喜欢的皮肤加入你的衣柜，供看板娘和游戏角色使用
- 我的皮肤 — 管理你上传的皮肤（查看、删除）
🛒 商店与经济系统
官方商店
- 商品浏览 — 查看商店中上架的所有道具和礼物商品
- 紫水晶余额 — 顶部钱包栏实时显示你的 💎 紫水晶数量
- 购买道具 — 点击「购买」按钮消耗紫水晶获得道具
- 赠送给看板娘 — 购买的道具可以在看板娘中心赠送给看板娘，提升好感度或恢复能量
经济系统
- 紫水晶（💎） — Youni 的核心货币，用于商店购物
- 每日签到 — 在首页点击「✨ 每日签到」即可获得紫水晶奖励
- 钱包管理 — 在个人中心和首页都能查看紫水晶余额
🌸 看板娘中心
看板娘中心是你与桌面宠物互动的核心页面：
看板娘状态
- 好感度（❤️） — 通过赠送礼物提升，满值为 100
- 心情（😊） — 显示看板娘当前的情绪状态
- 能量（⚡） — 使用官方 AI 对话时消耗，可通过签到或购买道具恢复
- 今日加成 — 每日随机一种道具获得额外好感加成（+1~4）
道具背包
- 查看你从商店购买的所有道具
- 点击「赠送」按钮将道具送给看板娘
- 赠送特效：弹出爱心动画，好感度或能量实时增加
- 今日加成道具会有特殊边框标识
更换皮肤
- 从你的衣柜（皮肤工坊上传的皮肤）中选择看板娘皮肤
- 支持经典 / Slim 两种模型
- 点击即可实时更换，刷新页面后依然生效
切换人设
- 选择不同的人设来改变看板娘的性格和对话风格
- 每个人设可绑定不同的触发器模板
- 未绑定模板的人设需要先在看板娘管理中配置
智能触发器（AI 对话）
- 官方 API 模式 — 使用系统内置 AI，每次对话消耗 1 点能量
- 自定义 API 模式 — 填入你自己的 OpenAI API Key（支持 OpenAI 兼容接口），无能量消耗限制
- 配置项 — OpenAI API Key、模型名称（如 gpt-3.5-turbo、gpt-4o）、自定义请求地址
- 连接测试 — 内置测试功能，可输入消息测试 AI 连接是否正常
- 安全存储 — 自定义 API Key 使用 AES 加密存储于服务器数据库
桌宠令牌
- 复制你的访问令牌到 Youni 桌宠程序。
- 桌宠程序将自动登录并展示看板娘在你的桌面上
- 支持实时交互：悬停、点击、对话等
⚙️ 看板娘管理
看板娘管理（控制中心）用于深度定制看板娘的行为逻辑。
人设管理
- 创建人设 — 命名新人设并选择绑定的触发器模板
- 编辑人设 — 修改人设绑定的模板
- 激活人设 — 选择当前生效的人设
- 删除人设 — 移除不再需要的人设
触发器系统
触发器是看板娘的核心行为引擎，每个触发器包含：
- 触发条件（可多选） —
- 模型交互 — 鼠标悬停、左键单击、双击、左键长按、右键长按
- 页面行为 — 页面加载、指定页面加载、首次访问、滚动到顶部/底部、标签页隐藏/可见、即将离开
- 时间条件 — 上午(6-12)、下午(12-17)、傍晚(17-22)、深夜(22-6)
- 关键词 — 检测网页中出现的关键词后触发
- 空闲超时 — 用户一段时间无操作后触发
- 亲密度要求 — 设置触发所需的最低好感度。
- 执行动画 — 从动画资源库中选择播放的动画
- 对话文本 — 每行一条，触发时随机选取一条显示
- 冷却时间 — 同一触发器的冷却间隔（秒）
- 关键词列表 — 当选择关键词条件时，指定要检测的关键词
- 页面过滤 — 当选择指定页面条件时，指定需要监听的页面路径
动画资源管理
- 导入动画 — 支持 JSON 格式的动画文件批量导入
- 动画列表 — 网格展示所有已导入的动画
- 预览 / 停止 — 选中动画后可预览播放或停止
- 播放倍速 — 支持 0.25x — 3x 的倍速调整
- 循环播放 — 可设置动画是否循环
- 删除动画 — 移除不需要的动画资源
模板管理
- 创建模板 — 新建触发器模板，用于组织和管理触发器集合
- 切换模板 — 在不同模板之间切换编辑
- 删除模板 — 删除模板及其中的所有触发器
- 复用配置 — 同一个人设可绑定模板，方便切换和复用
🌐 联机大厅
联机大厅（Lobby）用于跨服务器聊天和玩家互动。
聊天大厅
- 大厅列表 — 浏览所有可用的聊天大厅，每个大厅显示名称、描述和在线人数
- 加入大厅 — 点击大厅卡片加入（已加入的大厅有绿色标识）
- 退出大厅 — 再次点击已加入的大厅即可退出
- 在线玩家 — 点击大厅可查看当前在线的所有玩家及其来源服务器
- 跨服聊天 — 加入同一大厅的玩家可以跨服务器实时聊天
服务器接入
- 验证服务器 — 输入服务器 ID（srv_xxx）和密钥（sec_xxx）进行验证
- 加入大厅 — 验证成功后，点击大厅卡片即可将你的服务器加入大厅
- 多大厅支持 — 一台服务器可同时加入多个聊天大厅
📝 考核中心
考核中心用于管理员申请和技能认证：
- 在线考核 — 选择领域参加在线测试（如 PVP、建筑、红石等）
- 答题系统 — 逐题作答，系统自动评分
- 查看成绩 — 查看考核成绩和通过状态
- 提交题目 — 为题库贡献新题目，等待管理员审核
- 擅长领域认证 — 通过考核可获得对应领域的等级认证徽章
💬 游戏内命令
以下是 Youni 在 Minecraft 游戏内的完整命令列表：
/youni login — 使用已注册的邮箱和密码登录 Youni 账号/youni skin — 管理你的皮肤（选择、切换、查看）/youni profile — 查看自己或他人的个人资料/youni credit — 查看你的信誉评分/youni friend — 好友系统（添加、删除、好友列表、关注）/youni msg — 发送跨服务器私聊消息给指定玩家/youni hall — 加入、退出或切换聊天大厅
❓ 常见问题
账号相关
忘记密码怎么办？
在登录页面选择"忘记密码"或进入个人中心的修改密码，通过邮箱验证码重置密码。
如何绑定 QQ？
在个人中心找到“QQ 绑定”"功能，输入 QQ 号后系统会发送验证码到你的 QQ 邮箱，验证通过即完成绑定。
可以用 QQ 邮箱之外的邮箱注册吗？
可以。注册使用任意邮箱即可，QQ 绑定是额外的可选功能。
如何修改用户名？
在个人中心的“修改用户名”，输入新用户名后保存即可。
皮肤相关
皮肤上传失败怎么办？
请确保上传的是标准 64x64 或 64x32 的 PNG 格式皮肤文件。经典手臂用 64x64，Slim 纤细手臂也用 64x64。
经典 / Slim 皮肤有什么区别？
经典模型手臂宽度为 4 像素，Slim（纤细）模型手臂宽度为 3 像素，适合女性或纤细角色皮肤。
如何将皮肤公开到皮肤站？
在皮肤站页面点击上传，上传时会询问是否公开分享。也可以在个人中心选择已上传的皮肤发布到皮肤站。
经济相关
如何获取紫水晶？
每日在首页点击「✨ 每日签到」即可获得紫水晶奖励，连续签到可获得更多。
购买的道具在哪里查看？
在看板娘中心 — 我的道具（背包）中可以查看所有已购买的道具。
看板娘相关
看板娘不显示怎么办？
请确保在看板娘管理中已导入动画资源（JSON 动画文件）并配置了触发器模板，然后在看板娘中心激活人设。
如何让看板娘显示在桌面上？
在看板娘中心复制桌宠访问令牌，使用 Youni 桌宠程序配置令牌后即可在桌面上显示看板娘。
AI 智能对话如何配置？
在看板娘中心的「智能触发器模式」区域开启 AI 对话开关，可选择官方 API（消耗能量）或填入自己的 OpenAI API Key 使用自定义模式。内置测试功能可以验证 API 连接是否正常。
自定义 API 支持哪些服务商？
只要是兼容 OpenAI API 格式的服务都可以使用，如 OpenAI 官方、Azure OpenAI、DeepSeek、通义千问等。
能量用完了怎么办？
每日签到可以恢复能量，商店也可能上架能量道具。如果使用自定义 API 模式则不消耗能量。
服务器相关
如何绑定我的 Minecraft 服务器？
在个人中心的“服务器绑定”，输入服务器 IP 地址后生成验证码，将该验证码设为服务器 MOTD 并开服，系统会自动验证。
服务器验证码在哪里获取？
先在网站生成验证码，然后将其设置为服务器 MOTD（可在 server.properties 中设置 motd 字段），最后开服等待系统检测。
一台服务器可以加入几个大厅？
没有限制，一台服务器可以同时加入多个聊天大厅。