HomeJavaModsHeroBot
HeroBot

This mod is made for datapack makers to make bots that can fight back

The bots have a much higher parity with a vanilla client compared to carpet, with things like Auto-Jump and the spear working.


Incompatible With Carpet Mod and Carpet PVP


Settings

Views and modifies HeRoBot settings via the /herobot command. Running /herobot with no arguments displays the mod version.

Usage


Bots

allowSpawningOfflinePlayers

Spawn offline players in online mode if an online-mode player with the specified name does not exist.

Default: true

allowListingBotPlayers

Allows bot players to appear in the multiplayer player list.

Default: true

botPingToTicks

Changes the ping to tick conversion rate for bot players. Used when converting a bot's ping (in ms) to a tick delay for knockback.

Default: 25

botLagAttacks

[Experimental] Makes left clicks (attack) on bot players delayed by the bot's ping value.

Default: false

botLagUses

[Experimental] Makes right clicks (use) on bot players delayed by the bot's ping value.

Default: false

botLeaveOnDeath

Bot players disconnect from the server on death instead of automatically respawning.

Default: false


Creative

creativeNoClip

Creative no clip mode. Allows creative players who are flying to phase through blocks.

Default: false

creativeFlySpeed

Changes the creative flying speed multiplier. Higher values make the client fly faster.

Default: 1.0

creativeFlyDrag

Changes creative air drag. Lower values reduce air resistance while flying.

Default: 0.09


Combat

shieldStunning

Enables shield stunning, allowing entities to be damaged immediately after a shield is disabled.

Default: false

noProjectileRandom

Removes randomness from projectiles, making them perfectly accurate.

Default: false


Explosions

explosionNoBlockDamage

Controls whether explosions destroy blocks.

Values:

Default: FALSE

explosionNoFire

Prevents explosions from beds and respawn anchors from creating fire.

Default: false

windChargeNoTrigger

Wind charges won't activate redstone blocks.

Default: false


World / Misc

clientsIgnoreSlowTickRate

If false, makes client players ignore slower tick rates.

Default: true

editablePlayerNbt

Allows editing player NBT data directly. Also allows mounting players via /ride when enabled.

Default: false

xpNoCooldown

Players absorb experience instantly without delay.

Default: false

shulkerBoxAlwaysDrops

Shulker boxes will always drop, regardless of the doTileDrops gamerule.

Default: false

deleteChunkEntities

When enabled, chunk reset/deletion also deletes entity data files within those chunks.

Default: false

rainThroughMovingPiston

Allows rain to fall through blocks being moved by pistons.

Default: false

disableExperimentalScreen

Remove the experimental world setting. If set on the client, disables all experimental screens. If set on a world, only disables it for that world.

Default: false


Bot Player

Bot players are fake players that join the server and can be controlled entirely through commands. They are spawned with /playerspawn and controlled with /player. Bot players have correct server-side behavior for combat, movement, and item usage.

Bot players automatically respawn on death with full health, empty inventory, and no XP (unless botLeaveOnDeath is enabled).

/playerspawn

Spawns a bot player with optional position, rotation, gamemode, and dimension.

Prevents duplicate names. Respects whitelist and bans. Spectators spawn flying, survival players spawn grounded.

/player

Controls bot players using action packs. All subcommands target with /player <targets> ... and support selectors for targeting multiple bots.

use, attack, swing, jump, drop, dropStack, swapHands

Action commands that make the bot perform player actions.

use without parameters stops using without triggering another use (unlike carpet where it behaved like use once).

swing swings a hand without performing an action and resets the attack cooldown.

attack with a spear/kinetic weapon will perform a stab action instead.

autojump

Controls automatic jumping over one-block obstacles while moving

move

Controls bot movement direction.

sneak / sprint

Sneaking slows movement to 30% speed. Using an item (non-spear) slows to 20% speed.

look

Controls where the bot is looking. Most look commands support delta <ticks> for smooth transitions over multiple ticks.

Cardinal Directions

Exact Rotation

Relative Turns

Look at Position

Look at Entity

Random

hotbar

Selects a hotbar slot.

itemCd

Controls item cooldowns.

ping

Controls the bot's simulated ping. Knockback is delayed by the equivalent number of ticks based on the botPingToTicks setting.

The tick delay has some randomness when the ping doesn't divide evenly by botPingToTicks. For example, with ping 30 and botPingToTicks 25, there is a 5/25 chance each tick to add 1 extra tick of delay.

copycat

Copies another player's inventory and action pack onto the bot.

skin / handedness

Toggles visibility of individual skin parts on the bot.

Skin parts:

Each call toggles the part on/off.

Left/Right Handedness:

stop / kill / disconnect
Distance

Measures distance between two positions, entities, or hitboxes and stores the result as the command return value (scoreboard-friendly). Default distance is spherical (3D).

from

Point-to-point distance using exact positions.

fromHitbox

Uses the full bounding box of the source instead of its center point.

Can also be combined with toHitbox:

e (Exponent Scaling) horizontal

Measures XZ distance only (ignores Y).

vertical

Measures Y distance only (ignores XZ).


Delayed

Schedules commands or functions to run after a tick delay.

tickDelay

Schedules a command or function to execute after a specified number of ticks.

queue

View and manage pending delayed commands.

clear
Chunk Resetter

Resets (deletes) chunk data so they regenerate fresh on next load. Loaded chunks are skipped and must be unloaded first.

chunk

Resets specific chunks by block column position.

Entities in reset chunks are discarded.

world

Resets all unloaded chunks in an entire dimension. Also deletes POI data. Entity data files are only deleted if deleteChunkEntities is enabled.


Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

Verified by MCModsHub

These come from our own check of the pack file, not from the source page.

Explore more