3.5 KiB
3.5 KiB
ErrorNoWatcher
ErrorNoWatcher is a Minecraft bot (written in Rust with azalea) that alerts you when players are near your base. You can customize the size and location of your base, change the players that will receive a private message in-game, and even run custom shell commands! It also has other features such as an entity finder, a pathfinder that can follow players and go to coordinates, the ability to interact with blocks, a scripting system to run commands from a file, the ability to accept and respond to commands from Matrix, and much more.
Compiling
git clone https://github.com/ErrorNoInternet/ErrorNoWatcher
cd ErrorNoWatcher
cargo build --release
The compiled executable can be found at ./target/release/errornowatcher
Usage
Configuration
Running the bot will create the bot_configuration.toml file, where you can change several options:
username = "<bot's username>" # offline username
server_address = "<server address>"
register_keyword = "Register using"
register_command = "register MyPassword MyPassword"
login_keyword = "Login using"
login_command = "login MyPassword"
bot_owners = ["ErrorNoInternet", "<Minecraft usernames that are allowed to run commands>"]
whitelist = [
"ErrorNoInternet",
"<won't be triggered by the alert system>"
]
alert_players = ["ErrorNoInternet", "<players to send a message to>"]
alert_location = [0, 0] # coordinates of your base (X and Y position)
alert_radius = 192 # the radius of your base (-192, -192 to 192, 192)
alert_command = [
"curl",
"-s",
"-m 5",
"-HTitle: Intruder Alert",
"-HPriority: urgent",
"-HTags: warning",
"-d{player_name} is near your base! Their coordinates are {x} {y} {z}.",
"<your URL here (or a service such as ntfy.sh)>"
]
alert_pause_time = 5 # the amount of seconds to wait between alert messages
cleanup_interval = 300 # the amount of seconds to wait before checking for idle entities
mob_expiry_time = 300 # the maximum amount of time a mob can stay idle before getting cleared
mob_packet_drop_level = 5 # the amount of mob packets to drop (0 = 0%, 5 = 50%, 10 = 100%)
[matrix]
enabled = false
homeserver_url = "https://matrix.example.com"
username = "errornowatcher"
password = "MyMatrixPassword"
bot_owners = ["@zenderking:envs.net", "<Matrix user IDs that are allowed to run commands>"]
Example commands
/msg ErrorNoWatcher help 1- list the first page of usable commands/msg ErrorNoWatcher bot_status- display the bot's health, food & saturation levels, etc/msg ErrorNoWatcher goto 20 64 10- go to X20 Y64 Z10 (using the pathfinder)/msg ErrorNoWatcher script sleep.txt- run all commands in the filesleep.txt/msg ErrorNoWatcher attack ErrorNoInternet- attack the player named ErrorNoInternet/msg ErrorNoWatcher look 180 0- rotate the bot's head to 180 (yaw) 0 (pitch)/msg ErrorNoWatcher whitelist_add Notch- temporarily add Notch to the whitelist/msg ErrorNoWatcher sprint forward 5000- sprint forward for 5 seconds/msg ErrorNoWatcher drop_item- drop the currently held item (ordrop_stack)/msg ErrorNoWatcher last_location 1- show the first page of players sorted by join time/msg ErrorNoWatcher last_location ErrorNoInternet- display the last seen location/msg ErrorNoWatcher follow_player ErrorNoInternet- start following ErrorNoInternet/msg ErrorNoWatcher slot 1- switch to the first inventory slot (hold the item)