Skip to content

How to Use iHorizon?

iHorizon spreads more than 350 commands over 34 categories, so the first time you open the list it can feel like a lot. You don't have to configure all of it. Follow the six steps below in order and you will have a working setup in a few minutes, then turn on extra modules whenever your community needs them.

Who can run these commands

Almost every setup command on this page asks for the Administrator permission on your server, and a few belong to the server owner alone. Each command page states its requirement in a box like this one.

πŸš€ 1. Add iHorizon to your server

Open the invite link, or click Add App on the bot's Discord profile, then pick your server from the list. Discord only shows servers where you hold the Manage Server permission, so ask an admin to do it if yours is missing.

The invite link asks for Administrator. iHorizon needs wide permissions because its modules touch bans, roles, channels and messages, Withhold one and you will meet it later as a command that fails with no obvious explanation. If you prefer to grant less, uncheck what you don't need and come back to the server settings when a module complains.

Once the bot joins, its commands land in Discord within a few seconds. Type / in any channel and start typing iHorizon to filter the list down to this bot.

πŸ”Ž 2. Find your way around

Run /help for a guided tour. The command opens a home page with a dropdown of every category; pick one and iHorizon pages through the commands it contains, each with a short description.

Watch the padlock next to each command: a green one means anyone can run it, a red one means someone has restricted it through iHorizon's permission system, with the required level shown beside it. Pass a name to /help (for example /help ban) to jump to a single command.

Three more commands tell you the bot is healthy:

  • /ping shows the bot's latency in milliseconds
  • /botinfo counts the servers, members and channels iHorizon serves
  • /status reports the machine behind it: CPU, RAM, operating system and uptime

🌍 3. Set your server's language

iHorizon answers in ten languages: English, French, German, Spanish, Italian, Portuguese, Russian, Japanese, Egyptian Arabic and a "Rude French" dialect. Run /setlang and pick yours; the bot switches its replies for the whole server rather than for you alone.

Do this before the rest of the setup, so the menus you are about to open speak your language. See /setlang for the full list.

πŸ”§ 4. Configure the essentials

These four settings cover what most servers want on day one. All of them live on the Server Configuration page.

Audit logs. Run /setlogs and choose Setup all channels: iHorizon creates a full set of log channels in one go, covering deleted messages, moderation actions, role changes, voice activity and more. To route them yourself, pick a single log type and name the channel instead.

Welcome and leave messages. /guildconfig set channel chooses where greetings and departures are posted. From there, /guildconfig set join-message writes the greeting, /guildconfig set leave-message the farewell, and /guildconfig set join-dm a private message sent to each newcomer. Messages accept placeholders for the member's name and the server, so each one reads as if written for that person.

A role on arrival. /guildconfig set join-role hands one or more roles to every new member the moment they join, which is what you want for a default "Member" role or a verification setup.

Automod. The /automod block commands filter what members may post: link, discord_invite_link, telegram_link, spam and mass-mention. Each takes an action to switch it on or off, and an optional logs-channel where iHorizon reports the members who broke the rule.

Check your work

/guildconfig config show prints your server's whole iHorizon configuration in one message. Run it whenever you lose track of what is switched on.

πŸ§‘β€βš–οΈ 5. Give your staff access

Discord already controls who may ban or manage channels. iHorizon adds a second layer on top, nine levels named Perm 1 to Perm 9, so you can hand out access to bot features without giving anyone Administrator.

The quickest path, if you own the server:

  1. /perm create-roles builds the nine roles for you in one step.
  2. /perm edit-roles <perm_level> <perm_role> ties one of those levels to a role you already use. Link your "Moderator" role to a level once and every mod inherits it.
  3. /perm command <action> restricts a single command to a level, a role or a member. Use it to keep /mod ban in the hands of two people.

/perm set-user grants a level to one member without going through a role, and /perm list shows who holds a custom level. Unless you own the server, you can only grant a level below your own.

Two more commands belong in this step: /commandlimit rate-limits how often a command may run in a given window, and /guildconfig block bot stops other people from adding bots to your server.

🧩 6. Turn on the modules you want

Most features stay off until you enable them. Pick what your community needs and ignore the rest; nothing here is required.

Module Start with Documentation
Protection /protect actions then /protect sanction Protection
Anti-spam /antispam manage AntiSpam
Captcha verification /security config Security
Night mode /nightmode Night Mode
Honeypot /honeypot config Honeypot
Tickets /ticket config then /ticket panel Ticket System
Levels and XP /ranks config Rankings
Economy /economy config Economy
Suggestions /setsuggest config Suggestions Module
Confessions /confession channel Confessions
Starboard /starboard config Boards
Member counters /membercount MemberCount
Voice dashboard /voice interface set-voice-channel VoiceDashboard
Creator notifications /notifier author add Notifier
RSS feeds /blogger blog add Blogger
Role menus /rolereaction Role Reactions
Giveaways /gw create Giveaway
Music /music play Music

Music needs no setup: join a voice channel, run /music play with a title or a link, and iHorizon starts streaming.

Text commands and context menus

Slash commands cover most of iHorizon. Two other entry points exist.

Text commands answer to a prefix or to a mention. Out of the box, mentioning the bot works: @iHorizon help. Set your own prefix with /guildconfig bot prefix, choosing Change prefix and typing it in name. A handful of commands, among them +autorole, +welcomer and +autologs, exist in this form alone, and each command page lists them under "Prefix-only commands".

Context menus put iHorizon in Discord's right-click menu. Right-click a message or a member, open Apps, and pick an action. The Context-Menu Commands page lists what you get.

Keep a copy of your configuration

Once your setup is the way you like it, run /guildconfig config save. iHorizon hands you a file holding every setting from the steps above, which /guildconfig config restore reads back later. Keep it as insurance, or upload it on a second server to clone your setup in one command.

That file covers iHorizon's own settings. To save the server itself, its roles, channels and permissions, use Backups instead, and pair it with AuthRestore to bring your members back with the roles they had.

When you get stuck

  • /help inside Discord, for a command you can't remember
  • search.ihorizon.org to look one up from a browser
  • The Commands tab of this documentation, one page per category, with every option and permission listed
  • The Discord server, where the team and the community answer questions
  • Self-Hosting, if you would rather run your own instance