> For the complete documentation index, see [llms.txt](https://obey.gitbook.io/wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://obey.gitbook.io/wiki/coinflips/features/quality-of-life.md).

# Quality of Life

CrownCoinFlips includes several Quality of Life (QoL) features designed to ensure a smooth, secure, and user-friendly experience for both server administrators and players.

***

## 1. Smart Number Parsing

When entering wager amounts (in chat or via the virtual SignGUI), players don't need to type out long series of zeroes. The plugin supports smart number format suffixes:

| Input Example   | Interpreted Value |
| --------------- | ----------------- |
| `10k` / `10K`   | `10,000`          |
| `1.5m` / `1.5M` | `1,500,000`       |
| `2.5b` / `2.5B` | `2,500,000,000`   |

***

## 2. Automatic Refunds & Safety

* **Server Shutdown / Reload Protection**: If the server stops or reloads while a coinflip is waiting for an opponent, the plugin automatically cancels open games and refunds the exact wager back to the creator.
* **Manual Game Cancellation**: Players can close their own unjoined coinflips at any time by clicking their game head in the GUI, which instantly refunds their money.

***

## 3. Real-Time Game Spectating

Players are not limited to just playing—they can also watch the action unfold!

* Clicking on any active game marked as **Running** opens the live spinning screen.
* Spectators can watch the head-spinning animation in real-time alongside the two participants.

***

## 4. Disconnect & GUI Close Resolution

* **Closing GUI Mid-Spin**: If a player closes their inventory during a spin, the game continues safely in the background. The outcome is determined fairly, and winnings are automatically awarded to the winner's account.
* **Player Offline Handling**: If both players close the GUI or go offline mid-spin, the plugin safely force-resolves the coinflip outcome in the background, ensuring no money or game states get lost or stuck.

***

## 5. Permission-Based Tax Discounts

Server administrators can reward specific player ranks (e.g., VIP, MVP) with discounted house tax rates.

* Permission tax rates are configured in `config.yml`.
* If a player holds multiple tax permission nodes, the lowest tax rate is automatically selected.

***

## 6. Per-Player Broadcast Toggling

Players who prefer not to see global coinflip notifications can toggle broadcasts for themselves.

* Broadcast preferences are saved per player and persist across server restarts.