minecraft-tweaks 0.1.0__tar.gz

minecraft_tweaks-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 newlevel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

minecraft_tweaks-0.1.0/PKG-INFO

@@ -0,0 +1,185 @@
+Metadata-Version: 2.4
+Name: minecraft-tweaks
+Version: 0.1.0
+Summary: simple minecraft injector
+Author: newlevel
+License: MIT
+Project-URL: Homepage, https://pypi.org/project/minecraft-tweaks/
+Keywords: minecraft,overlay,esp,gui,win32,cheat
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# minecraft-tweaks
+
+simple minecraft injector
+
+Оверлей, ESP и ClickGUI для Minecraft на чистом Python. Зависимостей нет, игра не
+перезапускается: библиотека создаёт слоёное окно с попиксельной прозрачностью
+(`UpdateLayeredWindow` и 32-битный DIB) и держит его над клиентской областью игры.
+
+```python
+import minecraft_tweaks as mt
+
+@mt.on_start                     # Minecraft запустился
+def started(mc):
+    print("нашли:", mc.title, "pid", mc.pid)
+
+@mt.on_world                     # вошли в мир
+def world(mc):
+    print("мир:", mc.world)
+
+mt.run_forever(fps=144)          # держит оверлей и вызывает хуки
+```
+
+## Установка
+
+```powershell
+cd minecraft-tweaks
+python -m pip install -e .
+```
+
+Нужен Python 3.10 или новее и Windows. Win32 вызывается через `ctypes`, дополнительных
+пакетов не требуется.
+
+## Что внутри
+
+| Модуль | Что делает |
+|---|---|
+| `mt.find()` / `mt.is_running()` / `mt.wait()` | ищет окно и процесс Minecraft по заголовку, без psutil |
+| `@mt.on_start` / `@mt.on_world` / `@mt.on_exit` | хуки жизненного цикла игры |
+| `mt.Overlay` | прозрачное окно поверх игры: per-pixel alpha, от 144 fps, фокус не забирает, клики пропускает |
+| `mt.Canvas` | рисование: `fill_rect`, `frame`, `corners`, `line`, `gradient_line`, `rounded`, `hgradient`, `bar`, `text`, `pixel_art` |
+| `mt.ESPRenderer` | рамки, уголки, свечение, иконки, дистанция, полоса HP, трассеры, интерполяция позиций |
+| `mt.ClickGui` | колонки категорий, тумблеры, поиск, подсветка под курсором, тёмное стекло |
+| `mt.Keys`, `mt.Combo`, `mt.Hotkey` | клавиши и мышь через `GetAsyncKeyState`, хуки не ставятся |
+| `mt.agent` | по желанию: внедрение Java-агента из `../mc-inject` и чтение состояния |
+
+## Оверлей
+
+```python
+ov = mt.Overlay(fps=144)
+
+def render(canvas, overlay, mc):
+    canvas.text(f"{overlay.stats.fps:.0f} FPS", 10, 10, 0xFFF2F2F5)
+    esp.draw(canvas, camera, entities, partial_tick=partial)
+
+mt.run_forever(render, overlay=ov)
+```
+
+Почему картинка не дёргается:
+
+1. Попиксельная альфа. DWM композитит окно каждый кадр монитора, цветовой ключ не нужен,
+   поэтому края не мигают.
+2. Интерполяция. `Entity.position(partial_tick)` считает `pos - delta * (1 - partialTick)`,
+   как это делает ваниль. Сущности обновляются 20 раз в секунду, а кадры рисуются 144.
+3. Один оверлей. Окна старых запусков гасятся при старте.
+
+## ESP
+
+```python
+esp = mt.ESPRenderer(mt.EspSettings(tracers=True, names=True))
+cam = mt.Camera(x=0, y=1.62, z=0, yaw=90, pitch=0, fov=70)
+ents = [
+    mt.Entity(5, 0, 12, kind="player", health=0.8, name="bot"),
+    mt.Entity(-3, 0, 9, kind="mob"),
+    mt.Entity(2, 0, 6, kind="storage"),
+]
+esp.draw(canvas, cam, ents, partial_tick=0.5)
+```
+
+`kind` задаёт цвет и иконку: `player` (фиолетовый, человечек), `mob` (красный, ромб),
+`storage` (жёлтый, сундук). Дистанция и HP рисуются сами.
+
+## ClickGUI
+
+```python
+gui = mt.ClickGui({
+    "Combat": [mt.Module("KillAura"), mt.Module("Velocity")],
+    "Render": [mt.Module("PlayerESP"), mt.Module("Tracers")],
+})
+gui.draw(canvas, mt.Keys.cursor(), focused=True)
+hit = gui.click(mt.Keys.cursor(), lmb_pressed=True)   # переключит тумблер под курсором
+```
+
+Клики окно не перехватывает: оно прозрачно для мыши, а состояние кнопок читается глобально.
+
+## Свои методы (расширения)
+
+Расширения пишутся декораторами, наследование и ручная регистрация не нужны:
+
+```python
+import minecraft_tweaks as mt
+
+# 1. ESP для любого блока: имя, цвет, подпись, дальность
+@mt.esp_block("diamond_ore", color=0xFF00E5FF, label=True, max_distance=96)
+def diamonds():
+    return [(12, 5, -3), (18, 4, 2)]      # координаты углов блоков
+
+# 2. Свои сущности (вызывается каждый кадр)
+@mt.esp_entity
+def my_ents():
+    return [mt.Entity(0, 0, 8, kind="mob")]
+
+# 3. Своя отрисовка поверх кадра
+@mt.esp_draw
+def watermark(canvas, camera, app):
+    canvas.text("my client", 10, 10, 0xFFFFFFFF)
+
+# 4. Своя логика каждый кадр
+@mt.on_frame
+def logic(dt, app):
+    app.camera.yaw += 10 * dt
+
+# 5. Свой модуль: попадает в ClickGUI, получает колбэки
+@mt.module("MyMod", category="Render", enabled=True)
+class MyMod:
+    def on_tick(self, dt): ...
+    def on_draw(self, canvas, app): ...
+    def on_toggle(self, enabled): ...
+```
+
+Такой же файл можно положить в папку и не трогать код библиотеки:
+
+```python
+mt.load_scripts("scripts")     # импортирует все scripts/*.py
+```
+
+Внутри скрипта обычный Python с теми же декораторами. Исключение в чужом колбэке не
+ломает кадр: оно попадает в `mt.registry.errors`.
+
+## Клавиши и взвод макроса
+
+```python
+keys = mt.Keys()
+combo = mt.Combo(["S", "R", "R"], modifier="ALT")
+
+if combo.update():          # держим Alt, жмём S, R, R
+    armed = True
+```
+
+## Опционально: Java-агент
+
+Если нужны данные прямо из игры (позиции сущностей, состояние мира), рядом лежит
+`mc-inject` с Java-агентом:
+
+```python
+mt.agent.attach()                    # процесс найдёт сам
+state = mt.agent.wait_state()        # прочитает ss-state.json, если агент его пишет
+```
+
+## Примеры
+
+```powershell
+python examples/esp_demo.py     # плавный ESP на демо-мишенях
+python examples/gui_demo.py     # ClickGUI + HUD
+python tests/test_smoke.py      # смоук-тест без игры
+```
+
+## Ограничения
+
+- Только Windows: используется Win32 API.
+- Оверлей виден поверх окна и borderless-фуллскрина. Эксклюзивный fullscreen, когда игра
+  забирает дисплей целиком, перекрыть нельзя. Переключите игру в оконный режим.
+- Данные о сущностях библиотека не добывает. Их нужно передать в `Entity` из своего источника.

