Disclaimer:Although Nori was discontinued on October 14, 2025, SofiHelper (formerly NoriHelper) has been updated to parse and check card drops directly from Sofi instead of Nori.

Announcement

SofiHelper

SofiHelper (formerly NoriHelper) is a personal assistant bot for Discord that helps manage series and characters for card tracking. It was originally designed to assist Nori (a helper Discord bot that supported the card-collecting bot Sofi). Since Nori was discontinued on October 14, 2025, SofiHelper has been updated to directly parse and check Sofi's card drop messages. It provides commands to add, delete, and list series and characters.

Features

• Detects when a dropped card belongs to the user's favorite character and or series.
• Add, delete, and list series and characters.
• Provides status and help commands.
• Dual database support: dynamically switchable between JSON file storage (lightweight/portable) and MySQL database backends.

Installation

1. Clone the repository:

   git clone https://github.com/User-425/SofiHelper
   cd SofiHelper

2. Install dependencies:

   npm install

3. Configure the bot:

   • Copy data/config-example.json to data/config.json.
   • Update the configuration values:
     • token: Your Discord bot token.
     • targetBotId: The Discord user ID of Sofi (or the bot being tracked).
     • ownerId: Your Discord user ID.
     • prefixes: Array of prefixes to trigger this helper bot.
     • dbMode: Set to "json" (local file storage) or "mysql" (MySQL server storage).
     • mysql: Database connection settings (host, port, user, password, database) if using "mysql" mode.

Usage

1. Start the bot:

   npm start

   Or use the start.bat file:

   start.bat

2. Invite the bot to your Discord server

Contributing

Feel free to contribute to this project by opening an issue or submitting a pull request.

License

This project is licensed under the MIT License.