PleaseHelp

# PleaseHelp v0.10.8

## 한국어 — v0.10.7 대비 변경 내역

### 자동 부공 승급 안정화

- 자동 승급을 전장 입장 초기 최대 20초로 제한했습니다.
- 준비 단계에서 입장 후 최소 2초 뒤 첫 요청을 시도하며, 필요한 경우 최소 10초 뒤 한 번만 재시도합니다.
- 매초 전체 명단을 확인하던 방식을 최대 두 차례의 명단 확인으로 변경했습니다. 개별 승급 방식에서는 요청 직전에 해당 대상의 상태를 추가 확인합니다.
- 일괄 부공 승급 API가 있으면 이를 우선 사용합니다. 해당 API가 없는 환경에서만 개별 승급으로 처리합니다.
- 개별 승급도 대상별 최대 두 번, 재시도 간 최소 10초, 전체 최대 20초 제한을 따릅니다.
- 경기 시작, 전투 진입, 공격대장 권한 상실 또는 승급 API 오류 시 해당 경기의 자동 승급을 중단합니다.
- 같은 경기에서 설정을 껐다 켜거나 `/reload`·재접속해도 승급 요청이 다시 시작되지 않도록 캐릭터별 기록을 추가했습니다.
- `/ph debug`에 승급 방식·명단 확인 회차·요청 횟수 등 진단 정보를 추가했습니다.

### 기존 기능 및 설정 유지

거점 신고, 은신 체크 요청, 깊은광혈 협곡 수레 수비, 권한별 `/rw`·`/i`, 공통 HOLD와 3초 초기화, Bloodlust 준비 안내, UI 위치·배율과 기존 설정을 유지합니다. 자동 부공 승급 기본값도 ON을 유지합니다.

### 참고

승급은 준비 상태와 권한이 확인될 때만 시도합니다. 종료 후 늦게 입장한 플레이어를 위해 추가 시도하지 않으며, 새 경기 여부가 불명확하면 재요청을 생략합니다. 반복 시스템 메시지와 자동 승급의 인과관계는 아직 확정되지 않았습니다. 채팅 메시지를 숨기는 필터는 추가하지 않았습니다.

Lua 5.1 모의 검사 721개 통과. 모의 검사는 실제 WoW의 보호 동작·서버 응답·채팅 수신을 보장하지 않습니다.

## English — Changes from v0.10.7

### Automatic assistant promotion improvements

- Limited automatic promotion to the first 20 seconds after battleground entry.
- The first request is attempted no earlier than 2 seconds after entry during preparation, with at most one retry at least 10 seconds later if needed.
- Replaced continuous full-roster polling with at most two roster passes. Individual fallback requests also recheck the target immediately before promotion.
- Prefer the everyone-is-assistant API when available. Individual promotion is used only when that API is unavailable.
- Individual promotion is limited to two requests per player, at least 10 seconds apart, within the same overall 20-second window.
- Stop promotion for the current match when the match starts, combat begins, leadership is lost, or a promotion API error occurs.
- Added per-character session history to prevent attempts from restarting after toggling the setting, reloading, or reconnecting within the same match.
- Added promotion method, roster pass count, and request count to `/ph debug`.

### Existing features and settings preserved

Objective callouts, Stealth Check, Deephaul Ravine cart defense, permission-based `/rw` and `/i`, shared HOLD and 3-second idle reset, the Bloodlust preparation reminder, UI position/scale, and existing settings are preserved. Automatic assistant promotion remains enabled by default.

### Notes

Promotion requires confirmed preparation state and authority. No additional attempts are made for players joining after processing ends. Ambiguous new-match detection fails closed. The reported repeated system messages have not been conclusively attributed to automatic promotion. No chat-message suppression filter has been added.

Passed 721 Lua 5.1 simulated checks. Simulation does not guarantee live WoW protected behavior, server responses, or chat delivery.