FRF_CoinFlow

# FRF CoinFlow

**Make every coin feel rewarding.**

FRF CoinFlow adds a little magic to earning money in World of Warcraft. When your character gains gold, silver, or copper, glowing coins sweep toward your bag along curved paths, with soft trails and coin sounds on arrival.

## Features

- **Animated coin collection:** Coins fly toward your bag with a soul-absorption-inspired effect.
- **Glowing trails:** Add a magical touch, or switch the trails off for a simpler look.
- **Coin sounds:** Hear a coin jingle as coins arrive. Sound can be disabled independently.
- **Money gained display:** Show the amount earned alongside the effect.
- **Custom positions:** Drag the starting point and destination wherever you prefer.
- **Default bag tracking:** Automatically use the default backpack button when it is visible.
- **Adjustable effects:** Change the maximum coin count, flight time, coin size, spread, curvature, and opacity.
- **Minimum gain filter:** Choose the smallest money gain that triggers an effect.
- **Combat visibility:** Choose whether effects appear during combat.
- **Built-in preview:** Test your settings without earning or spending money.
- **No dependencies:** Works as a standalone addon.

## Getting started

1. Install and enable **FRF CoinFlow**.
2. Type `/coinflow` to open the settings.
3. Click **Test effect**, or type `/coinflow test`.
4. For a custom bag layout, use `/coinflow move`, drag the gold destination marker onto your bag icon, then lock the positions.

Dragging the destination marker disables automatic bag tracking. If the default backpack button is hidden, automatic mode uses your saved destination instead.

## Commands

| Command | Action |
| --- | --- |
| `/coinflow` or `/fcf` | Open settings |
| `/coinflow test` | Preview the effect |
| `/coinflow move` | Move the starting point and destination |
| `/coinflow lock` | Hide and lock the position markers |

Settings are also available through **Options → AddOns → FRF CoinFlow**.

## What triggers the effect?

CoinFlow detects increases in your character's money balance. This includes loot, quest rewards, vendor sales, mail, trades, and withdrawals when they increase the money you carry. It does not distinguish between those sources or track other currencies.

Rapid gains are combined into short bursts. Coin count scales with the amount, up to your configured maximum. It is a visual effect, not a literal representation of every coin earned.

## Language and compatibility

- **Korean clients:** Korean interface.
- **All other clients:** English interface.
- Designed for **Retail WoW, Interface 120100**.
- For custom bag addons, set the destination manually. Direct integration with their internal frames is not required.
- Settings are shared across characters on the same account.

*The example GIF is an illustrative animation, not in-game footage. GIFs do not contain sound. Appearance may differ in-game.*

# FRF CoinFlow

**돈을 획득하는 순간에 작은 재미를 더해 보세요.**

FRF CoinFlow는 월드 오브 워크래프트에서 골드·실버·코퍼를 획득할 때, 반짝이는 동전이 곡선을 그리며 가방으로 날아가는 효과를 추가합니다. 소울을 흡수하듯 빛 잔상이 따라붙고, 동전이 도착하면 짤랑 소리가 납니다.

## 주요 기능

- **동전 흡수 효과:** 동전들이 가방을 향해 곡선을 그리며 날아갑니다.
- **빛 잔상:** 마법 같은 잔상을 켜거나 간결하게 끌 수 있습니다.
- **짤랑 소리:** 동전 도착 시 소리가 재생되며, 소리만 따로 끌 수도 있습니다.
- **획득 금액 표시:** 효과와 함께 획득한 금액을 표시합니다.
- **자유로운 위치 지정:** 동전 출발 위치와 도착 위치를 드래그해서 옮깁니다.
- **기본 가방 자동 추적:** 기본 가방 버튼이 보이면 해당 위치로 동전이 날아갑니다.
- **효과 세부 설정:** 최대 동전 수, 비행 시간, 크기, 퍼짐, 경로 휘어짐, 불투명도를 조절합니다.
- **최소 금액 설정:** 지정한 금액 이상을 획득했을 때만 효과를 표시합니다.
- **전투 중 표시 설정:** 전투 중 효과 사용 여부를 선택합니다.
- **효과 미리보기:** 실제 돈을 획득하거나 소비하지 않고 설정을 테스트합니다.
- **독립 실행:** 다른 애드온이나 라이브러리를 설치할 필요가 없습니다.

## 시작하기

1. **FRF CoinFlow**를 설치하고 활성화합니다.
2. `/coinflow`를 입력해 설정창을 엽니다.
3. **효과 테스트** 버튼을 누르거나 `/coinflow test`를 입력합니다.
4. 커스텀 가방을 사용한다면 `/coinflow move`를 입력하고 금색 도착 표시를 가방 아이콘 위로 옮긴 뒤 위치를 잠급니다.

도착 표시를 직접 옮기면 자동 추적이 꺼집니다. 자동 추적 상태에서 기본 가방 버튼이 보이지 않으면 저장된 도착 위치를 사용합니다.

## 명령어

| 명령어 | 기능 |
| --- | --- |
| `/coinflow` 또는 `/fcf` | 설정창 열기 |
| `/coinflow test` | 효과 미리보기 |
| `/coinflow move` | 출발·도착 위치 이동 |
| `/coinflow lock` | 위치 표시 숨기기 및 잠금 |

게임 **설정 → 애드온 → FRF CoinFlow**에서도 설정창을 열 수 있습니다.

## 언제 효과가 나오나요?

캐릭터가 소지한 돈이 증가하면 반응합니다. 전리품, 퀘스트 보상, 상점 판매, 우편, 거래, 은행 인출 등도 소지금이 늘면 효과가 나옵니다. 획득 원인을 구분하지 않으며 골드·실버·코퍼 이외의 화폐는 추적하지 않습니다.

빠르게 연속으로 획득한 금액은 짧게 묶어서 표시합니다. 획득 금액에 따라 동전 수가 늘어나되, 설정한 최대 개수를 넘지 않습니다. 표시되는 동전 수는 실제 획득 동전 개수와 일치하지 않습니다.

## 언어 및 호환성

- **한국어 클라이언트:** 한국어로 표시합니다.
- **그 외 모든 클라이언트:** 영어로 표시합니다.
- **리테일 WoW, Interface 120100**을 대상으로 제작했습니다.
- 커스텀 가방 애드온은 도착 위치를 직접 지정해서 사용할 수 있습니다.
- 설정은 같은 계정의 캐릭터들이 공유합니다.

*예시 GIF는 실제 게임 녹화가 아닌 동작 설명용 애니메이션입니다. GIF에는 소리가 포함되지 않으며, 실제 게임 화면과 차이가 있을 수 있습니다.*