Справочник API

1
2mod = Module("MyModule", "Combat")   # имя, категория
mod.setDesc("Описание модуля")       # возвращает сам модуль, можно цепочкой

1
2
3
4@events.module_toggled
def on_toggle(event):
    if event.getModule().getName() == "MyModule":
        client.msg("включён" if event.isState() else "выключен")

1
2
3
4
5
6
7
8
9
10
11
12client.modules.all()            # список всех PyModule
client.modules.find("Aura")     # PyModule или None, если модуля нет
client.modules.require("Aura")  # PyModule или ValueError, если модуля нет
client.modules.enabled("Aura")  # bool (False, если модуля нет)
client.modules.enable("Aura")   # идёт через require, значит ValueError, если модуля нет
client.modules.disable("Aura")
client.modules.toggle("Aura")

client.find("Aura")             # то же, что modules.find: PyModule или None

# настройка чужого модуля: имя это внутренний ключ, а не подпись из меню
client.find("Aura", "modules.settings.aura.attackDistance")

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17mod = Module("Demo", "Visuals")

enabled = Checkbox(mod, "Enabled")
speed   = Slider(mod, "Speed").min(1).max(10).step(0.5).set(5).suffix(" м/с")
target  = Mode(mod, "Target").add("Head").add("Body").select("Head")
filters = Select(mod, "Filters").add("Players").add("Mobs").select("Players").min(1).draggable()
btn     = Button(mod, "Run").action(lambda: client.msg("клик"))
rng     = Range(mod, "Range").min(0).max(20).step(1).first(3).second(7)
col     = ColorSetting(mod, "Color").color(255, 0, 0).alpha(True)
hotkey  = Bind(mod, "Hotkey").set("G")
nick    = TextSetting(mod, "Nick").maxLength(16).set("Steve")
pause   = TimeSetting(mod, "Pause").units("minutes", "seconds").set(90)
grad    = Gradient(mod, "Gradient").set(Color(255, 0, 90), Color(90, 0, 255))
offset  = PositionSetting(mod, "Offset").bounds(-1, -1, 1, 1).set(0, 0)
curve   = Bezier(mod, "Easing").start(0.2, 0.0).end(0.8, 1.0)
blocks  = Blocks(mod, "Blocks").select("obsidian")
Info(mod, "Заголовок секции")

1
2
3
4
5
6@events.tick
def on_tick(event): ...

events.tick(on_tick)
events.tick.on(on_tick)
events.getEvent("tick").on(on_tick)

1
2
3
4
5
6
7@events.menu_render
def draw(event):
    ctx = event.getContext()
    for panel in menu.panels:
        ctx.drawShadow(panel.x - 8, panel.y - 8,
                       panel.width + 16, panel.height + 16,
                       30, border(18), Color(120, 190, 255).withAlpha(110 * menu.progress))

1
2
3
4
5
6el = Hud("MyHud", width=100, height=20, x=8, y=8)

@el.render
def draw(d):
    d.rect(0, 0, d.width, d.height, Color(0, 0, 0, 180))
    d.text("Привет", 4, 4, size=7, color=Color(255, 255, 255))

1
2
3
4
5
6
7
8
9
10
11st = IslandStatus("MyStatus", width=48, height=15, radius=7, expandable=False)
st.selected(True)      # новый статус создаётся выключенным

@st.render
def draw(d):
    d.centered_text("Hi", d.w / 2, 4)

st.visible_when(lambda: world.ingame())
st.click(lambda mx, my, btn: client.msg("клик"))
st.color(lambda: Color(255, 0, 0))
st.measure(lambda: st.size(60, 15))

1
2
3
4
5
6
7track = music.current()             # None если ничего не играет
if track:
    client.msg(track["artist"] + " : " + track["title"])

line = music.current_lyric()        # строка с таймкодами или None
if line:
    client.msg("%d: %s" % (line["index"], line["text"]))

1
2
3
4
5
6sound.play("beep.wav")                        # один голос на файл, повтор начинает заново
sound.once("hit.wav", volume=0.5)             # отдельный голос: звуки накладываются
track = sound.loop("ambient.mp3", volume=0.2) # играет по кругу

track.volume(0.1)
track.stop()

