# hoshinobot | ice9coffee | Knowledge Base | Instagit

A qqbot for Princess Connect Re:Dive (and other usage :)

GitHub Stars: 1.5k

Repository: https://github.com/ice9coffee/hoshinobot

---

## Articles

### [How HoshinoBot's Superuser Command System (sucmd) Works: Privileged Commands Explained](/ice9coffee/hoshinobot/how-does-hoshionbots-superuser-command-system-sucmd-work-and-what-are-privileged-commands)

Discover how HoshinoBot's sucmd decorator creates privileged superuser commands by checking configurations and enforcing restrictions. Learn about `hoshino.config.SUPERUSERS`.

- Tags: internals
- Published: 2026-03-03

### [Common HoshinoBot Deployment Issues with OneBot and gocqhttp: Complete Troubleshooting Guide](/ice9coffee/hoshinobot/what-are-common-deployment-issues-with-hoshionbot-using-onebot-or-gocqhttp-and-how-to-troubleshoot-them)

Troubleshoot HoshinoBot deployment issues with OneBot and gocqhttp. Solve common problems like protocol version mismatches, incorrect URLs, and token errors for a smooth setup.

- Tags: troubleshooting-guide
- Published: 2026-03-03

### [How to Add Support for New Games to HoshinoBot: A Complete Kancolle Integration Guide](/ice9coffee/hoshinobot/how-can-i-add-support-for-new-games-like-kancolle-to-hoshionbot)

Learn how to add support for new games, like Kancolle, to HoshinoBot. Integrate new game modules by creating Python packages and registering command handlers.

- Tags: how-to-guide
- Published: 2026-03-03

### [How to Implement Natural Language Processing (NLP) Triggers in HoshinoBot: Service Class and Trigger Chain Guide](/ice9coffee/hoshinobot/how-to-implement-natural-language-processing-nlp-triggers-in-hoshionbot)

Learn to implement Natural Language Processing NLP triggers in HoshinoBot using decorators and regex. Enhance your bot's responsiveness with this guide.

- Tags: how-to-guide
- Published: 2026-03-03

### [HoshinoBot Configuration System: How to Enable and Configure Modules](/ice9coffee/hoshinobot/what-is-the-configuration-system-in-hoshionbot-and-how-to-configure-modules)

Learn to configure HoshinoBot modules using its Python-based system. Rename config_example to config, define network settings, and customize plugins with Python or JSON files.

- Tags: how-to-guide
- Published: 2026-03-03

### [How to Implement Database Persistence for Module-Specific Data in HoshinoBot](/ice9coffee/hoshinobot/how-to-implement-database-persistence-for-module-specific-data-in-hoshionbot)

Learn how to implement database persistence for module-specific data in HoshinoBot using JSON files or the SqliteDao base class. Store your bot's data efficiently.

- Tags: how-to-guide
- Published: 2026-03-03

### [How HoshinoBot Performs Text Normalization and Chinese Character Conversion](/ice9coffee/hoshinobot/how-does-hoshionbot-perform-text-normalization-and-chinese-character-conversion)

Discover how HoshinoBot performs text normalization and Chinese character conversion using Unicode NFKC and zhconv. Learn how it prepares messages for efficient matching.

- Tags: internals
- Published: 2026-03-03

### [How HoshinoBot Handles Group Events: Join and Leave Notifications Explained](/ice9coffee/hoshinobot/how-does-hoshionbot-handle-group-events-such-as-join-and-leave-notifications)

Discover how HoshinoBot manages group events like join and leave notifications using OneBot notice events and the Service.on_notice decorator. Learn about permission checks for welcome and farewell messages.

- Tags: how-to-guide
- Published: 2026-03-03

### [How to Implement Custom Bot Commands Using the `on_command` Decorator in HoshinoBot](/ice9coffee/hoshinobot/how-to-implement-custom-bot-commands-using-the-oncommand-decorator-in-hoshionbot)

Learn to implement custom bot commands in HoshinoBot using the on_command decorator. Seamlessly add commands with built-in checks and NoneBot integration for your bot.

- Tags: how-to-guide
- Published: 2026-03-03

### [How to Configure and Use the Resource File System (RES_DIR, RES_PROTOCOL) in HoshinoBot](/ice9coffee/hoshinobot/how-to-configure-and-use-the-resource-file-system-resdir-resprotocol-in-hoshionbot)

Learn to configure and use HoshinoBot's resource file system RES_DIR and RES_PROTOCOL. Control static asset storage and delivery for OneBot/CQHTTP clients.

- Tags: how-to-guide
- Published: 2026-03-03

### [**SQL (Structured Query Language)** 是一种用于管理和操作**关系型数据库**的编程语言。它允许用户使用**声明式语句**执行以下核心操作：](/ice9coffee/hoshinobot/understanding-the-message-preprocessing-and-trigger-chain-in-hoshionbot)

Learn SQL, the powerful language for relational databases. Master declarative statements for core data operations and unlock database management efficiency.

- Tags: deep-dive
- Published: 2026-03-03

### [How to Create and Load Custom Modules into HoshinoBot: The Complete Guide](/ice9coffee/hoshinobot/how-to-create-and-load-custom-modules-into-hoshionbot)

