Frequently Asked Questions: Difference between revisions

From OpenKore Wiki
Jump to navigation Jump to search
No edit summary
Line 1: Line 1:
== About OpenKore ==
== About OpenKore ==
=== What is OpenKore? ===
=== What is OpenKore? ===
OpenKore is a free open source [http://www.ragnarokonline.com/ Ragnarok Online] client + bot program, mostly written in [http://www.perl.org/ perl], created back in 2003. It is licensed under the [http://en.wikipedia.org/wiki/GNU_General_Public_License GNU General Public License GPL].
OpenKore is a free open source [http://www.ragnarokonline.com/ Ragnarok Online] client + bot program, mostly written in [http://www.perl.org/ perl], created back in 2003. It is licensed under the [http://en.wikipedia.org/wiki/GNU_General_Public_License GNU General Public License GPL].


=== What functions does OpenKore have? ===
=== What functions does OpenKore have? ===
OpenKore is capable of doing '''almost everything''' a normal player could do on Ragnarok. Additionally, its AI permits the use of automatic tasks, like attack, move, use items and skills, storage, buy and sell, vending, teleport etc. You can see an (incomplete) list of currently supported features and tasks in the [[Overview]].
OpenKore is capable of doing '''almost everything''' a normal player could do via Ragnarok Online client. Additionally, its AI permits the use of automatic tasks, like attack, move, use items and skills, storage, buy and sell, vending, teleport etc. You can see an (incomplete) reference list of currently built-in features in the [[Overview]].


=== Is it possible to...? ===
=== Is it possible to...? ===
Most likely. Even if there is no such a ready-to-go feature in OpenKore and plugins, you can always implement it yourself, as OpenKore is free open source program.
Most likely. Even if there is no such a ready-to-go feature in OpenKore and plugins, you can always implement it yourself via macro, plugin or patch, as OpenKore is free open source software. (You'll probably have to know general concepts about computer science and programming for that.)


== Installation and Configuration ==
== Installation and Configuration ==
=== Where do I download Openkore? ===
=== Where do I download Openkore? ===
You can download it on the [[Links]] page. Be sure to check the [[Quick Start Guide]] if you are new on Openkore.
You can download it on the [[Links]] page. Be sure to check the [[Quick Start Guide]] if you are new on OpenKore.


=== How do I make it connect in my server? ===
=== How do I make it connect in my server? ===
Line 17: Line 19:


=== How do I configure it? ===
=== How do I configure it? ===
Openkore is based on text configuration files, which are located on control folder. Each file has it's own function and can easily be configured according to your needs. See [[Manual]].
Openkore is based on text configuration files, which are located on <code>control</code> folder. Each file has it's own function and can easily be configured according to your needs. See [[Manual]].


=== Why is everything in a single line in control/table files? ===
=== Everything in a single line in control/table files ===
That's not the problem of our files, but the problem of your text editor (known problem of Windows Notepad; it's not an OpenKore problem). Try another editor.
That's not the problem of our files, but the problem of your text editor (known problem of Windows Notepad). Try another editor.


=== How can I update it? ===
=== How can I update it? ===
There are two ways to update Openkore:
There are two ways to update Openkore:
* Using Openkore SVN AutoUpdater - see [[Updating Openkore Guide]] (recommended for normal users)
* Using Openkore SVN AutoUpdater - see [[Updating Openkore Guide]] (recommended for normal users)
* Using any subversion client, like TortoiseSVN - see [[TortoiseSVN Guide]] (recommended for testers, supporters, developers users)
* Using any subversion client, for example TortoiseSVN - see [[TortoiseSVN Guide]] (recommended for testers, supporters, developers users)


=== Does OpenKore work on Linux? ===
=== Does OpenKore work on Linux? ===
Yes, Linux users can run OpenKore without any additional binaries (directly in perl). See [[How to run OpenKore on Linux/Unix]].
Yes, Linux (and other OSes) users can run OpenKore without any additional binaries (directly in perl). See [[How to run OpenKore on Linux/Unix]].
 
=== OpenKore versions ===
* '''trunk''' ''(located at ^/openkore/trunk/ in version control)'', also called '''svn version''' — development version which developers directly working at, so it's continuously updated. There could be some bugs introduced, but that's also always most up to time version with all new features and fixes
* '''release''' — currently, snapshot of '''trunk''' from some point of time
 
== General Errors ==
 
=== ext/hash_fun.h: No such file or directory ===
In file <code>src/auto/XSTools/utils/sparseconfig.h</code>, replace <code>#define HASH_FUN_H <ext/hash_fun.h></code> with <code>#define HASH_FUN_H <backward/hash_fun.h></code>.
 
=== XSTools.dll is not found ===
[[How to run Openkore#Precompiled binaries|Download]] XSTools.dll and extract to src/auto/XSTools/
 
=== Your Windows TCP/IP stack is broken ===
You must fix TCP/IP stack:
 
; Windows XP
# Make sure you're logged in as Administrator, or an administrator account.
# Open a DOS command window.
# Type the following command and press Enter:
netsh int ip reset resetlog.txt
 
; Windows 2000
http://www.petri.co.il/reinstall_tcp_ip_on_windows_2000.htm
 
=== Recursive inheritance detected in package Network::Receive::kRO ===
You need at least Perl 5.10 if you're using kRO [[serverType]] tree.
 
== Connection Errors ==


== Connecting Errors ==
=== Error code 10060 when connecting to the server ===
=== Unknown error code 10060 when connecting to the server ===
Connection to the server can't be established. Probably means that your server information (probably address), set on servers.txt, is wrong. See [[Connectivity Guide]] to learn how to get your server's information correctly.
Your server information, set on servers.txt, is wrong. See [[Connectivity Guide]] to learn how to get your server's information correctly.


=== Timeout on Account server, error when connecting to the server ===
=== Timeout on Account server, error when connecting to the server ===
Wrong server information, on servers.txt, or the server has some kind of anti-bot protection againts bots. See [[Connectivity Guide]] to check your server's information and [[Unsupported servers]] for a list of unbottable servers.
Wrong server information, on servers.txt, or the server has some kind of anti-bot protection againts bots. See [[Connectivity Guide]] to check your server's information and [[Unsupported servers]] for a list of unbottable servers.


=== Openkore is showing character information incorrectly ===
=== Incorrect characters information ===
Wrong value for '''charBlockSize''' on servers.txt. Possible values are 106, 108 or 112 for servers with Renewal Interface.
Wrong value for '''charBlockSize''' on servers.txt. Possible values are 106, 108 or 112 for servers with Renewal Interface.


== Common Problems ==
=== Anti-bot that prevents OpenKore from connecting ===
=== My server has some kind of anti-bot, that doesn't let Openkore connect===
Unfortunately, Openkore doesn't have any built-in solution to break those anti-bots.
Unfortunately, Openkore doesn't have any built-in solution to break those anti-bots.


=== OpenKore is showing NPCs and monsters as "Unknown xxxxxxxx" ===
== Ingame Problems ==
 
=== NPCs and monsters are shown as "Unknown xxxxxxxx" ===
Wrong serverType, on servers.txt, or outdated recvpackets. See [[Connectivity Guide]] to get the correct [[serverType]] and [[Packet Length Extractor]] to extract the [[recvpackets]].
Wrong serverType, on servers.txt, or outdated recvpackets. See [[Connectivity Guide]] to get the correct [[serverType]] and [[Packet Length Extractor]] to extract the [[recvpackets]].


=== OpenKore is showing items and skills as "?????" ===
=== Items and skills are shown as "?????" ===
That's probably your terminal failing to show Korean names which are used with kRO [[serverType]] by default. Change your server settings or use command line arguments to select table set with names your terminal can handle.
That's probably your terminal failing to show Korean names which are used with kRO [[serverType]] by default. Change your server settings or use command line arguments to select table set with names your terminal can handle.


Line 63: Line 94:
Packet length is known and packet structure is found, but there is no handler function in serverType for it. Packet ignored.
Packet length is known and packet structure is found, but there is no handler function in serverType for it. Packet ignored.


=== XSTools.dll is not found ===
=== Skills are not used or not recognized ===
[[How to run Openkore#Precompiled binaries|Download]] XSTools.dll and extract to src/auto/XSTools/
Check [[skills]] output for skill names you're using. If there is no skills shown (but your character has some), then your server settings are wrong.


=== ext/hash_fun.h: No such file or directory ===
== Macro plugin ==
In file <code>src/auto/XSTools/utils/sparseconfig.h</code>, replace:
#define HASH_FUN_H <ext/hash_fun.h>
with:
#define HASH_FUN_H <backward/hash_fun.h>
 
=== Your Windows TCP/IP stack is broken ===


If you have got this message, you must reinstall TCP/IP stack by following these instructions:
; Windows XP
1. Make sure you're logged in as Administrator, or an administrator account.
2. Open a DOS command window.
3. Type the following command and press Enter:
netsh int ip reset resetlog.txt
; Windows 2000
http://www.petri.co.il/reinstall_tcp_ip_on_windows_2000.htm
=== Recursive inheritance detected while looking for method '...' in package 'Network::Receive::kRO::...' ===
You need at least perl5.10 if you're using kRO [[serverType]] tree.
== Macro plugin ==
=== Malformed UTF-8 character ===
=== Malformed UTF-8 character ===
Save your macro file in UTF-8 encoding.
Save your macro file in UTF-8 encoding.

Revision as of 04:37, 12 June 2010

About OpenKore

What is OpenKore?

OpenKore is a free open source Ragnarok Online client + bot program, mostly written in perl, created back in 2003. It is licensed under the GNU General Public License GPL.

What functions does OpenKore have?

OpenKore is capable of doing almost everything a normal player could do via Ragnarok Online client. Additionally, its AI permits the use of automatic tasks, like attack, move, use items and skills, storage, buy and sell, vending, teleport etc. You can see an (incomplete) reference list of currently built-in features in the Overview.

Is it possible to...?

Most likely. Even if there is no such a ready-to-go feature in OpenKore and plugins, you can always implement it yourself via macro, plugin or patch, as OpenKore is free open source software. (You'll probably have to know general concepts about computer science and programming for that.)

Installation and Configuration

Where do I download Openkore?

You can download it on the Links page. Be sure to check the Quick Start Guide if you are new on OpenKore.

How do I make it connect in my server?

Currently, Openkore only comes with Official Servers information, so if you want to play on a private server, for example, you will need to get its server's information. See Connectivity Guide.

How do I configure it?

Openkore is based on text configuration files, which are located on control folder. Each file has it's own function and can easily be configured according to your needs. See Manual.

Everything in a single line in control/table files

That's not the problem of our files, but the problem of your text editor (known problem of Windows Notepad). Try another editor.

How can I update it?

There are two ways to update Openkore:

  • Using Openkore SVN AutoUpdater - see Updating Openkore Guide (recommended for normal users)
  • Using any subversion client, for example TortoiseSVN - see TortoiseSVN Guide (recommended for testers, supporters, developers users)

Does OpenKore work on Linux?

Yes, Linux (and other OSes) users can run OpenKore without any additional binaries (directly in perl). See How to run OpenKore on Linux/Unix.

OpenKore versions

  • trunk (located at ^/openkore/trunk/ in version control), also called svn version — development version which developers directly working at, so it's continuously updated. There could be some bugs introduced, but that's also always most up to time version with all new features and fixes
  • release — currently, snapshot of trunk from some point of time

General Errors

ext/hash_fun.h: No such file or directory

In file src/auto/XSTools/utils/sparseconfig.h, replace #define HASH_FUN_H <ext/hash_fun.h> with #define HASH_FUN_H <backward/hash_fun.h>.

XSTools.dll is not found

Download XSTools.dll and extract to src/auto/XSTools/

Your Windows TCP/IP stack is broken

You must fix TCP/IP stack:

Windows XP
  1. Make sure you're logged in as Administrator, or an administrator account.
  2. Open a DOS command window.
  3. Type the following command and press Enter:
netsh int ip reset resetlog.txt
Windows 2000

http://www.petri.co.il/reinstall_tcp_ip_on_windows_2000.htm

Recursive inheritance detected in package Network::Receive::kRO

You need at least Perl 5.10 if you're using kRO serverType tree.

Connection Errors

Error code 10060 when connecting to the server

Connection to the server can't be established. Probably means that your server information (probably address), set on servers.txt, is wrong. See Connectivity Guide to learn how to get your server's information correctly.

Timeout on Account server, error when connecting to the server

Wrong server information, on servers.txt, or the server has some kind of anti-bot protection againts bots. See Connectivity Guide to check your server's information and Unsupported servers for a list of unbottable servers.

Incorrect characters information

Wrong value for charBlockSize on servers.txt. Possible values are 106, 108 or 112 for servers with Renewal Interface.

Anti-bot that prevents OpenKore from connecting

Unfortunately, Openkore doesn't have any built-in solution to break those anti-bots.

Ingame Problems

NPCs and monsters are shown as "Unknown xxxxxxxx"

Wrong serverType, on servers.txt, or outdated recvpackets. See Connectivity Guide to get the correct serverType and Packet Length Extractor to extract the recvpackets.

Items and skills are shown as "?????"

That's probably your terminal failing to show Korean names which are used with kRO serverType by default. Change your server settings or use command line arguments to select table set with names your terminal can handle.

Packet Tokenizer: Unknown switch: xxxx

Packet switch not found in recvpackets.txt, so packet length is not known. Recvpackets file needs to be updated for your server.

Valid RO packet switches are: 0064—04FF, 0700—07FF. Other switches (like 9600, 0000 and others) indicate that your server settings (or recvpackets) are wrong.

Packet Parser: Unknown switch: xxxx

Packet length is known, but packet structure in %packet_list is not found. Packet ignored.

Main forum topic about unknown switches and unhandled packets

Packet Parser: Unhandled Packet: xxxx Handler: xxxxxxxx

Packet length is known and packet structure is found, but there is no handler function in serverType for it. Packet ignored.

Skills are not used or not recognized

Check skills output for skill names you're using. If there is no skills shown (but your character has some), then your server settings are wrong.

Macro plugin

Malformed UTF-8 character

Save your macro file in UTF-8 encoding.

Syntax error at line 1 (when there is no syntax errors)

Save your macro file in UTF-8 encoding without BOM. If you are using Notepad and getting this, do not use it anymore.