> For the complete documentation index, see [llms.txt](https://risk-scripts.gitbook.io/risk-scripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://risk-scripts.gitbook.io/risk-scripts/scripts/spin-the-bottle/usage.md).

# Usage

* **Starting Spin the Bottle**
  * Ensure you have the required item (default: <mark style="color:red;">`"spinbottle"`</mark>) in your inventory.
  * Use the script’s command or item-based logic (depends on your setup) to place the bottle and start spinning.
* **Spinning the Bottle**
  * The bottle will spin in place, optionally showing a countdown or wait time if <mark style="color:red;">`RS.canMoveWhileSpinning`</mark> is <mark style="color:red;">`false`</mark>.
  * If another player attempts to spin it, the script checks <mark style="color:red;">`RS.OtherPlayersCanSpin`</mark>. Otherwise, they might see a cooldown message.
* **Announcing the Winner**
  * Once the bottle stops, if <mark style="color:red;">`RS.ShowWinnerName`</mark> is <mark style="color:red;">`true`</mark>, the name is announced (translated via your chosen language).
  * If <mark style="color:red;">`RS.ShowWinnerMarker`</mark> is <mark style="color:red;">`true`</mark>, a marker (with <mark style="color:red;">`RS.MarkerColor`</mark> and <mark style="color:red;">`RS.MarkerType)`</mark> is placed over the winner’s head for a short duration.
* **Notifications & Customization**
  * If <mark style="color:red;">`RS.UseCustomNotify`</mark> is <mark style="color:red;">`true`</mark>, your custom function is called (e.g., to trigger an external notify resource).
  * Otherwise, default GTA or ESX/QB notifications are used.