NTEUID provides cross-platform support for 异环Bot plugins within the gsuid_core ecosystem. Built as an extension for gsuid_core—a Python-based core library from the Genshin-bots project—it enables bots to operate across services like OneBot (for QQ), QQ channels, WeChat, KOOK (开黑啦), and Telegram. The plugin aims to unify functionality that would otherwise require separate setups for platforms such as HoshinoBot, NoneBot2, Koishi, yunzai, or ZeroBot. Hosted at github.com/tyql688/NTEUID with 52 stars, it's written in Python and currently at version 0.1.0.

This addresses a common pain point in bot development: fragmentation across messaging apps. Developers or server operators running Genshin Impact-related bots (given gsuid_core's origins) often juggle adapters for QQ, Telegram, Discord, and others. NTEUID consolidates these into gsuid_core, allowing a single plugin to handle interactions like logins and commands over multiple protocols. The README notes ongoing development (marked with 🚧 symbols), with plans to expand to additional platforms including FeiShu (飞书), DoDo, Villa (米游社大别野), and Discord.

Core features

NTEUID focuses on login and protocol bridging, with these key capabilities pulled from its documentation:

  • Multi-protocol support: Handles OneBot (QQ), OneBotV12, QQ channels, WeChat, KOOK, Telegram, and previews for others like FeiShu, DoDo, Villa, and Discord.
  • Web-based login: Relies on gsuid_core's Web service for initial authentication; users must ensure it's browser-accessible before first use.
  • Configurable login URL: Allows manual override via the NTELoginUrl setting in gsuid_core configs.
  • Command-driven installation: Integrates directly with gsuid_core's plugin system for quick deployment.
  • Community feedback loop: Ties into QQ group 662548513 for reports and a Bilibili space (space.bilibili.com/3546897499294077) linked to the 零号攻略组.

These features make it a bridge for 异环-specific tasks, likely involving Genshin Impact queries or automation, without rewriting core bot logic.

Getting it running

NTEUID requires an existing gsuid_core setup and Python 3.11 or higher. It's not a standalone project—treat it as a plugin. Full installation details live at docs.sayu-bot.com, which covers gsuid_core prerequisites like dependencies and bot adapters.

For users on the latest gsuid_core:

  1. Send the command core安装插件NTEUID directly to your bot.
  2. Restart the gsuid_core instance to load the plugin.

This pulls the plugin automatically, assuming your core version supports it. Before using login features, verify gsuid_core's Web service is reachable from a browser (typically on port 5010 or as configured). If needed, edit your gsuid_core config file to set NTELoginUrl to a custom address, e.g.:

NTELoginUrl: "http://your-server:5010/login"

Manual installation follows gsuid_core's plugin flow: clone the repo into the plugins directory (path depends on your gsuid_core install, often plugins/ or src/plugins/), then restart. No Docker or pip commands appear in the README—it's all core-integrated.

The project ships under GPL-3.0 license, with credits to gsuid_core and contributor Wuyi 无疑 (github.com/KimigaiiWuyi). Test in a development environment first, as the README flags it as under active improvement.

Who this is for

Server admins running gsuid_core for Genshin Impact communities will find NTEUID most useful. If your bot handles 异环 queries—cross-server lookups, event tracking, or player stats—across QQ groups, Telegram channels, or KOOK servers, this plugin reduces adapter overhead. It's suited for hobbyists in Chinese gaming circles, given ties to QQ, WeChat, and 米游社 (miHoYo's platform).

Small teams or solo operators benefit from the command-based install, avoiding deep code dives. Users already in the exchange group (662548513) or following 零号攻略组 on Bilibili get direct support paths. If you're bridging bots like NoneBot2 (QQ-focused) with Telegram groups for international play, it fits without full rewrites.

It's less ideal for beginners without gsuid_core experience—expect familiarity with Python bots and Web services. Commercial use is explicitly banned; stick to learning or personal servers.

How it compares

NTEUID builds directly on gsuid_core, so compare it to that foundation rather than full alternatives. Gsuid_core alone supports Genshin-specific plugins but lacks broad protocol bridging; NTEUID adds the multi-platform layer.

Other options include:

  • NoneBot2 or HoshinoBot: Native OneBot(QQ)/V12 support, but narrower platform reach. You'd need extra adapters like go-cqhttp for QQ or telebot for Telegram—more setup than NTEUID's plugin drop-in.
  • Koishi or yunzai: Similar cross-adapter ambitions, but gsuid_core's Genshin focus gives NTEUID an edge for that niche. Koishi (JavaScript-based) might appeal if you prefer npm ecosystems over Python.
  • ZeroBot: Lightweight for QQ, lacks the Web login or full multi-protocol stack here.

NTEUID is lighter than forking gsuid_core yourself (no custom code needed) but heavier than single-platform tools due to its extension nature. With only 52 GitHub stars, it's niche—gsuid_core has broader adoption in Genshin botting.

For non-Genshin bots, look to universal frameworks like Botpress or Rasa, though they diverge from 异环/gsuid patterns.

NTEUID suits gsuid_core users needing quick multi-platform expansion, but skip it if your setup avoids plugins or targets production (still 🚧-marked). Source at github.com/tyql688/NTEUID; raise issues for new 异环 features.

View on GitHub →