A free/open source client and automation tool for Ragnarok Online
Clone or download
Latest commit cfe5b5e Nov 17, 2018
Failed to load latest commit information.
.github Merge pull request #1637 from OpenKore/new_issues Aug 10, 2018
control added proccess in AI and implemented timeout Jul 8, 2018
fields Update Map base kRO [data.grf] Aug 29, 2018
plugins Merge pull request #2464 from Nipodemos/improve-reuse-of-code Nov 12, 2018
script-launcher small edit Sep 16, 2013
src Merge pull request #2502 from cydh/hotfix/idro_vender-1 Nov 17, 2018
tables Merge pull request #2501 from OpenKore/iro_update Nov 17, 2018
tools Merge remote-tracking branch 'refs/remotes/OpenKore/master' into item… Jul 24, 2017
.gitignore add support to cryptkey in xkore 1 and 3 (#1374) Nov 17, 2017
Distfiles Moved src files Feb 28, 2016
LICENSE Fix again T.T Jul 11, 2018
LegacyChangelog.md Removing junk line in LegacyChangelog.md Aug 1, 2018
Makefile Run tests with `make test` instead of launching openkore Dec 25, 2016
NetRedirect.dll Added compiled binaries from misc.openkore.com Mar 4, 2016
OpenKore Help & Support.url Moved src files Feb 28, 2016
README.md added link to Russian Community Nov 5, 2018
SConstruct Fix "use of undeclared identifier dNOOP" when building on OS X Dec 27, 2016
XSTools.dll Added compiled binaries from misc.openkore.com Mar 4, 2016
makedist.sh Moved src files Feb 28, 2016
mapview.pl Moved src files Feb 28, 2016
openkore.pl Translation module changes Dec 29, 2017
perltidyrc fix whitespace, add suggested perltidyrc (#1041) Aug 31, 2017
start-poseidon.exe Moved src files Feb 28, 2016
start.exe Added compiled binaries from misc.openkore.com Mar 4, 2016
start.pl Moved src files Feb 28, 2016
wxstart.exe Added compiled binaries from misc.openkore.com Mar 4, 2016



  • OpenKore is an 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).


To run OpenKore you will need:


  1. Download OpenKore and extract it. Alternatively, you could press the Windows Key + R, type in cmd and enter. Run the following command in the cmd to clone. Note: Git required.
git clone https://github.com/OpenKore/openkore.git
  1. Configure OpenKore: documentation.
  2. Run openkore.pl (you can run start.exe or wxstart.exe if you use Windows).

Things to know

  • Before submitting an issue, ensure you are running the latest commit on branch.
  • Check if an issue already exists for your request.
  • Please post in English if possible.
  • Please use the issue template, please post information about the server and your configuration.
  • Remember, developers are doing this on free time.

Weekly Maintence on official Servers

Some official servers (like bRO and iRO) have a weekly maintence.
When this weekly maintence happens, openkore stops working on this server.
To make it work again, a developer have to update openkore.
So if you see a green message written: timeout on map server... reconnecting.... that means you have to wait for developer to update openkore.
So please wait, don't need to make an issue to tell this.

Status of botting on Official Servers

Server Description Protection Status Supporter
iRO International(US) RO *** Botable, Weekly Update allanon
bRO Brazil RO nProtect Botable, Weekly Update lututui, Henrybk, alisonrag
idRO Indonesia RO (Renewal) *** Botable alisonrag
idRO Indonesia RO (classic) *** Not Working N/A
fRO Europe(french) RO *** Botable allanon
cRO China RO nProtect Botable, Weekly Update alisonrag
kRO:Zero Korea Zero server Cdclient Not Working alisonrag
kRO Korea RO Cdclient Need Verification N/A
jRO Japan RO HShield Need Verification N/A
tRO Thailand RO EAC Need Verification N/A
mRO Malaysia RO EAC Not Working N/A
phRO Philippines RO EAC Not Working N/A
ruRO Russia RO Frost Security Not Working ya4ept
twRO Taiwan RO Cdclient Not working N/A


OpenKore is developed by a team located around the world. Check out the documentation and if necessary submit a pull request!



Other communities are not affiliated to openkore.com

Other Links

  1. Openkore History
  2. Legacy Changelog
  3. Openkore RoadMap
  4. Feature Requests and TODO Wiki and Feature Requests GitHub


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 http://www.gnu.org/licenses/gpl.html for the full license.