1
2
3
4
5
6
7
8
9
10@screen("Моё меню", 400, 300)
def menu(ui):
    with ui.column(gap=8, pad=12, bg=Color(20, 20, 24), fill=True):
        ui.text("Заголовок", size=10, weight="bold", color=Color(255, 255, 255))
        with ui.row(gap=6, align="center"):
            ui.button("Кнопка", on_click=lambda: client.msg("клик"))
            ui.toggle("Флаг", lambda: flag.get(), lambda v: flag.set(v))

m = Module("Menu", "Other")
Button(m, "Открыть").action(lambda: menu.open())

1
2
3
4
5
6
7
8
9@raw_screen("Raw", 400, 300)
def render(d):
    d.rect(10, 10, 100, 20, Color(255, 255, 255))
    d.text("Hi", 12, 12)

@render.on_click
def click(mx, my, btn): ...

render.open()

1
2
3
4
5
6@events.render_2d
def draw(event):
    ctx = event.getContext()
    ctx.drawRect(10, 10, 100, 20, Color(255, 255, 255))
    ctx.drawRoundedRect(10, 40, 100, 20, border(6), Color(0, 0, 0, 180))
    ctx.drawText(font("medium", 8), "Привет", 12, 44, Color(255, 255, 255))

1
2
3
4@events.render_3d
def draw(event):
    for p in world.players():
        render3d.box(event, p, Color(255, 0, 0))

1
2
3
4
5
6
7
8
9
10
11
12
13
14glow = Shader("glow", """
uniform float Power;

void main() {
    fragColor = vec4(Color.rgb, Color.a * exp(-distance(FragCoord, vec2(0.5)) * Power));
}
""")


@events.render_2d
def draw(event):
    glow.set("Power", 6.0)
    glow.color(Color(120, 200, 255))
    glow.rect(event.getContext(), 40, 40, 160, 80)

1
2
3
4
5
6
7
8
9
10
11
12
13
14mc.player, mc.world, mc.options
mc.getSession().getUsername()
mc.getCurrentFps()

p = mc.player
p.getX(), p.getY(), p.getZ()
p.getYaw(), p.setYaw(v)
p.getHealth(), p.isOnGround()
p.getNameForScoreboard()     # ник строкой; getName() отдаёт Text
p.getId()                    # номер сущности в сети

# клавиши: forwardKey, backKey, leftKey, rightKey,
# jumpKey, sneakKey, sprintKey, attackKey, useKey
mc.options.forwardKey.setPressed(True)

1
2from net.minecraft.entity import LivingEntity
Box = jimport("net.minecraft.util.math.Box")

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15@command("hello", desc="Здоровается", aliases=["hi"])
def hello(ctx):
    ctx.msg("Привет!")


@command("tp")
def tp(ctx, x: int, y: int, z: int):
    """Телепорт по координатам"""
    newton.goto(x, y, z, radius=1)


@tp.sub("home")
def tp_home(ctx):
    """Домой"""
    newton.goto(120, 64, -340, radius=1)

1
2
3
4
5
6newton.goto(100, 64, -200, radius=1)   # точка: три числа, список или сущность
newton.fly_to(1500, 120, -800)         # на элитре
newton.mine("diamond_ore")             # копать ближайшие такие блоки
newton.excavate([100, 60, 200], [110, 66, 210])
newton.fill([100, 60, 200], [110, 66, 210], "stone")
newton.cancel()

1
2
3notify.island("Готово", "success")            # строка в Dynamic Island
notify.crosshair("Внимание", "Рядом игрок")   # плашка под прицелом
notify.item("Нашёл", "diamond", highlight="алмаз")

1
2
3
4
5
6
7slot = inventory.find("totem_of_undying", "hotbar")
if slot is not None:
    inventory.to_offhand(slot)

inventory.select(2)
inventory.total("ender_pearl")
inventory.items("hotbar")        # [(слот, id, количество), ...]

1
2
3
4
5
6
7for eff in effects.list():
    client.msg("%s %s" % (eff.label, eff.time))

if effects.has("speed"):
    lvl = effects.level("speed")

ctx.effect("strength", 0, 0, 12)      # иконка эффекта в контексте рисования

1
2
3ctx.rect(0, 20, 120, 2, theme.accent())
ctx.text("текст", 8, 6, size=7, color=theme.text())
ctx.text("на акценте", 8, 20, size=7, color=theme.readable(theme.accent()))

1
2
3
4
5skins.me(skin="Notch", cape="optifine:Notch")
skins.skin("Player123", "skins/my.png")
skins.model("Player123", "slim")
skins.all(skin="Herobrine")
skins.reset("Player123")

