> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jar.rip/llms.txt
> Use this file to discover all available pages before exploring further.

# Ping-on-Join

> Ghost ping users in selected channels when they join your server.

## Introduction

jar can ghost ping (ping then delete) users in selected channels when they join your server. This can be useful for directing users to important channels.

## Setting up ping-on-join

To setup a ping-on-join, simply use the `pingonjoin setup` command.

<CodeGroup>
  ```ruby Syntax theme={null}
  pingonjoin setup
  ```

  ```ruby Example theme={null}
  ,,pingonjoin setup
  ```
</CodeGroup>

You should see a confirmation message after running the command.

<Frame caption="Ping-on-join setup confirmation">
  <img src="https://mintcdn.com/jarinc/A4GghNGPwdWr9LoP/images/server/poj/poj_setup.png?fit=max&auto=format&n=A4GghNGPwdWr9LoP&q=85&s=ab23131f821cc4aa51cd53aa9f3549fd" alt="Ping-on-join setup confirmation" width="612" height="254" data-path="images/server/poj/poj_setup.png" />
</Frame>

<Info>After the setup is complete, the first step is to **enable the ping-on-join system**.
This isn't enabled by default to prevent accidental pings.</Info>

## Toggling the ping-on-join system

To toggle the ping-on-join system, simply use the `pingonjoin toggle` command.
You should see a confirmation message after running the command.

<CodeGroup>
  ```ruby Syntax theme={null}
  pingonjoin toggle
  ```

  ```ruby Example theme={null}
  ,,pingonjoin toggle
  ```
</CodeGroup>

<Frame caption="Ping-on-join enabled confirmation">
  <img src="https://mintcdn.com/jarinc/A4GghNGPwdWr9LoP/images/server/poj/poj_toggle_on.png?fit=max&auto=format&n=A4GghNGPwdWr9LoP&q=85&s=6d0b87d42573d7578abd63a6017e0d1e" alt="Ping-on-join toggle confirmation" width="627" height="255" data-path="images/server/poj/poj_toggle_on.png" />
</Frame>

<Frame caption="Ping-on-join disabled confirmation">
  <img src="https://mintcdn.com/jarinc/A4GghNGPwdWr9LoP/images/server/poj/poj_toggle_off.png?fit=max&auto=format&n=A4GghNGPwdWr9LoP&q=85&s=630c20bb809f673cf647daec7fc66f4d" alt="Ping-on-join toggle confirmation" width="644" height="256" data-path="images/server/poj/poj_toggle_off.png" />
</Frame>

## Viewing the ping-on-join settings

To view the ping-on-join settings, simply use the `pingonjoin` command. This will show you all the channels you've set up to ping.

<CodeGroup>
  ```ruby Syntax theme={null}
  pingonjoin
  ```

  ```ruby Example theme={null}
  ,,pingonjoin
  ```
</CodeGroup>

<Frame caption="Ping-on-join settings">
  <img src="https://mintcdn.com/jarinc/A4GghNGPwdWr9LoP/images/server/poj/poj_list.png?fit=max&auto=format&n=A4GghNGPwdWr9LoP&q=85&s=50a52eb80484700816752161a2a78d32" alt="Ping-on-join settings" width="636" height="557" data-path="images/server/poj/poj_list.png" />
</Frame>

## Adding a channel to ping

To add a channel to ping, simply use the `pingonjoin add` command, followed by the channel you'd like to ping.

<CodeGroup>
  ```ruby Syntax theme={null}
  pingonjoin add <channel>
  ```

  ```ruby Example theme={null}
  ,,pingonjoin add #general
  ```
</CodeGroup>

You should see a confirmation message after running the command.

<Frame caption="Ping-on-join channel added confirmation">
  <img src="https://mintcdn.com/jarinc/A4GghNGPwdWr9LoP/images/server/poj/poj_add.png?fit=max&auto=format&n=A4GghNGPwdWr9LoP&q=85&s=a40aff7be93b968f1c8dff8682b8a953" alt="Ping-on-join channel added confirmation" width="720" height="256" data-path="images/server/poj/poj_add.png" />
</Frame>

## Testing the ping-on-join system

To test the ping-on-join system, simply use the `pingonjoin test` command.

This will ping you in all the channels you've set up, and delete its message after 5 seconds.
jar will react to your message once this process is complete.

<CodeGroup>
  ```ruby Syntax theme={null}
  pingonjoin test
  ```

  ```ruby Example theme={null}
  ,,pingonjoin test
  ```
</CodeGroup>

<Frame caption="Ping-on-join test message">
  <img src="https://mintcdn.com/jarinc/A4GghNGPwdWr9LoP/images/server/poj/poj_test_msg.png?fit=max&auto=format&n=A4GghNGPwdWr9LoP&q=85&s=f69c76dab02c1610bc93cc40a173acd4" alt="Ping-on-join test message" width="1199" height="76" data-path="images/server/poj/poj_test_msg.png" />
</Frame>

## Removing a channel to ping

To remove a channel to ping, simply use the `pingonjoin remove` command, followed by the channel you'd like to remove.

<CodeGroup>
  ```ruby Syntax theme={null}
  pingonjoin remove <channel>
  ```

  ```ruby Example theme={null}
  ,,pingonjoin remove #general
  ```
</CodeGroup>

You should see a confirmation message after running the command.

<Frame caption="Ping-on-join channel removed confirmation">
  <img src="https://mintcdn.com/jarinc/A4GghNGPwdWr9LoP/images/server/poj/poj_remove.png?fit=max&auto=format&n=A4GghNGPwdWr9LoP&q=85&s=05287057803c22e9d68d90b951372d34" alt="Ping-on-join channel removed confirmation" width="750" height="246" data-path="images/server/poj/poj_remove.png" />
</Frame>

## Resetting the ping-on-join system

To reset the ping-on-join system, simply use the `pingonjoin reset` command. This will remove all the channels you've set up to ping.

<CodeGroup>
  ```ruby Syntax theme={null}
  pingonjoin reset
  ```

  ```ruby Example theme={null}
  ,,pingonjoin reset
  ```
</CodeGroup>

<Frame caption="Ping-on-join reset confirmation">
  <img src="https://mintcdn.com/jarinc/A4GghNGPwdWr9LoP/images/server/poj/poj_reset.png?fit=max&auto=format&n=A4GghNGPwdWr9LoP&q=85&s=194ae5af089e1b2fee36fb19f8d1728b" alt="Ping-on-join reset confirmation" width="752" height="247" data-path="images/server/poj/poj_reset.png" />
</Frame>
