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

# Counting

> Members count up together in one channel, one number at a time.

## <Icon icon="arrow-up-1-9" size={24} /> Set up counting

<Steps>
  <Step title="Pick the channel">
    Run it in the channel, or name one. Counting turns on straight away.

    <CodeGroup>
      ```plaintext Syntax theme={null}
      /count setup channel [channel]
      ```

      ```plaintext Example theme={null}
      /count setup channel channel:#counting
      ```
    </CodeGroup>
  </Step>

  <Step title="Choose the rules">
    Reactions, resets and chat are on to start with. Change them with the commands below, or on the dashboard's **Counting** tab.
  </Step>
</Steps>

Members type 1, then 2, then 3, and so on. A sum counts too: if the next number is 88, `44+44` works. So does a number followed by words, like `57 nice`.

Newt needs **View Channel**, **Send Messages**, **Embed Links**, **Add Reactions**, **Read Message History** and **Manage Messages** in the channel.

## <Icon icon="sliders" size={24} /> Rules

<AccordionGroup>
  <Accordion title="Turn counting on or off" icon="power-off">
    ```plaintext theme={null}
    /count setup enable
    /count setup disable
    ```

    Turning it off keeps the count and everyone's stats.
  </Accordion>

  <Accordion title="Reset after a mistake" icon="arrow-rotate-left">
    ```plaintext theme={null}
    /count setup reset <on>
    ```

    On to start with: a wrong number resets the count to 1. The mistake and Newt's message stay, so everyone sees who ruined it.

    With `on:False` the count carries on. The wrong number is deleted, and Newt posts the next number. That message goes as soon as somebody gets it right.
  </Accordion>

  <Accordion title="Reactions" icon="face-smile">
    ```plaintext theme={null}
    /count setup reactions <on>
    ```

    On to start with. `on:False` stops every reaction, right or wrong.
  </Accordion>

  <Accordion title="Chat in the channel" icon="comments">
    ```plaintext theme={null}
    /count setup chat <on>
    ```

    On to start with, so people can talk between numbers. With `on:False`, anything that isn't a count is deleted.
  </Accordion>

  <Accordion title="Twice in a row" icon="user-group">
    ```plaintext theme={null}
    /count setup twice <on>
    ```

    Off to start with, so counting twice in a row is a mistake. `on:True` allows it.
  </Accordion>

  <Accordion title="A role for a wrong number" icon="user-tag">
    ```plaintext theme={null}
    /count setup role [role] [removeafter]
    ```

    Whoever gets it wrong gets the role. With `removeafter`, it comes off again after that long, from 1 minute to 30 days. Leave out `role` to stop giving one.

    Example: `/count setup role role:@Math Noob removeafter:2m`

    <Warning>
      Newt needs **Manage Roles**, and its own role has to be above the one it gives.
    </Warning>
  </Accordion>
</AccordionGroup>

## <Icon icon="face-smile" size={24} /> What the reactions mean

| Reaction | Meaning |
| - | - |
| ✅ | The right number |
| ☑️ | The right number, and a new server best |
| 💯 | Every hundredth number |
| ❌ | A mistake that reset the count |

## <Icon icon="gear" size={24} /> Other commands

<AccordionGroup>
  <Accordion title="Set the count" icon="hashtag">
    ```plaintext theme={null}
    /count setcount <number>
    ```

    The count is at that number, so the next one is one more. `number:0` starts over. Newt posts the change in the channel.
  </Accordion>

  <Accordion title="See the stats" icon="chart-simple">
    ```plaintext theme={null}
    /count stats [member]
    ```

    The server's count, best and rules. Name a member to see their counts, mistakes, accuracy and rank.
  </Accordion>

  <Accordion title="See the leaderboard" icon="ranking-star">
    ```plaintext theme={null}
    /count leaderboard
    ```

    The top 10 counters, the next number and the server best.
  </Accordion>
</AccordionGroup>

## <Icon icon="circle-info" size={24} /> Good to know

* Newt remembers the last 50 numbers. If someone edits one to another number, or deletes it, Newt warns them and posts the next number.
* A wrong number before anyone has counted costs nothing. It's deleted, and Newt says the next number is 1.
* The server best stays when the count resets.
* A sum with a fraction or a negative answer, like `7/2`, isn't a count.
* One counting channel per server. Bots and webhooks never count.
* `/count setcount` and the dashboard go up to 1,000,000,000.

**Permission:** Manage Server for `/count setup` and `/count setcount`. Everyone for `stats` and `leaderboard`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.