View source for EQ2CharsUpgrade

== EQ2Chars.INC converted to EQ2Chars.xml ==
=== Who does this effect? ===
On or around June 2nd 2014, a patch was released that made EQ2Chars.inc obsolete. If you are a new user as of June 2nd 2014 or AFTER, then this does not apply to you at all. If you have ever used Ogrebot PRIOR to June 2nd 2014, then this DOES apply to you.
=== Why the change? ===
The concept behind EQ2Chars.INC was really, really terrible. It is a 'code' file, meaning it has actual code in the file. And having people with no coding experience modify it, is simply asking for trouble. Generally speaking it was relatively easy, copy/paste and change a few values, but if you copied ONE extra { or }, or missed one, it broke the entire file (we call this being freedo'd).

What made it even more complicated, was this file holds private information, so it's not like you could just share the file while asking for assistance.


It also meant I could never add more, or modify this file, because in doing so, it would wipe all the data out!


This shouldn't have ever been there, it should have been in a data file (a file that just contains this data, no code). But unfortunately it was this way from day 1, and changing it was a big task, and one I just didn't make the time for until now.
=== What is in this EQ2Chars.inc file? ===
There are 3 things contained in this file.

Key Binds. For example, if you do NOT use WASD/Num Lock/Home/End, they would be changed here.

Uplink information. If you use Ogre's 'Connect', this holds the information on where you are connecting.

Character Information. Your characters information (for auto login and authorization list).


==== Key Binds ====
This information will be "lost". When you load Ogrebot for the first time, there is a new tab, Key Binds, where you can re-enter this information. With how few people don't use the standard keys, making a little converter just wasn't worth the time to invest in it.

==== Uplink information ====
This information WILL be converted over, when/if your character information is. See Character information below for more details.

You can also add/remove uplink information inside of Ogrebot, on a new 'Uplink info' tab.

==== Character information ====
This is probably the biggest concern, as many people have a lot of toons, a lot of alts, and maybe some friends toons in their lists. I personally had 451 entries in mine! Don't worry, none of that is lost.

When Ogrebot loads, it checks to see if the new EQ2Chars.xml file exists, if it does NOT exist, it checks to see if EQ2Chars.inc file exists. If it DOES, then it converts the EQ2Chars.inc to EQ2Chars.xml. It also converts the uplink information also.

If you look in the console, it will tell you how many entries it converted, incase you are wondering.

Worth nothing, if you use OgreAutoLogin and it logs in for example, 3 toons at the same time, while the conversion is happening, the other two toons will not load the character information (because it's being updated). So the first time you log in and convert, you should just restart Ogrebot, so it picks it back up.