mirror of
https://github.com/langbot-app/LangBot.git
synced 2026-11-02 05:45:20 +08:00
39 lines
4.0 KiB
Markdown
39 lines
4.0 KiB
Markdown
# MCBotPlugin
|
|
|
|
ปลั๊กอิน LangBot สำหรับกลุ่มแชทเซิร์ฟเวอร์ Minecraft: ผูกเซิร์ฟเวอร์เข้ากับกลุ่ม สอบถามสถานะเซิร์ฟเวอร์แบบเรียลไทม์และผู้เล่นออนไลน์ และติดตามเวลาเล่นของผู้เล่นแต่ละคน
|
|
|
|
> นี่คือเวอร์ชันที่ย้าย [MCBotPlugin](https://github.com/langbot-app/MCBotPlugin) รุ่นเก่า (สร้างสำหรับ QChatGPT) มายัง LangBot plugin SDK ใหม่ พื้นที่จัดเก็บถูกเปลี่ยนจาก MongoDB เป็น KV storage ในตัวของปลั๊กอิน (ไม่ต้องใช้ฐานข้อมูลภายนอก) การสอบถามสถานะ Minecraft เปลี่ยนจาก `mctools` แบบ synchronous เป็น `mcstatus` แบบ asynchronous และการสุ่มเก็บเวลาเล่นในเบื้องหลังเปลี่ยนจาก thread เป็น asyncio task
|
|
|
|
## ฟีเจอร์
|
|
|
|
- **ผูกเซิร์ฟเวอร์**: แต่ละกลุ่มผูกเซิร์ฟเวอร์ Minecraft (Java Edition) ได้หนึ่งเครื่อง
|
|
- **สอบถามสถานะ**: ดู MOTD เวอร์ชัน จำนวนผู้เล่นออนไลน์ และรายชื่อผู้เล่นแบบเรียลไทม์
|
|
- **สถิติเวลาเล่น**: งานเบื้องหลังสุ่มเก็บข้อมูลผู้เล่นออนไลน์ และรวมเวลาออนไลน์ของผู้เล่นแต่ละคนในช่วงเวลาใดก็ได้
|
|
|
|
## คำสั่ง
|
|
|
|
| คำสั่ง | คำอธิบาย | สิทธิ์ |
|
|
| --- | --- | --- |
|
|
| `!mcbot` | แสดงความช่วยเหลือ | ทุกคน |
|
|
| `!mcbot bind <ที่อยู่[:พอร์ต]>` | ผูกเซิร์ฟเวอร์เข้ากับกลุ่มนี้ | ผู้ดูแล |
|
|
| `!mcbot unbind` | ยกเลิกการผูกเซิร์ฟเวอร์ | ผู้ดูแล |
|
|
| `!mcbot status` | แสดงสถานะเซิร์ฟเวอร์และผู้เล่นออนไลน์ | ทุกคน |
|
|
| `!mcbot time [นาที]` | แสดงสถิติเวลาเล่น (ค่าเริ่มต้น 1440 นาที = 24 ชม.) | ทุกคน |
|
|
|
|
> ผู้ดูแลกำหนดจากการตั้งค่า `admins` ของ LangBot (`{launcher_type}_{launcher_id}`)
|
|
|
|
## การตั้งค่า
|
|
|
|
| คีย์ | คำอธิบาย | ค่าเริ่มต้น |
|
|
| --- | --- | --- |
|
|
| `track_interval` | ช่วงเวลาสุ่มเก็บข้อมูลผู้เล่นออนไลน์ (วินาที) ขั้นต่ำ 15 | 60 |
|
|
| `ping_timeout` | เวลา timeout ในการ ping เซิร์ฟเวอร์ (วินาที) | 10 |
|
|
|
|
## สิ่งที่ต้องพึ่งพา
|
|
|
|
- [`mcstatus`](https://github.com/py-mine/mcstatus) —— การสอบถามสถานะเซิร์ฟเวอร์ Minecraft
|
|
|
|
## การจัดเก็บข้อมูล
|
|
|
|
ข้อมูลการผูกและบันทึกการออนไลน์ถูกเก็บไว้ใน KV storage ในตัวของปลั๊กอิน LangBot ไม่ต้องใช้ MongoDB บันทึกการออนไลน์จะถูกเก็บไว้ 14 วันโดยค่าเริ่มต้น
|