minecraft_tweaks-0.1.0/README.md

@@ -0,0 +1,172 @@
+# minecraft-tweaks
+
+simple minecraft injector
+
+Оверлей, ESP и ClickGUI для Minecraft на чистом Python. Зависимостей нет, игра не
+перезапускается: библиотека создаёт слоёное окно с попиксельной прозрачностью
+(`UpdateLayeredWindow` и 32-битный DIB) и держит его над клиентской областью игры.
+
+```python
+import minecraft_tweaks as mt
+
+@mt.on_start                     # Minecraft запустился
+def started(mc):
+    print("нашли:", mc.title, "pid", mc.pid)
+
+@mt.on_world                     # вошли в мир
+def world(mc):
+    print("мир:", mc.world)
+
+mt.run_forever(fps=144)          # держит оверлей и вызывает хуки
+```
+
+## Установка
+
+```powershell
+cd minecraft-tweaks
+python -m pip install -e .
+```
+
+Нужен Python 3.10 или новее и Windows. Win32 вызывается через `ctypes`, дополнительных
+пакетов не требуется.
+
+## Что внутри
+
+| Модуль | Что делает |
+|---|---|
+| `mt.find()` / `mt.is_running()` / `mt.wait()` | ищет окно и процесс Minecraft по заголовку, без psutil |
+| `@mt.on_start` / `@mt.on_world` / `@mt.on_exit` | хуки жизненного цикла игры |
+| `mt.Overlay` | прозрачное окно поверх игры: per-pixel alpha, от 144 fps, фокус не забирает, клики пропускает |
+| `mt.Canvas` | рисование: `fill_rect`, `frame`, `corners`, `line`, `gradient_line`, `rounded`, `hgradient`, `bar`, `text`, `pixel_art` |
+| `mt.ESPRenderer` | рамки, уголки, свечение, иконки, дистанция, полоса HP, трассеры, интерполяция позиций |
+| `mt.ClickGui` | колонки категорий, тумблеры, поиск, подсветка под курсором, тёмное стекло |
+| `mt.Keys`, `mt.Combo`, `mt.Hotkey` | клавиши и мышь через `GetAsyncKeyState`, хуки не ставятся |
+| `mt.agent` | по желанию: внедрение Java-агента из `../mc-inject` и чтение состояния |
+
+## Оверлей
+
+```python
+ov = mt.Overlay(fps=144)
+
+def render(canvas, overlay, mc):
+    canvas.text(f"{overlay.stats.fps:.0f} FPS", 10, 10, 0xFFF2F2F5)
+    esp.draw(canvas, camera, entities, partial_tick=partial)
+
+mt.run_forever(render, overlay=ov)
+```
+
+Почему картинка не дёргается:
+
+1. Попиксельная альфа. DWM композитит окно каждый кадр монитора, цветовой ключ не нужен,
+   поэтому края не мигают.
+2. Интерполяция. `Entity.position(partial_tick)` считает `pos - delta * (1 - partialTick)`,
+   как это делает ваниль. Сущности обновляются 20 раз в секунду, а кадры рисуются 144.
+3. Один оверлей. Окна старых запусков гасятся при старте.
+
+## ESP
+
+```python
+esp = mt.ESPRenderer(mt.EspSettings(tracers=True, names=True))
+cam = mt.Camera(x=0, y=1.62, z=0, yaw=90, pitch=0, fov=70)
+ents = [
+    mt.Entity(5, 0, 12, kind="player", health=0.8, name="bot"),
+    mt.Entity(-3, 0, 9, kind="mob"),
+    mt.Entity(2, 0, 6, kind="storage"),
+]
+esp.draw(canvas, cam, ents, partial_tick=0.5)
+```
+
+`kind` задаёт цвет и иконку: `player` (фиолетовый, человечек), `mob` (красный, ромб),
+`storage` (жёлтый, сундук). Дистанция и HP рисуются сами.
+
+## ClickGUI
+
+```python
+gui = mt.ClickGui({
+    "Combat": [mt.Module("KillAura"), mt.Module("Velocity")],
+    "Render": [mt.Module("PlayerESP"), mt.Module("Tracers")],
+})
+gui.draw(canvas, mt.Keys.cursor(), focused=True)
+hit = gui.click(mt.Keys.cursor(), lmb_pressed=True)   # переключит тумблер под курсором
+```
+
+Клики окно не перехватывает: оно прозрачно для мыши, а состояние кнопок читается глобально.
+
+## Свои методы (расширения)
+
+Расширения пишутся декораторами, наследование и ручная регистрация не нужны:
+
+```python
+import minecraft_tweaks as mt
+
+# 1. ESP для любого блока: имя, цвет, подпись, дальность
+@mt.esp_block("diamond_ore", color=0xFF00E5FF, label=True, max_distance=96)
+def diamonds():
+    return [(12, 5, -3), (18, 4, 2)]      # координаты углов блоков
+
+# 2. Свои сущности (вызывается каждый кадр)
+@mt.esp_entity
+def my_ents():
+    return [mt.Entity(0, 0, 8, kind="mob")]
+
+# 3. Своя отрисовка поверх кадра
+@mt.esp_draw
+def watermark(canvas, camera, app):
+    canvas.text("my client", 10, 10, 0xFFFFFFFF)
+
+# 4. Своя логика каждый кадр
+@mt.on_frame
+def logic(dt, app):
+    app.camera.yaw += 10 * dt
+
+# 5. Свой модуль: попадает в ClickGUI, получает колбэки
+@mt.module("MyMod", category="Render", enabled=True)
+class MyMod:
+    def on_tick(self, dt): ...
+    def on_draw(self, canvas, app): ...
+    def on_toggle(self, enabled): ...
+```
+
+Такой же файл можно положить в папку и не трогать код библиотеки:
+
+```python
+mt.load_scripts("scripts")     # импортирует все scripts/*.py
+```
+
+Внутри скрипта обычный Python с теми же декораторами. Исключение в чужом колбэке не
+ломает кадр: оно попадает в `mt.registry.errors`.
+
+## Клавиши и взвод макроса
+
+```python
+keys = mt.Keys()
+combo = mt.Combo(["S", "R", "R"], modifier="ALT")
+
+if combo.update():          # держим Alt, жмём S, R, R
+    armed = True
+```
+
+## Опционально: Java-агент
+
+Если нужны данные прямо из игры (позиции сущностей, состояние мира), рядом лежит
+`mc-inject` с Java-агентом:
+
+```python
+mt.agent.attach()                    # процесс найдёт сам
+state = mt.agent.wait_state()        # прочитает ss-state.json, если агент его пишет
+```
+
+## Примеры
+
+```powershell
+python examples/esp_demo.py     # плавный ESP на демо-мишенях
+python examples/gui_demo.py     # ClickGUI + HUD
+python tests/test_smoke.py      # смоук-тест без игры
+```
+
+## Ограничения
+
+- Только Windows: используется Win32 API.
+- Оверлей виден поверх окна и borderless-фуллскрина. Эксклюзивный fullscreen, когда игра
+  забирает дисплей целиком, перекрыть нельзя. Переключите игру в оконный режим.
+- Данные о сущностях библиотека не добывает. Их нужно передать в `Entity` из своего источника.

