headlessbot

A headless Minecraft bot built with 3arthqu4ke/HeadlessMc and cabaletta/baritone.

---

Usage

Tools required for execution and development are managed with Devbox.

Bot

Execute devbox run bot to start the bot.

Connection target

Set $MCADDR and $MCPORT to configure connection target:
MCADDR="example.org" MCPORT="9001" devbox run bot

Defaults are:

• MCADDR=172.17.0.1
• MCPORT=25565

Server

Execute devbox run server to start a local test server.

Monitoring

Execute devbox run monitoring to start some monitoring stuff.

Visit Grafana at 127.0.0.1:3000 and check the dashboard.

Behavior

The bots behavior is represented as behavior tree.

TODO

(Assorted Ideas)

General / Misc

• [X] test disconnect/kick
• [X] expiring flags
• [X] global cooldowns
• [ ] inventory utils
• [ ] port old player utils
• [ ] more block groups
• [ ] baritone settings
• [ ] permission groups (admin commands)
• [ ] player standing (friend/foe) system
• [ ] config file
• [ ] http api for remote control
• [ ] webhook logs

Behavior Tree

• [X] Tree walking
• [X] Composite nodes
• [X] Decorator nodes
• [ ] Port old behavior
• [ ] WebUI
  • [ ] tree viewer
  • [ ] tree editor
  • [ ] tree manager

Monitoring

• [X] Prometheus exporter

Modules

• [ ] module system for non-tick based reactive logic
• [ ] AutoArmor
• [ ] AutoTotem
• [ ] Autoeat
• [ ] BaritoneSettings
• [ ] Blink
• [ ] ChatCommands
• [ ] ChatSpam
• [ ] CrystalAura
• [ ] DataExport
• [ ] DisconnectDetector
• [ ] InventoryCleanup
• [ ] Jesus
• [ ] KillAura
• [ ] Noslow
• [ ] Respawn
• [ ] Safewalk
• [ ] Step
• [ ] StuckDetector
• [ ] Velocity
• [ ] Visualrange (say hi to players)

Chat Commands

• [ ] command system
• [ ] clear (clear area)
• [ ] take (go to player, pick up dropped items and check containers in range)
• [ ] guard (patrol and kill mobs around anchor position)
• [ ] chatlog (upload latest chatlog as paste)
• [ ] nbt (dump current inventory nbt data as paste)
• [ ] names (get old names of player)
• [ ] search (get infos from ddg/google/etc.)
• [ ] yt (search videos)