Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/developer51709/Niko/llms.txt

Use this file to discover all available pages before exploring further.

Niko’s utility cog provides everyday tools for both server members and admins — from setting reminders and saving reusable text snippets to getting notified when your name comes up in conversation. All utility commands support Niko’s trilingual responses (English, German, Spanish) and adapt their tone to the active server personality (normal or cafe).

General

CommandDescription
/pingCheck the bot’s current latency.
/echo <message>Echo a message in the channel. Requires Manage Messages.

Server Information

CommandDescription
/serverinfoDisplay server details: name, ID, total member count (users + bots), role count, creation date, and current owner. Aliases: !si, !server.
/userinfo [member]Display a user’s profile: account creation date, server join date and join position, nickname, top role, all roles, online status, and any Discord or Niko badges. Defaults to yourself if no member is specified. Aliases: !ui, !user.
/avatar [member]Show a user’s full-size avatar as an inline image. Defaults to your own avatar.
/banner [member]Show a user’s profile banner. Defaults to your own banner.
/roleinfo <role>Display information about a role: name, ID, colour, position in the hierarchy, and member count.
/servericonShow the server’s current icon as an inline image.
/serverbannerShow the server’s banner image, if one is set.
/booststatsShow the server’s current Nitro boost count, boost tier, and number of active boosters.
/spotify [member]Show what a server member is currently listening to on Spotify, including track, artist, album, duration, and live start/end timestamps.
/aboutLearn about Niko — description, developer, library, server count, and links to invite, GitHub, ToS, and Privacy Policy.
/creatorMeet Niko’s creator, with links to their Discord profile, GitHub, and website.
/inviteGet Niko’s OAuth2 invite link to add him to another server.
/debuginfoView bot debug information: uptime, AI model, command count, latency, CPU usage, and memory usage.
/hostinfoView host machine information: hostname, OS, CPU, and RAM.
/shardsView per-shard statistics: guild count, member count, and latency for each shard.

AFK System

CommandDescription
!afk [reason]Mark yourself as AFK globally across all servers. When another user @mentions you while you are AFK, Niko replies in that channel with your reason and how long you have been away. Your AFK status is automatically removed the next time you send any message (that isn’t a bot command).
How it works:
  • AFK state is stored in memory and applies across every server Niko is in.
  • When you speak again, Niko sends a “Welcome back” panel and tells you how long you were away.
  • Triggering a prefix command does not clear your AFK — only a regular message does.
Example:
!afk grabbing coffee
If someone then @mentions you, Niko replies:
🌙 YourName is AFK Reason: grabbing coffee Since: 5 minutes ago

Reminders

Reminders are persisted to data/reminders.json and survive bot restarts. Niko first attempts to deliver reminders via DM; if that fails, it falls back to the original channel where the reminder was set.
CommandDescription
reminder set <duration> <text>Schedule a reminder. Duration uses a combined format — e.g. 30s, 10m, 2h, 1d, or combined like 1h30m. Maximum duration is 1 year.
reminder listList all your pending reminders with their IDs and due times.
reminder delete <id>Cancel a scheduled reminder by its short ID (shown in reminder list). You can only delete your own reminders.
reminder clearCancel all of your pending reminders at once.
Duration format reference:
UnitSuffixExample
Secondss30s
Minutesm15m
Hoursh2h
Daysd3d
Combined1h30m, 2d12h

Snipe

The snipe system stores the last 10 deleted messages per channel in memory. The cache is not persisted — it resets on bot restart.
CommandDescription
!snipeDisplay the most recently deleted messages in the current channel, paginated newest-first. Each page shows the author, deletion timestamp, message content, and any attached image. Use the ◀ ▶ buttons to browse older entries. Aliases: !sn, !s.
!clearsnipeClear the deleted-message history for the current channel. Requires Manage Messages. Alias: !cs.
The snipe cache lives in memory only. It is cleared when the bot restarts and is scoped per-channel.

Tags

Tags are server-specific text snippets stored in data/tags.json. Each server can hold up to 500 tags, and each tag can be up to 1,900 characters long.
CommandDescription
tag <name>Display a saved tag by name. Also invokable as tag show <name>.
tag create <name> <content>Create a new tag. Tag names are lowercased and capped at 50 characters. Anyone can create tags.
tag edit <name> <content>Edit an existing tag’s content. Only the tag’s creator or a user with Manage Messages can edit it.
tag delete <name>Delete a tag. Only the tag’s creator or a user with Manage Messages can delete it.
tag listList all tags in the server, sorted alphabetically with usage counts. Results are paginated when there are more than 20 tags.
tag info <name>Show metadata about a tag: owner, usage count, and creation date.
tag raw <name>Show the raw markdown source of a tag (useful for debugging formatting).

Highlights

Highlights let you register keywords so Niko DMs you whenever that word appears in any message on the server. Up to 25 keywords per user per server. A 60-second cooldown per keyword per channel prevents notification spam.
CommandDescription
highlight add <keyword>Register a keyword. Niko will DM you any time that word is mentioned in a server message. Keywords are lowercased and capped at 50 characters.
highlight remove <keyword>Remove a keyword from your highlights list.
highlight listList all your active highlight keywords for this server, including any ignored users or channels.
highlight clearRemove all your highlight keywords for this server at once.
highlight ignore user <user>Stop receiving highlight DMs for messages from a specific user.
highlight ignore channel <channel>Stop receiving highlight DMs for messages in a specific channel.
highlight unignore user <user>Resume receiving highlight DMs from a previously ignored user.
highlight unignore channel <channel>Resume receiving highlight DMs from a previously ignored channel.
How notifications work:
  • Niko DMs you with a quote of the message, a link to jump to it, and the channel/server it came from.
  • Your own messages never trigger your own highlights.
  • Highlights only fire if you have permission to read the channel where the keyword appeared.

Build docs developers (and LLMs) love