7cc5c4f330d47060/botv12
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
ECMAScript rewrite of owobot11, a Minecraft bot for the Kaboom server and clones
340 commits 7 branches 3 tags 657 KiB
Find a file
Exact
7cc5c4f330d47060 7c3b62b604 Remove logging 1000 to console every startup
2025-12-13 20:36:53 -05:00
chatParsers Rename UBotClient to Botv12Client, to avoid confusion with other similarly named programs. 2025-11-07 10:50:16 -05:00
commands Change username generator, complete about command 2025-11-12 20:19:49 -05:00
lang Change username generator, complete about command 2025-11-12 20:19:49 -05:00
plugins Fix many types 2025-11-07 16:03:02 -05:00
util Remove logging 1000 to console every startup 2025-12-13 20:36:53 -05:00
.gitignore Remove logging 1000 to console every startup 2025-12-13 20:36:53 -05:00
index.ts Remove logging 1000 to console every startup 2025-12-13 20:36:53 -05:00
launch.cmd 1.21.8 2025-09-08 00:06:26 -04:00
launch.sh 1.21.8 2025-09-08 00:06:26 -04:00
LICENSE Change license to AGPL v3 2025-08-23 19:28:19 -04:00
package-lock.json Remove logging 1000 to console every startup 2025-12-13 20:36:53 -05:00
package.json Add HTML parser 2025-10-04 16:21:51 -04:00
README.md Revert "Add "open source" to README." 2025-10-25 18:37:34 -04:00
settings.d.ts Fix many types 2025-11-07 16:03:02 -05:00
settings_example.js Change username generator, complete about command 2025-11-12 20:19:49 -05:00
version.d.ts Fix many types 2025-11-07 16:03:02 -05:00
version.js Fix many types 2025-11-07 16:03:02 -05:00

README.md

botv12

botv12 is a Minecraft bot originally designed for Kaboom and its clones.

It supports all Minecraft server versions from 1.21.1 to 1.21.8 that are supported by node-minecraft-protocol. It is primarily developed using Kaboom or clones, but it should work on other servers with reduced functionality.

How to install?

  1. Install Node.js for your operating system.
  2. Download the latest release, or alternatively, download the latest development version using the latest source archive or running the command git clone https://codeberg.org/7cc5c4f330d47060/botv12 with Git installed.
  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 the reference configuration (settings_example.js in the root) to settings.js, and adjust the settings to fit your needs. The secrets are also contained in this file as well.
  6. (Optional) If you plan to use a database with the bot, set dbEnabled in settings.js to true and fill in the appropriate fields. Currently, MySQL and MariaDB are supported, with more to come.
  7. 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 npx tsx index.ts to start the bot only once (it will still rejoin when kicked). If it displays an error saying npx is not a command, please make sure Node.js is on your PATH.

License

Copyright © 2020-2025 7cc5c4f330d47060. This project is free software licensed under the GNU Affero General Public License, version 3 or later. Using, modifying, and distributing this code is allowed, even for commercial purposes. If you make any copies of this software, you must link back to this repository. If you make any changes to the bot, you must make your changes free as well. See the License file for the full terms and conditions.