Documentation

Setup Guide

Everything you need to get HabboBot verifying members and handing out roles in your Discord server.

Overview #

HabboBot is a Discord verification bot for Habbo Hotel, developed by Owen (misteromorg) and Andy (andings). It lets members prove which Habbo account is theirs, then keeps their Discord roles and nickname in line with that account.

  • Stop trolls and spammers by putting a verification step between them and your server.
  • Integrate with Habbo groups by giving roles based on group membership.
  • Nickname members to their Habbo username automatically.

All commands are Discord slash commands: type / in any channel the bot can see and pick a HabboBot command from the list. See the full command reference.

Quick start #

  1. Invite HabboBot

    Use the Add to Server link and pick your server. You need the Manage Server permission to do this.

  2. Move the HabboBot role up

    In Server Settings → Roles, drag the HabboBot role above every role you want the bot to give or remove. Discord doesn't let a bot manage roles above its own.

  3. Choose your hotel

    Run /settings to view the current configuration and set hotel to the hotel your community plays on. You can also do this from the web dashboard.

  4. Create a verified role Optional

    Create a role (most servers call it Verified), then run /specialbind with that role and the Verified type so everyone who verifies receives it.

  5. Bind Habbo groups Optional

    Use /bind to give roles to members or admins of a Habbo group. See Role bindings.

  6. Tell your members

    Point members to Verifying your account, or simply ask them to run /verify.

Permissions the bot needs

The invite link requests these permissions. If you remove any of them, some features stop working.

Permission Used for
Manage Roles Giving and removing verified and group roles
Manage Nicknames Setting members' nicknames to their Habbo username
View Channels, Send Messages, Embed Links, Read Message History, Manage Messages Replying to commands and posting logs

Verifying your account #

Your Habbo profile must be visible (public) for verification to work. You can change this in your Habbo privacy settings and switch it back afterwards if you like.

  1. Request a code

    Run /verify with your Habbo username. The bot replies with a motto to use, such as HabboBot aB3x9.

  2. Update your motto

    In Habbo, change your motto so it contains that text exactly. The code is unique to you and stays the same if you need to try again.

  3. Confirm

    Run /verify with your Habbo username again. HabboBot checks your motto, links your account and gives you any roles the server has set up.

  4. Change your motto back

    Once you're verified you can set your motto to anything you like.

Verification is stored per hotel, so you only need to do this once for each hotel. In any other server using the same hotel, /verify recognises you straight away. If your Habbo name changes, HabboBot picks up the new name automatically.

Role bindings #

A binding connects a Discord role to a condition. Members receive bound roles when they verify, when they run /getroles, or when an admin runs /update on them.

Special bindings

Created with /specialbind. The role is given to everyone who matches the type:

  • Verified: every member with a verified Habbo account.
  • Staff: HabboBot staff members.

Group bindings

Created with /bind. The role is given to members of a Habbo group. You'll need:

  • The group name as it appears on Habbo.
  • The group owner's Habbo username. This is case sensitive, and the owner's profile must be visible so the bot can find the group.
  • Whether the role is for every member or only group admins.
  • Optionally, a role to remove when the member qualifies, for example removing a "Guest" role when someone joins your group.

Running /bind again for the same role and group updates the existing binding. View everything with /bindings and remove a role's bindings with /unbind.

The member's Habbo profile must be visible for group roles to be checked.

Server settings #

Change settings with /settings in Discord, or log in and use the web dashboard.

Setting Values Description
hotel See below The hotel members verify against. Default com.
setNickname yes / no Rename verified members to their Habbo username. Default no.
logsEnabled yes / no Post verification activity to a log channel. Default no.
logsChannel Channel ID The channel that logs are posted to.

Supported hotels

  • Habbo.com com
  • Habbo.com.br com.br
  • Habbo.com.tr com.tr
  • Habbo.de de
  • Habbo.fi fi
  • Habbo.fr fr
  • Habbo.it it
  • Habbo.nl nl
  • Habbo Origins origins

FAQ & troubleshooting #

The bot says my profile is private

Open Habbo, go to your privacy settings and make your profile visible, then try /verify again. Habbo's API can take a few minutes to reflect the change.

I changed my motto but verification still fails

Check the motto contains the exact text the bot gave you, including HabboBot and a space before the code. Make sure you're verifying on the same hotel the server uses, and give Habbo a minute to update before retrying.

Members aren't receiving roles or nicknames

Almost always this is role order. The HabboBot role must be above every role it manages, and the bot needs the Manage Roles and Manage Nicknames permissions. Discord never lets bots rename the server owner.

"This Habbo is already verified to another Discord account"

Each Habbo can only be linked to one Discord account. If the other account is yours, run /unverify from it first. Otherwise, ask for help in the support server.

The bot can't find our group when using /bind

The group owner's username is case sensitive and their profile must be visible. Also check the group name matches Habbo exactly and that the server's hotel setting is the group's hotel.

How do I know I'm talking to real HabboBot staff?

Compare their Discord ID with the IDs on the Team page. Usernames can be copied; IDs can't.

Still stuck? Ask in our support server.