Python Scripting for
Minescript 5.0

from minescript import echo, player_position, player_name

# Get the player's name
name = player_name()

# Get the player's current position
# player_position() returns three decimal numbers: x, y, z
x, y, z = player_position()

# Convert to whole numbers for display
x = int(x)
y = int(y)
z = int(z)

# Echo is like "print but in Minecraft" — only you can see it
echo(f"Hello, {name}!")
echo(f"You are at X={x}  Y={y}  Z={z}")

from minescript import echo, chat, execute, player_position, player_health, add_event_listener

# ─── Command handler functions ───

def cmd_pos():
    """Show current position."""
    x, y, z = player_position()
    echo(f"📍 Position: {int(x)}, {int(y)}, {int(z)}")

def cmd_health():
    """Show current health."""
    hp = player_health()
    hearts = int(hp / 2)
    echo(f"❤ Health: {hp}/20 ({hearts} hearts)")

def cmd_time(part):
    """Set the time of day. Usage: !time day / night / noon"""
    times = {
        "day": 1000,
        "noon": 6000,
        "night": 13000,
        "midnight": 18000,
    }
    if part in times:
        execute(f"/time set {times[part]}")
        echo(f"🕐 Time set to {part}")
    else:
        echo(f"Unknown time: {part}. Use: day, noon, night, midnight")

def cmd_help():
    """Show available commands."""
    echo("─── Chat Bot Commands ───")
    echo("!pos          — show your position")
    echo("!health       — show your health")
    echo("!time [part]  — set time (day/noon/night/midnight)")
    echo("!help         — show this list")

# ─── Main event listener ───

def on_chat(event):
    msg = event.message.strip()

    # Only react to messages starting with !
    if not msg.startswith("!"):
        return

    # Split into command and optional argument
    # e.g. "!time day" → parts = ["!time", "day"]
    parts = msg.split()
    command = parts[0].lower()         # "!time"
    arg = parts[1].lower() if len(parts) > 1 else ""

    if command == "!pos":
        cmd_pos()
    elif command == "!health":
        cmd_health()
    elif command == "!time":
        cmd_time(arg)
    elif command == "!help":
        cmd_help()
    else:
        echo(f"Unknown command: {command}. Type !help for a list.")

# Register the listener and notify the player
add_event_listener("chat", on_chat)
echo("✅ Chat bot is running! Type !help for commands.")

from minescript import echo, player_position, getblocklist
import sys

# ─── Configuration ───
# You can pass arguments when running the script:
# \block_scanner  diamond_ore  10
# (target_block, radius)

if len(sys.argv) >= 2:
    target_block = sys.argv[1]   # e.g. "diamond_ore"
else:
    target_block = "diamond_ore"  # default to diamond ore

if len(sys.argv) >= 3:
    radius = int(sys.argv[2])
else:
    radius = 15  # scan 15 blocks in each direction

# ─── Get player position ───
px, py, pz = player_position()
px, py, pz = int(px), int(py), int(pz)

echo(f"🔍 Scanning {radius*2+1}³ region for: {target_block}")
echo(f"   (Centred on {px}, {py}, {pz})")

# ─── Build list of all positions to check ───
# This collects every (x, y, z) in the scan cube
positions = []
for dx in range(-radius, radius + 1):
    for dy in range(-radius, radius + 1):
        for dz in range(-radius, radius + 1):
            positions.append((px + dx, py + dy, pz + dz))

echo(f"   Checking {len(positions)} blocks...")

# ─── Fetch all block types at once ───
# getblocklist is much faster than calling getblock in a loop
block_types = getblocklist(positions)

# ─── Search for matching blocks ───
found = []
for i, block in enumerate(block_types):
    # Strip "minecraft:" and block states for comparison
    clean = block.replace("minecraft:", "").split("[")[0]
    if clean == target_block:
        found.append(positions[i])

# ─── Report results ───
if len(found) == 0:
    echo(f"❌ No {target_block} found within radius {radius}")
else:
    echo(f"✅ Found {len(found)} {target_block} blocks:")

    # Sort by distance to player (closest first)
    def distance(pos):
        bx, by, bz = pos
        return ((bx - px)**2 + (by - py)**2 + (bz - pz)**2) ** 0.5

    found.sort(key=distance)

    # Show the 10 closest results
    for bx, by, bz in found[:10]:
        d = round(distance((bx, by, bz)), 1)
        echo(f"   → ({bx}, {by}, {bz})  —  {d} blocks away")

    if len(found) > 10:
        echo(f"   ... and {len(found) - 10} more")

from minescript import (echo, player_position, player_orientation,
    player_get_targeted_block, player_look_at, player_press_attack,
    getblock)
import time

# ─── All wood log block IDs ───
WOOD_LOGS = {
    "oak_log", "birch_log", "spruce_log", "jungle_log",
    "acacia_log", "dark_oak_log", "mangrove_log", "cherry_log",
    "oak_wood", "birch_wood", "spruce_wood", "jungle_wood",
}

def is_log(block_name):
    """Return True if the block is a type of wood log."""
    clean = block_name.replace("minecraft:", "").split("[")[0]
    return clean in WOOD_LOGS

