ni han bao
Docs

Set it up

ni han bao works without setup. /setup changes a few things per server. Only members with Manage Server see it, and only you see its answers.

Screenshot coming: /setup with its subcommands listed

What to do

  1. Report channel: /setup report-channel channel:#weekly-report. The bot posts the weekly report card there every Monday, and the monthly recap on the first of the month. Leave channel out to turn both off.
  2. Time zone: /setup timezone timezone:Europe/Brussels. It decides when "today" and "this week" start, and when the report is posted. Use an IANA name, like America/New_York. The default is UTC.
  3. Public totals: /setup public-totals include:False leaves your server out of the totals on the public home page. They never show your server's name either way.
  4. Rank roles: /setup rank-roles state:on gives members who linked a League account a role for their tier, kept in sync. The bot needs Manage Roles, and its own role must be above the tier roles.
  5. Check: /setup show lists the settings.

What you should see

/setup show answers with the settings, and only you see it:

You used /setup show

ni han baoAPP

Weekly report card: #weekly-report Time zone: Europe/Brussels Public totals: left out Rank roles: off (existing rank roles stay until you delete them)

Only you can see this

Example reply, drawn from the bot's code

With a report channel set, the bot posts a report card there every Monday:

ni han baoAPP

Weekly report card: week of 2026-10-12

Report card's in. Sit down, we need to talk.
Top talkers
🥇 Anna: 1,284 messages 🥈 Bram: 967 messages 🥉 Chloé: 412 messages
Busiest channel
#general: 1,712 messages
Top emoji
😂 58 times
Member growth
+2 (3 joined, 1 left) Welcome to the family. Wipe your feet.
League
Bram: 14 games, mostly Ahri 14 games between you. Ranked and normals only.
Coming up this week
Sat 17 Oct, 19:00 · Riftbound Nexus Night · The Card Corner (Leuven): Anna, Bram

Monday 2026-10-12 to Sunday 2026-10-18 (Europe/Brussels)

Example reply, drawn from the bot's code

If you don't

  • No /setup in the command list: you need Manage Server. A server admin can change who sees it under Server Settings, Integrations, ni han bao.
  • "I cannot post in #channel": give the bot View Channel and Send Messages in that channel, then run the command again.
  • "… is not a time zone": check the spelling against the IANA list, like Europe/Brussels.
  • No report on Monday: check /setup show for the channel, and that the bot can still post there. Embed Links is needed for the card.
  • Rank roles answers with a problem: it says what to fix: the Manage Roles permission, or the bot's role must be above the tier roles (Server Settings > Roles).

Next: link your accounts.