Skip to content

Repository files navigation

BD Library

BD Library is a multi-game community Discord bot for Brown Dust 2 (Neowiz), NIKKE: Goddess of Victory, and Horizon Walker. It looks up character info for all three games, converts event times to everyone's local timezone, and keeps each community's favourite resources one slash-command away.

What BD Library does

🔎 Look up any character — one command group per game

Type a name — or a nickname like hea for High Elf Archer or rrh for Rapi: Red Hood — and BD Library replies with everything you need at a glance (autocomplete included):

  • /bd character <name> — Brown Dust 2: PvE/PvP tier placements from DotGG, costume guides (a link for every costume DotGG has covered), and a link to the full DotGG character guide
  • /nikke character <name> — NIKKE: Prydwen Story/Bossing/PvP tiers, Nikke Synergy arena stats, and Tsareena's pull priority & build advice, with profile icons and links to the sources
  • /hw character <name> — Horizon Walker: grade, profile, substat priority, and traits to get from the community wiki sheet

🕒 Convert event times — /time <when> <offset>

Turn something like "July 10, 8pm UTC+9" into a Discord timestamp that every member sees in their own local timezone — no more timezone math in the comments.

📰 Automatic news timestamps

Pick one or more channels and BD Library watches them for game-news / tweet posts, then automatically replies with a local-time stamp for any event time mentioned. It reads the post text, ignores posts with no clear date/time, and assumes UTC+9 (KST server time) when a post doesn't say. A server admin sets this up with /config news #channel.

🔗 Quick resource links

  • Brown Dust 2: /bd guides — all the community resources in one post; /bd dotgg · /bd bd2db · /bd wiki · /bd codes · /bd pve-tier-list · /bd pvp-tier-list — jump straight to one
  • NIKKE: /nikke guides — the resource round-up; /nikke build-guide · /nikke prydwen · /nikke pvp-team-builder · /nikke pvp-teams-guide · /nikke raid-usage — one link each; /nikke unprivate-blabla — an illustrated walkthrough for making a blablalink.com roster public
  • Horizon Walker: /hw guides — the resource round-up; /hw sheet — the community wiki spreadsheet behind /hw character
  • /support — where to report bugs and ask for help
  • /github — BD Library's source code

💬 Save memorable quotes

React to any message with the server's quote emoji — once it hits the configured number of reactions, BD Library saves it under whoever said it. Pull up someone's greatest hits any time with /quotes @user. An admin turns it on with /config quotes emoji:⭐.

✨ Handy extras

  • /help — DMs you the full list of commands
  • /quotes @user — show a member's saved quotes
  • /feature-request <idea> — suggest a feature (it's logged for the maintainer)
  • /ping · /serverinfo · /userinfo — the usual quality-of-life utilities

For server admins

After inviting the bot, follow the setup guide — it walks through the permissions BD Library's role needs (including the locked-channel gotcha that stops news posts) and the /config options. In short (these commands are hidden from regular members):

  • /config news #channel — choose the channel(s) to watch for game news. Run it again to add more; add remove:true to stop watching one.
  • /config welcome #channel · /config modlog #channel · /config show
  • /config quotes emoji:⭐ threshold:3 — turn on the quote-saver: which reaction saves a message, and how many it takes (default 3).
  • /setup-guide — DMs you this whole setup checklist, right inside Discord
  • /sync [game] — refresh the game data on demand, for one game or all three (it also refreshes daily on its own)
  • /perms <role> <permission> … — bulk-edit one permission for a role across many channels. Previews the changes first and is audit-logged, so it's safe to try.

General moderation (ban/kick/timeout/etc.) is intentionally left to Discord's own built-in tools.

Data sources

Character data comes from public community resources — all credit to their maintainers:

Brown Dust 2

NIKKE

  • Prydwen — the Story/Bossing/PvP tier ratings on /nikke character
  • Nikke Synergy — arena pick/win stats and the name dictionary that keeps matching automatic
  • Tsareena's NIKKE Build Guide — pull priority and per-character build advice
  • NIKKE Deck and Enikk — the PvP team builder and raid-usage sites linked by the subcommands

Horizon Walker

  • The community "HORIZON WALKER WIKI (UNOFFICIAL)" Google Sheet — the unit roster, profiles, and build guides behind /hw character
  • Gamekee and GachaWiki — the wikis linked by /hw guides

The bot refreshes its data for all three games automatically once a day; admins can trigger a refresh anytime with /sync.

Under the hood

BD Library is an open-source TypeScript project (discord.js + an optional Next.js dashboard + Postgres) you run yourself — on a VPS or even a home PC. If you'd like to contribute, self-host, or understand how it works, everything is in docs/development.md.

License & credits

BD Library is a derivative of bakery-bot by Infernal-Crack-LED, a NIKKE community bot — the architecture, admin tooling, and most of the plumbing come from there, and the NIKKE module brings its data pipeline full circle.

Licensed under the GNU AGPL-3.0, same as the original. If you run a modified version as a network service, you must make your source available under the same license.

BD Library is a fan project and is not affiliated with Neowiz, Shift Up, the Horizon Walker team, or any of the community sites it links.


📄 Privacy Policy · Terms of Service · ⚖️ License

About

No description, website, or topics provided.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages