7cc5c4f330d47060/botv12
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
2,343 commits 12 branches 40 tags 3.1 MiB
  • TypeScript 87%
  • JavaScript 9.8%
  • CSS 1.8%
  • HTML 1.3%
Find a file
Exact
7cc5c4f330d47060 9bb7db72fd Make isVanilla work better
2026-03-21 01:01:51 -04:00
chatParsers Fix more eslint errors (28 left) 2026-03-20 05:22:25 -04:00
commands Fix more eslint errors (1 left) 2026-03-20 05:32:46 -04:00
lang Fix the initial set of eslint errors (232 left, down from 8163) 2026-03-20 05:14:45 -04:00
plugins Make isVanilla work better 2026-03-21 01:01:51 -04:00
util More changes to web panel 2026-03-21 00:31:01 -04:00
.gitignore Add data directory 2026-02-08 00:01:40 -05:00
eslint.config.mjs Fix more eslint errors (16 left) 2026-03-20 05:24:26 -04:00
index.ts Fix more eslint errors (1 left) 2026-03-20 05:32:46 -04:00
launch.cmd Wix Findows launcher 2026-02-01 17:33:50 -05:00
launch.sh Add process.argv parser 2025-11-15 22:50:39 -05:00
LICENSE Change license to AGPL v3 2025-08-23 19:28:19 -04:00
package-lock.json Add the thing 2026-03-20 05:11:31 -04:00
package.json Add the thing 2026-03-20 05:11:31 -04:00
README.md Add large comment with information about 26.1 (Ignore it, 26.1 is not here) 2026-02-14 22:39:46 -05:00
settings_example.js Add new argument system 2026-02-15 19:05:42 -05:00
tsconfig.json Port mariadb database support 2026-02-01 16:42:34 -05:00
version.ts Lint ts files with neostandard (60 errors left) 2026-03-20 05:19:16 -04:00

README.md

botv12

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

It supports all Minecraft server versions from 1.20 to 1.21.11 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, MariaDB and SQLite are supported, with more to come.
  7. Compile the TypeScript code to JavaScript by running npx tsc. If it displays an error saying npx is not a command, please make sure Node.js is on your PATH.
  8. 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 dist/index.js to start the bot only once (it will still rejoin when kicked).

License

Copyright © 2020-2026 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 software, you must make your changes free as well. See the License file for the full terms and conditions.