PleaseHelp

PleaseHelp is a compact PvP callout addon for World of Warcraft Retail. With one click, you can report incoming enemies, mark an objective clear, ask your team to check enemy stealth classes, or send dedicated cart-defense callouts in Deephaul Ravine.

### Fast battleground callouts

- Compact horizontal bar styled after Blizzard's default UI
- `Enemy 1` / `Enemy 2` / `Enemy 3` / `CLEAR` / `Check Stealth`
- Compact location names on the bar and full names in chat
- Automatic Raid Warning (`/rw`) or Instance Chat (`/i`) selection based on permission
- Korean and English interface and chat messages
- Stale location, channel, and language macros are blocked during combat transitions
- Saved position, scale, movement lock, region policy, and feature settings

Standard objective callouts include the detected location.

```text
[Farm] 2 enemies attacking! Please help!
[Farm] Clear! Base is secure.
```

Check Stealth is a team-wide strategy request and never includes an objective prefix.

```text
[Stealth Check] Please check the enemy team's stealth classes!
```

All five buttons are available at a recognized objective in a supported objective battleground. In non-objective battlegrounds such as Warsong Gulch and Twin Peaks, Enemy 1/2/3 and CLEAR remain disabled while Check Stealth stays available. Real chat transmission is blocked outside battlegrounds, in preview mode, and when instance-group status cannot be confirmed.

### Deephaul Ravine Cart Defense mode

Starting with v0.10.7, Deephaul Ravine has a dedicated **Cart Defense mode**.

- Status label: `Cart Defense`
- Enemy 1/2/3, CLEAR, and Check Stealth are available
- Cart callouts use the fixed `[Defending Our Cart]` context instead of a subzone name
- Instance-ID detection prevents shared subzone names such as Waterworks from being mistaken for objectives in another battleground

```text
[Defending Our Cart] 1 enemy attacking! Please help!
[Defending Our Cart] 2 enemies attacking! Please help!
[Defending Our Cart] 3 enemies attacking! Please help!
[Defending Our Cart] Clear! Our cart is safe.
```

The addon does not automatically detect cart proximity or incoming enemies. Press the appropriate button manually while escorting or defending your team's cart. Check Stealth remains independent and does not receive a cart or objective prefix.

### Chat channel and language

- Raid leader or assistant: Raid Warning `/rw`
- Members without Raid Warning permission: Instance Chat `/i`
- KR policy: Korean messages
- US policy: English messages
- AUTO policy: language selected by the existing region detection

Korean and North American policies use the same permission rules.

### Callout spam protection

All five buttons share one callout limiter.

- Five consecutive valid callouts trigger a 5-second HOLD
- The counter resets after 3 seconds without a valid callout
- An active HOLD always lasts the full 5 seconds
- Preview actions, blocked clicks, dragging, settings, and closing the Bloodlust reminder do not count

The count represents valid prepared-macro click executions; it does not confirm server chat delivery.

### Bloodlust reminder for Battleground Blitz

During the Battleground Blitz preparation phase, PleaseHelp can show one central reminder per match when your character can provide a raid-wide Bloodlust-family effect.

- Concise three-line reminder containing the current battleground name
- Native Bloodlust icon and Blizzard-style frame
- Centered layout that adapts to resolution, global UI scale, language, and long battleground names
- Remains visible for up to 60 seconds from the moment it appears
- Hides immediately when the match begins
- Blizzard-style X button for immediate dismissal
- Click-through body; only the X receives mouse input
- Does not reappear in the same match after dismissal, expiry, `/reload`, or reconnecting
- Does not cast abilities, send chat, play sounds, or issue live combat instructions

Provider checks include Bloodlust, Heroism, Time Warp, Fury of the Aspects, Harrier's Cry, and Primal Rage with a valid living pet. Shamanism is not treated as a normal raid-wide Bloodlust provider.

### Automatic assistant promotion

When enabled and you are the instance raid leader, PleaseHelp requests assistant promotion for eligible battleground raid members while out of combat. This option defaults to ON for both Korean and North American policies. Disabling it does not demote existing assistants.

### Default settings

- Test Mode: OFF
- UI Movement: Locked
- Battleground Auto-Assistant: ON
- Bloodlust Reminder: ON
- Chat Region: AUTO

Existing position, scale, lock state, and feature settings are preserved when updating. You do not need to delete SavedVariables.

