CheatUtils 1.20.1 upgrade notes

This update replaces the old scripting engine and aligns the basic scripting API with newer CheatUtils versions. Simple scripts should require only small changes. The web editor's autocomplete and LLM API.txt button show the exact API available in this version.

Scripts that are not migrated automatically

The old Game Tick and Auto Disconnect script sources are intentionally discarded during the upgrade. Copy their source before updating if you want to reuse their conditions.

Use Events Scripting for tick-based logic:

events.onTickEnd(() => {
    // Runs every client tick while the player is in a world.
});

Auto Disconnect conditions can call the new disconnect API:

events.onTickEnd(() => {
    if (player.getHealth() < 10) {
        player.disconnect("", "Low HP");
    }
});

The first argument can be "self-attack", "invalid-chars", or an empty string for a normal disconnect.

Common API moves

main and convert no longer exist. Use the scripting language's toStandardString(...) methods when formatting numbers. A few old main interaction and enchantment-seed helpers were removed without replacements.

Inventory equipment getters now return ItemStack values. For example, replace inventory.getMainHandItemId() with inventory.getMainHand().item.id. Durability and other item information are available through the returned stack.

Block Automation scripts now receive x, y, and z parameters. Replace currentBlock queries with game.blocks methods and replace blockPlacer.setBlockId(...) with blockAutomation.useItem(...). blockPlacer.placeOne() is now blockAutomation.useOne().

Configuration and profiles

The old zergatulcheatutils.json file is renamed to cheatutils.json. The migration does not create a backup or add a schema-version field. Named profiles use cheatutils.<profile>.json, and the selected profile is stored in cheatutils-profile.json.

This release intentionally retains the existing 1.20.1 Teleport implementation and API. It does not add newer-version-only modules, Block ESP/Entity ESP scripting, Reset or Privacy pages, or the scripting MCP server.