Ina's New World Bot

Your indispensable Aeternum companion for Discord.
Uncover secrets, manage your arsenal, and conquer the island!

Invite Ina to Your Server

✨ Key Features

  • Deep Dive Database: Instantly access detailed information on New World items, perks, and recipes. (e.g., /nwdb, /perk, /recipe)
  • Strategic Crafting: Calculate materials for crafts, view full recipe breakdowns, and determine exact costs for your crafting endeavors. (e.g., /calculate_craft, /recipe)
  • Build Management: Save, share, and manage your favorite New World builds from nw-buddy.de. (e.g., /build add, /build list)
  • Server Enhancements: Enhance your server with optional welcome messages for new members and activity logging.
  • Aeternum Fun: Engage with fun commands, including the legendary /petpet ritual and more!
  • Bot Administration: Tools for bot owners and administrators to manage the bot, including permissions and updates.
  • Automatic Updates: Configure Ina to check for and apply updates to herself (requires specific server-side setup).
  • Always Evolving: Regularly updated with new features, improvements, and the latest New World game data.

Commands

Here's a list of available commands. Use /help [command_name] in Discord for more details on a specific command.

General Commands

  • /ping: Check if the bot is online.
  • /help [command_name]: Show available commands or help for a specific command.
  • /petpet <user>: Give a New World petting ritual to a user!
  • /calculate <expression>: Perform a calculation with New World magic!
  • /about: Show information about Ina's New World Bot.

New World Specific Commands

  • /nwdb <item_name>: Look up items from New World Database.
  • /perk <perk_name>: Look up information about a specific New World perk.
  • /recipe <item_name>: Show the full recipe breakdown for a craftable item.
  • /calculate_craft <item_name> [amount]: Calculate resources needed to craft an item, including intermediates.

Build Management

  • /build add <link> <name> [keyperks]: Add a build from nw-buddy.de.
  • /build list: Show a list of saved builds.
  • /build remove <name>: Remove a saved build. (Requires: Manage Server or Bot Manager)

Management & Settings (Require Permissions)

  • /manage update: Pulls updates from GitHub and restarts the bot. (Requires: Bot Owner)
  • /manage restart: Shuts down the bot for manual restart. (Requires: Bot Owner/Manager)
  • /manage permit <user>: Grants a user bot management permissions. (Requires: Server Admin or Bot Owner)
  • /manage unpermit <user>: Revokes a user's bot management permissions. (Requires: Server Admin or Bot Owner)
  • /settings listmanagers: Lists users with bot management permissions. (Requires: Server Admin or Bot Manager/Owner)
  • /settings welcomemessages <action> [channel]: Manage welcome messages. Actions: enable, disable, status. (Requires: Manage Server or Bot Manager/Owner)
  • /settings logging <action> [channel]: Manage server activity logging. Actions: enable, disable, status. (Requires: Manage Server or Bot Manager/Owner)

Setup

  1. Clone the repository.
  2. Install dependencies: pip install -r requirements.txt
  3. Create a .env file in the root directory with your BOT_TOKEN. Example: 
    BOT_TOKEN=YOUR_DISCORD_BOT_TOKEN_HERE
  4. The bot uses a SQLite database (new_world_data.db) for item, perk, and recipe data. If this file is not present when the bot starts, it will attempt to automatically create and populate it by downloading the necessary data from the internet. This process may take a few moments on the first run.
  5. Run the bot: python main.py

For automatic updates, ensure update_bot.ps1 (Windows) or update_bot.sh (Linux) is executable and correctly configured for your environment. The bot also needs a process manager (like PM2 or systemd) to restart it after an update.