7cc5c4f330d47060/botv12
1
1
Fork 0
mirror of https://codeberg.org/7cc5c4f330d47060/botv12.git synced 2025-08-28 19:19:39 -04:00
Code Issues 1 Projects Releases Packages Wiki Activity Actions
Minecraft bot written in JavaScript for the kaboom.pw server and clones - mirror from codeberg
275 commits 5 branches 2 tags 424 KiB
Find a file
Exact
Your Name 4b59c9c781 Add -n flag to logoff command
2025-08-28 11:11:51 -04:00
chatParsers Merge all chat parsers to one 2025-07-17 21:35:15 -04:00
commands Add -n flag to logoff command 2025-08-28 11:11:51 -04:00
lang Change license to AGPL v3 2025-08-23 19:28:19 -04:00
plugins Add -n flag to logoff command 2025-08-28 11:11:51 -04:00
util Change license to AGPL v3 2025-08-23 19:28:19 -04:00
.gitignore Make directories more obvious, add downloader 2025-08-21 01:57:31 -04:00
index.js Add debug mode 2025-07-31 04:56:54 -04:00
launch.cmd refactor: small cleanups 2024-12-18 15:11:14 -03:00
launch.sh refactor: small cleanups 2024-12-18 15:11:14 -03:00
LICENSE Change license to AGPL v3 2025-08-23 19:28:19 -04:00
package-lock.json Change license to AGPL v3 2025-08-23 19:28:19 -04:00
package.json Change license to AGPL v3 2025-08-23 19:28:19 -04:00
README.md Add -n flag to logoff command 2025-08-28 11:11:51 -04:00
settings_example.js Lint 2025-08-15 15:46:26 -04:00
version.js Change license to AGPL v3 2025-08-23 19:28:19 -04:00

README.md

botv12

botv12 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 client versions from 1.20.6 to 1.21.4 that are supported by node-minecraft-protocol.

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://codeberg.org/7cc5c4f330d47060/botv12.
  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 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.

License

This project is free software licensed under the GNU Affero General Public License, version 3 or later. Using, modifying, and/or distributing this code is allowed, even for commercial purposes. If you make any changes to the bot and host an instance with those changes, you must make your changes free as well, and release the source for your version. See the License file for the full terms and conditions.