rizzlogy / aterbot

AterBot ✨

Keep your Aternos server alive 24/7.

Please star this project <3

Important Notice 📢

This project will be unmaintained until at least 2024.
But you can use it as usual.

Requirements 🎒

1. A Replit account.
   Sign up at: https://replit.com/signup

2. An UptimeRobot account.
   Sign up at: https://uptimerobot.com/signUp

3. A Minecraft server you owned.
   Make sure your server settings online-mode set to false!
   And you should have an OP permission!

Setup ⚙

1. Join your server.
2. Build a bedrock room somewhere, and stay in there.
   (Recommended room size: X5 Y3 Z5)
3. Go to Replit.
4. Click + at the top right, click Import from GitHub at the close button.
5. Put https://github.com/JadeMin/aterbot.git into GitHub URL, click Create Repl.
6. Click Run at the top, your bot will join your server.
7. Teleport the bot into the bedrock room, change the bot's gamemode to Creative to not die!
8. You'll see the Webview tab on Repl, copy the url.
9. Go to UptimeRobot.
10. Click Add New Monitor, select Monitor Type to HTTP(s).
11. Paste the url copied in Step 8 into URL (or IP).
12. Click Create Monitor 2 times.

Finally... DONE! Enjoy your free 24/7 Aternos server.

FAQ ❓

Q1: My bot leaves immediately when I close the Repl page.

A1:

Repl projects are automatically turned off when close the window, or after 5 minutes of inactivity.
And UptimeRobot trying to wake it up in every 5 minutes.
So you can just leave it even if it's not working for a while.

---

Q2: How to fix unsupported/unknown protocol version: ###, update minecraft-data?

A2:

This project is using the mineflayer module.
It may not supported on your server version yet.
I'm trying to periodically check for updates, so please be patient.

---

Q3: How to fix Invalid move player packet received?

A3:

It seems your bot escaped from the bedrock room.
So you have to wipe the playerdata in your server.

1. Go to the management page of your Aternos server.
2. Click Files in the left section.
3. Delete the world/playerdata/<UUID>.dat, <UUID>.dat_old file. (the UUID is your bot's UUID)
4. Restart the bot.

Lock the bot somewhere as soon as possible!
And change the bot's gamemode to Creative to not die.

---

Q4: My bot leaves permanently after n hours.

A4:

Aternos automatically bans AFK players from your server.
So just unban your bot, if it's banned.

CAUTION ⚠

Aternos might detect your suspicious actions and delete your account!

By using this, you acknowledge that you're responsible for any problems arise.