LirayBot — Setup & Calibration Guide

Contents

Quick start — just 6 steps
Install — 3 steps
Add your server
What calibration is and how it works
Target Panel (HP bar) — required
Character HP bar — recommended
Calibration per farm mode
Optional settings that pay off
Run the bot
Back up / move your settings
Troubleshooting

🚀 Quick start — really just 6 steps

Don't let the long list below scare you. The bot handles most of the settings itself — all you really have to do is this:

Install — open liray_updater.exe, enter your licence. (1)
Add a server — pick the game window from the list, the name fills in itself. (2)
Target HP bar — click a metin in game, then press 🎯 Find automatically. (4) REQUIRED
Character HP bar — press ❤ Find automatically. (5)
Metin template — draw a box over the "Metin" text above a metin. (6)
Start — pick the farm mode, press START; stop with F12. (8)

The bot does the rest by itself: the metin brightness threshold, telling the metin stone apart from the name, filtering out fixed interface text, minimap search, reconnecting, captcha protection, closing panels, camera setup... you don't need to touch any of these by hand.

1Install — 3 steps

Unzip. There is exactly one file inside: liray_updater.exe. Nothing else to look for.
Double-click it. Windows asks whether to allow changes → click Yes.
Enter your licence key and activate. The program downloads everything it needs, then the interface opens.

⚠ Administrator rights are required

The game runs elevated, so the bot must run elevated too. If you do not click Yes on the Windows prompt, the bot will open but its keystrokes and clicks will never reach the game — nothing will happen on screen.

💡 Every time from now on

Always start the bot through liray_updater.exe. That is what pulls updates — don't launch any other file directly.

yonetici-kutu — Turkish Windows shown. To skip the UAC prompt every time: right-click `liray_updater.exe` → **Properties → Compatibility** → tick *Run this program as an administrator*.

2Add your server

Go to Setup → 🌐 Server and add the server you play on.

You do not type the window title — you pick the open game window from a list and the bot reads the title and window size itself.

Start the game (don't leave it minimised).
Go to Setup → 🌐 Server and scroll to the Add new server card.
Pick the game window from the dropdown — the server name fills in automatically, edit it if you like.
Press + Add.

If the list is empty the game isn't running, or it started after you opened this page: press ↻ Windows to refresh the list.

sunucu-ekle — Pick the window from the dropdown, the name fills in by itself, then press **+ Add**. **↻ Windows** refreshes the list.

Every server keeps its own settings and calibrations, so you can play on several servers without them interfering.

3What calibration is and how it works

Calibration means showing the bot what to look at on screen. Every server's interface is different, so the bot cannot know this by itself — you show it once.

Every calibration works the same way:

Click the relevant Calibrate button
The game comes to the front and the screen dims slightly
Hold the left mouse button and drag a box over the target area, then release
Press ESC to cancel

Before you calibrate

The game must be open and not minimised.
Whatever you are calibrating must be visible on screen at that moment (for the HP bar, click a target first).
If you change the game's resolution later, redo your calibrations. The bot compensates up to a point, but recalibrating is the reliable fix.

kalibrasyon-ani — When you press **Calibrate** the game comes to the front and the screen dims like this — that is normal. Hold the left mouse button and drag a box over the target; release to save, ESC to cancel.

4Target Panel (HP bar)REQUIRED

The bot will not start without this. The home page shows "⚠ Calibrate the target HP bar before starting".

Why it matters so much: the bot detects whether a metin died by reading this bar. Kill counting, the "combat is taking too long" recovery, damage (DPS) tracking and mount handling all depend on it.

Easiest way: 🎯 Find automatically RECOMMENDED

You no longer need to draw a box — the bot finds the target panel and the red health bar itself.

In game, click a metin so the target panel appears at the top of the screen.
Press Setup → 🌐 Server → 🎯 Find automatically - click a metin in game.
The bot compares a few frames and marks the panel and only the red bar itself (takes a few seconds). When it's done you get a "✓ found" notification.

💡 Why this became so important

The most common mistake was drawing the box too wide and catching the panel frame or name as well — the bot then misread health. Find automatically takes only the red bar, so it removes that mistake. It also reads the percentage the same as the game, so you can see it working correctly.

Alternative: draw the box by hand

If Find automatically doesn't work for some reason (the panel isn't showing, or two clients get mixed up) you can still calibrate by hand:

In game, click a metin so the target panel appears.
Go to Setup → 🌐 Server → Calibrate
On the screen that opens, box only the red health bar.

The most common mistake happens here

✅ CORRECT: only the filled red bar.

❌ WRONG: the panel frame, the target's name, the level text, empty areas — keep these out of the box.

Include too much and the bot misreads health: it kills metins without registering them, runs pointless recovery manoeuvres, and your yield drops.

hedef-paneli — The calibration rows on the Server page. **✓ Calibrated** means that item is done; the ↺ button clears it.

hp-dogru — **✅ CORRECT** — the box contains only the red health bar.