### Commands

- `/ph` — open settings
- `/ph test` — toggle the out-of-battleground callout preview; preview never sends chat
- `/ph test cart` — preview the Cart Defense label and message examples; never sends chat
- `/ph show` / `/ph hide` — show or hide the callout bar
- `/ph lock` / `/ph unlock` — lock or unlock movement
- `/ph reset` — restore the callout bar to the center
- `/ph region auto|kr|us` — select the chat-language and region policy
- `/ph version` — display the installed version
- `/ph selftest` — run built-in checks
- `/ph debug` — display battleground mode, channel, and secure-macro state

### Installation

1. Exit World of Warcraft completely.
2. Back up or remove the existing `Interface/AddOns/PleaseHelp` folder.
3. Extract the complete `PleaseHelp` folder from the ZIP into `Interface/AddOns`.
4. Log in and confirm that `/ph version` reports `0.10.7`.

Install the complete `PleaseHelp` folder from the ZIP. v0.10.7 contains eight files, including both Retail TOC files and `BloodlustReminder.lua`.

------

# PleaseHelp

## 한국어

PleaseHelp는 월드 오브 워크래프트 본 서버 전장에서 아군 지원을 빠르게 요청할 수 있는 컴팩트 PvP 애드온입니다. 버튼 한 번으로 현재 거점의 적 인원, 정리 완료, 상대 은신 클래스 확인을 알릴 수 있으며, 깊은광혈 협곡에서는 전용 수레 수비 메시지를 제공합니다.

### 빠른 전장 신고

- Blizzard 기본 UI 스타일의 가로형 신고 바
- `적 1명` / `적 2명` / `적 3명` / `CLEAR` / `은신 체크 요청`
- UI에는 읽기 쉬운 축약 위치명, 채팅에는 정식 위치명 출력
- 현재 권한에 따라 공격대 경보(`/rw`) 또는 인스턴스 채팅(`/i`) 자동 선택
- 한국어와 영어 UI 및 채팅 메시지 지원
- 전투 중 오래된 위치·채널·언어 매크로 실행 차단
- UI 위치, 배율, 이동 잠금, 지역 정책 및 기능 설정 저장

일반 거점 전장에서는 현재 위치를 포함해 신고합니다.

```text
[농장] 적 2명 공격 중! 제발 도와주세요!
[농장] 정리 완료! 거점 안전합니다.
```

`은신 체크 요청`은 거점과 무관한 전략 메시지이므로 위치명을 붙이지 않습니다.

```text
[은신 체크 요청] 상대 은신 클래스 체크 부탁드립니다!
```

지원되는 거점 전장에서는 위치가 확인된 경우 다섯 버튼을 모두 사용할 수 있습니다. 전쟁노래 협곡·쌍둥이 봉우리처럼 거점 수비형이 아닌 전장에서는 적 인원/CLEAR 버튼을 비활성화하고 `은신 체크 요청`만 제공합니다. 전장 밖, 미리보기, 인스턴스 그룹 미확인 상태에서는 실제 메시지를 전송하지 않습니다.

### 깊은광혈 협곡 수레 수비 모드

v0.10.7부터 깊은광혈 협곡을 전용 **수레 수비 모드**로 지원합니다.

- 위치 표시: `수레 수비`
- 적 1명/2명/3명, CLEAR, 은신 체크 요청 모두 사용 가능
- 일반 거점 이름 대신 고정된 `[우리 수레 수비]` 문맥 사용
- 깊은광혈 협곡의 전장 ID를 확인하므로 `수력작업장`처럼 다른 전장과 겹치는 지역명을 거점으로 오인하지 않음

```text
[우리 수레 수비] 적 1명 공격 중! 제발 도와주세요!
[우리 수레 수비] 적 2명 공격 중! 제발 도와주세요!
[우리 수레 수비] 적 3명 공격 중! 제발 도와주세요!
[우리 수레 수비] 정리 완료! 수레 안전합니다.
```

수레나 적의 접근을 자동으로 감지하지 않습니다. 아군 수레를 호위하거나 방어하는 상황에서 사용자가 버튼을 직접 눌러 신고합니다. 은신 체크 메시지에는 수레명이나 거점명을 추가하지 않습니다.

### 채팅 채널과 언어