minecraft_tweaks-0.1.0/minecraft_tweaks/__init__.py

@@ -0,0 +1,121 @@
+"""minecraft-tweaks: оверлей, ESP и GUI для Minecraft на чистом Python.
+
+Быстрый старт::
+
+    import minecraft_tweaks as mt
+
+    @mt.on_start
+    def started(mc):
+        print("Minecraft:", mc.title)
+
+    ov = mt.Overlay(fps=144)
+    esp = mt.ESPRenderer()
+
+    def render(canvas, overlay, mc):
+        cam = mt.Camera(0, 0, 0, 0, 0, fov=70)
+        ents = [mt.Entity(5, 0, 10, kind="player", health=0.8)]
+        esp.draw(canvas, cam, ents)
+        canvas.text(f"FPS {overlay.stats.fps:.0f}", 10, 10, 0xFFFFFFFF)
+
+    mt.run_forever(render, overlay=ov)
+"""
+
+from __future__ import annotations
+
+from . import agent, process
+from .app import App
+from .draw import Canvas
+from .esp import KIND_COLOR, Camera, Entity, ESPRenderer, EspSettings
+from .extensions import (
+    BlockEsp,
+    Registry,
+    esp_block,
+    esp_draw,
+    esp_entity,
+    load_scripts,
+    module,
+    on_frame,
+    registry,
+)
+from .gui import ClickGui, Module
+from .hooks import on_exit, on_start, on_world, run_forever
+from .keys import (
+    Combo,
+    Hotkey,
+    Keys,
+    VK_ALT,
+    VK_CONTROL,
+    VK_ESCAPE,
+    VK_LBUTTON,
+    VK_RBUTTON,
+    VK_RSHIFT,
+    VK_SHIFT,
+    VK_SPACE,
+    vk,
+)
+from .overlay import Overlay, OverlayStats
+from .process import MinecraftWindow
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "agent",
+    "process",
+    "App",
+    "Canvas",
+    "Overlay",
+    "OverlayStats",
+    "MinecraftWindow",
+    "Camera",
+    "Entity",
+    "ESPRenderer",
+    "EspSettings",
+    "KIND_COLOR",
+    "ClickGui",
+    "Module",
+    "Registry",
+    "BlockEsp",
+    "esp_entity",
+    "esp_block",
+    "esp_draw",
+    "on_frame",
+    "module",
+    "load_scripts",
+    "registry",
+    "Keys",
+    "Combo",
+    "Hotkey",
+    "vk",
+    "on_start",
+    "on_world",
+    "on_exit",
+    "run_forever",
+    "VK_ALT",
+    "VK_CONTROL",
+    "VK_ESCAPE",
+    "VK_LBUTTON",
+    "VK_RBUTTON",
+    "VK_RSHIFT",
+    "VK_SHIFT",
+    "VK_SPACE",
+]
+
+
+def find() -> MinecraftWindow | None:
+    """Найти окно Minecraft прямо сейчас."""
+    return process.find()
+
+
+def is_running() -> bool:
+    """Запущен ли Minecraft (проверка по окну, без перебора процессов)."""
+    return process.is_running()
+
+
+def wait(timeout: float | None = None) -> MinecraftWindow | None:
+    """Дождаться запуска Minecraft."""
+    return process.wait(timeout)
+
+
+def wait_world(timeout: float | None = None) -> MinecraftWindow | None:
+    """Дождаться входа в мир."""
+    return process.wait_world(timeout)