hp-yanlis — **❌ WRONG** — the panel frame, the target name, the level text and the close button are all inside the box. The bot then misreads health and **never registers the kill**.

hata-hali — This is what the home page looks like while the HP bar is not calibrated. **Go to Setup →** takes you straight to the right page.

5Character HP barRECOMMENDED

Setup → 🌐 Server → ❤ Find automatically - character health bar

The bot finds this one too — just press the button; you don't even need to click a metin in game (your character's health bar is always on screen anyway). If Find automatically doesn't work, you can still draw the box by hand with Calibrate.

Calibrate this and the bot will drink a potion when your health drops and recover by itself if you die. Skip it and the bot still runs — you just lose those two safety nets.

6Calibration per farm mode

Metin mode

Metin → 📛 Capture the metin name

Draw a box over the white "Metin" text above a metin stone — take only the word "Metin", not the level text like "Lv 40". The bot strips the background automatically.

This template is used for verification: when the bot spots white text it checks here whether it is really a metin. Without it, the bot may try to click other white text such as player or NPC names.

💡 The size doesn't have to be exact

It's fine if you draw the box a little too big or too small — the bot adjusts the template itself to the real name size. And when you switch to another metin type on the same server (Shadow, Soul, Fire...) you don't need to recalibrate: since the word "Metin" is common to all of them, the same template catches them all.

💡 Don't touch the white threshold

The bot tunes it automatically based on how bright the map is, and re-measures if detection drops. You never need to set it by hand.

Mob / Slot mode

Mob → Mob template REQUIRED

Without a mob template the bot cannot find targets in this mode. It can also detect mobs by their red names (toggle on the same page).

Fishing mode

Fishing → 🎣 Basics

