# wow-Krowi Libraries

**Repository Path**: chenbool/wow-krowi-libraries

## Basic Information

- **Project Name**: wow-Krowi Libraries
- **Description**: Krowi Libraries
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-26
- **Last Updated**: 2026-04-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Krowi 全能模板

基于 **Krowi Libraries** 的魔兽世界插件开发模板，集成 Ace3 核心功能。

## 项目结构

```
Krowi Libraries/
├── MyAddon.toc              # 插件入口文件
├── MyAddon.lua               # 主插件代码
├── readme.md                # 说明文档
└── Libs/
    └── Krowi_Util/          # Krowi 工具库
        ├── Libs/            # 依赖库 (LibStub, CallbackHandler, AceLocale)
        ├── Localization/     # 多语言支持 (enUS, zhCN, deDE, frFR, itIT, ruRU)
        ├── Options/         # 配置面板相关
        ├── Krowi_Util.xml   # 库入口
        └── ...
```

## 功能特性

| 功能 | 实现方式 |
|------|----------|
| 本地化 | Krowi_Util 内置 LocalizationHelper |
| 数据存储 | AceDB-3.0 |
| 配置面板 | AceConfig-3.0 + AceConfigDialog-3.0 |
| 聊天命令 | AceConsole-3.0 |
| 数据 Broker | Krowi_Brokers (可选) |
| 进度条 | Krowi_ProgressBar (可选) |

## 使用方法

### 1. 安装插件

将整个文件夹放入魔兽世界插件目录：
```
World of Warcraft/_retail_/Interface/AddOns/KrowiTemplate/
```

### 2. 命令

| 命令 | 说明 |
|------|------|
| `/MyAddon` | 打开设置面板 |
| `/MyAddon help` | 显示帮助信息 |

### 3. 配置选项

- **启用插件** - 开启/关闭插件功能
- **自动显示** - 登录时自动打开设置面板
- **显示 Broker** - 在小地图/信息条显示数据
- **欢迎消息** - 自定义欢迎提示文本

## 依赖库

本模板依赖以下库（已内置在 Libs 文件夹中）：

- **Krowi_Util** - Krowi 工具库（核心）
- **AceDB-3.0** - 数据存储
- **AceConfig-3.0** - 配置管理
- **AceConsole-3.0** - 命令行
- **LibStub** - 库加载
- **CallbackHandler** - 事件回调
- **AceLocale-3.0** - 本地化

### 可选库

如需 Broker 和进度条功能，需额外下载：
- [Krowi_Brokers](https://www.curseforge.com/wow/addons/krowi-brokers)
- [Krowi_ProgressBar](https://www.curseforge.com/wow/addons/krowi-progress-bar)

## 代码结构

```
MyAddon.lua
├── 初始化
│   ├── 获取 Krowi_Util 库
│   ├── 初始化本地化系统
│   └── 定义本地化字符串
├── 数据库 (AceDB-3.0)
│   ├── profile - 角色配置
│   └── global - 全局数据
├── 配置面板 (AceConfig-3.0)
│   ├── general - 通用设置
│   └── about - 关于信息
├── 聊天命令 (AceConsole-3.0)
├── 事件处理
│   └── PLAYER_LOGIN / PLAYER_LOGOUT
├── 数据 Broker (可选)
└── 进度条 (可选)
```

## 版本信息

- **插件版本**: 1.0.0
- **支持版本**: 魔兽世界正式服 (11.0.5+)
- **界面版本**: 110005

## 许可证

本模板基于 Krowi Libraries 开发，仅供学习交流使用。

---

如需扩展功能，请参考：
- [Krowi 官方文档](https://www.curseforge.com/wow/addons/krowi-util)
- [Ace3 文档](https://www.wowace.com/projects/ace3)