All Characters

# CurseForge release guide (AllReps project)

This addon is published on the existing **AllReps** CurseForge project as the successor to **All Reps**.

The install folder name is **`AllChars`** (not `AllReps`).

**Current version:** matches `## Version` in `AllChars.toc` (see [CHANGELOG.md](CHANGELOG.md)).

---

## Before you upload

1. **Project page (not only the ZIP)**

   - Display name: **All Characters** (subtitle: *formerly All Reps* / *AllReps 후속*)

   - Short description: multi-character **지역평판 · 전문기술 · 무기숙련** in one window

   - Long description: mention AllReps → AllChars rename, `AllRepsDB` → `AllCharsDB` migration, new features in 4.0.0

   - **Logo:** upload `Art/AllChars-CurseForge-400.png` (400×400 PNG)

   - Game versions: match `## Interface` in `AllChars.toc`

2. **Release notes** (paste from CHANGELOG **4.0.0**, include AllReps migration block and the **auto-update** note below)

3. **ZIP layout** (required)

```text

AllChars.zip

└── AllChars/

    ├── AllChars.toc

    ├── AllChars.lua

    ├── … (all .lua files listed in the .toc)

    ├── README.md

    └── CHANGELOG.md

```

**Do not include:** `tools/` (if present), `__pycache__/`, `*.pyc`, `Art/` (logo is for the website only), `CURSEFORGE.md`, or any **developer-only** `*.py` scripts, for example:

| File | Purpose (local dev only) |

|------|---------------------------|

| `build_recipe_db.py` | Regenerate `AllCharsRecipeDB_Data.lua` from external recipe data |

| `repair_all_korean.py` | Batch-fix Korean strings in Lua sources |

| `fix_korean.py` | Restore corrupted Korean text in `AllChars.lua` |

| `count_recipes.py` | Count / inspect recipe DB entries |

| `_fix_turnin_ko.py` | Fix Korean for dungeon / turn-in strings |

| `_fix_prof_notice_ko.py` | Fix Korean for profession notice strings |

| `_fix_remain.py` | Misc remaining Korean string fixes |

WoW does not run Python; none of these belong in the release ZIP. Include only `.toc`, `.lua` (as listed in the `.toc`), `README.md`, and `CHANGELOG.md`.

---

## AllReps → All Characters (user migration)

| Item | Old (AllReps) | New (AllChars) |

|------|----------------|----------------|

| Folder | `Interface\AddOns\AllReps` | `Interface\AddOns\AllChars` |

| SavedVariables | `AllRepsDB` | `AllCharsDB` (auto-migrated on first load) |

| Slash | (varies) | `/allchars`, `/ac`, `/allcharacters` |

| Legacy addon | — | If `AllReps` is still installed, AllChars disables it and prints a chat notice |

**After updating:** users may delete the old `AllReps` folder and `/reload`.

---

## Auto-update for existing AllReps users

Uploading to the **same AllReps CurseForge project** (not a new project) keeps existing subscribers on the update channel.

| What works automatically | What users may need to do once |

|--------------------------|--------------------------------|

| CurseForge App / CF-linked clients show an **update** for subscribed users | Delete the old `Interface\AddOns\AllReps` folder after updating (CF may leave it behind) |

| New files install to **`Interface\AddOns\AllChars`** | `/reload` after the first update (legacy disable message) |

| **`AllRepsDB` → `AllCharsDB`** on first load | — |

| Legacy **AllReps** addon disabled at account level if still present | — |

**Does not auto-update:** manual installs (no CurseForge App), or clients that do not track this CF project. Match **game version tags** on the release to your `## Interface` line so Anniversary / Classic clients receive the file.

**Suggested release-note line (EN):**

> Installs to the **AllChars** folder (renamed from AllReps). Your saved data migrates automatically. You may delete the old **AllReps** folder after updating and `/reload`.

**Suggested release-note line (KO):**

> 설치 폴더가 **AllChars**로 바뀌었습니다 (구 AllReps). 저장 데이터는 자동 이전됩니다. 업데이트 후 **AllReps** 폴더를 삭제하고 `/reload` 하세요.

---

## Artwork

| File | Use |

|------|-----|

| `Art/AllChars-CurseForge-400.png` | CurseForge project icon (400×400) |

| `Art/AllChars-CurseForge-400.svg` | Editable source for the logo |

In-game minimap / addon list icon: `Interface\Icons\INV_Misc_Book_11` (`## IconTexture` in the TOC).

---

## 한국어 요약

- **같은 AllReps CurseForge 프로젝트**에 새 ZIP을 올리면 됩니다. (새 프로젝트를 만들면 기존 구독자 자동 업데이트가 끊깁니다.)

- **프로젝트 설명·로고·릴리스 노트**도 함께 갱신하세요. ZIP만 올리면 부족합니다.

- ZIP 안 최상위 폴더명은 반드시 **`AllChars`**. `tools/`, `__pycache__/`, `*.py` 등 개발용 파일은 넣지 않습니다.

### 기존 AllReps 사용자 · 자동 업데이트

| 자동으로 되는 것 | 사용자가 한 번 할 일 |

|------------------|----------------------|

| CurseForge 앱 등 **같은 프로젝트 구독자**에게 업데이트 알림 | 업데이트 후 남은 **`AllReps` 폴더 삭제** (클라이언트가 안 지울 수 있음) |

| **`AddOns\AllChars`** 에 새 버전 설치 | 첫 업데이트 후 **`/reload`** |

| **`AllRepsDB` → `AllCharsDB`** 자동 이전 | — |

| 구 **AllReps** 애드온 계정 비활성화 | — |

**자동 업데이트 안 됨:** CurseForge 앱 없이 수동 설치한 경우, 또는 릴리스 **게임 버전 태그**가 사용자 클라이언트와 맞지 않는 경우.

**릴리스 노트에 넣을 문장:**  

「설치 폴더가 **AllChars**로 바뀌었습니다. 저장 데이터는 자동 이전됩니다. 업데이트 후 **AllReps** 폴더를 삭제하고 `/reload` 하세요.」