|
1 |
| -<div align="center"> |
2 |
| - <img src="https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/icons/apple-icon.png" width="100" style="border-radius: 100%;" /> |
| 1 | +<center> |
| 2 | + <img src="https://raw.githubusercontent.com/Maseshi/Shioru/main/assets/icons/apple-icon.png" width="100" style="border-radius: 100%;" alt="Shioru" /> |
3 | 3 | <strong>
|
4 | 4 | <h1>Shioru</h1>
|
5 | 5 | <p>เลขาส่วนตัวใน Discord ที่จะช่วยทำให้กิลด์ของคุณน่าอยู่ยิ่งขึ้น</p>
|
6 | 6 | </strong>
|
7 |
| - <img src="https://img.shields.io/badge/discord.js-14-blue?logo=discord&logoColor=white |
8 |
| - " /> |
9 |
| - <img src="https://img.shields.io/github/last-commit/Maseshi/Shioru?logo=github |
10 |
| - " /> |
11 |
| - <img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fq60yrzp0cbgg.statuspage.io%2Fapi%2Fv2%2Fstatus.json&query=status.indicator&logo=google-cloud&logoColor=white&label=status&link=https%3A%2F%2Fshioru.statuspage.io%2F |
12 |
| - " /> |
13 |
| - <a title="Crowdin" target="_blank" href="https://crowdin.com/project/shioru"> |
14 |
| - <img src="https://badges.crowdin.net/shioru/localized.svg" /> |
| 7 | + <a href="https://shiorus.web.app/invite">เชิญชวน</a> |
| 8 | + | |
| 9 | + <a href="https://github.com/Maseshi/Shioru/tree/main/documents">เปลี่ยนภาษา</a> |
| 10 | + | |
| 11 | + <a href="https://shioru.statuspage.io/">สถานะ</a> |
| 12 | + | |
| 13 | + <a href="https://github.com/Maseshi/Shioru/tree/main/documents">ปรับปรุงการแปลภาษา</a> |
| 14 | + | |
| 15 | + <a href="https://top.gg/bot/704706906505347183">ให้คะแนน</a> |
| 16 | + <br /> |
| 17 | + <img src="https://img.shields.io/badge/discord.js-14-blue?logo=discord&logoColor=white" alt="Discord.js version 14" /> |
| 18 | + <img src="https://img.shields.io/github/last-commit/Maseshi/Shioru?logo=github" alt="Last commit" /> |
| 19 | + <img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fq60yrzp0cbgg.statuspage.io%2Fapi%2Fv2%2Fstatus.json&query=status.indicator&logo=google-cloud&logoColor=white&label=status&link=https%3A%2F%2Fshioru.statuspage.io%2F" alt="Status" /> |
| 20 | + <a title="Crowdin" href="https://crowdin.com/project/shioru"> |
| 21 | + <img src="https://badges.crowdin.net/shioru/localized.svg" alt="Crowdin" /> |
15 | 22 | </a>
|
16 |
| - <a title="CodeFactor" target="_blank" href="https://www.codefactor.io/repository/github/maseshi/shioru"> |
| 23 | + <a title="CodeFactor" href="https://www.codefactor.io/repository/github/maseshi/shioru"> |
17 | 24 | <img src="https://www.codefactor.io/repository/github/maseshi/shioru/badge" alt="CodeFactor" />
|
18 | 25 | </a>
|
19 |
| - <a title="Топ.гг" target="_blank" href="https://top.gg/bot/704706906505347183"> |
20 |
| - <img src="https://top.gg/api/widget/upvotes/704706906505347183.svg" /> |
| 26 | + <a title="Топ.гг" href="https://top.gg/bot/704706906505347183"> |
| 27 | + <img src="https://top.gg/api/widget/upvotes/704706906505347183.svg" alt="Top.gg" /> |
21 | 28 | </a>
|
22 |
| -</div> |
23 |
| - |
24 |
| -[เปลี่ยนภาษา](https://github.com/Maseshi/Shioru/tree/main/documents) |
| 29 | +</center> |
25 | 30 |
|
26 | 31 | เลขาส่วนตัวที่ดีที่สุดของคุณจะช่วยให้กิลด์ของคุณดูมีชีวิตชีวามากขึ้น เธอสามารถทำสิ่งต่าง ๆ ได้หลายอย่างซึ่งคุณสามารถดูรายละเอียดข้อมูลของคำสั่งทั้งหมด ได้ง่าย ๆ โดยพิมพ์ `/help`
|
27 | 32 |
|
28 |
| -<div align="center"> |
29 |
| - <a href="https://shiorus.web.app/invite"> |
30 |
| - <img src="https://img.shields.io/badge/Invite_Bot-_?style=for-the-badge&logo=discord&logoColor=white&color=blue |
31 |
| - " /> |
32 |
| - </a> |
33 |
| -</div> |
34 |
| - |
35 | 33 | ## ✨ คุณสมบัติเด่น
|
36 | 34 |
|
37 |
| -- Работи на [Discord.js](https://discord.js.org/) v14. |
38 |
| -- Възможност за персонализиране на различни желани елементи |
39 |
| -- Музиката може да се възпроизвежда от [YouTube](https://www.youtube.com/), [Spotify](https://www.spotify.com/) и [SoundCloud](https://soundcloud.com/) с автоматично възпроизвеждане. |
40 |
| -- Поддръжка на множество езици Можете да проверите поддържаните езици от[езикови](https://github.com/Maseshi/shioru/blob/main/source/languages)файлове на това хранилище. |
41 |
| -- Система на нива (ниво и опит) |
42 |
| -- Поддръжка за персонализиране на известията на сървъра |
43 |
| -- Можете да говорите, като напишете `@Shioru` , последвано от съобщението, което искате да комуникирате. |
44 |
| -- Може да се използва командата на приложението (/). |
45 |
| -- จำลองระบบฐานข้อมูลสำหรับทดสอบ |
46 |
| -- รองรับการทำงานบน Shard |
| 35 | +[ / ] ทำงานบน [Discord.js](https://discord.js.org/) v14 \ |
| 36 | +[ / ] อ่านง่าย ใช้งานง่ายและประสิทธิภาพสูง \ |
| 37 | +[ / ] สามารถปรับแต่งสิ่งที่ต้องการได้หลากหลายรายการ \ |
| 38 | +[ / ] มีคำสั่งทั้งหมดรวมถึงคำสั่งย่อยที่พร้อมใช้งานมากกว่า 100+ คำสั่ง \ |
| 39 | +[ / ] สามารถเล่นเพลงได้ทั้งจาก [YouTube](https://www.youtube.com/), [Spotify](https://www.spotify.com/), [SoundCloud](https://soundcloud.com/) และอีก [900+ เว็บไซต์](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md)พร้อมทั้งมีระบบเล่นเพลงต่อโดยอัตโนมัติ \ |
| 40 | +[ / ] รองรับหลายภาษา ซึ่งคุณสามารถตรวจสอบภาษาที่รองรับได้จาก[ไฟล์ภาษา](https://github.com/Maseshi/Shioru/blob/main/source/configs/languages.json)ของที่เก็บนี้ \ |
| 41 | +[ / ] ระบบระดับชั้น (เลเวลและค่าประสบการณ์) \ |
| 42 | +[ / ] รองรับการปรับแต่งการแจ้งเตือนของเซิร์ฟเวอร์ \ |
| 43 | +[ / ] สามารถพูดคุยได้โดยการพิมพ์ `@Shioru` ตามด้วยข้อความที่ต้องการสื่อสาร \ |
| 44 | +[ / ] รองรับการทำงานบน Shard หรือรองรับการทำงานในหลากหลายกิลด์ \ |
| 45 | +[ / ] สามารถใช้งานคำสั่งแอปพลิเคชั่น (/) ได้ \ |
| 46 | +[ / ] จำลองระบบฐานข้อมูลสำหรับทดสอบ |
47 | 47 |
|
48 | 48 | и много други интересни функции...
|
49 | 49 |
|
50 | 50 | ## 🧩 ข้อกำหนดเบื้องต้น
|
51 | 51 |
|
52 |
| -- [Node.js](https://nodejs.org/) v20.6.0 หรือมากกว่า |
53 |
| -- [Python](https://www.python.org/downloads/) v3.8.0 หรือมากกว่า |
54 |
| -- [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือมากกว่า |
55 |
| -- [Firebase Tools](https://firebase.google.com/docs/cli) |
56 |
| -- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) |
| 52 | +- [Node.js](https://nodejs.org/) v20.6.0 หรือสูงกว่า |
| 53 | +- [Firebase Tools](https://firebase.google.com/docs/cli) (ต้องการ [Java](https://www.oracle.com/java/technologies/downloads/) v11.0.0 หรือสูงกว่า) |
| 54 | +- [Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) (ต้องการ [Python](https://www.python.org/downloads/) v3.8.0 หรือสูงกว่า) |
57 | 55 | - [FFmpeg](https://www.ffmpeg.org/download.html)
|
58 | 56 | - [Git](https://git-scm.com/downloads)
|
59 | 57 |
|
|
106 | 104 | - Firebase จะให้ข้อมูลเกี่ยวกับการกำหนดค่าแก่คุณ นำค่าเหล่านี้ไปใช้กับไฟล์ `.env`
|
107 | 105 | - Отидете на **създаване > [база данни в реално време](https://console.firebase.google.com/u/0/project/_/database/data)** , за да създадете база данни за съхранение.
|
108 | 106 |
|
109 |
| -## 🪛 การพัฒนา |
| 107 | +## 🔥 เริ่มต้นใช้งาน |
110 | 108 |
|
111 |
| -- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดพัฒนา** |
112 |
| -- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run dev` |
| 109 | +มีหลากหลายทางเลือกให้เปิดใช้งานได้ หากคุณใช้ [Visual Studio Code](https://code.visualstudio.com/) คุณสามารถเลือกวิธีการทำงานได้ทันทีผ่านแท็บ Run and Debug (<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>D</kbd>) ส่วนการทำงานอื่น ๆ ให้ดูที่ Tasks (<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>B</kbd> และ <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> พิมพ์ `>Tasks: Run Task`) |
113 | 110 |
|
114 |
| -> [!NOTE] เมื่อคุณเข้าสู่โหมดการพัฒนา คุณลักษณะบางอย่างอาจถูกปิดใช้งาน เช่น การส่งสถิติ การอัปเดตข้อมูล เป็นต้น |
| 111 | +### 🪛 พัฒนา |
115 | 112 |
|
116 |
| -## ☕ จำลอง |
| 113 | +- เปิดเทอร์มินัลแล้วรันคำสั่ง `npm run dev` |
| 114 | + |
| 115 | +### ☕ จำลอง |
117 | 116 |
|
118 | 117 | ทดสอบการใช้งานจริงด้วยการทำงานที่คล้ายกับการใช้งานจริง โดยระบบจะคำนวณการแยกเศษของการทำงานตามจำนวนของกิลด์โดยอัตโนมัติ
|
119 | 118 |
|
120 |
| -- เปิดเทอร์มินัลแล้วรัน `npm run emulators` เพื่อจำลองระบบฐานข้อมูลใน**โหมดจำลอง** |
121 |
| -- เปิดเทอร์มินัลหน้าใหม่แล้วรันคำสั่ง `npm run serve` |
| 119 | +- เปิดเทอร์มินัลแล้วเพิ่มตัวแปรสภาพแวดล้อมทั้งหมดที่จำเป็น |
| 120 | + - สำหรับ Windows ใช้คำสั่ง `set variable=example` |
| 121 | + - สำหรับ Linux หรือ MacOS ใช้คำสั่ง `export variable=example` |
| 122 | +- รันคำสั่ง `npm run serve` |
122 | 123 |
|
123 |
| -> [!NOTE] คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ทำให้คุณสมบัติบางอย่างอาจไม่ทำงาน |
| 124 | +> [!NOTE] คุณจะเข้าสู่โหมดการพัฒนาโดยอัตโนมัติเนื่องจากเป็นการจำลองการใช้งานจริง ข้อมูลทั้งหมดจะไม่ได้รับการบันทึก |
124 | 125 |
|
125 |
| -## 🍵 ใช้งานจริง |
| 126 | +### 🍵 ใช้งานจริง |
126 | 127 |
|
127 | 128 | สำหรับการใช้งานจริงสามารถใช้คำสั่งหรือชุดคำสั่งที่เตรียมไว้ได้ตามปกติ ดังนี้:
|
128 | 129 |
|
129 | 130 | - บน Linux หรือ MacOS
|
130 | 131 |
|
131 | 132 | ```sh
|
132 |
| - # with command file (recommend) |
133 |
| - |
134 | 133 | sh start.sh || sudo sh start.sh
|
135 | 134 |
|
136 |
| - # or with call command |
| 135 | + # or |
137 | 136 |
|
138 | 137 | npm start
|
139 | 138 | ```
|
140 | 139 |
|
141 | 140 | - บน Windows
|
142 | 141 |
|
143 | 142 | ```bat
|
144 |
| - @REM with command file (recommend) |
145 |
| -
|
146 | 143 | ./start.bat
|
147 | 144 |
|
148 |
| - @REM or with call command |
| 145 | + @REM or |
149 | 146 |
|
150 | 147 | npm start
|
151 | 148 | ```
|
|
154 | 151 |
|
155 | 152 | การดำเนินการนี้จำเป็นต้องมี [Docker](https://www.docker.com/products/docker-desktop/)
|
156 | 153 |
|
157 |
| -- ใช้คำสั่ง `npm run docker:build` แล้วรอให้ทำงานเสร็จทั้งหมด |
158 |
| -- จากนั้นเปิดโปรแกรม Docker แล้วสั่งรันพร้อมกับใส่ข้อมูลสภาพแวดล้อมที่จำเป็น (env) หรือใช้คำสั่ง `npm run docker:run` แล้วรอจนบอททำงาน |
| 154 | +- เปิดเทอร์มินัลแล้วเพิ่มตัวแปรสภาพแวดล้อมทั้งหมดที่จำเป็น |
| 155 | + - สำหรับ Windows ใช้คำสั่ง `set variable=example` |
| 156 | + - สำหรับ Linux หรือ MacOS ใช้คำสั่ง `export variable=example` |
| 157 | +- ทำการสร้างอิมเมจโดยใช้คำสั่ง `npm run docker:build` หรือ `npm run docker:build:serve` สำหรับโหมดจำลองแล้วรอจนกว่าจะเสร็จสิ้นกระบวนการ |
| 158 | +- หลังจากสร้างอิมเมจสำเร็จแล้วให้รันโดยใช้คำสั่ง `npm run docker:run` หรือ `npm run docker:build:serve` สำหรับโหมดจำลอง |
159 | 159 |
|
160 |
| -> [!TIP] คุณสามารถตรวจสอบการทำงานได้โดยใช้คำสั่ง `docker ps -a` |
| 160 | +[เรียนรู้เพิ่มเติมเกี่ยวกับคำสั่ง Docker](https://docs.docker.com/reference/) |
161 | 161 |
|
162 | 162 | ## ⚡ แก้ไขปัญหาอย่างรวดเร็ว
|
163 | 163 |
|
164 | 164 | - `gyp ERR! stack Error: not found: make`
|
165 | 165 |
|
166 | 166 | ปัญหานี้อาจเกิดจาก **Build Tools** ติดตั้งไม่ถูกต้องหรืออาจยังไม่ได้ติดตั้ง วิธีแก้ไขปัญหานี้ให้ดูที่ส่วน[การติดตั้ง Build Tools](#1-ติดตั้ง-build-tools)
|
167 | 167 |
|
168 |
| -- `GrpcConnection RPC 'Write' stream 0x58a118ce error. Code: 14 Message: 14 UNAVAILABLE: No connection established. Last error: connect ECONNREFUSED 127.0.0.1:8080` |
169 |
| - |
170 |
| - เป็นไปได้ว่าคุณยังไม่ได้จำลองระบบฐานข้อมูลบนเครื่องในโหมดทดสอบ โดยคุณสามารถแก้ปัญหานี้ได้โดยปิดบอทแล้วรันคำสั่งดังนี้ในอีกหน้าหนึ่ง |
171 |
| - |
172 |
| - ```bat |
173 |
| - npm run emulators |
174 |
| - ``` |
175 |
| - |
176 | 168 | ## 🌐 ปรับปรุงการแปลภาษา
|
177 | 169 |
|
178 | 170 | и много други интересни функции...
|
|
0 commit comments