Home

Awesome

<div align="center">

Lagrange.Core Core OneBot C# C#

License Telegram

Image

> English < | 简体中文

</div>

Related Projects

<table> <tr> <td><a href="https://github.com/LagrangeDev/Lagrange.Core">Lagrange.Core</a></td> <td>NTQQ Protocol Implementation(👈Here</td> </tr> <tr> <td><a href="https://github.com/whitechi73/OpenShamrock">OpenShamrock</a></td> <td>Based on Xposed, OneBot Bot Framework</td> </tr> <tr> <td><a href="https://github.com/chrononeko/chronocat">Chronocat</a></td> <td>Based on Electron, modular Satori Bot Framework</td> </tr> </table>

Document

Lagrange.Doc

Docker guide

Out of Active Feature Requesting

Lagrange.Core has completed nearly all the function and task scheduled by Linwenxuan05, so mostly enhance to the library would be concentrated to the repo for next.

Feature request would be accepted but implemented with a long duration.

The new function of NTQQ supported in following versions would be added as well.

Disclaimer

The Lagrange.Core project, including its developers, contributors, and affiliated individuals or entities, hereby explicitly disclaim any association with, support for, or endorsement of any form of illegal behavior. This disclaimer extends to any use or application of the Lagrange.Core project that may be contrary to local, national, or international laws, regulations, or ethical guidelines.

Lagrange.Core is an open-source software project designed to facilitate lawful and ethical applications in its intended use cases. It is the responsibility of each user to ensure that their usage of Lagrange.Core complies with all applicable laws and regulations in their jurisdiction.

The developers and contributors of Lagrange.Core assume no liability whatsoever for any actions taken by users that violate the law or engage in any form of illicit activity. Users are solely responsible for their own actions and any consequences that may arise from the use of Lagrange.Core.

Furthermore, any discussions, suggestions, or guidance provided by the Lagrange.Core community, including its developers, contributors, and users, should not be interpreted as legal advice. It is strongly recommended that users seek independent legal counsel to understand the legal implications of their actions and ensure compliance with the relevant laws and regulations.

By using or accessing Lagrange.Core, the user acknowledges and agrees to release the developers, contributors, and affiliated individuals or entities from any and all liability arising from the use or misuse of the project, including any legal consequences incurred as a result of their actions.

Please use Lagrange.Core responsibly and in accordance with the law.

SignServer

https://sign.lagrangecore.org/api/sign

Thanks for 外国热心网友 for Provision of Azure Servlet

** Built-in SignServer is now provided, Enjoy! **

Features List

ProtocolSupportLoginSupportMessagesSupportOperationsSupportEventsSupport
Windows🟢QrCode🟢Images🟢Poke🟢Captcha🟢
macOS🟢Password🟢Text / At🟢Recall🟢BotOnline🟢
Linux🟢EasyLogin🟢Records🟢Leave Group🟢BotOffline🟢
UnusalDevice<br/>Password🔴QFace🟢Set Special Title🟢Message🟢
UnusalDevice<br/>Easy🟢Json🟢Kick Member🟢Poke🟢
NewDeviceVerify🟢Xml🟢Mute Member🟢MessageRecall🟢
Forward🟢Set Admin🟢GroupMemberDecrease🟢
Video🟢Friend Request🟢GroupMemberIncrease🟢
Reply🟢Group Request🟢GroupPromoteAdmin🟢
File🟢Voice Call🔴GroupInvite🟢
Poke🟢Client Key🟢GroupRequestJoin🟢
LightApp🟢Cookies🟢FriendRequest🟢
Send Message🟢FriendTyping🔴
FriendVoiceCall🔴

Lagrange.OneBot

The Binary for development could be found in Actions Artifacts

<Details> <Summary>Message Segement</Summary>
Message SegementSupport
Text🟢
Face🟢
Image🟢
Record🟢
Video🟢
At🟢
Rps🟢
Dice🟢
Shake🔴
Poke🟢
Anonymous🔴
Share🔴
Contact🔴
Location🟢
Music🟢
Reply🟢
Forward🟢
Node🟢
Xml🔴
Json🟢
</Details> <Details> <Summary>API</Summary>
APISupport
/send_private_msg🟢
/send_group_msg🟢
/send_msg🟢
/delete_msg🟢
/get_msg🟢
/get_forward_msg🟢
/send_like🟢
/set_group_kick🟢
/set_group_ban🟢
/set_group_anonymous_ban🔴
/set_group_whole_ban🟢
/set_group_admin🟢
/set_group_anonymous🔴
/set_group_card🟢
/set_group_name🟢
/set_group_leave🟢
/set_group_special_title🟢
/set_friend_add_request🟢
/set_group_add_request🟢
/get_login_info🟢
/get_stranger_info🟢
/get_friend_list🟢
/get_group_info🟢
/get_group_list🟢
/get_group_member_info🟢
/get_group_member_list🟢
/get_group_honor_info🟢
/get_cookies🟢
/get_csrf_token🟢
/get_credentials🟢
/get_record🔴
/get_image🔴
/can_send_image🟢
/can_send_record🟢
/get_status🟢
/get_version_info🟢
/set_restart🟢
/clean_cache🔴
</Details> <Details> <Summary>Event</Summary>
PostTypeEventNameSupport
MessagePrivate Message🟢
MessageGroup Message🟢
NoticeGroup File Upload🟢
NoticeGroup Admin Change🟢
NoticeGroup Member Decrease🟢
NoticeGroup Member Increase🟢
NoticeGroup Mute🟢
NoticeFriend Add🟢
NoticeGroup Recall Message🟢
NoticeFriend Recall Message🟢
NoticeGroup Poke🟢
NoticeGroup red envelope luck king🔴
NoticeGroup Member Honor Changed🔴
RequestAdd Friend Request🟢
RequestGroup Request/Invitations🟢
MetaLifeCycle🟢
MetaHeartbeat🟢
</Details> <Details> <Summary>Communication</Summary>
CommunicationTypeSupport
Http🟢
Http-Post🟢
ForwardWebSocket🟢
ReverseWebSocket🟢
</Details>

appsettings.json Example

As the Password is empty here, this indicates that QRCode login is used

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "SignServerUrl": "",
  "Account": {
    "Uin": 0,
    "Password": "",
    "Protocol": "Linux",
    "AutoReconnect": true,
    "GetOptimumServer": true
  },
  "Message": {
    "IgnoreSelf": true,
    "StringPost": false
  },
  "QrCode": {
    "ConsoleCompatibilityMode": false
  },
  "Implementations": [
    {
      "Type": "ReverseWebSocket",
      "Host": "127.0.0.1",
      "Port": 8080,
      "Suffix": "/onebot/v11/ws",
      "ReconnectInterval": 5000,
      "HeartBeatInterval": 5000,
      "HeartBeatEnable": true,
      "AccessToken": ""
    },
    {
      "Type": "ForwardWebSocket",
      "Host": "*",
      "Port": 8081,
      "HeartBeatInterval": 5000,
      "HeartBeatEnable": true,
      "AccessToken": ""
    },
    {
      "Type": "HttpPost",
      "Host": "127.0.0.1",
      "Port": 8082,
      "Suffix": "/",
      "HeartBeatInterval": 5000,
      "HeartBeatEnable": true,
      "AccessToken": ""
    },
    {
      "Type": "Http",
      "Host": "*",
      "Port": 8083,
      "AccessToken": ""
    }
  ]
}

[!WARNING] Currently, ForwardWebSocket and Http are implemented based on HttpListener, which has the following problems:

  1. On Linux, the Host header of an Http request must match the value of Prefix unless it is + or *, so configure the Host of ForwardWebSocket and Http to be the domain name or IP you are using to access it.

  2. On Windows, the HttpListener is based on the http.sys implementation, so you need to register urlacl before using it. see netsh. You can also start Lagrange.OneBot using the administrator, at which point HttpListener will automatically register the required urlacl.

NOTICE BEFORE LOGIN

Known Problem

Thanks KonataDev/TheSnowfield for Provision of Signature API

Signature API is now not provided, you may need to find it somewhere and inherit SignProvider class for CustomSignProvider in BotConfig