minecraft_tweaks-0.1.0/minecraft_tweaks/__main__.py

@@ -0,0 +1,6 @@
+"""Точка входа: python -m minecraft_tweaks [--version|--fps N|...]."""
+
+from .watchdog import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

minecraft_tweaks-0.1.0/minecraft_tweaks/_win.py

@@ -0,0 +1,190 @@
+"""Тонкая обёртка над Win32 (ctypes): только то, что нужно библиотеке.
+
+Здесь нет бизнес-логики: структуры, константы и объявления функций.
+"""
+
+from __future__ import annotations
+
+import ctypes
+from ctypes import wintypes as wt
+
+user32 = ctypes.WinDLL("user32", use_last_error=True)
+gdi32 = ctypes.WinDLL("gdi32", use_last_error=True)
+kernel32 = ctypes.WinDLL("kernel32", use_last_error=True)
+
+LRESULT = ctypes.c_ssize_t
+WNDPROC = ctypes.WINFUNCTYPE(LRESULT, wt.HWND, ctypes.c_uint, wt.WPARAM, wt.LPARAM)
+WNDENUMPROC = ctypes.WINFUNCTYPE(wt.BOOL, wt.HWND, wt.LPARAM)
+
+# --- константы -------------------------------------------------------------
+WS_POPUP = 0x80000000
+WS_EX_LAYERED = 0x00080000
+WS_EX_TRANSPARENT = 0x00000020
+WS_EX_TOPMOST = 0x00000008
+WS_EX_TOOLWINDOW = 0x00000080
+WS_EX_NOACTIVATE = 0x08000000
+
+SW_HIDE = 0
+SW_SHOWNOACTIVATE = 4
+SW_RESTORE = 9
+
+SWP_NOZORDER = 0x0004
+SWP_NOACTIVATE = 0x0010
+SWP_SHOWWINDOW = 0x0040
+
+ULW_ALPHA = 0x00000002
+AC_SRC_OVER = 0x00
+AC_SRC_ALPHA = 0x01
+
+BI_RGB = 0
+DIB_RGB_COLORS = 0
+
+HWND_TOPMOST = -1
+PROCESS_QUERY_LIMITED_INFORMATION = 0x1000
+
+
+class WNDCLASSEXW(ctypes.Structure):
+    _fields_ = [
+        ("cbSize", ctypes.c_uint),
+        ("style", ctypes.c_uint),
+        ("lpfnWndProc", WNDPROC),
+        ("cbClsExtra", ctypes.c_int),
+        ("cbWndExtra", ctypes.c_int),
+        ("hInstance", wt.HINSTANCE),
+        ("hIcon", wt.HICON),
+        ("hCursor", wt.HANDLE),
+        ("hbrBackground", wt.HBRUSH),
+        ("lpszMenuName", wt.LPCWSTR),
+        ("lpszClassName", wt.LPCWSTR),
+        ("hIconSm", wt.HICON),
+    ]
+
+
+class BITMAPINFOHEADER(ctypes.Structure):
+    _fields_ = [
+        ("biSize", ctypes.c_uint32),
+        ("biWidth", ctypes.c_int32),
+        ("biHeight", ctypes.c_int32),
+        ("biPlanes", ctypes.c_uint16),
+        ("biBitCount", ctypes.c_uint16),
+        ("biCompression", ctypes.c_uint32),
+        ("biSizeImage", ctypes.c_uint32),
+        ("biXPelsPerMeter", ctypes.c_int32),
+        ("biYPelsPerMeter", ctypes.c_int32),
+        ("biClrUsed", ctypes.c_uint32),
+        ("biClrImportant", ctypes.c_uint32),
+    ]
+
+
+class BITMAPINFO(ctypes.Structure):
+    _fields_ = [("bmiHeader", BITMAPINFOHEADER), ("bmiColors", ctypes.c_uint32 * 3)]
+
+
+class BLENDFUNCTION(ctypes.Structure):
+    _fields_ = [
+        ("BlendOp", ctypes.c_ubyte),
+        ("BlendFlags", ctypes.c_ubyte),
+        ("SourceConstantAlpha", ctypes.c_ubyte),
+        ("AlphaFormat", ctypes.c_ubyte),
+    ]
+
+
+class SIZE(ctypes.Structure):
+    _fields_ = [("cx", ctypes.c_long), ("cy", ctypes.c_long)]
+
+
+# --- прототипы -------------------------------------------------------------
+user32.EnumWindows.argtypes = [WNDENUMPROC, wt.LPARAM]
+user32.EnumWindows.restype = wt.BOOL
+user32.IsWindowVisible.argtypes = [wt.HWND]
+user32.IsWindowVisible.restype = wt.BOOL
+user32.GetWindowTextW.argtypes = [wt.HWND, wt.LPWSTR, ctypes.c_int]
+user32.GetWindowTextW.restype = ctypes.c_int
+user32.GetClassNameW.argtypes = [wt.HWND, wt.LPWSTR, ctypes.c_int]
+user32.GetClassNameW.restype = ctypes.c_int
+user32.GetForegroundWindow.restype = wt.HWND
+user32.GetClientRect.argtypes = [wt.HWND, ctypes.POINTER(wt.RECT)]
+user32.GetClientRect.restype = wt.BOOL
+user32.ClientToScreen.argtypes = [wt.HWND, ctypes.POINTER(wt.POINT)]
+user32.ClientToScreen.restype = wt.BOOL
+user32.GetWindowThreadProcessId.argtypes = [wt.HWND, ctypes.POINTER(wt.DWORD)]
+user32.GetWindowThreadProcessId.restype = wt.DWORD
+user32.CreateWindowExW.argtypes = [
+    wt.DWORD, wt.LPCWSTR, wt.LPCWSTR, wt.DWORD,
+    ctypes.c_int, ctypes.c_int, ctypes.c_int, ctypes.c_int,
+    wt.HWND, wt.HMENU, wt.HINSTANCE, wt.LPVOID,
+]
+user32.CreateWindowExW.restype = wt.HWND
+user32.RegisterClassExW.argtypes = [ctypes.POINTER(WNDCLASSEXW)]
+user32.RegisterClassExW.restype = wt.ATOM
+user32.DefWindowProcW.argtypes = [wt.HWND, ctypes.c_uint, wt.WPARAM, wt.LPARAM]
+user32.DefWindowProcW.restype = LRESULT
+user32.ShowWindow.argtypes = [wt.HWND, ctypes.c_int]
+user32.ShowWindow.restype = wt.BOOL
+user32.DestroyWindow.argtypes = [wt.HWND]
+user32.DestroyWindow.restype = wt.BOOL
+user32.SetWindowPos.argtypes = [wt.HWND, wt.HWND, ctypes.c_int, ctypes.c_int,
+                                ctypes.c_int, ctypes.c_int, ctypes.c_uint]
+user32.SetWindowPos.restype = wt.BOOL
+user32.GetAsyncKeyState.argtypes = [ctypes.c_int]
+user32.GetAsyncKeyState.restype = ctypes.c_short
+user32.GetCursorPos.argtypes = [ctypes.POINTER(wt.POINT)]
+user32.GetCursorPos.restype = wt.BOOL
+user32.GetDC.argtypes = [wt.HWND]
+user32.GetDC.restype = wt.HDC
+user32.ReleaseDC.argtypes = [wt.HWND, wt.HDC]
+user32.ReleaseDC.restype = ctypes.c_int
+
+user32.UpdateLayeredWindow.argtypes = [
+    wt.HWND, wt.HDC, ctypes.POINTER(wt.POINT), ctypes.POINTER(SIZE),
+    wt.HDC, ctypes.POINTER(wt.POINT), wt.COLORREF,
+    ctypes.POINTER(BLENDFUNCTION), wt.DWORD,
+]
+user32.UpdateLayeredWindow.restype = wt.BOOL
+
+gdi32.CreateCompatibleDC.argtypes = [wt.HDC]
+gdi32.CreateCompatibleDC.restype = wt.HDC
+gdi32.CreateDIBSection.argtypes = [wt.HDC, ctypes.POINTER(BITMAPINFO), ctypes.c_uint,
+                                   ctypes.POINTER(ctypes.c_void_p), wt.HANDLE, wt.DWORD]
+gdi32.CreateDIBSection.restype = wt.HBITMAP
+gdi32.SelectObject.argtypes = [wt.HDC, wt.HGDIOBJ]
+gdi32.SelectObject.restype = wt.HGDIOBJ
+gdi32.DeleteObject.argtypes = [wt.HGDIOBJ]
+gdi32.DeleteObject.restype = wt.BOOL
+gdi32.DeleteDC.argtypes = [wt.HDC]
+gdi32.DeleteDC.restype = wt.BOOL
+
+kernel32.GetModuleHandleW.argtypes = [wt.LPCWSTR]
+kernel32.GetModuleHandleW.restype = wt.HMODULE
+kernel32.OpenProcess.argtypes = [wt.DWORD, wt.BOOL, wt.DWORD]
+kernel32.OpenProcess.restype = wt.HANDLE
+kernel32.CloseHandle.argtypes = [wt.HANDLE]
+kernel32.CloseHandle.restype = wt.BOOL
+kernel32.QueryFullProcessImageNameW.argtypes = [wt.HANDLE, wt.DWORD, wt.LPWSTR,
+                                                ctypes.POINTER(wt.DWORD)]
+kernel32.QueryFullProcessImageNameW.restype = wt.BOOL
+
+
+DPI_AWARE = False
+
+
+def set_dpi_aware() -> bool:
+    """Включает per-monitor DPI. Без этого оверлей смещается при масштабе 125-150 %."""
+    global DPI_AWARE
+    try:
+        # DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2 = -4
+        user32.SetProcessDpiAwarenessContext(ctypes.c_void_p(-4))
+        DPI_AWARE = True
+        return True
+    except Exception:
+        try:
+            user32.SetProcessDPIAware()
+            DPI_AWARE = True
+            return True
+        except Exception:
+            # Старая Windows без DPI API: остаётся системный масштаб.
+            return False
+
+
+def last_error() -> int:
+    return ctypes.get_last_error()