How to use every module

Install and update

OpenBot runs next to the Metin2 client you already play with. Nothing is copied into the game folder.

You need

• Windows 10 or 11.
• Metin2 started through the GameForge launcher. OpenBot is tested on the Romanian (ro-RO) client.
• Nothing else: no Python and no extra runtimes. The optional external control panel in the Panel folder needs Python 3.8 or newer.

Install

1. Download the zip from the home page and extract it anywhere, for example your Desktop.
2. Start Metin2 through GameForge and stay on the character selection screen.
3. Run native\OpenBotLauncher.exe from the OpenBot folder and pick your character. OpenBot loads while the character enters the game.
4. Click "Show Hackbar" at the right edge of the game screen, open a module and press Start.

Update

Extract the new version over the old folder. Your settings are stored per character in OpenBot\Saves\clients and are kept.

If the hackbar does not appear

Open OpenBotLoad.log in the OpenBot folder. If it says "PHASE 2 main import FAILED", the next line names the module that failed. Restart the client and run the launcher again from character selection.

The hackbar

The main OpenBot menu: turn the most used bots on or off with one click and open every other module.

How to use

1. Open or close this menu with the "Show Hackbar" shortcut on the right side of the screen.
2. Use the switch at the end of a row to turn that bot ON or off (the row shows ON / off).
3. Press the teal arrow on a row to open that bot's full window with all its settings.
4. Under MODULES, click a button to open that module's window.

Controls

Notes

• Farm Bot needs a path with at least 2 points before it starts.
• Turning Radar ON here also opens the Radar window.
• Anti Ban turned ON here watches for both GMs and players if nothing was selected.
• Every window has this yellow "i" button next to its title.

Auto-Hunt

Hunts the monsters around you on its own: attacks, casts your skills, drinks potions and elixirs and revives you after a death.

How to use

1. Click the skill icons you want cast (only learned skills can be switched on).
2. Type the HP % and SP % at which red and blue potions are drunk.
3. Switch the rows you need On: "Attack", "Focus", "Potions", "Skills", "Resurrection".
4. Optional: the teal arrow next to Attack picks WHAT to attack, the one next to Focus sets the radius.
5. Press "Save" to keep this setup, then "Start". Press "Stop" to end.

Controls

Notes

• Focus centres the circle where you stand when you press "Confirm" in Focus Range.
• After several deaths in one hunt it moves to the next channel and keeps hunting.
• Unlearned skills are shown dimmed and cannot be switched on.

Mob Puller

Makes the monsters around you run to you: it hops next to every monster out of reach, pokes it once and comes straight back.

How to use

1. Turn WaitHack (DmgHacks) OFF first - both drive your position.
2. Set "Max mobs" (slider at the top = ALL). The range is fixed at 40 m, the Bravery Cape reach.
3. Press "Pull once" for one sweep, or press "Auto OFF" to switch Auto on.
4. Press "Auto ON" again to stop.

Controls

Notes

• The poke gives the monster aggro but does NO damage.
• It needs a learned class skill (cast once after login to arm it). With none learned it does nothing and says so in chat.
• Idle monsters already next to you are poked too, never the one you are fighting.
• A monster it cannot reach from one spot is retried from another before being skipped.
• A monster gives up a target further than 40 m, so 40 m is what a cape really pulls.
• Pokes wait about 2 s after a skill cast, so Auto-Hunt casting skills slows the pull a little.

WaitHack

Hits many monsters around you very fast, from a distance.

How to use

1. Set "Range" and "Monsters" (how many are hit per round).
2. Pick the options you want (for example "Target only").
3. Press the Start button; press it again (Stop) to end.

Controls

Notes

• Near buildings it can teleport to reach monsters, which may occasionally disconnect you.
• Mob Puller will not run while WaitHack is on.

Speed Hack

Makes your character move faster by gliding it along the direction it is moving.

How to use

1. Drag the slider to pick the speed multiplier.
2. Press "Speed OFF" to turn it on (it then reads "Speed ON").
3. Then HOLD SHIFT to sprint at that speed; release SHIFT for normal speed.
4. Press "Speed ON" to switch it off.

Notes

• Keep it modest (2 - 3x): too fast and the server kicks you.
• The boost eases off as you stop, so the character settles without sliding past.

FarmBot

Walks a path you record and farms along it: destroys metin stones and mines ores.

How to use

