Skip to content

Commit ab65824

Browse files
committed
HARD reset README before change
1 parent 2741cb0 commit ab65824

File tree

1 file changed

+12
-164
lines changed

1 file changed

+12
-164
lines changed

README.md

+12-164
Original file line numberDiff line numberDiff line change
@@ -14,186 +14,34 @@ PteroStats is a Discord App/Bot designed to check Pterodactyl or Pelican Panel s
1414

1515
<img alt="PteroStats Console Preview" src="https://usercontent.catto.pictures/hirzi/8ce3aac6-5c46-4626-bd14-af994b602f8e.png" width="300"/>
1616

17-
<img alt="PteroStats GIF Preview" src="https://usercontent.catto.pictures/hirzi/ad6e36cc-b582-460b-ab4e-b5e1dacd8b02.gif" width="300"/>
18-
1917
## Guide
2018
- [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)
3126

3227
### Starting the App/Bot
3328
1. [Create your Discord App/Bot](https://discordjs.guide/preparations/adding-your-bot-to-servers.html).
3429
2. [Invite your Discord App/Bot to your Discord server](https://discordjs.guide/preparations/adding-your-bot-to-servers.html).
3530
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.
3732
- Using Git: Run `git clone https://github.com/HirziDevs/PteroStats.git` in the command line.
3833
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.
4035

4136
<img alt="Setup" src="https://usercontent.catto.pictures/hirzi/b8645828-591d-4d52-b6d8-51f8df60440c.png" width="300"/>
4237

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)
4540

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!
4742

4843
<img alt="Console Logging" src="https://usercontent.catto.pictures/hirzi/8ce3aac6-5c46-4626-bd14-af994b602f8e.png" width="300"/>
4944

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-
19745
## Reporting a Bug
19846
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).
19947

0 commit comments

Comments
 (0)