How STMod works (overview)
This page gives a high-level picture of how the pieces fit together — enough to understand what you're running and why certain settings exist, without getting into internal implementation details.
Starting a client
STMod is not a standalone bot — it runs inside your Metin2 game client. The launcher starts the game client for you and attaches STMod's engine to it, which is why STMod's tabs (General, Farming, Fishbot, ...) appear as a panel inside the game window itself rather than as a separate program.
Setting up a server
Before you can start anything, STMod needs a server profile: the server's name, the game client to start, and whether it's a private or an Official server. You create one the first time you log in, and you can keep as many as you like and switch between them.
Server profilesRunning multiple clients
The STMod Launcher is where you manage every client you want to run. Each character/account you want to bot at the same time gets its own client slot, with its own login, its own restart behavior, and its own STMod settings once it's running.

Clients: X/99 (with +/−) — Add or remove client slots, up to 99.
Per slot: Autologin, Restart client (auto-restarts that slot if the client crashes — STMod also watches for Runtime errors and restarts even if the window hasn't fully crashed), User/Pass, Pin, Click #1/Click #2 (for servers whose login needs a specific screen click — use Set x,y to record the position), Enter, Char number, CH, Server.
The green ▶ button starts that slot's client; Hide/Show toggles whether its game window is visible.
Stop all metin2 clients — Stops every running slot at once.
Launcher-wide options
The checkboxes under Stop all metin2 clients apply to the whole profile, not to one slot, and are saved with it:
Execute self script — Auto-loads your own Python script into every client you start. STMod creates
Data\Python\self_script.pyfor you the first time you tick this; put your code in that file.Manual mode — STMod doesn't load its panel for you. Instead it tells you to focus the game window and press
Insert,TABorCapsLockto load it yourself. This is forced on for Official servers.Attack as ninja — Makes your character play the assassin's faster dual-blade attack animations whatever weapon it's actually holding. This is a local animation change only — bow and fishing animations are left alone.
Auto minimize when start new client — Minimises each client to the system tray as it starts.
Keep windows on focus — Keeps bringing the game windows to the front.
OCR Groq captcha solver — Solves server-side captchas using the Groq API. It needs your own (free) Groq API key — see Plugins → Groq API key. Not available on Official servers.
Use proxy (Proxifier based) — Routes clients through proxies using Proxifier. STMod offers to open the Proxifier download page if it isn't installed.
If no clients running for more than X minutes, shutdown PC — Shuts the machine down once nothing has been running for that long.
Activating your license
Your STMod license is tied to your account on stmod.net, not entered directly into the launcher. To activate it:
Log into your account on the stmod.net dashboard.
Go to the Redeem License Key section.
Enter your key there to redeem it onto your account.
The rest of the launcher
Everything that isn't a per-client setting lives in the launcher's menu bar — profile switching, the language and theme pickers, and the plugin windows.
Launcher menusTheme editorWe keep this page intentionally high-level — the anti-cheat/anti-tamper measures and the exact license-validation protocol aren't documented here on purpose.
Last updated