1. "Moving" tab: stand on a spot and press "Add"; repeat along your route (at least 2 points).
2. Switch on "Mining?" and / or "Metins?".
3. "Mining" tab: pick which ores to mine.
4. Press the Start button; press it again to stop.
5. "Settings" tab: type a name and press "Save" to keep the path; pick it later and press "Load".

Controls

Stone Compass

Points a compass arrow at the nearest metin, ore or boss and records every one it sees.

How to use

1. Pick the "Target:" (Metin, Ore or Boss).
2. Pick the "Arrow:" size, or Auto (the arrow grows as you get closer).
3. Press the Start button; press it again to stop.
4. Press "Record List" to see everything recorded this session.

Notes

• The arrow is refreshed every 3 seconds.
• On Auto a firecracker shows when you are right on the target.

FishBot

Fishes for you: casts, catches the fish in the minigame and deals with every catch the way you chose.

How to use

1. Equip a fishing rod and keep bait (worms) in your inventory.
2. Under each catch set what happens to it (hover a square to see what it does).
3. Set "Min cast delay" and "Max cast delay" (a random wait between casts).
4. Press the green Start button; press it again to stop.

Controls

Notes

• The catch minigame is played inside the game for you.

EnergyBot

Buys weapons at the weapon dealer and gives them to the alchemist for energy fragments, again and again.

How to use

1. Go to a first village (map a1, b1 or c1).
2. Optional: switch on "Route recorded" and pick a route (recorded with Route Recorder).
3. Choose "Fill inventory" or "Buy set amount" (and type "Buy items").
4. Press the Start button; press it again to stop.

Controls

Notes

• The dealer's menu is answered hidden - no dialogue window appears.

Alchemy Bot

The Alchemy Bot's whole job: it finds its own way to any map it knows -- through portals and by talking to teleporter NPCs -- so you never record routes.

How to use

1. First time: stand by the alchemist and press "Scan NPCs". Do the same next to the storage keeper (left-click it first). Then go where you want to hunt and press "Add CP" once per spot.
2. Press "Start": it takes the quest, travels, hunts your checkpoints, deposits, and goes again. Press it again to stop.
3. "Go" / "Go to CP" are for travelling only, when you just want to get somewhere.
4. Press "Stop" at any time; grab the keyboard and it stands aside until you let go.

Controls

Notes

• Scan and checkpoints are saved per map; set them once and both stay remembered.
• Hunting uses your Auto-Hunt settings, so set the monsters and range up there.
• It learns: each crossing it makes and any spot it gets stuck on are remembered, so later trips avoid trouble.
• The status line shows what it is doing and why it stopped.

Biologist Timer

Tracks the biologist's cooldown and tells you when you can hand in the next item - even after restarting the game.

How to use

1. Just open the biologist: the cooldown is read from its window and the countdown starts on its own.
2. No biologist nearby? Type the hours and minutes and press "Start".
3. The window pops up on its own with the time left; "Reset" clears it.

Notes

• Each character has its own timer.
• A chat message tells you when the cooldown is over.

Teleport

Teleports or walks you to any point you choose on the map of the current area.

How to use

1. Hover the map: the coordinates of that spot appear next to the cursor.
2. Hold Shift over the spot to go there.
3. The "Mode" button switches between "Teleport" and "Walk".

Notes

• The blue numbers are your own position.
• It waits 2 seconds between two teleports.
• Zooming the game's own map (M) resizes this window.

Route Recorder

Records a route while you walk it, then walks it for you - there and back, over and over.

How to use

1. Type a name in the box (for example route1).
2. Press "Record" and walk the route yourself.
3. Press "Record" again to stop and save it.
4. Select a route in the list and press "Play"; press "Play" again to stop.

Controls

Notes

• EnergyBot and Alchemy Bot can use these routes too.
• Playback walks normally with pathfinding - no teleporting.
• You can take control while it walks; it continues from where you leave off.

Radar

Shows NPCs, ores, metins, players, bosses and monsters around you, on a small map and in a list.

How to use

1. "Settings" tab: switch on what to show, then press the Start button.
2. "Entities" tab: select an entry and press "Warp" to teleport to it.
3. "Radar" tab: the map around you; "-" and "+" zoom, "Map" opens the world map.

Notes

• Turning Radar ON in the main menu also opens this window.

Area map

A zoomable map of the current area with your position.

How to use

1. Press Ctrl+N to open or close it.
2. Use "-" and "+" (or the mouse wheel) to zoom.

Controls