Game panel — the area where the fishing mini-game appears
Detection mode game → Fish template
Detection mode symbol → Symbol region (the mark above your character's head)
Set the bait / cast / reel keys to match your own keybinds

metin-ismi — Example metin-name template: box only the white text — the bot strips the background itself.

balik-panel — For the **Game panel** calibration, box this whole window — the pink ring and the fish appear inside it.

7Optional settings that pay off

Setting	What it does
Advanced → 🎯 Extra keys	Camera setup — don't skip this. With the camera unadjusted, metins look far away or unreachable and the bot wastes time. Typically F zooms out and G tilts the camera up. Add these keys; the bot presses them as soon as farming starts and refreshes them periodically. You also drive your active attack skill from here — see the section just below.
Advanced → 🚫 Unwanted panels	You define the windows that pop up and block the bot: calibrate the panel, then choose what should happen when it appears (press a key or click somewhere). Five slots available.
Advanced → 🗺 Minimap	When no metin is left on screen, the bot walks toward metin dots on the minimap instead of wandering randomly. Useful if your server shows metins on the minimap. Needs two calibrations — see below.
Advanced → 🔄 Auto reconnect	Gets you back in if the connection drops. Asks for four screenshots in order: login screen, character screen, the button on it, and the maintenance/already-connected popup.
Advanced → ⚔ Skills	Refreshes buffs when they expire. For each skill set its key and calibrate its icon while the buff is active.
Setup → ❤ Potion & Death	Calibrate the "Start Here" button so the bot revives and continues after dying.
Advanced → 📦 Loot / Advanced → 🔗 Metin queue	Loot: presses Z to pick up after a kill. Metin queue: clicks several metins in sequence (requires auto-loot enabled in game). They cannot be used together — pick one.
Advanced → 🕶 Human behavior	Periodic breaks, reaction delay before clicks, click scatter. This is the strongest defence against behaviour-based detection — leave it on.
Advanced → 💰 Selling · Advanced → 💬 PM protection · Advanced → 🧩 CAPTCHA	Sells items to a sellbox · pauses and alerts you when a private message arrives · switches to protection when a captcha appears.

ekstra-tuslar — **Advanced → Extra keys**. Here `f` and `g` are set; the two numbers are the 'press every N seconds' range, the last one is how long the key is held.

paneller — **Unwanted panels**, 5 slots. For each calibrated panel you choose what happens when it shows up.

⚔ Active attack skill — “press key 2 every 10 seconds”

Advanced → 🎯 Extra keys

The thing most people never find: Extra keys are pressed during combat too. So if you add your attack skill's key here, the bot uses the skill while it is hitting the metin. There is no separate “active skill” setting — this is it.

Click + New key.
Key = your skill's key (e.g. 2).
min s = 10, max s = 12 → the bot presses it at a random moment every 10-12 seconds.
hold s = a short value (a normal tap). Increase it for skills that need the key held down.

There is no lower limit — 10 is fine. Giving min and max slightly different values is recommended: pressing at exactly the same second every time looks robotic. There are 8 slots, so you can set up 8 different skills/keys, each with its own cooldown interval.

💡 Don't confuse it with the Skills page

Advanced → ⚔ Skills is for buffs: it presses the key only when the icon is missing from the screen. For an active attack skill use Extra keys — it presses on the interval you set, without looking at any icon.

❤ Health potion

Setup → ❤ Potion & Death

Turn on Potion active, set Key to your potion key and HP threshold (0-1) to the ratio at which it should be used (0.5 = 50%).

It only works if the character HP bar is calibrated — that is where the bot reads your health from.

🔵 SP / Mana potion

Setup → ❤ Potion & Death

Exactly the same logic as the health potion, but for the SP (mana) bar: turn on SP potion active, set Key to your SP potion key and SP threshold to the ratio at which it should be used.

No calibration needed. The blue SP bar is detected automatically at the bottom left — you only pick the key and the threshold.

On classes that deal damage through skills (mage, shaman), without this setting the bot stops casting as soon as SP runs out: it only auto-attacks and kills get noticeably slower.

🗺 Minimap search — two-step setup

Advanced → 🏃 Anti-stuck & Panels → 🗺 Find metins via minimap

Minimap region → Calibrate → draw a box over the round map area. Keep the decorative frame and the surrounding buttons outside the box.
🎨 Colour of the metin dot → Pick the colour → draw a small box over one metin dot on the minimap.

Why does it ask for the colour separately?

The metin dot is not the same colour on every server. It may be white on one, green, yellow or even red on another. The bot cannot guess which one to look for — you show it once.

If you skip this, the bot assumes a white/grey dot and treats red ones as monsters. On a server with coloured metin dots it would find nothing at all.

The colour you picked is shown as a small swatch in the interface, so you can tell if you picked the wrong thing. Catching a bit of dark background in the box is fine — the bot uses the brightest part of it.

Colour tolerance is in the same section: raise it if dots are being missed, lower it if the bot walks toward the wrong things. The log shows how many dots it sees each scan.

minimap-ayar — The minimap card: region, dot colour and colour tolerance are all set here.

minimap-bolge — How to box the minimap region: **the round map only**. Keep the ornate frame and the X button outside — the bright white of the frame is otherwise taken for a metin dot and the bot walks the wrong way.

8Run the bot

Open the game and move your character to your farming spot.
In the bot go to Home → pick the farm mode (Metin / Mob / Fishing).
Check that it says "✓ Ready to farm" at the top. A "⚠" means the HP bar isn't calibrated.
Press START.

To stop: F12

Press F12 to stop the bot. It works even while the game window is in focus. The STOP button in the interface does the same thing.

The Logs page shows live what the bot is doing: how many metins it sees, what it clicked, how health is dropping, why it ran a recovery. Share this log when asking for support.

farma-hazir — When everything is set you get this green line at the top.

baslat-mod — **START BOT** / **STOP**, and the farm mode selector underneath.

9Back up / move your settings

Setup → 🌐 Server → 💾 Back up / transfer settings

This produces a single .lirayayar file containing every server's settings plus all calibration images.

💡 Why this matters

Copying only the settings file will not work — without the calibration images the bot cannot run. Take this backup before changing computers or reinstalling, import it on the other side, and you won't have to calibrate from scratch.

Importing overwrites the settings of a server with the same name; the interface asks you to confirm.

yedekle — **Export** writes the backup file, **Import** restores it on the other machine.

10Troubleshooting

Symptom	Cause and fix
"⚠ Calibrate the target HP bar before starting"	The target panel isn't calibrated. See section 4.
The bot opens but nothing happens in game	Administrator rights weren't granted. Close it, run `liray_updater.exe` again and click Yes.
"Window not found"	The window you picked when adding the server isn't open right now, or its title changed. Start the game; if the title changed, go to Setup → 🌐 Server, press ↻ Windows and add the server again.
It can't find metins / clicks the wrong things	The "metin name" template is missing or wrong. Redraw the box over the white "Metin" text. Also make sure the camera is set up (Extra keys).
Lots of metins on screen but it keeps saying "searching for metins" / spins on the minimap	You may have picked the wrong "Metin" template — the level text (Lv 40) or some other text entirely. Redraw the box over the white text containing only the word "Metin". (The current version fixes the template size itself; the problem is usually picking the wrong spot.)
It kills metins but doesn't count them / runs pointless recoveries	The HP bar box is too wide. Recalibrate so it contains only the red bar.
The bot stalls while metins are on screen	A window may be blocking it. Define it under Advanced → 🚫 Unwanted panels.
I changed resolution and it broke	Redo the calibrations — the target HP bar at minimum.
Settings didn't carry over to a new PC	Only the profile was copied. Use the `.lirayayar` backup from section 9 — it carries the calibration images too.
The bot finds metins but never clicks / kills nothing	First make sure the whole game window is inside the screen. If part of it hangs off the edge (or spills onto a second monitor), the bot cannot see that area and the mouse cannot reach it — no click lands. Move the window fully inside the screen. Current builds (v17.9.52 and later) fix this automatically at startup; if you are on an older build, update.
Mob mode finds nothing	Open Mob → 👹 Mob detection: if mob names are not red on your server, name detection cannot work — calibrate a Mob template instead. If you already have a template, Template sensitivity may be too high; lower it step by step. When nothing at all is found, the threshold is usually the cause.