Minescript Basics 01 – Getting Started

🎥 YouTube

01 – Hello World

A simple script to verify that Minescript is working correctly.

echo()

Prints a message to the in-game chat. Useful for debugging or providing feedback to the player. https://minescript.net/docs/#echo

import minescript  # Import the minescript module

minescript.echo("Hello from Minescript!")  # Output a message to the Minecraft chat

02 – Get Player Position

Get and print the player’s current coordinates in the Minecraft world.

player_position()

Returns the player’s current position as an (x, y, z) tuple. This is useful for tracking movement or targeting actions. https://minescript.net/docs/#player_position

import minescript
from math import floor

# Get the current player position (floats)
x, y, z = minescript.player_position()

# Convert to integers for clean display
# x, y, z = int(x), int(y), int(z)
x, y, z = floor(x), floor(y), floor(z)

# Show the position in chat
minescript.echo(f"Current Position: X={x}, Y={y}, Z={z}")

03 – Teleport Relative to Current Position

Move the player 3 blocks east and 3 blocks south, and rotate them to face directly south.

execute(command: str)

Executes a raw Minecraft command as if entered in the game. Useful for advanced actions not directly supported by Minescript. https://minescript.net/docs/#execute

import minescript
from math import floor

# Get and convert player position
x, y, z = minescript.player_position()
# x, y, z = int(x), int(y), int(z)
x, y, z = floor(x), floor(y), floor(z)

minescript.echo(f"Current Position: X={x}, Y={y}, Z={z}")

# Teleport the player relative to current position and face south
minescript.execute(f"/tp @p {x+3} {y} {z+3} 0 0")
minescript.echo("Teleported to x+3, z+3 and faced due south.")

04 – Wait, Then Teleport

Adds a short delay before teleporting the player.

import time
import minescript
from math import floor

x, y, z = minescript.player_position()
# x, y, z = int(x), int(y), int(z)
x, y, z = floor(x), floor(y), floor(z)
minescript.echo(f"Current Position: X={x}, Y={y}, Z={z}")

time.sleep(3)  # Wait for 3 seconds

minescript.execute(f"/tp @p {x+3} {y} {z+3} 0 0")
minescript.echo("Teleported after delay to x+3, z+3 and faced due south.")

04a – Clean Import Style

Same as Tutorial 4 but using cleaner, explicit imports and built-in map().

from time import sleep
from minescript import player_position, echo, execute
from math import floor

# Get and convert position using map()
# x, y, z = map(int, player_position())
x, y, z = map(floor, player_position())
echo(f"Current Position: X={x}, Y={y}, Z={z}")

sleep(3)  # Wait 3 seconds

execute(f"/tp @p {x+3} {y} {z+3} 0 0")
echo("Teleported after delay to x+3, z+3 and faced due south.")

05 – Summon Mobs with Delay

Summon different mobs one after another near the player, with a short delay between each.

from time import sleep
from minescript import player_position, echo, execute
from math import floor

# Get and convert player position
# x, y, z = map(int, player_position())
x, y, z = map(floor, player_position())

# Summon an Allay at x+3, z+3
execute(f"/summon minecraft:allay {x+3} {y} {z+3} ")
sleep(3)

# Summon a warm-variant cow (note: "variant" NBT works only in some versions/mods)
execute(f'/summon minecraft:cow {x+3} {y} {z+3} variant')
sleep(3)

# Summon a cold-variant chicken (same note as above)
execute(f'/summon minecraft:chicken {x+3} {y} {z+3} variant')

06 – Circular Mob Summoning

Summon the same type of mob (Allay) in a circular pattern around the player.

from time import sleep
import math
from minescript import player_position, echo, execute

# x, y, z = map(int, player_position())
x, y, z = map(math.floor, player_position())

mob = "allay"
num_mobs = 12
radius = 1

for i in range(num_mobs):
    angle = 2 * math.pi * i / num_mobs
    dx = round(math.cos(angle) * radius, 2)
    dz = round(math.sin(angle) * radius, 2)
    sx = x + dx
    sy = y
    sz = z + dz
    execute(f'/summon minecraft:{mob} {sx} {sy} {sz} ')

07 – Random Mobs in a Circle

Summon random mobs in a circle around the player using a preset list.

from time import sleep
import math
import random
from minescript import player_position, echo, execute

# x, y, z = map(int, player_position())
x, y, z = map(math.floor, player_position())

mobs = ["allay", "bee", "parrot"]
num_mobs = 12
radius = 1

for i in range(num_mobs):
    angle = 2 * math.pi * i / num_mobs
    dx = round(math.cos(angle) * radius, 2)
    dz = round(math.sin(angle) * radius, 2)
    sx = x + dx
    sy = y
    sz = z + dz
    mob = random.choice(mobs)
    execute(f'/summon minecraft:{mob} {sx} {sy} {sz} ')