# mNotes - WoW Class Note Addon

## Overview

mNotes is a lightweight, minimalist, and highly practical in-game note addon for World of Warcraft, designed for players to record and manage class-specific guides, rotation tips, boss mechanics, macro commands, and more without leaving the game. It fully adapts to the latest World of Warcraft official server version, with a clean pixel-style UI and zero impact on game performance.

## Core Features

1. **Independent Per-Class Note System**

- Separate note archive for all 13 World of Warcraft classes, with independent data storage that will not be overwritten between different classes.

- Real-time automatic sync: when you switch your character or specialization, the addon will automatically load and display the note content corresponding to your current class.

2. **Customizable Floating Display Panel**

- A translucent floating panel that displays your current class's notes in real time, always visible during combat, questing, or dungeons.

- Full click-through support for the text area: the note display area will not block or intercept clicks on the underlying game interface or other addons.

- Adjustable panel position: you can drag the panel by right-clicking the "mNotes" button, and the position will be automatically saved permanently.

- One-click toggle: left-click the "mNotes" button to show/hide the note content at any time.

3. **Easy-to-Use Edit Panel**

- Dedicated edit window for each class, with a scrollable multi-line edit box, support for line breaks, spacing adjustment, and long text content.

- Real-time save: all note content is automatically saved to the local database in real time, and will not be lost after reloading the interface or logging out.

- Quick access: open the edit panel with the slash command `/mnt` at any time.

## User Experience Benefits

- **No more alt-tabbing out of the game**: You can save all your class guides, rotation tips, boss fight notes, and macro commands directly in the game, no need to switch to a browser or notepad while playing, which greatly improves the smoothness of the game and avoids missing key operations in combat.

- **No more wrong notes for different classes**: The independent per-class archive ensures that you will never open the wrong guide when switching characters or specializations. For example, your warrior tank notes and paladin healing notes are stored separately, and automatically switched when you change characters, which is very convenient for players with multiple characters.

- **Zero interference with your game interface**: The click-through text area and freely adjustable panel position allow you to place the note panel in any position on the screen, without blocking your action bars, unit frames, or other important game interfaces, while always keeping the key information you need in view.

- **Lightweight and stable**: The addon has no redundant functions, zero memory bloat, and will not affect the game's frame rate or cause lag, even during intense raid combat.

## Quick Start

1. Install the addon and enable it in the game, you will see the mNotes floating panel on the left side of the screen by default.

2. Type `/mnt` in the chat box and press Enter to open the edit panel.

3. Select your class in the left tab bar, enter your note content in the edit box, and the content will be saved automatically.

4. Left-click the "mNotes" button to show or hide the note content; right-click and hold the button to drag the panel to your preferred position.

## Compatibility

- Compatible with World of Warcraft Official Server 12.0.x

- Compatible with most mainstream addons, including ElvUI, WeakAuras, Details, DBM, etc.

---

## 中文说明

### 插件简介

mNotes 是一款轻量化、极简风格的魔兽世界游戏内笔记插件，专为玩家设计，无需切出游戏即可记录和管理各职业的攻略、手法循环、BOSS机制、宏命令等内容，完美适配魔兽世界最新正式服版本，拥有简洁的像素风UI，对游戏性能零影响。

### 核心功能

1. **全职业独立笔记系统**

- 为魔兽世界13个职业分别设置独立的笔记存档，不同职业的内容完全隔离，不会互相覆盖。

- 实时自动同步：切换角色或专精时，插件会自动加载并显示当前职业对应的笔记内容。

2. **可自定义悬浮展示面板**

- 半透明悬浮面板，实时展示当前职业的笔记，在战斗、任务、副本中始终可见。

- 文本区域完全点击穿透：笔记展示区域不会遮挡、拦截下层游戏界面或其他插件的点击操作。

- 面板位置可自由调整：右键按住「mNotes」按钮即可拖动面板，位置会自动永久保存。

- 一键显隐：左键点击「mNotes」按钮，可随时显示/隐藏笔记内容。

3. **易用的编辑面板**

- 每个职业都有专属的编辑窗口，支持滚动多行编辑框，支持换行、间距调整，可容纳长文本内容。

- 实时自动保存：所有笔记内容实时自动保存到本地数据库，重载界面、退出登录后都不会丢失。

- 快速访问：随时在聊天框输入斜杠命令 `/mnt` 即可打开编辑面板。

### 使用说明

1. 安装并在游戏内启用插件，默认会在屏幕左侧看到mNotes悬浮面板。

2. 在聊天框输入 `/mnt` 并回车，打开编辑面板。

3. 在左侧标签栏选择对应职业，在编辑框中输入笔记内容，内容会自动保存。

4. 左键点击「mNotes」按钮可显示/隐藏笔记内容；右键按住按钮可拖动面板到你习惯的位置。

### 兼容性

- 适配魔兽世界正式服 12.0.x 版本

- 兼容绝大多数主流插件，包括ElvUI、WeakAuras、Details、DBM等