def break_block_at(x, y, z, break_time):
    """Look at coordinates and hold left-click to break the block."""
    player_look_at(x, y, z)
    time.sleep(0.2)  # short pause to let the view settle
    player_press_attack(True)
    time.sleep(break_time)
    player_press_attack(False)
    time.sleep(0.15)  # brief pause between blocks

# ─── Step 1: Find a log block ───
# Look at the targeted block in crosshairs (up to 8 blocks away)
target = player_get_targeted_block(8)

if target is None:
    echo("❌ Not looking at any block. Face a tree log first.")
elif not is_log(target.type):
    echo(f"❌ That's not a log: {target.type}")
else:
    start_x, start_y, start_z = target.position
    start_x, start_y, start_z = int(start_x), int(start_y), int(start_z)

    echo(f"🌳 Found log at ({start_x}, {start_y}, {start_z})")
    echo(f"   Type: {target.type}")

    # ─── Step 2: Find the full trunk height ───
    # Scan upward from the first log to find where the trunk ends
    trunk = []
    scan_y = start_y
    while True:
        block = getblock(start_x, scan_y, start_z)
        if is_log(block):
            trunk.append((start_x, scan_y, start_z))
            scan_y += 1
            if scan_y > start_y + 30:   # safety cap: max 30 blocks tall
                break
        else:
            break

    echo(f"   Trunk height: {len(trunk)} blocks")

    # ─── Step 3: Chop from bottom to top ───
    # Breaking the bottom log first causes the higher logs to drop too
    # But we face each log individually to avoid missing any
    chopped = 0
    try:
        for lx, ly, lz in trunk:
            # Check if the block is still there
            current = getblock(lx, ly, lz)
            if is_log(current):
                echo(f"⛏ Chopping Y={ly}")
                break_block_at(lx, ly, lz, 0.8)  # 0.8s per block (adjust for axe type)
                chopped += 1
    finally:
        # Always make sure attack is released, even if script crashes
        player_press_attack(False)

    echo(f"✅ Done! Chopped {chopped} logs.")

from minescript import (echo, player_position, player_orientation,
    player_look_at, player_press_attack, player_press_use,
    getblock, getblocklist)
import time
import sys

# ─── Configuration ───
# How wide and deep is the farm to scan?
FARM_WIDTH = int(sys.argv[1]) if len(sys.argv) > 1 else 9   # east-west
FARM_DEPTH = int(sys.argv[2]) if len(sys.argv) > 2 else 9   # forward

# Crops that are considered "harvestable" when fully grown
HARVESTABLE = {"wheat", "carrots", "potatoes", "beetroots"}

def is_mature_crop(block_name):
    """Return True if block is a fully grown (age=7) crop."""
    if "minecraft:" not in block_name:
        return False
    clean = block_name.replace("minecraft:", "")
    # Clean looks like "wheat[age=7]" or "carrots[age=7]"
    crop_name = clean.split("[")[0]
    if crop_name not in HARVESTABLE:
        return False
    # Check if it's fully grown
    if "age=7" in block_name:
        return True
    # Beetroot is fully grown at age=3
    if crop_name == "beetroots" and "age=3" in block_name:
        return True
    return False

def harvest_block(x, y, z):
    """Look at a block and left-click to harvest it."""
    player_look_at(x, y, z)
    time.sleep(0.15)
    player_press_attack(True)
    time.sleep(0.1)
    player_press_attack(False)
    time.sleep(0.1)

def replant_block(x, y, z):
    """Look at farmland and right-click to plant a seed."""
    player_look_at(x, y, z)
    time.sleep(0.15)
    player_press_use(True)
    time.sleep(0.1)
    player_press_use(False)
    time.sleep(0.1)

# ─── Main ───

# Get player position and facing direction
px, py, pz = player_position()
px, py, pz = int(px), int(py), int(pz)
yaw, _ = player_orientation()

echo(f"🌾 Scanning {FARM_WIDTH}×{FARM_DEPTH} farm area...")

# Build list of crop positions to check (at player's Y level)
# We check the block at eye level (py), crops are at foot level (py-1)
positions = []
for dz in range(0, FARM_DEPTH):        # forward
    for dx in range(-FARM_WIDTH // 2, FARM_WIDTH // 2 + 1):  # side
        positions.append((px + dx, py - 1, pz + dz))

# Fetch all block types at once
block_types = getblocklist(positions)

# Find mature crops
mature_crops = []
for i, block in enumerate(block_types):
    if is_mature_crop(block):
        mature_crops.append(positions[i])

echo(f"   Found {len(mature_crops)} mature crops to harvest")

if len(mature_crops) == 0:
    echo("❌ No mature crops found in this area.")
else:
    harvested = 0
    replanted = 0

    try:
        for cx, cy, cz in mature_crops:
            # Double-check it's still there before harvesting
            current = getblock(cx, cy, cz)
            if is_mature_crop(current):
                harvest_block(cx, cy, cz)
                harvested += 1
                time.sleep(0.2)  # wait for item to drop

                # Try to replant: right-click on the farmland below
                # The player must have seeds/crops in their hotbar
                replant_block(cx, cy, cz)
                replanted += 1
    finally:
        # Release keys if anything goes wrong
        player_press_attack(False)
        player_press_use(False)

    echo(f"✅ Harvested: {harvested}  |  Replanted: {replanted}")