![logo](https://upload.wikimedia.org/wikipedia/commons/b/b5/Kore_2g_logo.png)

[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/OpenKore/openkore)

![Language](https://img.shields.io/badge/language-Perl-blue.svg)

![Stars](https://img.shields.io/github/stars/OpenKore/openkore)
![Fork](https://img.shields.io/github/forks/OpenKore/openkore?label=Fork)
![Watch](https://img.shields.io/github/watchers/OpenKore/openkore?label=Watch)

![Issues](https://img.shields.io/github/issues/OpenKore/openkore)
![Pull Requests](https://img.shields.io/github/issues-pr/OpenKore/openkore.svg)
![Contributors](https://img.shields.io/github/contributors/OpenKore/openkore.svg)

![Github_Workflow_status](https://img.shields.io/github/actions/workflow/status/OpenKore/openkore/build_XSTools.yml?branch=master)
![Github_Workflow_CI](https://github.com/OpenKore/openkore/actions/workflows/build_XSTools.yml/badge.svg)

* OpenKore is a custom client and intelligent automated assistant for Ragnarok Online.
* It is a **free**, open source and cross-platform program _(Linux, Windows and MacOS are supported)_.

## Prerequisites

To run OpenKore you will need:
* [Read the Requirements page on our wiki](https://openkore.com/wiki/How_to_run_OpenKore#Requirements)

## Quickstart

1. [Download OpenKore](https://github.com/OpenKore/openkore/archive/master.zip) and extract it. Alternatively, you could press the **Windows Key + R**, type in ``cmd`` & enter. Run the following command in the cmd to clone.
***Note: [Git](https://git-scm.com/) required.***
```
git clone https://github.com/OpenKore/openkore.git
```

2. Configure OpenKore: [documentation](https://openkore.com/wiki/Category:control).
3. Run openkore.pl _(You can run start.exe or wxstart.exe if you use Windows)_.

## F.A.Q. (Frequently Asked Questions)
<!-- Source: https://forums.openkore.com/viewtopic.php?f=0&t=11287 -->
 1. **Have a problem?**
    - Update your openkore or download a new one.
 2. **Still having problems?**
    - Search in [Wiki](https://openkore.com/wiki/).
    - Search in [Forum](https://forums.openkore.com/).
    - Search in [Github issues](https://github.com/openkore/openkore/issues?utf8=%E2%9C%93&q=).
 3. **Cant find what you need? / Do not understand?**
    - Ask in [Discord](https://discord.com/invite/hdAhPM6).
 4. **Is it a problem in Openkore?**
    - Read [things to know](https://github.com/OpenKore/openkore#things-to-know) before [reporting](https://github.com/OpenKore/openkore/issues/new).

## Things to know

* Make sure you've read [FAQ](https://github.com/OpenKore/openkore#faq-frequently-asked-questions) especially to [run latest commit on master branch](https://github.com/OpenKore/openkore/commits/master) & checking [existed issue for your request.](https://github.com/OpenKore/openkore/issues?utf8=%E2%9C%93&q=)
* Please post in English.
* Please use the issue template.
* Please include informations about your server & any changes you did in your configuration.
* Briefly explain what happened, take a screenhot & include the error message _(If available)_.
* Please be advised any developers here are doing this on their free time. Please give some time for anyone to respond.

## Status of botting on Official Servers

| Server | Description | Protection | Status | Supporter |
| --- | --- | --- | --- | --- |
| [aRO Baphomet](https://www.gnjoy.asia/) | Asia RO | CheatDefender | Not working | N/A |
| [bRO](https://playragnarokonlinebr.com/) | Brazil RO | EAC | Not working | N/A |
| [cRO](https://ro.zhaouc.com/) | China RO | nProtect | Not working | N/A |
| [euRO Prime](https://eu.4game.com/roprime/) | Europe RO | Frost Security | Not working | N/A |
| [iRO Сhaos/Thor/Freya](http://renewal.playragnarok.com/) | International RO | EAC | Not working | N/A |
| [idRO Classic](https://roclassic.gnjoy.id/) | Indonesia RO | nProtect | Not Working | N/A |
| [idRO Yggdrasil](https://ro.gnjoy.id/) | Indonesia RO (Forever Love) | EAC | Not Working | N/A |
| [jRO](https://ragnarokonline.gungho.jp/) | Japan RO | nProtect | Not working | N/A |
| [kRO](http://ro.gnjoy.com/) | Korea RO | nProtect | Not working | N/A |
| [kRO Zero](http://roz.gnjoy.com/) | Korea RO | nProtect | Not working | N/A |
| [laRO](https://rola.maxion.gg/) | Latam (Landverse America) | Custom | Not working | N/A |
| [ROla](https://www.gnjoylatam.com/) | Latam RO | nProtect | Not working | N/A |
| [ruRO Prime](https://ru.4game.com/roprime/) | Russia RO | Frost Security | Not Working | ya4ept |
| [tRO Chaos/Thor](https://ro.gnjoy.in.th/) | Thailand RO (Online) | nProtect | Not Working | N/A |
| [tRO Classic](https://roc.gnjoy.in.th/) | Thailand RO (Classic) | nProtect | Not Working | N/A |
| [tRO Baphomet](https://rolth.maxion.gg/) | Thailand (Landverse) | Custom | Not Working | N/A |
| [tRO Baphomet](https://rolg.maxion.gg/) | Thailand (Landverse Genesis) | Custom | Not Working | N/A |
| [twRO](https://ro.gnjoy.com.tw/) | Taiwan RO | CheatDefender | Not Working | N/A |

## Contributing

OpenKore is developed by a [team](https://github.com/OpenKore/openkore/graphs/contributors) located around the world. Check out the [documentation](https://openkore.com/wiki/Manual) and if necessary, submit a pull request.

## Contacts

* [OpenKore Wiki](https://openkore.com/wiki/)
* [OpenKore forum](https://forums.openkore.com/)
* [Discord](https://discord.com/invite/hdAhPM6)
* [Russian Community](https://RO-fan.ru/)

## **Warning**

Other communities or websites are not affiliated to openkore.com

## Other Links

1. [Openkore History](https://openkore.com/wiki/OpenKore)
2. [Legacy Changelog](https://github.com/OpenKore/openkore/blob/master/LegacyChangelog.md)
3. [Openkore RoadMap](https://openkore.com/wiki/roadmap)
4. [Feature Requests and TODO Wiki](https://openkore.com/wiki/Category:Feature_Request) and [Feature Requests GitHub](https://github.com/OpenKore/openkore/issues?q=is%3Aopen+is%3Aissue+label%3A%22feature+request%22)

## License

This software is open source, licensed under the GNU General Public License, version 2.
Basically, this means that you're free to use and allowed to modify and distribute this software.
However, if you distribute modified versions, you **MUST** also distribute the source code.


See https://www.gnu.org/licenses/gpl-3.0.html for the full license.