Inventory Manager

Upgrades, sells, drops, stacks and sorts the items in your inventory.

How to use

1. Press the refresh icon to list your items (Slot, ID, Name) and select one.
2. Pick an action below; "STOP" cancels everything that is queued.

Controls

Notes

• "Drop All" throws away everything - use it with care.

Shop Creator

Opens your private shop with the price you set for each item.

How to use

1. Tick the "Sell" box on the left of an item to put it on the shop; untick it to leave it out (e.g. keep the armour, drop the chests). "All"/"None" tick or untick every item at once.
2. Type a price next to each item (0 leaves it out; 1kk = 1,000,000). WON and YANG are separate.
3. "Shop Scan" (title bar): with a Trade Glass in the inventory, looks up the lowest market price of every item and fills it in, minus the "Undercut" yang (default 1). Click again to stop.
4. Type the "Shop-Name:" (default SHOP; saved as you type).
5. Switch on "Multiply" if the price is per piece (multiplied by the stack size). Shop Scan switches it on: its prices are per piece.
6. "Clear" sets every price back to 0.
7. Press "Make Shop".

Notes

• You need a shop package in the inventory.
• Prices, the shop name and the undercut are remembered for next time.

Settings

Options shared by all bots: login, revive, wallhack, item pickup, attack mode and channels.

How to use

1. "General": "Auto Login", "Auto Revive" (+ "Revive delay"), the wallhack icons, "Close game in ... min", "AntiExp", "Time to wait after dead".
2. "Pickup": build the list of items to pick up with "Add Item" / "Remove".
3. "Attack": "One-Handed" / "Two-Handed" weapon mode; "Damage Hacks" opens WaitHack.
4. "Channels": press "CH 1", "CH 2", ... to change channel; "Refresh" re-reads them.

Controls

Notes

• Wallhack icons: walk through everything, or through mobs and terrain only.
• The monster icon + slider on "Attack" hits your selected target.

AntiBan

Watches for game masters, other players, a teleport you did not make, and chat that asks whether you are a bot -- then reacts for you, and can answer whispers.

How to use

1. Under "Watch for", switch on what to watch: "Game masters", "Other players", "Teleport", "Chat keywords".
2. Type the "Range (m)".
3. Under "Then", switch on what should happen.
4. Press the Start button; press it again to stop.
5. After a PM the bots keep going ~10 s (finish the fight), then pause; they resume on their own once the conversation has been quiet for 2 min.
6. After a TELEPORT, or anything from a GM, they stop and stay PAUSED until you press Start yourself.
7. A GM is never answered automatically - you answer, in your own words.

Controls

Notes

• Auto-reply answers at most 3 times per person; unknown messages get a "?".
• The bot's own teleports do not count: Teleporthack, the arrows, a channel change, a portal, a recorded route, the teleporter NPC, dying and relogging are all recognised.

Python File Loader

Runs a Python script inside the game.

How to use

1. Select a script in the list, or type its path in "File:".
2. Press "Load" to run it.
3. "Refresh" updates the list.

Notes

• Errors are shown in the status line under the list.
• Only run scripts you trust.

Check your download

Every release has a fingerprint (a SHA-256 hash). If the fingerprint of your file matches the one below, you have exactly the file published on this site.

1. Open PowerShell in the folder that holds the zip.
2. Run the command below.
3. Compare the result with the hash shown here. Capital letters do not matter.

Get-FileHash .\OpenBot.zip -Algorithm SHA256

Hash of :

For developers

OpenBot is written in Python and runs inside the game client. You can add your own bot mode: extend BotBase and put your logic in Frame(). BotBase handles the update loop, pausing, waiting while dead and the game-phase check.

from BotBase import BotBase
import chr, OpenLib, Movement, OpenLog

class MetinWalker(BotBase):
    def __init__(self):
        # run Frame() every 0.1 s, idle while dead
        BotBase.__init__(self, 0.1, waitIsPlayerDead=True)

    def StartBot(self):
        OpenLog.DebugPrint("MetinWalker started")

    def Frame(self):
        vid = OpenLib.GetNearestMonsterVid()
        if not vid or not OpenLib.IsThisMetin(vid):
            return
        x, y, z = chr.GetPixelPosition(vid)
        Movement.GoToPositionAvoidingObjects(x, y)

    def StopBot(self):
        Movement.StopMovement()

Helper modules

Press Ctrl+R in the game to reload edited modules without logging out.