1
2
3
4
5
6
7
8
9
10
11
12el = Esp("esp.mybox", targets=["players", "mobs"], enable=["others"])
color = ColorSetting(el, "esp.mybox.color")


@el.filter
def only_close(entity):
    return entity.distanceTo(mc.player) < 20


@el.render
def draw(entity, event):
    render3d.box(event, entity, color.get())

1
2
3
4
5
6
7
8lang.load({
    "ru_ru": {"mymod.speed": "Скорость", "mymod.hi": "Привет, %s"},
    "en_us": {"mymod.speed": "Speed", "mymod.hi": "Hi, %s"},
})

speed = Slider(mod, "mymod.speed")     # надпись в меню на языке игрока
client.msg(lang("mymod.hi", "Steve"))
lang.plural(5, "игрок", "игрока", "игроков")

1
2
3
4
5
6
7@events.key
def on_key(event):
    if event.isPress() and event.getKey() == keys.G:
        client.msg("нажата G")

if keys.down("LEFT_SHIFT") and keys.mouse(1):
    client.msg("шифт и правая кнопка")

1
2
3victim = target.best(players=True, range=6, sort="distance")
everyone = target.all(players=True, mobs=True, range=16)
current = target.current()      # кого бьёт Aura

1
2
3
4for event in funtime.events():
    client.msg("%s: %s" % (event["name"], event["status"]))

funtime.fetch_players(lambda players: client.msg("онлайн: %d" % len(players)))

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17class MyRot:
    name = "My Rot"

    def rotate(self, ctx):
        yaw, pitch = ctx.default()      # углы на цель по умолчанию
        return (yaw, pitch)             # или {"yaw": ..., "pitch": ...}

    def attack(self): ...               # необязательно
    def can_attack(self): return True   # необязательно
    def target_null(self): ...          # необязательно
    def update(self): ...               # необязательно

aura.add(MyRot(), select=True)

@aura.rotation("Simple", select=True)
def rotate(ctx):
    return ctx.to(ctx.target)

1
2
3
4
5
6
7
8
9
10
11
12
13c = Color(255, 0, 0)                 # r, g, b (0..255), alpha=255
c = Color(255, 0, 0, 128)            # с альфой
c = Color.from_hex("#ff0000")        # или "#ff0000aa"
c = Color.from_int(0xFFFF0000)
c = Color.from_hsb(0.5, 1.0, 1.0)    # каждое 0..1

ColorRGBA.WHITE, ColorRGBA.BLACK, ColorRGBA.RED
ColorRGBA.GREEN, ColorRGBA.BLUE, ColorRGBA.YELLOW

c.withAlpha(120)     # копия с другой альфой (0..255)
c.mulAlpha(0.5)      # умножить альфу
c.mix(other, 0.5)    # смешать два цвета
c.toHex()            # "#rrggbbaa"

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16f = font("medium", 8)
client.font_width("medium", 8, "text")
client.font_height("medium", 8)

tex = assets.image("assets/logo.png")     # путь относительно папки scripts/
tex = assets.image("https://site.ru/logo.png")   # или ссылка: качается один раз
assets.resource("icons/logo.png")         # ресурс клиента (assets/rockstar/...)
assets.ttf("Inter", "assets/Inter.ttf", 9)   # свой шрифт из ttf/otf, файлом или ссылкой
assets.svg("моё/сердце", "assets/heart.svg")   # свой значок: дальше d.icon("моё/сердце")
assets.svg_text("моё/звезда", "<svg viewBox='0 0 24 24'>...</svg>")
assets.download("https://site.ru/data.json", on_ready)   # любой другой файл по ссылке
assets.scripts_dir()

paths.root()        # .minecraft/Rockstar, папка клиента (то же, что client.gameDir())
paths.scripts()     # .minecraft/Rockstar/scripts
paths.runtime()     # .minecraft/Rockstar/runtime, сам CPython лежит внутри, в python/

1
2
3
4
5
6
7
8
9
10
11
12
13db = Storage("myscript")   # scripts/storage/myscript.json
db.set("kills", 10).save()
db.get("kills", 0)
db["kills"] = 5
db.all()
db.remove("kills")
db.clear()
db.load()

t = Timer()
if t.finished(500):    # прошло 500 мс или больше
    t.reset()
t.elapsed()            # мс с последнего reset