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

# Setup

> Download MANIA

<Note>
  Versions are independent, you may use what works best for you.
</Note>

<Warning>
  MANIA may be flagged by antivirus software, this is expected for bots.
</Warning>

<Tabs>
  <Tab title="Windows" icon="windows">
    <Steps>
      <Step title="Disable Windows Security">
        Disable Windows Security real-time protection before downloading.

        Open **Windows Security → Virus & threat protection → Manage settings** → Turn off **Real-time protection**.
      </Step>

      <Step title="Download">
        Download MANIA from [mania.bot](https://mania.bot).

        If your browser blocks the download, click **Keep anyway**.
      </Step>

      <Step title="Place in hidden folder">
        Move the file to a hidden folder with an inconspicuous name.

        Avoid names like "bot", "mania", or "maplestory" in the path.
      </Step>

      <Step title="Add antivirus exclusion">
        Add the folder to your antivirus exclusions before re-enabling protection.

        **Windows Security → Virus & threat protection → Manage settings → Exclusions → Add an exclusion → Select the folder**.
      </Step>
    </Steps>
  </Tab>

  <Tab title="MacOS" icon="apple">
    <Warning>
      MANIA needs an **Apple Silicon Mac (M1 or later)** running **macOS 14 (Sonoma) or newer**.

      Confirm under **Apple Menu → About This Mac** before you download.
    </Warning>

    <Steps>
      <Step title="Download">
        Download MANIA from [mania.bot](https://mania.bot).

        If Apple blocks the app:

        * Open **Apple Menu → System Settings → Privacy & Security** (scroll down in the sidebar).
        * Under **Security**, click **Open Anyway**, then confirm **Open Anyway** on the pop-up.

        <Note>
          See Apple's [official guide](https://support.apple.com/en-tj/guide/mac-help/mchleab3a043/mac) for more details on opening apps from unidentified developers.
        </Note>
      </Step>

      <Step title="Grant permissions">
        You may see pop-ups asking to:

        * Receive keystrokes from any application
        * Control this computer using accessibility features
        * Record this computer's screen and audio

        Click **Open System Settings** on each pop-up and enable the requested permission. Restart the app after granting them.

        <Tip>
          If the prompts don't appear, grant them manually in **System Settings → Privacy & Security**.
        </Tip>
      </Step>

      <Step title="Place in Applications">
        Move the executable to your Applications folder
      </Step>
    </Steps>
  </Tab>

  <Tab title="Linux (WSL)" icon="linux">
    <Note>
      Linux support is coming soon.
    </Note>
  </Tab>
</Tabs>