Learn to create and load custom modules into HoshinoBot. Follow this guide to register handlers and configure your bot for new functionality.

- Tags: how-to-guide
- Published: 2026-03-03

### [How HoshinoBot Group Management and Anti-Spam Features Work: A Deep Dive into the Service Architecture](/ice9coffee/hoshinobot/how-do-hoshionbots-group-management-features-like-anti-spam-function)

Discover how HoshinoBot's group management and anti-spam features function. Explore its modular service architecture handling permissions, configurations, and block lists for effective bot control.

- Tags: deep-dive
- Published: 2026-03-03

### [How to Integrate Twitter API v2 into HoshinoBot: Complete Setup Guide](/ice9coffee/hoshinobot/how-to-integrate-twitter-api-v2-into-hoshionbot)

Integrate Twitter API v2 into HoshinoBot with this comprehensive setup guide. Learn to configure credentials, map accounts, and broadcast tweets for seamless social media integration.

- Tags: how-to-guide
- Published: 2026-03-03

### [How to Manage and Implement Clan Battle (公会战) Features in HoshinoBot](/ice9coffee/hoshinobot/how-to-manage-and-implement-clan-battle-features-in-hoshionbot)

Easily manage HoshinoBot clan battle features using commands like !建会 !出刀 and !进度 Enable v2 v3 or v4 and persist data with BattleMaster and SQLite JSON files

- Tags: how-to-guide
- Published: 2026-03-03

### [How the Character Name Alias Conversion System Works in HoshinoBot](/ice9coffee/hoshinobot/how-does-the-character-name-alias-conversion-system-charapy-work-in-hoshionbot)

Uncover the HoshinoBot character name alias conversion system. Learn how its trie-based Roster and fuzzy matching accurately identify characters like Princess Connect! Re:Dive for seamless interaction.

- Tags: internals
- Published: 2026-03-03

### [How to Implement Arena Query Functionality in HoshinoBot: Complete API Integration Guide](/ice9coffee/hoshinobot/how-to-implement-arena-query-functionality-in-hoshionbot-possibly-with-api-integration)

Integrate HoshinoBot arena query functionality with the pcrdfans API. Learn about command handlers, business logic, and data persistence in this comprehensive guide.

- Tags: how-to-guide
- Published: 2026-03-03

### [How HoshinoBot Gacha Simulation Works: Probability Mechanics and Pool System](/ice9coffee/hoshinobot/how-does-the-hoshionbot-gacha-simulation-system-work-and-handle-probabilities)

Discover how HoshinoBot gacha simulation handles probabilities and its pool system. Understand the mechanics behind Princess Connect Re:Dive draws in this technical deep dive.

- Tags: deep-dive
- Published: 2026-03-03

### [How to Implement Broadcast Functionality to Send Messages to Multiple Groups in HoshinoBot](/ice9coffee/hoshinobot/how-to-implement-broadcast-functionality-to-send-messages-to-multiple-groups-in-hoshionbot)

Learn how to implement broadcast functionality in HoshinoBot to send messages to multiple groups effortlessly. Explore built-in commands and service methods for efficient mass messaging.

- Tags: how-to-guide
- Published: 2026-03-03

### [How to Create and Use Scheduled Jobs with the scheduled_job Decorator in HoshinoBot](/ice9coffee/hoshinobot/how-can-i-create-and-use-scheduled-jobs-with-the-scheduledjob-decorator-in-hoshionbot)

Learn to use the scheduled_job decorator in HoshinoBot to easily create and manage scheduled tasks. Automate bot functions with APScheduler for reliable execution.

- Tags: how-to-guide
- Published: 2026-03-03

### [How the HoshinoBot Permission System Manages User Privileges in priv.py](/ice9coffee/hoshinobot/how-does-the-permission-system-in-hoshionbot-privpy-manage-user-privileges)

Discover how HoshinoBot manages user privileges using integer-based levels in priv.py. Learn about super-users, block lists, and group roles with get user priv and check priv functions.

- Tags: internals
- Published: 2026-03-03

### [How to Implement Per-Group Service Enabling and Disabling in HoshinoBot](/ice9coffee/hoshinobot/how-to-implement-per-group-service-enabling-and-disabling-in-hoshionbot)

Learn to implement per-group service enabling and disabling in HoshinoBot. Master persistent JSON configuration with set enable and set disable methods for fine-grained feature control.

- Tags: how-to-guide
- Published: 2026-03-03

### [HoshinoBot Trigger Types: A Complete Guide to Prefix, Suffix, Keyword, and Regex](/ice9coffee/hoshinobot/what-are-the-different-types-of-triggers-in-hoshionbot-prefix-suffix-keyword-and-regex)

Explore HoshinoBot trigger types: prefix, suffix, keyword, and regex. Learn how to match messages with leading text, trailing text, substrings, or regex patterns for powerful bot automation.

- Tags: deep-dive
- Published: 2026-03-03

### [How HoshinoBot's Service System Works: A Complete Guide to Creating Custom Services](/ice9coffee/hoshinobot/how-does-hoshionbots-service-system-work-and-how-can-i-create-custom-services)

Discover how HoshinoBot's service system isolates functionality into modular objects. Learn to create custom HoshinoBot services for command registration, permissions, and config management easily.

- Tags: how-to-guide
- Published: 2026-03-03