The 10th and 11th versions of my Minecraft bot.
Find a file
2024-09-21 14:58:34 -04:00
commands Rename userSettingsDisabled to disableUserSettings 2024-09-21 14:58:34 -04:00
lang Seperate the chat parsers from the chat file & add message subtypes to the command class 2024-09-19 00:31:15 -04:00
plugins Rename userSettingsDisabled to disableUserSettings 2024-09-21 14:58:34 -04:00
util Rename userSettingsDisabled to disableUserSettings 2024-09-21 14:58:34 -04:00
.gitignore Add this to gitignore 2024-08-15 12:53:41 -04:00
index.js Rename userSettingsDisabled to disableUserSettings 2024-09-21 14:58:34 -04:00
launch.cmd This better not say 0 commits 2024-08-12 04:33:43 -04:00
launch.sh This better not say 0 commits 2024-08-12 04:33:43 -04:00
LICENSE This better not say 0 commits 2024-08-12 04:33:43 -04:00
package-lock.json Update packages 2024-09-14 12:50:39 -04:00
package.json Bump version 2024-09-14 12:48:13 -04:00
README.md Update wording 2024-09-20 00:19:38 -04:00
secret_example.json Change file permissions to 755 2024-09-12 00:53:24 -04:00
settings_example.json Remove settings location from example settings 2024-08-25 21:32:59 -04:00
version.json Change author 2024-09-18 03:07:59 -04:00

owobot

owobot is a Minecraft bot originally designed for Kaboom and its clones. It has many of the features that you would expect in a modern Kaboom bot:

  • commands (obviously)
  • a self care system
  • a command core, to run commands quickly
  • a hashing system, to enable trusted users to securely run certain commands in chat

It supports all Minecraft versions from 1.9 to 1.20.4 that are supported by node-minecraft-protocol.

If you are not sure if this code is safe to run, you can read through every line of code. You can also see the commit history by clicking on the (n) commits button, to make sure nobody has added any exploits or introduced vulnerabilities to the code.

If you find any exploits, security issues, etc in the code, please send me an issue or pull request and I will try to respond to it as soon as possible.

How to install?

  1. Install Node.js for your operating system.
  2. Download the latest release, or alternatively, download the latest development version using git clone https://code.chipmunk.land/7cc5c4f330d47060/owobot.
  3. Extract the files if necessary.
  4. Run npm install in the bot's directory. If it doesn't work, try using the Node.js command prompt, or adding Node.js to your PATH.
  5. Copy settings_example.json to settings.json and secret_example.json to secret.json, and adjust the settings to fit your needs. Change the example keys in secret.json as well.
  6. Run ./launch.sh (macOS, Linux, FreeBSD) or ./launch.cmd (Windows). This will start a bot launcher, which will restart the bot when the process closes. Alternatively, you can run node index.js to start the bot only once (it will still rejoin when kicked). If it displays an error saying node is not a command, please make sure Node.js is on your PATH.

Command list

Name Usage Description
about [serverlist | servers | server] About the bot. May also show system information or a list of connected servers.
cb <command> Run a command in a command block
cloop add , remove , list, clear Manage command loops
eval <code> Run JavaScript code (must run through console)
help [cmd] Shows command help
logoff Disconnect and reconnect the bot from a server
netmsg <message> Send a message to all servers the bot is connected to
refill Refill core
restart Restart bot, closes when launched directly
say <message> Sends a message to chat
settings get, set Set your user preferences
stop Close bot
template Used in development, does nothing
test Debug command for the chat parser
tpr Teleport to a random location
validate Check the hashing system