- 공격대장 또는 지원공격대장: 공격대 경보 `/rw`
- 공격대 경보 권한이 없는 구성원: 인스턴스 채팅 `/i`
- KR 정책: 한국어 메시지
- US 정책: 영어 메시지
- AUTO 정책: 기존 지역 판정에 따라 언어 선택

한국과 북미 정책 모두 같은 권한 규칙을 사용합니다.

### 연속 호출 방지

다섯 신고 버튼은 하나의 공통 호출 제한을 공유합니다.

- 유효한 신고를 연속 5회 사용하면 5초 HOLD
- 마지막 유효 신고 후 3초 동안 사용하지 않으면 누적 횟수 초기화
- 이미 시작된 HOLD는 5초간 유지
- 미리보기, 차단된 클릭, UI 이동, 설정 조작 및 Bloodlust 팝업 닫기는 횟수에서 제외

호출 횟수는 준비된 보안 매크로의 실제 클릭 실행을 기준으로 하며 서버가 메시지를 수신했는지를 직접 확인하는 값은 아닙니다.

### 대공세 Bloodlust 준비 안내

Battleground Blitz 준비 단계에서 플레이어가 공대 전체 Bloodlust 계열 효과를 제공할 수 있으면 경기당 한 번 중앙 안내창을 표시합니다.

- 현재 전장 이름을 포함한 간결한 세 문장 안내
- 게임 기본 Bloodlust 아이콘과 Blizzard 스타일 프레임
- 해상도, 전체 UI 배율, 언어 및 긴 전장명에 맞춘 중앙 배치
- 실제 표시 시점부터 최대 60초 유지
- 경기 시작 시 즉시 숨김
- Blizzard 스타일 X 버튼으로 직접 닫기
- 본문 클릭 통과, X 영역만 마우스 입력 사용
- 닫기·시간 만료·`/reload`·같은 경기 재접속 이후 재표시하지 않음
- 주문 자동 시전, 채팅 전송, 소리 및 실시간 전투 지시 없음

피의 욕망, 영웅심, 시간 왜곡, 위상의 격노, 해리어의 외침과 유효한 생존 펫이 있을 때의 원초적 분노를 확인합니다. 주술주의는 일반적인 공대 전체 Bloodlust 제공 상태로 취급하지 않습니다.

### 전장 자동 부공격대장 승급

기능이 켜져 있고 자신이 인스턴스 공격대장이라면 비전투 중 전장 구성원의 지원공격대장 승급을 요청합니다. 한국과 북미 모두 기본값은 ON입니다. 기능을 꺼도 이미 승급된 구성원을 강등하지 않습니다.

### 기본 설정

- 테스트 모드: OFF
- UI 이동: 잠김
- 전장 자동 부공 승급: ON
- Bloodlust 준비 안내: ON
- 채팅 지역 정책: AUTO

업데이트 시 기존 위치, 배율, 잠금 및 기능 설정을 유지합니다. SavedVariables를 삭제할 필요가 없습니다.

### 명령어

- `/ph` — 설정창 열기
- `/ph test` — 전장 밖 신고 바 미리보기 전환; 실제 메시지는 전송하지 않음
- `/ph test cart` — 수레 수비 표시와 메시지 예문 미리보기; 실제 메시지는 전송하지 않음
- `/ph show` / `/ph hide` — 신고 바 표시 또는 숨기기
- `/ph lock` / `/ph unlock` — UI 이동 잠금 또는 해제
- `/ph reset` — 신고 바를 화면 중앙으로 복원
- `/ph region auto|kr|us` — 채팅 언어·지역 정책 선택
- `/ph version` — 설치 버전 확인
- `/ph selftest` — 기본 자체 검사 실행
- `/ph debug` — 전장 모드, 채널 및 보안 매크로 상태 출력

### 설치 방법

1. 월드 오브 워크래프트를 완전히 종료합니다.
2. 기존 `Interface/AddOns/PleaseHelp` 폴더를 백업하거나 제거합니다.
3. ZIP 안의 `PleaseHelp` 폴더 전체를 `Interface/AddOns`에 압축 해제합니다.
4. 게임에 접속해 `/ph version`이 `0.10.7`로 표시되는지 확인합니다.

ZIP 안의 `PleaseHelp` 폴더 전체를 설치해야 합니다. v0.10.7은 두 개의 Retail TOC와 `BloodlustReminder.lua`를 포함해 총 8개 파일로 구성됩니다.