Lagrange.Core
0.1.9-alpha
See the version list below for details.
dotnet add package Lagrange.Core --version 0.1.9-alpha
NuGet\Install-Package Lagrange.Core -Version 0.1.9-alpha
<PackageReference Include="Lagrange.Core" Version="0.1.9-alpha" />
paket add Lagrange.Core --version 0.1.9-alpha
#r "nuget: Lagrange.Core, 0.1.9-alpha"
// Install Lagrange.Core as a Cake Addin #addin nuget:?package=Lagrange.Core&version=0.1.9-alpha&prerelease // Install Lagrange.Core as a Cake Tool #tool nuget:?package=Lagrange.Core&version=0.1.9-alpha&prerelease
<div align="center">
Lagrange.Core
An Implementation of NTQQ Protocol, with Pure C#, Derived from Konata.Core
</div>
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.
Features List
Protocol | Support | Login | Support | Messages | Support | Operations | Support | Events | Support |
---|---|---|---|---|---|---|---|---|---|
Windows | 🟢 | QrCode | 🟢 | Images | 🟢 | 🔴 | Captcha | 🟢 | |
macOS | 🟢 | Password | 🟢 | Text / At | 🟢 | Recall | 🟡 | BotOnline | 🟢 |
Linux | 🟢 | EasyLogin | 🟢 | 🔴 | Leave Group | 🟢 | BotOffline | 🟢 | |
UnusalDevice<br/>Password | 🔴 | QFace | 🟢 | 🔴 | Message | 🟢 | |||
UnusalDevice<br/>Easy | 🟢 | Json | 🟡 | Kick Member | 🟢 | 🔴 | |||
NewDeviceVerify | 🔴 | Xml | 🟢 | Mute Member | 🟢 | MessageRecall | 🔴 | ||
Forward | 🟢 | Set Admin | 🟢 | GroupMemberDecrease | 🟢 | ||||
Video | 🔴 | Friend Request | 🔴 | GroupMemberIncrease | 🟢 | ||||
🔴 | Group Request | 🔴 | GroupPromoteAdmin | 🟢 | |||||
Reply | 🟢 | 🔴 | GroupInvite | 🟢 | |||||
File | 🟡 | Client Key | 🟢 | GroupRequestJoin | 🔴 | ||||
Cookies | 🟢 | FriendRequest | 🔴 | ||||||
Send Message | 🟢 | 🔴 | |||||||
🔴 |
Lagrange.OneBot
Implementation - OneBot v11
<Details> <Summary>Message Segement</Summary>
Message Segement | Support |
---|---|
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>
API | Support |
---|---|
/send_private_msg | 🟢 |
/send_group_msg | 🟢 |
/send_msg | 🟢 |
/delete_msg | 🔴 |
/get_msg | 🔴 |
/get_forward_msg | 🔴 |
🔴 | |
/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>
PostType | EventName | Support |
---|---|---|
Message | Private Message | 🔴 |
Message | Group Message | 🟢 |
Notice | Group File Upload | 🔴 |
Notice | Group Admin Change | 🔴 |
Notice | Group Member Decrease | 🔴 |
Notice | Group Member Increase | 🔴 |
Notice | Group Mute | 🔴 |
Notice | Friend Add | 🔴 |
Notice | Group Recall Message | 🔴 |
Notice | Friend Recall Message | 🔴 |
Notice | Group Poke | 🔴 |
Notice | Group red envelope luck king | 🔴 |
Notice | Group Member Honor Changed | 🔴 |
Request | Add Friend Request | 🔴 |
Request | Group Request/Invitations | 🔴 |
Meta | LifeCycle | 🟢 |
Meta | Heartbeat | 🟢 |
</Details>
<Details> <Summary>Communication</Summary>
CommunicationType | Support |
---|---|
Http | 🔴 |
Http-Post | 🟢 |
ForwardWebSocket | 🟢 |
ReverseWebSocket | 🟢 |
</Details>
appsettings.json Example
{
"Logging": {
"LogLevel": {
"Default": "Trace",
"Microsoft": "Warning",
"Microsoft.Hosting.Lifetime": "Information"
}
},
"SignServerUrl": "",
"Account": {
"Uin": 0,
"Password": "",
"Protocol": "Linux",
"AutoReconnect": true,
"GetOptimumServer": true
},
"Implementation": {
"ForwardWebSocket": {
"Host": "127.0.0.1",
"Port": 8081,
"HeartBeatInterval": 5000,
"AccessToken": ""
},
"ReverseWebSocket": {
"Host": "127.0.0.1",
"Port": 8080,
"Suffix": "/onebot/v11/ws",
"ReconnectInterval": 5000,
"HeartBeatInterval": 5000,
"AccessToken": ""
},
"Http": {
"Host": "",
"Port": 0,
"EventEnabled": false
},
"HttpPost": {
"Host": "127.0.0.1",
"Port": 8080,
"Suffix": "/onebot/v11/http",
"Timeout": 0
}
}
}
- Create a file named 'appsettings.json' under Lagrange.OneBot executable directory
- As the Password is empty here, this indicates that QRCode login is used
- After the QRCode Login, write Uin back to perform EasyLogin
- If you want a multi connection, remove the 'Implementation' Part and add
{ "Implementations": [
{
"Type": "ReverseWebsocket",
"Host": "127.0.0.1",
"Port": 8080,
"Suffix": "/onebot/v11/ws",
"ReconnectInterval": 5000,
"HeartBeatInterval": 5000,
"AccessToken": ""
},
{
"Type": "ReverseWebsocket",
"Host": "127.0.0.1",
"Port": 8081,
"HeartBeatInterval": 5000,
"AccessToken": ""
}
]
}
Known Problem
- [ ] Signature Service is currently not established, so the login tend to be failed and return code may be 45, you can establish your own sign service by rewriting the Signature
static class.
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
- Signature of Windows and macOS is missing, you need to figure out by your self
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net6.0
- protobuf-net (>= 3.2.16)
- System.Text.Json (>= 7.0.2)
NuGet packages (3)
Showing the top 3 NuGet packages that depend on Lagrange.Core:
Package | Downloads |
---|---|
Lagrange.XocMat
Package Description |
|
NoNameBot
A Bot framework based on Lagrange |
|
ALBot.PluginExtension
Plugin extension of ALBot |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
0.3.1 | 386 | 10/6/2024 |
0.3.0 | 312 | 7/25/2024 |
0.2.3 | 83 | 7/25/2024 |
0.2.2 | 330 | 6/11/2024 |
0.2.1 | 521 | 3/19/2024 |
0.2.0 | 118 | 3/18/2024 |
0.1.17-alpha | 104 | 2/27/2024 |
0.1.16-alpha | 95 | 2/26/2024 |
0.1.15-alpha | 85 | 2/26/2024 |
0.1.14-alpha | 110 | 2/9/2024 |
0.1.13-alpha | 158 | 1/5/2024 |
0.1.12-alpha | 123 | 12/23/2023 |
0.1.11-alpha | 104 | 12/19/2023 |
0.1.10-alpha | 218 | 11/11/2023 |
0.1.9-alpha | 132 | 10/29/2023 |
0.1.8-alpha | 136 | 10/11/2023 |
0.1.7-alpha | 108 | 10/11/2023 |
0.1.6-alpha | 117 | 10/8/2023 |
0.1.5-alpha | 110 | 10/7/2023 |
0.1.4-alpha | 103 | 9/28/2023 |
0.1.3-alpha | 108 | 9/23/2023 |
0.1.2-alpha | 115 | 8/31/2023 |
0.1.1-alpha | 124 | 8/30/2023 |
0.1.0-alpha | 114 | 8/27/2023 |
0.0.9-alpha | 109 | 8/24/2023 |
0.0.8-alpha | 108 | 8/22/2023 |
0.0.7-alpha | 111 | 8/20/2023 |
0.0.6-alpha | 124 | 8/11/2023 |
0.0.5-alpha | 129 | 8/11/2023 |
0.0.4-alpha | 113 | 7/29/2023 |
0.0.3-alpha | 115 | 7/27/2023 |
0.0.2 | 147 | 3/3/2024 |
0.0.2-alpha | 122 | 7/24/2023 |
0.0.1-alpha | 121 | 6/29/2023 |