# YExperienceBar **Repository Path**: game_87/yexperience-bar ## Basic Information - **Project Name**: YExperienceBar - **Description**: YExperienceBar - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-13 - **Last Updated**: 2026-11-13 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # YExperienceBar 独立的魔兽世界升级经验条插件,从 YUI 套件中提取,不依赖任何框架,可单独安装运行。 ## 功能特性 - **升级进度显示**:经验条 + 等级圆环,实时显示当前经验百分比 - **预计升级时间**:基于采样速率估算 ETA,采样不足5分钟时标注"样本较少" - **双倍经验区段**:在经验条上叠加显示双倍经验储备量 - **任务经验预测**:扫描任务日志,预测交付已完成任务后的经验进度 - **详情面板**:悬停或点击固定显示详细信息(当前经验、剩余、效率、双倍储备、任务预测、本级用时、本次时长、本次获得等) - **17种圆环样式**:从细金到冰冠,多种等级圆环装饰可选 - **4种布局样式**:圆环在左/右/居中/纯进度条 - **渐变填充**:经验、双倍经验、任务经验各自独立的渐变颜色配置 - **隐藏原生经验条**:自动隐藏暴雪原生经验条(正式服隐藏 StatusTrackingBarManager,怀旧服隐藏 MainMenuExpBar) - **拖拽定位**:在颜色预览模式下可拖拽移动经验条位置 - **会话持久化**:登出时保存会话状态,重新登录后恢复速率估算 ## 安装 1. 将 `YExperienceBar` 文件夹放入 `Interface\AddOns\` 目录 2. 重启游戏或在角色选择界面加载插件 3. 插件默认启用,经验条出现在屏幕左上角 ## 使用说明 ### 斜杠命令 | 命令 | 功能 | |---|---| | `/yxp toggle` | 开启/关闭经验条 | | `/yxp reset` | 恢复全部默认设置 | | `/yxp config` | 打开设置面板 | ### 交互操作 - **悬停**:显示详情面板(可在设置中关闭) - **左键点击**:固定/取消固定详情面板(可在设置中关闭) - **右键点击**:打开设置面板 - **拖拽**:在设置面板的颜色预览模式下可拖拽移动经验条位置 ### 设置面板 通过游戏菜单 → 界面设置 → YExperienceBar,或输入 `/yxp config` 打开。 **布局与尺寸** - 布局样式:圆环在左 / 圆环在右 / 圆环居中 / 纯进度条 - 等级圆环:17种样式可选 - 整体宽度(300~700)、进度条高度(4~64)、圆环直径(36~80) **经验填充** - 启用渐变、起始/结束颜色 **双倍经验填充** - 显示双倍经验区段、起始颜色 **任务经验填充** - 已完成任务预测段、起始颜色 **条上文字与等级** - 显示百分比、显示预计升级时间 - 等级字号(12~36)、进度条字号(9~22) **显示与交互** - 启用经验条、满级后隐藏、隐藏暴雪原生经验条 - 悬停显示详情、点击固定详情 **信息面板内容** - 10项详情数据可独立开关:当前经验、升级剩余、经验效率、双倍储备、已完成任务、未完成任务、交付预测、本级用时、本次时长、本次获得 **恢复默认值**:一键重置全部设置 ## 布局样式 | 样式 | 说明 | |---|---| | 圆环在左 | 等级圆环位于经验条左侧(默认) | | 圆环在右 | 等级圆环位于经验条右侧 | | 圆环居中 | 等级圆环位于经验条中央,进度条分为左右两段 | | 纯进度条 | 无圆环,仅显示进度条和百分比 | ## 圆环样式 | 键名 | 中文名 | 键名 | 中文名 | |---|---|---|---| | thin | 专业细金 | fineSilver | 极细银环 | | services | 服务雕金 | islandRing | 海岛金环 | | portrait | 头像银金 | challengeRing | 暗金细环 | | faceted | 切面厚金 | braid | 编织金环 | | medal | 玻璃徽章 | laurel | 金色藤环 | | stable | 明亮金环 | runic | 银金符文 | | journeys | 旅程厚环 | arcane | 奥术纹章 | | | | gear | 古铜齿环 | | | | cross | 十字金环 | | | | frost | 冰冠圆环 | ## 兼容性 - **正式服**(Mainline):Interface 120000~120105 - **怀旧服**(Forever/TBC/WLK/CTM/MoP Classic):Interface 16001, 38001 - **可选依赖**:LibSharedMedia-3.0(提供额外字体和材质) ## 从 YUI 迁移 本插件从 YUI 套件的 ExperienceBar 组件提取而来。如果你之前使用 YUI 的经验条: 1. 安装 YExperienceBar 后,YUI 中的 ExperienceBar 组件不再加载 2. YUI 的 SavedVariables 中保存的 ExperienceBar 配置不会自动迁移 3. 首次使用 YExperienceBar 会使用默认配置,请根据需要重新调整设置 ## 技术细节 - **会话持久化**:登出时将经验采样数据保存到 `YExperienceBarDB.experienceBarSession`,重新登录后恢复 - **速率估算**:需要至少30秒采样数据和实际经验获取量才会显示速率 - **任务扫描**:最多扫描200个任务条目,统计已完成和未完成任务的经验奖励 - **本级用时**:通过 `TIME_PLAYED_MSG` 事件获取,观察到升级后自动开始计时 - **连接处几何**:圆环与进度条交接处使用弦长算法确保平滑过渡 ## 版本 1.0.0 — 从 YUI 提取的独立版本