@@ -14,186 +14,34 @@ PteroStats is a Discord App/Bot designed to check Pterodactyl or Pelican Panel s
14
14
15
15
<img alt =" PteroStats Console Preview " src =" https://usercontent.catto.pictures/hirzi/8ce3aac6-5c46-4626-bd14-af994b602f8e.png " width =" 300 " />
16
16
17
- <img alt =" PteroStats GIF Preview " src =" https://usercontent.catto.pictures/hirzi/ad6e36cc-b582-460b-ab4e-b5e1dacd8b02.gif " width =" 300 " />
18
-
19
17
## Guide
20
18
- [ Starting the App/Bot] ( #starting-the-appbot )
21
- - [ Changing Env Configuration] ( #changing-env-configuration )
22
- - [ Getting an Panel API key] ( #getting-panel-api-key )
23
- - [ Getting a Channel ID] ( #getting-channel-id )
24
- - [ Using Custom Emoji] ( #using-custom-emoji )
25
- - [ Blacklist Nodes] ( #blacklist-nodes )
26
- - [ Notifier] ( #notifier )
27
- - [ Docker] ( #docker )
28
- - [ Installation] ( #installation )
29
- - [ Docker Compose] ( #docker-compose )
30
- - [ Docker Run] ( #docker-run )
19
+ - [ Changing Env Configuration] ( https://github.com/HirziDevs/PteroStats/blob/main/guide/changing-env-configuration.md )
20
+ - [ Getting an Panel API key] ( https://github.com/HirziDevs/PteroStats/blob/main/guide/getting-panel-api-key.md )
21
+ - [ Getting a Channel ID] ( https://github.com/HirziDevs/PteroStats/blob/main/guide/getting-channel-id.md )
22
+ - [ Using Custom Emoji] ( https://github.com/HirziDevs/PteroStats/blob/main/guide/using-custom-emoji.md )
23
+ - [ Blacklist Nodes] ( https://github.com/HirziDevs/PteroStats/blob/main/guide/blacklist-specific-nodes.md )
24
+ - [ Notifier] ( https://github.com/HirziDevs/PteroStats/blob/main/guide/notifier.md )
25
+ - [ Docker] ( https://github.com/HirziDevs/PteroStats/blob/main/guide/docker.md )
31
26
32
27
### Starting the App/Bot
33
28
1 . [ Create your Discord App/Bot] ( https://discordjs.guide/preparations/adding-your-bot-to-servers.html ) .
34
29
2 . [ Invite your Discord App/Bot to your Discord server] ( https://discordjs.guide/preparations/adding-your-bot-to-servers.html ) .
35
30
3 . Download this repository:
36
- - [ Download this repository] ( https://github.com/HirziDevs/PteroStats/archive/refs/heads/main.zip ) and extract it.
31
+ - Manually: [ Download this repository] ( https://github.com/HirziDevs/PteroStats/archive/refs/heads/main.zip ) and extract it.
37
32
- Using Git: Run ` git clone https://github.com/HirziDevs/PteroStats.git ` in the command line.
38
33
4 . Run ` npm install ` in the root directory of the app/bot files.
39
- 5 . Run ` node index ` and answer the prompted questions to set up the app/bot.
34
+ 5 . Run ` node index.js ` and answer the prompted questions to set up the app/bot.
40
35
41
36
<img alt =" Setup " src =" https://usercontent.catto.pictures/hirzi/b8645828-591d-4d52-b6d8-51f8df60440c.png " width =" 300 " />
42
37
43
- - [ Getting Panel API Key ] ( # getting-panel-api-key)
44
- - [ Getting a Channel ID] ( # getting-channel-id)
38
+ - [ Getting an Panel API key ] ( https://github.com/HirziDevs/PteroStats/blob/main/guide/ getting-panel-api-key.md )
39
+ - [ Getting a Channel ID] ( https://github.com/HirziDevs/PteroStats/blob/main/guide/ getting-channel-id.md )
45
40
46
- 6 . Run ` node index ` if you want to start the app/bot again, and you're done!
41
+ 6 . Run ` node index.js ` if you want to start the app/bot again, and you're done!
47
42
48
43
<img alt =" Console Logging " src =" https://usercontent.catto.pictures/hirzi/8ce3aac6-5c46-4626-bd14-af994b602f8e.png " width =" 300 " />
49
44
50
- ### Changing Env Configuration
51
- > [ !TIP]
52
- > You can change other configuration at the ` config.yml ` file.
53
-
54
- 1 . Run ` node setup ` in the root directory of the app/bot files.
55
- 2 . Enter ` 2 ` to change configuration.
56
-
57
- <img alt =" Change Configuration " src =" https://usercontent.catto.pictures/hirzi/f61ebf43-3df8-4b86-93ac-166e2de1edcd.png " width =" 300 " />
58
-
59
- 3 . Answer the provided question to set up the app/bot.
60
- 4 . Run ` node index ` if you want to start the app/bot again, and you're done!
61
-
62
- ### Getting Panel API Key
63
- > [ !WARNING]
64
- > The use of Application API keys is ** deprecated** ; you should use ** Client API keys** .
65
-
66
- > [ !TIP]
67
- > Make sure the owner of the Client API key has access to the administrator panel.
68
-
69
- 1 . Go to your ` Pterodactyl ` or ` Pelican ` Panel and navigate to the ` Account Page ` .
70
-
71
- <img alt =" Home " src =" https://usercontent.catto.pictures/hirzi/6d3e4c63-c5e8-4d94-9d78-07bb937b1dbd.png " width =" 400 " />
72
-
73
- 2 . Click on the ` API Credentials ` button.
74
-
75
- <img alt =" Account Page " src =" https://usercontent.catto.pictures/hirzi/0a2327ee-243a-4dd1-86f4-549f1ab8a91c.png " width =" 400 " />
76
-
77
- 3 . Fill in the ` Description ` and click the ` Create ` button.
78
-
79
- <img alt =" Create Client API Key " src =" https://usercontent.catto.pictures/hirzi/7fcf5b7e-0087-4cf2-9e57-fed01292fd10.png " width =" 400 " />
80
-
81
- 4 . Copy the API key.
82
-
83
- <img alt =" API Key " src =" https://usercontent.catto.pictures/hirzi/267cf48a-7229-4bb6-8c77-7d0c0884f6ba.png " width =" 400 " />
84
-
85
- ### Getting Channel ID
86
- 1 . Enable Developer Mode in your Discord settings.
87
-
88
- <img alt =" Discord User Settings " src =" https://usercontent.catto.pictures/hirzi/36894499-b141-488f-98ed-40245c8f6862.png " width =" 400 " />
89
-
90
- 2 . Right-click the text channel and select ` Copy ID ` .
91
-
92
- <img alt =" Right Click Channel " src =" https://usercontent.catto.pictures/hirzi/9f8352da-df5b-4587-9594-ced9b11a5507.png " width =" 250 " />
93
-
94
- ### Using Custom Emoji
95
- 1 . Type ` \ ` in the server that has the custom emoji you want.
96
-
97
- <img alt =" Type \ on the chat " src =" https://usercontent.catto.pictures/hirzi/2e3c821f-92f9-4b5c-863a-e020b2fbc426.png " width =" 350 " />
98
-
99
- 2 . Select the custom emoji you want.
100
-
101
- <img alt =" Select Custom Emoji " src =" https://usercontent.catto.pictures/hirzi/7c071727-2adb-4c8c-91d3-21664948a334.png " width =" 300 " />
102
-
103
- 3 . Copy the text!
104
-
105
- <img alt =" Copy Emoji ID " src =" https://usercontent.catto.pictures/hirzi/bd0084ac-f11b-413d-8b66-580efc011908.png " width =" 400 " />
106
-
107
- 4 . Paste the emoji ID into the config.
108
-
109
- <img alt =" Status Config " src =" https://usercontent.catto.pictures/hirzi/369cf7af-ae32-4193-9b09-195ba6f71f62.png " width =" 400 " />
110
-
111
- ### Blacklist Nodes
112
- 1 . Select a node from the node list on the admin page.
113
-
114
- <img alt =" Pterodactyl Nodes List " src =" https://usercontent.catto.pictures/hirzi/5699fdbd-7c3c-4fa5-ae2c-d0ccb39cb69e.png " width =" 400 " />
115
-
116
- <img alt =" Pelican Nodes List " src =" https://usercontent.catto.pictures/hirzi/5994fbf0-03ac-4196-9bb5-e945401f204e.png " width =" 400 " />
117
-
118
- 2 . Check the URL and copy the node ID.
119
-
120
- <img alt =" Pterodactyl Node ID " src =" https://usercontent.catto.pictures/hirzi/45f855fc-6d96-4b23-a96e-892071189d01.png " width =" 400 " />
121
-
122
- <img alt =" Pelican Node ID " src =" https://usercontent.catto.pictures/hirzi/0ff8d9fc-6125-4fbb-8e19-ff8743cd365c.png " width =" 400 " />
123
-
124
- 3 . Paste the ID into the blacklist in the config.
125
-
126
- <img alt =" Blacklist Config " src =" https://usercontent.catto.pictures/hirzi/bfae6a04-8dad-4db1-b3d8-05e6db691516.png " width =" 400 " />
127
-
128
- > [ !TIP]
129
- > You can add more than one node to the blacklist.
130
-
131
- <img alt =" Blacklist Config " src =" https://usercontent.catto.pictures/hirzi/7b5d6c7f-54d9-40ea-b5a6-9192325ba2a0.png " width =" 400 " />
132
-
133
- ## Links
134
- =======
135
- ### Notifier
136
- Get a notification on Discord when your panel or specific nodes are currently down.
137
-
138
- <img alt =" Notifier Preview " src =" https://usercontent.catto.pictures/hirzi/a2b8e36f-7448-4849-a14a-b1eb4ec8fb26.png " width =" 250 " />
139
-
140
-
141
- #### Enabling Notifier
142
- Open ` config.yml ` and set ` enable ` at the notifier configuration to ` true `
143
-
144
- <img alt =" Notifier Config " src =" https://usercontent.catto.pictures/hirzi/b4c3f1d0-e053-402c-8401-4de44926fce6.png " width =" 300 " />
145
-
146
- #### Getting Discord Webhook URL
147
- 1 . Go to the channel settings of the channel you want to set for the notifier.
148
-
149
- <img alt =" Notifier Config " src =" https://usercontent.catto.pictures/hirzi/7d7712b9-d9ac-4650-83ac-21dc3f20c3fe.png " width =" 300 " />
150
-
151
- 2 . Go to integrations and select ` View Webhooks ` or ` Create Webhook ` .
152
-
153
- <img alt =" Notifier Config " src =" https://usercontent.catto.pictures/hirzi/e251f1e9-6b46-4051-be64-1945a6eaee33.png " width =" 300 " />
154
-
155
- 3 . Create a new webhook and copy the Webhook URL
156
-
157
- <img alt =" Notifier Config " src =" https://usercontent.catto.pictures/hirzi/e0af8410-527a-42e2-b284-48d7eb81456f.png " width =" 300 " />
158
-
159
- 4 . Paste the Webhook URL on the webhook notifier configuration.
160
-
161
- <img alt =" Notifier Config " src =" https://usercontent.catto.pictures/hirzi/b4ec26ad-e426-434e-b8c8-27ddc2916f5f.png " width =" 300 " />
162
-
163
-
164
- > [ !TIP]
165
- > You can change the webhook icon and username on the webhook settings.
166
-
167
- <img alt =" Notifier Config " src =" https://usercontent.catto.pictures/hirzi/2a4f7aba-9377-4722-bf19-3b7f0cc32772.png " width =" 300 " />
168
-
169
- ## Docker
170
-
171
- This is a guide to run the bot using docker (alternative way to run the bot)
172
-
173
- ### Installation
174
-
175
- ``` bash
176
- curl -fsSL https://get.docker.com | sh
177
- ```
178
-
179
- ### Docker Compose
180
-
181
- Copy the ` docker-compose.yml ` file to your server and run ` docker compose pull `
182
- Copy the ` config.yml ` file at the same directory as the ` docker-compose.yml ` file and configure it
183
- Fill the environment variables in the ` docker-compose.yml ` file and run the bot using ` docker compose up -d `
184
-
185
- ``` bash
186
- docker compose up -d
187
- docker compose logs -f pterostats
188
- ```
189
-
190
- ### Docker Run
191
-
192
- ``` bash
193
- docker run -d --name pterostats -e PanelURL=< PanelURL> -e PanelKEY=< PanelKEY> -e DiscordBotToken=< DISCORD_BOT_TOKEN> -e DiscordChannel=< DISCORD_CHANNEL_ID> -v $( pwd) /config.yml:/app/config.yml ghcr.io/hirzidevs/pterostats:latest
194
- docker logs -f pterostats
195
- ```
196
-
197
45
## Reporting a Bug
198
46
Enable ` log_error ` in the ` config.yml ` file and check the console for the error message. After that, report it to our Discord server at [ Support Server] ( https://discord.znproject.my.id ) .
199
47
0 commit comments