ISXOgre - User contributions [en]

OgreOther:AutoLogin

2013-05-22T22:14:45Z

Mooshi: /* Step By Step */

== Overview ==
OgreAutoLogin can open sessions, and/or use existing sessions, and log characters into specific sessions.

Note: This is an advanced feature. You will need to follow specific instructions, including creating windows short cuts to be able to set this up.

Remember: If you only want to auto login one character, all you need is to complete the "Before You Begin" section. Then launch EQ2, open the innerspace console (using the ~ key), and type "ogre login toonname" (without the quotes).

==Before You Begin==
In order to use OgreAutoLogin, you need the following set up prior.
* A blank loginscene. Information on obtaining one can be found in the [[NewUserWalkthrough:Page1|New user walkthrough page 1]]. (Scroll down to the section titled Blank loginscene)
* EQ2Chars.inc must be filled in with correct information. Information can be found in the [[NewUserWalkthrough:Page2|New user walkthrough page 2]].

== Step By Step ==
#MAKE SURE you have completed the "Before You Begin" section! DO NOT SKIP ANY STEPS on EITHER of the pages linked above, or the rest of this will NOT work.
#Locate and edit the following file - Innerspace/Scripts/EQ2OgreCommon/OgreAutoLogin/AutoLogin.iss. Here is a listing of the first few lines of that file: 
#:<code>******** Ogre Automated Login. Version 1.03 **********</code>
#:<code>Change the below 2 to match what you have. Below are the defaults. All computers must have the same names. Use uniformity.</code>
#:<code>variable string GameName="Everquest 2"</code>
#:<code>variable string ProfileName="Everquest 2 Default Profile"</code>
#:<code>Below is the amount of time the script will wait after it loads a session.</code>
#*Edit the GameName and ProfileName to match the values you used when you configured Innerspace.
#*If you are unsure of what your game name is you can right click the innerspace taskbar notification window
#:[[image:IS.taskbar.png]]
#*At the top, you'll see a list of the "GameNames" innerspace knows about.
#*Moving your mouse over the Everquest2 game will show the name of the "ProfileName" you need to use.
#*Use these exact names (case sensitive) when editing your AutoLogin.iss file.
#Create a Desktop Shortcut that will launch the Ogre Auto Login UI
#*Right-click on your desktop and click 'New' -> 'Shortcut'
#*Click the Browse... button to locate Innerspace/Innerspace.exe. This will put the path to Innerspace.exe in the "Type the location of the item:" box.
#*Edit that line to append "runscript eq2ogrecommon/OgreAutoLogin/AutoLogin" after the path to the exe.
#*The line should now look something like 
#:D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/OgreAutoLogin/AutoLogin 
#::or 
#:"C:\Program Files\Innerspace\InnerSpace.exe" runscript eq2ogrecommon/OgreAutoLogin/AutoLogin 
#:(if the path to Innerspace.exe contains spaces or special characters, you'll need quotes around the path as shown in the 2nd example)
#*Click the Next button, Give it a name and click Finish.
#Launch the Ogre Auto Login UI by double-clicking the desktop shortcut you just created.
#* Note: This loads INSIDE of the uplink console. Depending on your computer, it will pop up in front of you, OR you will see a new window in your task bar, go ahead and click it. If you can't find the window anywhere, right-click the Innerspace icon in your taskbar and select Console.
#:[[image:Console.autologin.png|500px]]
#*The Character List (on the left) will contain all your characters from the EQ2Chars.ini file you edited above.
#*#Select the first Character from Character List
#*#Select the PC you wish to use for this character.
#*#Select the Innerspace Session name to use for that character (e.g. IS1).
#*#* Currently it performs the following checks
#*#** If session is "Any"
#*#*** Toon will stay logged in on its current session
#*#** If Session is specific "IS1" / "IS2" etc
#*#*** If toon online: Checks to see if the toon is on that specific session. If not, log off.
#*#*** If toon offline: If that specific session is in use, log that session off.
#*#** If an alt (based off of eq2chars.inc list) is logged on, they will be logged off to allow the characters you have selected to be logged on.
#*#Click Add Selection
#*#Repeat for each character in the group you wish to have logged in at the same time.
#*Type in a name to save the profile as (on the right side), then click the Save Profile button.
#**The next time you run Ogre Auto Login UI, the saved profiles will be available under the "load profile" button.
#*Click 'Load Toons and exit'.
#*Wait for it to finish logging in all your toons (this can take a long time, even as much as a few minutes) then you can click 'X' to close the Innerspace Console.
#And you've now successfully set up and used Ogre Auto Login. You can just click your desktop shortcut any time you want, and it will launch the Ogre Auto Login UI (remember it might be in the background, or you might have to manually launch the Innerspace Console if your shortcut doesn't bring the window up automatically) If you are happy with this, you can stop now. If you'd like to get even fancier, read the section below on launching a specific toon list directly from a desktop shortcut (without launching the Ogre Auto Login UI).

== Loading a specific toon list profile ==
Once you have created a toon list profile using the step-by-step method above, you can automatically launch and login that profile using Ogre Automated Login, rather than using the UI.
* The AutoLogin script that your desktop shortcut runs can accept 1 parameter, a saved toon list profile. When a parameter is passed, it automatically runs the script in the background, bypassing the Ogre Auto Login UI entirely.
* IMPORTANT *** You MUST create the toon list profile using the Ogre Auto Login UI *BEFORE* you can use this
#Let's assume you saved your toon list profile as "MainGroup".
#Create a new Desktop Shortcut exactly like you did above.
#When you get to the part where you're appending to the Innerspace.exe path, also append "MainGroup" at the very end. Example:
#* <code>D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/OgreAutoLogin/AutoLogin MainGroup</code>
#Now you have two desktop shorcuts. The first one will launch the UI, and the second one will automatically log in your "MainGroup" toons, but will bypass the UI.

== Quirks ==
* It's a good idea to have Innerspace running before you double-click your desktop shortcuts. Double-clicking your shortcuts will launch Innerspace if it is not already running. However:
** If Innerspace needs to patch, it will do so, reload itself, and run the script you were trying to run, but it will not include any parameters you were passing in (i.e. the "MainGroup" toon list profile name.
** If Innerspace is already open, it simply runs the script with the parameters (which is a good thing).
* There is VERY limited user error checking. So use some common sense. For example: If you say you want the toon Kannkor to load on IS8 and that's it, it will load 1 session (IS1), and fail to load Kannkor because it can't find IS8. It's best to start to have the entire set (Kannkor IS1, Kannkor2 IS2 etc), or use the "Any" option.
* The odd time, when changing toons around, 1 session would crash. I can't reproduce this bug other than rarely, and randomly, so I believe it still exists. If this happens to you, look at the uplink console of that computer, and you should see a line such as: Command given: ogre -<stuff>-. I need the <stuff>. It will have your toon name, but if it has anything else (including spaces) I need to know exactly what that other stuff is.
* Note: When you run this, it loads ISXOgre into your uplink. Which should patch ISXOgre fine. However if you are in the game and need to patch ISXOgre, you will need to unload the extension from the uplink console (done via loading the console and ext -unload isxogre).

== Using Multiple Computers ==
If you are using multiple computers, you must have them "connected" prior to running your desktop shortcuts.

If you like, you can create yet another desktop shortcut to connect them. Just create a shortcut to Innerspace.exe like you did above, and when you get to the part about appending the script name, append this:
: <code>runscript eq2ogrecommon/ogreconnect</code>
So your full shortcut link should look like this:
: <code>D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/ogreconnect</code>
And give this shortcut a name like "Ogre Connect"
* When using this shortcut, "nothing" visually you can see will happen. It simply connects your computers.
*'''Ensure all computers are using the same naming in the game profile in Innerspace game configuration.'''

Now if you've accomplished all of the "Step by Step" section above, you will have multiple shortcuts on your desktop.
A typical startup sequence if you are using multiple computers would be:
# Launch Innerspace on all computers.
# Double-Click your "Ogre Connect" desktop shortcut.
# Double-Click your "Auto Login" desktop shortcut
#* This can be either the one that launches the UI or one that launches one of your toon list groups.

OgreOther:AutoLogin

2013-05-22T22:01:15Z

Mooshi: /* Using Multiple Computers */

== Overview ==
OgreAutoLogin can open sessions, and/or use existing sessions, and log characters into specific sessions.

Note: This is an advanced feature. You will need to follow specific instructions, including creating windows short cuts to be able to set this up.

Remember: If you only want to auto login one character, all you need is to complete the "Before You Begin" section. Then launch EQ2, open the innerspace console (using the ~ key), and type "ogre login toonname" (without the quotes).

==Before You Begin==
In order to use OgreAutoLogin, you need the following set up prior.
* A blank loginscene. Information on obtaining one can be found in the [[NewUserWalkthrough:Page1|New user walkthrough page 1]]. (Scroll down to the section titled Blank loginscene)
* EQ2Chars.inc must be filled in with correct information. Information can be found in the [[NewUserWalkthrough:Page2|New user walkthrough page 2]].

== Step By Step ==
#MAKE SURE you have completed the "Before You Begin" section! DO NOT SKIP ANY STEPS on EITHER of the pages linked above, or the rest of this will NOT work.
#Locate and edit the following file - Innerspace/Scripts/EQ2OgreCommon/OgreAutoLogin/AutoLogin.iss. Here is a listing of the first few lines of that file: 
#:<code>******** Ogre Automated Login. Version 1.03 **********</code>
#:<code>Change the below 2 to match what you have. Below are the defaults. All computers must have the same names. Use uniformity.</code>
#:<code>variable string GameName="Everquest 2"</code>
#:<code>variable string ProfileName="Everquest 2 Default Profile"</code>
#:<code>Below is the amount of time the script will wait after it loads a session.</code>
#*Edit the GameName and ProfileName to match the values you used when you configured Innerspace.
#*If you are unsure of what your game name is you can right click the innerspace taskbar notification window
#:[[image:IS.taskbar.png]]
#*At the top, you'll see a list of the "GameNames" innerspace knows about.
#*Moving your mouse over the Everquest2 game will show the name of the "ProfileName" you need to use.
#*Use these exact names (case sensitive) when editing your AutoLogin.iss file.
#Create a Desktop Shortcut that will launch the Ogre Auto Login UI
#*Right-click on your desktop and click 'New' -> 'Shortcut'
#*Click the Browse... button to locate Innerspace/Innerspace.exe. This will put the path to Innerspace.exe in the "Type the location of the item:" box.
#*Edit that line to append "runscript eq2ogrecommon/OgreAutoLogin/AutoLogin" after the path to the exe.
#*The line should now look something like 
#:D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/OgreAutoLogin/AutoLogin 
#::or 
#:"C:\Program Files\Innerspace\InnerSpace.exe" runscript eq2ogrecommon/OgreAutoLogin/AutoLogin 
#:(if the path to Innerspace.exe contains spaces or special characters, you'll need quotes around the path as shown in the 2nd example)
#*Click the Next button, Give it a name and click Finish.
#Launch the Ogre Auto Login UI by double-clicking the desktop shortcut you just created.
#* Note: This loads INSIDE of the uplink console. Depending on your computer, it will pop up in front of you, OR you will see a new window in your task bar, go ahead and click it. If you can't find the window anywhere, right-click the Innerspace icon in your taskbar and select Console.
#:[[image:Console.autologin.png|500px]]
#*The Character List (on the left) will contain all your characters from the EQ2Chars.ini file you edited above.
#**Select the first Character from Character List
#**Select the PC you wish to use for this character.
#**Select the Innerspace Session name to use for that character (e.g. IS1).
#*** Currently it performs the following checks
#**** If session is "Any"
#***** Toon will stay logged in on its current session
#**** If Session is specific "IS1" / "IS2" etc
#***** If toon online: Checks to see if the toon is on that specific session. If not, log off.
#***** If toon offline: If that specific session is in use, log that session off.
#**** If an alt (based off of eq2chars.inc list) is logged on, they will be logged off to allow the characters you have selected to be logged on.
#**Click Add Selection
#**Repeat for each character in the group you wish to have logged in at the same time.
#*Type in a name to save the profile as (on the right side), then click the Save Profile button.
#**The next time you run Ogre Auto Login UI, the saved profiles will be available under the "load profile" button.
#*Click 'Load Toons and exit'.
#*Wait for it to finish logging in all your toons (this can take a long time, even as much as a few minutes) then you can click 'X' to close the Innerspace Console.
#And you've now successfully set up and used Ogre Auto Login. You can just click your desktop shortcut any time you want, and it will launch the Ogre Auto Login UI (remember it might be in the background, or you might have to manually launch the Innerspace Console if your shortcut doesn't bring the window up automatically) If you are happy with this, you can stop now. If you'd like to get even fancier, read the section below on launching a specific toon list directly from a desktop shortcut (without launching the Ogre Auto Login UI).

== Loading a specific toon list profile ==
Once you have created a toon list profile using the step-by-step method above, you can automatically launch and login that profile using Ogre Automated Login, rather than using the UI.
* The AutoLogin script that your desktop shortcut runs can accept 1 parameter, a saved toon list profile. When a parameter is passed, it automatically runs the script in the background, bypassing the Ogre Auto Login UI entirely.
* IMPORTANT *** You MUST create the toon list profile using the Ogre Auto Login UI *BEFORE* you can use this
#Let's assume you saved your toon list profile as "MainGroup".
#Create a new Desktop Shortcut exactly like you did above.
#When you get to the part where you're appending to the Innerspace.exe path, also append "MainGroup" at the very end. Example:
#* <code>D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/OgreAutoLogin/AutoLogin MainGroup</code>
#Now you have two desktop shorcuts. The first one will launch the UI, and the second one will automatically log in your "MainGroup" toons, but will bypass the UI.

== Quirks ==
* It's a good idea to have Innerspace running before you double-click your desktop shortcuts. Double-clicking your shortcuts will launch Innerspace if it is not already running. However:
** If Innerspace needs to patch, it will do so, reload itself, and run the script you were trying to run, but it will not include any parameters you were passing in (i.e. the "MainGroup" toon list profile name.
** If Innerspace is already open, it simply runs the script with the parameters (which is a good thing).
* There is VERY limited user error checking. So use some common sense. For example: If you say you want the toon Kannkor to load on IS8 and that's it, it will load 1 session (IS1), and fail to load Kannkor because it can't find IS8. It's best to start to have the entire set (Kannkor IS1, Kannkor2 IS2 etc), or use the "Any" option.
* The odd time, when changing toons around, 1 session would crash. I can't reproduce this bug other than rarely, and randomly, so I believe it still exists. If this happens to you, look at the uplink console of that computer, and you should see a line such as: Command given: ogre -<stuff>-. I need the <stuff>. It will have your toon name, but if it has anything else (including spaces) I need to know exactly what that other stuff is.
* Note: When you run this, it loads ISXOgre into your uplink. Which should patch ISXOgre fine. However if you are in the game and need to patch ISXOgre, you will need to unload the extension from the uplink console (done via loading the console and ext -unload isxogre).

== Using Multiple Computers ==
If you are using multiple computers, you must have them "connected" prior to running your desktop shortcuts.

If you like, you can create yet another desktop shortcut to connect them. Just create a shortcut to Innerspace.exe like you did above, and when you get to the part about appending the script name, append this:
: <code>runscript eq2ogrecommon/ogreconnect</code>
So your full shortcut link should look like this:
: <code>D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/ogreconnect</code>
And give this shortcut a name like "Ogre Connect"
* When using this shortcut, "nothing" visually you can see will happen. It simply connects your computers.
*'''Ensure all computers are using the same naming in the game profile in Innerspace game configuration.'''

Now if you've accomplished all of the "Step by Step" section above, you will have multiple shortcuts on your desktop.
A typical startup sequence if you are using multiple computers would be:
# Launch Innerspace on all computers.
# Double-Click your "Ogre Connect" desktop shortcut.
# Double-Click your "Auto Login" desktop shortcut
#* This can be either the one that launches the UI or one that launches one of your toon list groups.

OgreOther:AutoLogin

2013-05-22T22:00:44Z

Mooshi: /* Using Multiple Computers */

== Overview ==
OgreAutoLogin can open sessions, and/or use existing sessions, and log characters into specific sessions.

Note: This is an advanced feature. You will need to follow specific instructions, including creating windows short cuts to be able to set this up.

Remember: If you only want to auto login one character, all you need is to complete the "Before You Begin" section. Then launch EQ2, open the innerspace console (using the ~ key), and type "ogre login toonname" (without the quotes).

==Before You Begin==
In order to use OgreAutoLogin, you need the following set up prior.
* A blank loginscene. Information on obtaining one can be found in the [[NewUserWalkthrough:Page1|New user walkthrough page 1]]. (Scroll down to the section titled Blank loginscene)
* EQ2Chars.inc must be filled in with correct information. Information can be found in the [[NewUserWalkthrough:Page2|New user walkthrough page 2]].

== Step By Step ==
#MAKE SURE you have completed the "Before You Begin" section! DO NOT SKIP ANY STEPS on EITHER of the pages linked above, or the rest of this will NOT work.
#Locate and edit the following file - Innerspace/Scripts/EQ2OgreCommon/OgreAutoLogin/AutoLogin.iss. Here is a listing of the first few lines of that file: 
#:<code>******** Ogre Automated Login. Version 1.03 **********</code>
#:<code>Change the below 2 to match what you have. Below are the defaults. All computers must have the same names. Use uniformity.</code>
#:<code>variable string GameName="Everquest 2"</code>
#:<code>variable string ProfileName="Everquest 2 Default Profile"</code>
#:<code>Below is the amount of time the script will wait after it loads a session.</code>
#*Edit the GameName and ProfileName to match the values you used when you configured Innerspace.
#*If you are unsure of what your game name is you can right click the innerspace taskbar notification window
#:[[image:IS.taskbar.png]]
#*At the top, you'll see a list of the "GameNames" innerspace knows about.
#*Moving your mouse over the Everquest2 game will show the name of the "ProfileName" you need to use.
#*Use these exact names (case sensitive) when editing your AutoLogin.iss file.
#Create a Desktop Shortcut that will launch the Ogre Auto Login UI
#*Right-click on your desktop and click 'New' -> 'Shortcut'
#*Click the Browse... button to locate Innerspace/Innerspace.exe. This will put the path to Innerspace.exe in the "Type the location of the item:" box.
#*Edit that line to append "runscript eq2ogrecommon/OgreAutoLogin/AutoLogin" after the path to the exe.
#*The line should now look something like 
#:D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/OgreAutoLogin/AutoLogin 
#::or 
#:"C:\Program Files\Innerspace\InnerSpace.exe" runscript eq2ogrecommon/OgreAutoLogin/AutoLogin 
#:(if the path to Innerspace.exe contains spaces or special characters, you'll need quotes around the path as shown in the 2nd example)
#*Click the Next button, Give it a name and click Finish.
#Launch the Ogre Auto Login UI by double-clicking the desktop shortcut you just created.
#* Note: This loads INSIDE of the uplink console. Depending on your computer, it will pop up in front of you, OR you will see a new window in your task bar, go ahead and click it. If you can't find the window anywhere, right-click the Innerspace icon in your taskbar and select Console.
#:[[image:Console.autologin.png|500px]]
#*The Character List (on the left) will contain all your characters from the EQ2Chars.ini file you edited above.
#**Select the first Character from Character List
#**Select the PC you wish to use for this character.
#**Select the Innerspace Session name to use for that character (e.g. IS1).
#*** Currently it performs the following checks
#**** If session is "Any"
#***** Toon will stay logged in on its current session
#**** If Session is specific "IS1" / "IS2" etc
#***** If toon online: Checks to see if the toon is on that specific session. If not, log off.
#***** If toon offline: If that specific session is in use, log that session off.
#**** If an alt (based off of eq2chars.inc list) is logged on, they will be logged off to allow the characters you have selected to be logged on.
#**Click Add Selection
#**Repeat for each character in the group you wish to have logged in at the same time.
#*Type in a name to save the profile as (on the right side), then click the Save Profile button.
#**The next time you run Ogre Auto Login UI, the saved profiles will be available under the "load profile" button.
#*Click 'Load Toons and exit'.
#*Wait for it to finish logging in all your toons (this can take a long time, even as much as a few minutes) then you can click 'X' to close the Innerspace Console.
#And you've now successfully set up and used Ogre Auto Login. You can just click your desktop shortcut any time you want, and it will launch the Ogre Auto Login UI (remember it might be in the background, or you might have to manually launch the Innerspace Console if your shortcut doesn't bring the window up automatically) If you are happy with this, you can stop now. If you'd like to get even fancier, read the section below on launching a specific toon list directly from a desktop shortcut (without launching the Ogre Auto Login UI).

== Loading a specific toon list profile ==
Once you have created a toon list profile using the step-by-step method above, you can automatically launch and login that profile using Ogre Automated Login, rather than using the UI.
* The AutoLogin script that your desktop shortcut runs can accept 1 parameter, a saved toon list profile. When a parameter is passed, it automatically runs the script in the background, bypassing the Ogre Auto Login UI entirely.
* IMPORTANT *** You MUST create the toon list profile using the Ogre Auto Login UI *BEFORE* you can use this
#Let's assume you saved your toon list profile as "MainGroup".
#Create a new Desktop Shortcut exactly like you did above.
#When you get to the part where you're appending to the Innerspace.exe path, also append "MainGroup" at the very end. Example:
#* <code>D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/OgreAutoLogin/AutoLogin MainGroup</code>
#Now you have two desktop shorcuts. The first one will launch the UI, and the second one will automatically log in your "MainGroup" toons, but will bypass the UI.

== Quirks ==
* It's a good idea to have Innerspace running before you double-click your desktop shortcuts. Double-clicking your shortcuts will launch Innerspace if it is not already running. However:
** If Innerspace needs to patch, it will do so, reload itself, and run the script you were trying to run, but it will not include any parameters you were passing in (i.e. the "MainGroup" toon list profile name.
** If Innerspace is already open, it simply runs the script with the parameters (which is a good thing).
* There is VERY limited user error checking. So use some common sense. For example: If you say you want the toon Kannkor to load on IS8 and that's it, it will load 1 session (IS1), and fail to load Kannkor because it can't find IS8. It's best to start to have the entire set (Kannkor IS1, Kannkor2 IS2 etc), or use the "Any" option.
* The odd time, when changing toons around, 1 session would crash. I can't reproduce this bug other than rarely, and randomly, so I believe it still exists. If this happens to you, look at the uplink console of that computer, and you should see a line such as: Command given: ogre -<stuff>-. I need the <stuff>. It will have your toon name, but if it has anything else (including spaces) I need to know exactly what that other stuff is.
* Note: When you run this, it loads ISXOgre into your uplink. Which should patch ISXOgre fine. However if you are in the game and need to patch ISXOgre, you will need to unload the extension from the uplink console (done via loading the console and ext -unload isxogre).

== Using Multiple Computers ==
If you are using multiple computers, you must have them "connected" prior to running your desktop shortcuts.

If you like, you can create yet another desktop shortcut to connect them. Just create a shortcut to Innerspace.exe like you did above, and when you get to the part about appending the script name, append this:
: <code>runscript eq2ogrecommon/ogreconnect</code>
So your full shortcut link should look like this:
: <code>D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/ogreconnect</code>
And give this shortcut a name like "Ogre Connect"
* When using this shortcut, "nothing" visually you can see will happen. It simply connects your computers.
*'''Ensure all computers are using the same naming in the game profile in Innerspace game configuration.'''

Now if you've accomplished all of the "Step by Step" section above, you will have multiple shortcuts on your desktop.
A typical startup sequence if you are using multiple computers would be:
# Launch Innerspace.
# Double-Click your "Ogre Connect" desktop shortcut.
# Double-Click your "Auto Login" desktop shortcut
#* This can be either the one that launches the UI or one that launches one of your toon list groups.

OgreOther:AutoLogin

2013-05-22T21:48:34Z

Mooshi: /* Using Multiple Computers */

== Overview ==
OgreAutoLogin can open sessions, and/or use existing sessions, and log characters into specific sessions.

Note: This is an advanced feature. You will need to follow specific instructions, including creating windows short cuts to be able to set this up.

Remember: If you only want to auto login one character, all you need is to complete the "Before You Begin" section. Then launch EQ2, open the innerspace console (using the ~ key), and type "ogre login toonname" (without the quotes).

==Before You Begin==
In order to use OgreAutoLogin, you need the following set up prior.
* A blank loginscene. Information on obtaining one can be found in the [[NewUserWalkthrough:Page1|New user walkthrough page 1]]. (Scroll down to the section titled Blank loginscene)
* EQ2Chars.inc must be filled in with correct information. Information can be found in the [[NewUserWalkthrough:Page2|New user walkthrough page 2]].

== Step By Step ==
#MAKE SURE you have completed the "Before You Begin" section! DO NOT SKIP ANY STEPS on EITHER of the pages linked above, or the rest of this will NOT work.
#Locate and edit the following file - Innerspace/Scripts/EQ2OgreCommon/OgreAutoLogin/AutoLogin.iss. Here is a listing of the first few lines of that file: 
#:<code>******** Ogre Automated Login. Version 1.03 **********</code>
#:<code>Change the below 2 to match what you have. Below are the defaults. All computers must have the same names. Use uniformity.</code>
#:<code>variable string GameName="Everquest 2"</code>
#:<code>variable string ProfileName="Everquest 2 Default Profile"</code>
#:<code>Below is the amount of time the script will wait after it loads a session.</code>
#*Edit the GameName and ProfileName to match the values you used when you configured Innerspace.
#*If you are unsure of what your game name is you can right click the innerspace taskbar notification window
#:[[image:IS.taskbar.png]]
#*At the top, you'll see a list of the "GameNames" innerspace knows about.
#*Moving your mouse over the Everquest2 game will show the name of the "ProfileName" you need to use.
#*Use these exact names (case sensitive) when editing your AutoLogin.iss file.
#Create a Desktop Shortcut that will launch the Ogre Auto Login UI
#*Right-click on your desktop and click 'New' -> 'Shortcut'
#*Click the Browse... button to locate Innerspace/Innerspace.exe. This will put the path to Innerspace.exe in the "Type the location of the item:" box.
#*Edit that line to append "runscript eq2ogrecommon/OgreAutoLogin/AutoLogin" after the path to the exe.
#*The line should now look something like 
#:D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/OgreAutoLogin/AutoLogin 
#::or 
#:"C:\Program Files\Innerspace\InnerSpace.exe" runscript eq2ogrecommon/OgreAutoLogin/AutoLogin 
#:(if the path to Innerspace.exe contains spaces or special characters, you'll need quotes around the path as shown in the 2nd example)
#*Click the Next button, Give it a name and click Finish.
#Launch the Ogre Auto Login UI by double-clicking the desktop shortcut you just created.
#* Note: This loads INSIDE of the uplink console. Depending on your computer, it will pop up in front of you, OR you will see a new window in your task bar, go ahead and click it. If you can't find the window anywhere, right-click the Innerspace icon in your taskbar and select Console.
#:[[image:Console.autologin.png|500px]]
#*The Character List (on the left) will contain all your characters from the EQ2Chars.ini file you edited above.
#**Select the first Character from Character List
#**Select the PC you wish to use for this character.
#**Select the Innerspace Session name to use for that character (e.g. IS1).
#*** Currently it performs the following checks
#**** If session is "Any"
#***** Toon will stay logged in on its current session
#**** If Session is specific "IS1" / "IS2" etc
#***** If toon online: Checks to see if the toon is on that specific session. If not, log off.
#***** If toon offline: If that specific session is in use, log that session off.
#**** If an alt (based off of eq2chars.inc list) is logged on, they will be logged off to allow the characters you have selected to be logged on.
#**Click Add Selection
#**Repeat for each character in the group you wish to have logged in at the same time.
#*Type in a name to save the profile as (on the right side), then click the Save Profile button.
#**The next time you run Ogre Auto Login UI, the saved profiles will be available under the "load profile" button.
#*Click 'Load Toons and exit'.
#*Wait for it to finish logging in all your toons (this can take a long time, even as much as a few minutes) then you can click 'X' to close the Innerspace Console.
#And you've now successfully set up and used Ogre Auto Login. You can just click your desktop shortcut any time you want, and it will launch the Ogre Auto Login UI (remember it might be in the background, or you might have to manually launch the Innerspace Console if your shortcut doesn't bring the window up automatically) If you are happy with this, you can stop now. If you'd like to get even fancier, read the section below on launching a specific toon list directly from a desktop shortcut (without launching the Ogre Auto Login UI).

== Loading a specific toon list profile ==
Once you have created a toon list profile using the step-by-step method above, you can automatically launch and login that profile using Ogre Automated Login, rather than using the UI.
* The AutoLogin script that your desktop shortcut runs can accept 1 parameter, a saved toon list profile. When a parameter is passed, it automatically runs the script in the background, bypassing the Ogre Auto Login UI entirely.
* IMPORTANT *** You MUST create the toon list profile using the Ogre Auto Login UI *BEFORE* you can use this
#Let's assume you saved your toon list profile as "MainGroup".
#Create a new Desktop Shortcut exactly like you did above.
#When you get to the part where you're appending to the Innerspace.exe path, also append "MainGroup" at the very end. Example:
#* <code>D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/OgreAutoLogin/AutoLogin MainGroup</code>
#Now you have two desktop shorcuts. The first one will launch the UI, and the second one will automatically log in your "MainGroup" toons, but will bypass the UI.

== Quirks ==
* It's a good idea to have Innerspace running before you double-click your desktop shortcuts. Double-clicking your shortcuts will launch Innerspace if it is not already running. However:
** If Innerspace needs to patch, it will do so, reload itself, and run the script you were trying to run, but it will not include any parameters you were passing in (i.e. the "MainGroup" toon list profile name.
** If Innerspace is already open, it simply runs the script with the parameters (which is a good thing).
* There is VERY limited user error checking. So use some common sense. For example: If you say you want the toon Kannkor to load on IS8 and that's it, it will load 1 session (IS1), and fail to load Kannkor because it can't find IS8. It's best to start to have the entire set (Kannkor IS1, Kannkor2 IS2 etc), or use the "Any" option.
* The odd time, when changing toons around, 1 session would crash. I can't reproduce this bug other than rarely, and randomly, so I believe it still exists. If this happens to you, look at the uplink console of that computer, and you should see a line such as: Command given: ogre -<stuff>-. I need the <stuff>. It will have your toon name, but if it has anything else (including spaces) I need to know exactly what that other stuff is.
* Note: When you run this, it loads ISXOgre into your uplink. Which should patch ISXOgre fine. However if you are in the game and need to patch ISXOgre, you will need to unload the extension from the uplink console (done via loading the console and ext -unload isxogre).

== Using Multiple Computers ==
If you are using multiple computers, you must have them "connected" prior to running your desktop shortcuts.

If you like, you can create yet another desktop shortcut to connect them. Just create a shortcut to Innerspace.exe like you did above, and when you get to the part about appending the script name, append this:
: <code>runscript eq2ogrecommon/ogreconnect</code>
So your full shortcut link should look like this:
: <code>D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/ogreconnect</code>
And give this shortcut a name like "Ogre Connect"

Now if you've accomplished all of the "Step by Step" section above, you will have multiple shortcuts on your desktop.
A typical startup sequence if you are using multiple computers would be:
# Launch Innerspace.
# Double-Click your "Ogre Connect" desktop shortcut.
# Double-Click your "Auto Login" desktop shortcut
#* This can be either the one that launches the UI or one that launches one of your toon list groups.

* When using this shortcut, "nothing" visually you can see will happen. It simply connects your computers.
*'''Ensure all computers are using the same naming in the game profile in Innerspace game configuration.'''

OgreOther:AutoLogin

2013-05-22T21:39:35Z

Mooshi: typo

== Overview ==
OgreAutoLogin can open sessions, and/or use existing sessions, and log characters into specific sessions.

Note: This is an advanced feature. You will need to follow specific instructions, including creating windows short cuts to be able to set this up.

Remember: If you only want to auto login one character, all you need is to complete the "Before You Begin" section. Then launch EQ2, open the innerspace console (using the ~ key), and type "ogre login toonname" (without the quotes).

==Before You Begin==
In order to use OgreAutoLogin, you need the following set up prior.
* A blank loginscene. Information on obtaining one can be found in the [[NewUserWalkthrough:Page1|New user walkthrough page 1]]. (Scroll down to the section titled Blank loginscene)
* EQ2Chars.inc must be filled in with correct information. Information can be found in the [[NewUserWalkthrough:Page2|New user walkthrough page 2]].

== Step By Step ==
#MAKE SURE you have completed the "Before You Begin" section! DO NOT SKIP ANY STEPS on EITHER of the pages linked above, or the rest of this will NOT work.
#Locate and edit the following file - Innerspace/Scripts/EQ2OgreCommon/OgreAutoLogin/AutoLogin.iss. Here is a listing of the first few lines of that file: 
#:<code>******** Ogre Automated Login. Version 1.03 **********</code>
#:<code>Change the below 2 to match what you have. Below are the defaults. All computers must have the same names. Use uniformity.</code>
#:<code>variable string GameName="Everquest 2"</code>
#:<code>variable string ProfileName="Everquest 2 Default Profile"</code>
#:<code>Below is the amount of time the script will wait after it loads a session.</code>
#*Edit the GameName and ProfileName to match the values you used when you configured Innerspace.
#*If you are unsure of what your game name is you can right click the innerspace taskbar notification window
#:[[image:IS.taskbar.png]]
#*At the top, you'll see a list of the "GameNames" innerspace knows about.
#*Moving your mouse over the Everquest2 game will show the name of the "ProfileName" you need to use.
#*Use these exact names (case sensitive) when editing your AutoLogin.iss file.
#Create a Desktop Shortcut that will launch the Ogre Auto Login UI
#*Right-click on your desktop and click 'New' -> 'Shortcut'
#*Click the Browse... button to locate Innerspace/Innerspace.exe. This will put the path to Innerspace.exe in the "Type the location of the item:" box.
#*Edit that line to append "runscript eq2ogrecommon/OgreAutoLogin/AutoLogin" after the path to the exe.
#*The line should now look something like 
#:D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/OgreAutoLogin/AutoLogin 
#::or 
#:"C:\Program Files\Innerspace\InnerSpace.exe" runscript eq2ogrecommon/OgreAutoLogin/AutoLogin 
#:(if the path to Innerspace.exe contains spaces or special characters, you'll need quotes around the path as shown in the 2nd example)
#*Click the Next button, Give it a name and click Finish.
#Launch the Ogre Auto Login UI by double-clicking the desktop shortcut you just created.
#* Note: This loads INSIDE of the uplink console. Depending on your computer, it will pop up in front of you, OR you will see a new window in your task bar, go ahead and click it. If you can't find the window anywhere, right-click the Innerspace icon in your taskbar and select Console.
#:[[image:Console.autologin.png|500px]]
#*The Character List (on the left) will contain all your characters from the EQ2Chars.ini file you edited above.
#**Select the first Character from Character List
#**Select the PC you wish to use for this character.
#**Select the Innerspace Session name to use for that character (e.g. IS1).
#*** Currently it performs the following checks
#**** If session is "Any"
#***** Toon will stay logged in on its current session
#**** If Session is specific "IS1" / "IS2" etc
#***** If toon online: Checks to see if the toon is on that specific session. If not, log off.
#***** If toon offline: If that specific session is in use, log that session off.
#**** If an alt (based off of eq2chars.inc list) is logged on, they will be logged off to allow the characters you have selected to be logged on.
#**Click Add Selection
#**Repeat for each character in the group you wish to have logged in at the same time.
#*Type in a name to save the profile as (on the right side), then click the Save Profile button.
#**The next time you run Ogre Auto Login UI, the saved profiles will be available under the "load profile" button.
#*Click 'Load Toons and exit'.
#*Wait for it to finish logging in all your toons (this can take a long time, even as much as a few minutes) then you can click 'X' to close the Innerspace Console.
#And you've now successfully set up and used Ogre Auto Login. You can just click your desktop shortcut any time you want, and it will launch the Ogre Auto Login UI (remember it might be in the background, or you might have to manually launch the Innerspace Console if your shortcut doesn't bring the window up automatically) If you are happy with this, you can stop now. If you'd like to get even fancier, read the section below on launching a specific toon list directly from a desktop shortcut (without launching the Ogre Auto Login UI).

== Loading a specific toon list profile ==
Once you have created a toon list profile using the step-by-step method above, you can automatically launch and login that profile using Ogre Automated Login, rather than using the UI.
* The AutoLogin script that your desktop shortcut runs can accept 1 parameter, a saved toon list profile. When a parameter is passed, it automatically runs the script in the background, bypassing the Ogre Auto Login UI entirely.
* IMPORTANT *** You MUST create the toon list profile using the Ogre Auto Login UI *BEFORE* you can use this
#Let's assume you saved your toon list profile as "MainGroup".
#Create a new Desktop Shortcut exactly like you did above.
#When you get to the part where you're appending to the Innerspace.exe path, also append "MainGroup" at the very end. Example:
#* <code>D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/OgreAutoLogin/AutoLogin MainGroup</code>
#Now you have two desktop shorcuts. The first one will launch the UI, and the second one will automatically log in your "MainGroup" toons, but will bypass the UI.

== Quirks ==
* It's a good idea to have Innerspace running before you double-click your desktop shortcuts. Double-clicking your shortcuts will launch Innerspace if it is not already running. However:
** If Innerspace needs to patch, it will do so, reload itself, and run the script you were trying to run, but it will not include any parameters you were passing in (i.e. the "MainGroup" toon list profile name.
** If Innerspace is already open, it simply runs the script with the parameters (which is a good thing).
* There is VERY limited user error checking. So use some common sense. For example: If you say you want the toon Kannkor to load on IS8 and that's it, it will load 1 session (IS1), and fail to load Kannkor because it can't find IS8. It's best to start to have the entire set (Kannkor IS1, Kannkor2 IS2 etc), or use the "Any" option.
* The odd time, when changing toons around, 1 session would crash. I can't reproduce this bug other than rarely, and randomly, so I believe it still exists. If this happens to you, look at the uplink console of that computer, and you should see a line such as: Command given: ogre -<stuff>-. I need the <stuff>. It will have your toon name, but if it has anything else (including spaces) I need to know exactly what that other stuff is.
* Note: When you run this, it loads ISXOgre into your uplink. Which should patch ISXOgre fine. However if you are in the game and need to patch ISXOgre, you will need to unload the extension from the uplink console (done via loading the console and ext -unload isxogre).

== Using Multiple Computers ==
If you are using multiple computers, you must have them "connected" prior to running your desktop shortcuts.
Connecting via shortcut example (this is the same as clicking connect on OgreMCP):
* D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/ogreconnect
* When using this shortcut, "nothing" visually you can see will happen. It simply connects your computers.
*'''Ensure all computers are using the same naming in the game profile in Innerspace game configuration.'''

OgreOther:AutoLogin

2013-05-22T21:38:21Z

Mooshi:

== Overview ==
OgreAutoLogin can open sessions, and/or use existing sessions, and log characters into specific sessions.

Note: This is an advanced feature. You will need to follow specific instructions, including creating windows short cuts to be able to set this up.

Remember: If you only want to auto login one character, all you need is to complete the "Before You Begin" section. Then launch EQ2, open the innerspace console (using the ~ key), and type "oger login toonname" (without the quotes).

==Before You Begin==
In order to use OgreAutoLogin, you need the following set up prior.
* A blank loginscene. Information on obtaining one can be found in the [[NewUserWalkthrough:Page1|New user walkthrough page 1]]. (Scroll down to the section titled Blank loginscene)
* EQ2Chars.inc must be filled in with correct information. Information can be found in the [[NewUserWalkthrough:Page2|New user walkthrough page 2]].

== Step By Step ==
#MAKE SURE you have completed the "Before You Begin" section! DO NOT SKIP ANY STEPS on EITHER of the pages linked above, or the rest of this will NOT work.
#Locate and edit the following file - Innerspace/Scripts/EQ2OgreCommon/OgreAutoLogin/AutoLogin.iss. Here is a listing of the first few lines of that file: 
#:<code>******** Ogre Automated Login. Version 1.03 **********</code>
#:<code>Change the below 2 to match what you have. Below are the defaults. All computers must have the same names. Use uniformity.</code>
#:<code>variable string GameName="Everquest 2"</code>
#:<code>variable string ProfileName="Everquest 2 Default Profile"</code>
#:<code>Below is the amount of time the script will wait after it loads a session.</code>
#*Edit the GameName and ProfileName to match the values you used when you configured Innerspace.
#*If you are unsure of what your game name is you can right click the innerspace taskbar notification window
#:[[image:IS.taskbar.png]]
#*At the top, you'll see a list of the "GameNames" innerspace knows about.
#*Moving your mouse over the Everquest2 game will show the name of the "ProfileName" you need to use.
#*Use these exact names (case sensitive) when editing your AutoLogin.iss file.
#Create a Desktop Shortcut that will launch the Ogre Auto Login UI
#*Right-click on your desktop and click 'New' -> 'Shortcut'
#*Click the Browse... button to locate Innerspace/Innerspace.exe. This will put the path to Innerspace.exe in the "Type the location of the item:" box.
#*Edit that line to append "runscript eq2ogrecommon/OgreAutoLogin/AutoLogin" after the path to the exe.
#*The line should now look something like 
#:D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/OgreAutoLogin/AutoLogin 
#::or 
#:"C:\Program Files\Innerspace\InnerSpace.exe" runscript eq2ogrecommon/OgreAutoLogin/AutoLogin 
#:(if the path to Innerspace.exe contains spaces or special characters, you'll need quotes around the path as shown in the 2nd example)
#*Click the Next button, Give it a name and click Finish.
#Launch the Ogre Auto Login UI by double-clicking the desktop shortcut you just created.
#* Note: This loads INSIDE of the uplink console. Depending on your computer, it will pop up in front of you, OR you will see a new window in your task bar, go ahead and click it. If you can't find the window anywhere, right-click the Innerspace icon in your taskbar and select Console.
#:[[image:Console.autologin.png|500px]]
#*The Character List (on the left) will contain all your characters from the EQ2Chars.ini file you edited above.
#**Select the first Character from Character List
#**Select the PC you wish to use for this character.
#**Select the Innerspace Session name to use for that character (e.g. IS1).
#*** Currently it performs the following checks
#**** If session is "Any"
#***** Toon will stay logged in on its current session
#**** If Session is specific "IS1" / "IS2" etc
#***** If toon online: Checks to see if the toon is on that specific session. If not, log off.
#***** If toon offline: If that specific session is in use, log that session off.
#**** If an alt (based off of eq2chars.inc list) is logged on, they will be logged off to allow the characters you have selected to be logged on.
#**Click Add Selection
#**Repeat for each character in the group you wish to have logged in at the same time.
#*Type in a name to save the profile as (on the right side), then click the Save Profile button.
#**The next time you run Ogre Auto Login UI, the saved profiles will be available under the "load profile" button.
#*Click 'Load Toons and exit'.
#*Wait for it to finish logging in all your toons (this can take a long time, even as much as a few minutes) then you can click 'X' to close the Innerspace Console.
#And you've now successfully set up and used Ogre Auto Login. You can just click your desktop shortcut any time you want, and it will launch the Ogre Auto Login UI (remember it might be in the background, or you might have to manually launch the Innerspace Console if your shortcut doesn't bring the window up automatically) If you are happy with this, you can stop now. If you'd like to get even fancier, read the section below on launching a specific toon list directly from a desktop shortcut (without launching the Ogre Auto Login UI).

== Loading a specific toon list profile ==
Once you have created a toon list profile using the step-by-step method above, you can automatically launch and login that profile using Ogre Automated Login, rather than using the UI.
* The AutoLogin script that your desktop shortcut runs can accept 1 parameter, a saved toon list profile. When a parameter is passed, it automatically runs the script in the background, bypassing the Ogre Auto Login UI entirely.
* IMPORTANT *** You MUST create the toon list profile using the Ogre Auto Login UI *BEFORE* you can use this
#Let's assume you saved your toon list profile as "MainGroup".
#Create a new Desktop Shortcut exactly like you did above.
#When you get to the part where you're appending to the Innerspace.exe path, also append "MainGroup" at the very end. Example:
#* <code>D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/OgreAutoLogin/AutoLogin MainGroup</code>
#Now you have two desktop shorcuts. The first one will launch the UI, and the second one will automatically log in your "MainGroup" toons, but will bypass the UI.

== Quirks ==
* It's a good idea to have Innerspace running before you double-click your desktop shortcuts. Double-clicking your shortcuts will launch Innerspace if it is not already running. However:
** If Innerspace needs to patch, it will do so, reload itself, and run the script you were trying to run, but it will not include any parameters you were passing in (i.e. the "MainGroup" toon list profile name.
** If Innerspace is already open, it simply runs the script with the parameters (which is a good thing).
* There is VERY limited user error checking. So use some common sense. For example: If you say you want the toon Kannkor to load on IS8 and that's it, it will load 1 session (IS1), and fail to load Kannkor because it can't find IS8. It's best to start to have the entire set (Kannkor IS1, Kannkor2 IS2 etc), or use the "Any" option.
* The odd time, when changing toons around, 1 session would crash. I can't reproduce this bug other than rarely, and randomly, so I believe it still exists. If this happens to you, look at the uplink console of that computer, and you should see a line such as: Command given: ogre -<stuff>-. I need the <stuff>. It will have your toon name, but if it has anything else (including spaces) I need to know exactly what that other stuff is.
* Note: When you run this, it loads ISXOgre into your uplink. Which should patch ISXOgre fine. However if you are in the game and need to patch ISXOgre, you will need to unload the extension from the uplink console (done via loading the console and ext -unload isxogre).

== Using Multiple Computers ==
If you are using multiple computers, you must have them "connected" prior to running your desktop shortcuts.
Connecting via shortcut example (this is the same as clicking connect on OgreMCP):
* D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/ogreconnect
* When using this shortcut, "nothing" visually you can see will happen. It simply connects your computers.
*'''Ensure all computers are using the same naming in the game profile in Innerspace game configuration.'''

OgreOther:AutoLogin

2013-05-22T21:33:24Z

Mooshi: Reworked the page, Making it more chronological, and hopefully less confusing.

== Overview ==
OgreAutoLogin can open sessions, and/or use existing sessions, and log characters into specific sessions.

Note: This is an advanced feature. You will need to follow specific instructions, including creating windows short cuts to be able to set this up.

==Before You Begin==
In order to use OgreAutoLogin, you need the following set up prior.
* A blank loginscene. Information on obtaining one can be found in the [[NewUserWalkthrough:Page1|New user walkthrough page 1]]. (Scroll down to the section titled Blank loginscene)
* EQ2Chars.inc must be filled in with correct information. Information can be found in the [[NewUserWalkthrough:Page2|New user walkthrough page 2]].

== Step By Step ==
#MAKE SURE you have completed the "Before You Begin" section! DO NOT SKIP ANY STEPS on EITHER of the pages linked above, or the rest of this will NOT work.
#Locate and edit the following file - Innerspace/Scripts/EQ2OgreCommon/OgreAutoLogin/AutoLogin.iss. Here is a listing of the first few lines of that file: 
#:<code>******** Ogre Automated Login. Version 1.03 **********</code>
#:<code>Change the below 2 to match what you have. Below are the defaults. All computers must have the same names. Use uniformity.</code>
#:<code>variable string GameName="Everquest 2"</code>
#:<code>variable string ProfileName="Everquest 2 Default Profile"</code>
#:<code>Below is the amount of time the script will wait after it loads a session.</code>
#*Edit the GameName and ProfileName to match the values you used when you configured Innerspace.
#*If you are unsure of what your game name is you can right click the innerspace taskbar notification window
#:[[image:IS.taskbar.png]]
#*At the top, you'll see a list of the "GameNames" innerspace knows about.
#*Moving your mouse over the Everquest2 game will show the name of the "ProfileName" you need to use.
#*Use these exact names (case sensitive) when editing your AutoLogin.iss file.
#Create a Desktop Shortcut that will launch the Ogre Auto Login UI
#*Right-click on your desktop and click 'New' -> 'Shortcut'
#*Click the Browse... button to locate Innerspace/Innerspace.exe. This will put the path to Innerspace.exe in the "Type the location of the item:" box.
#*Edit that line to append "runscript eq2ogrecommon/OgreAutoLogin/AutoLogin" after the path to the exe.
#*The line should now look something like 
#:D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/OgreAutoLogin/AutoLogin 
#::or 
#:"C:\Program Files\Innerspace\InnerSpace.exe" runscript eq2ogrecommon/OgreAutoLogin/AutoLogin 
#:(if the path to Innerspace.exe contains spaces or special characters, you'll need quotes around the path as shown in the 2nd example)
#*Click the Next button, Give it a name and click Finish.
#Launch the Ogre Auto Login UI by double-clicking the desktop shortcut you just created.
#* Note: This loads INSIDE of the uplink console. Depending on your computer, it will pop up in front of you, OR you will see a new window in your task bar, go ahead and click it. If you can't find the window anywhere, right-click the Innerspace icon in your taskbar and select Console.
#:[[image:Console.autologin.png|500px]]
#*The Character List (on the left) will contain all your characters from the EQ2Chars.ini file you edited above.
#**Select the first Character from Character List
#**Select the PC you wish to use for this character.
#**Select the Innerspace Session name to use for that character (e.g. IS1).
#*** Currently it performs the following checks
#**** If session is "Any"
#***** Toon will stay logged in on its current session
#**** If Session is specific "IS1" / "IS2" etc
#***** If toon online: Checks to see if the toon is on that specific session. If not, log off.
#***** If toon offline: If that specific session is in use, log that session off.
#**** If an alt (based off of eq2chars.inc list) is logged on, they will be logged off to allow the characters you have selected to be logged on.
#**Click Add Selection
#**Repeat for each character in the group you wish to have logged in at the same time.
#*Type in a name to save the profile as (on the right side), then click the Save Profile button.
#**The next time you run Ogre Auto Login UI, the saved profiles will be available under the "load profile" button.
#*Click 'Load Toons and exit'.
#*Wait for it to finish logging in all your toons (this can take a long time, even as much as a few minutes) then you can click 'X' to close the Innerspace Console.
#And you've now successfully set up and used Ogre Auto Login. You can just click your desktop shortcut any time you want, and it will launch the Ogre Auto Login UI (remember it might be in the background, or you might have to manually launch the Innerspace Console if your shortcut doesn't bring the window up automatically) If you are happy with this, you can stop now. If you'd like to get even fancier, read the section below on launching a specific toon list directly from a desktop shortcut (without launching the Ogre Auto Login UI).

== Loading a specific toon list profile ==
Once you have created a toon list profile using the step-by-step method above, you can automatically launch and login that profile using Ogre Automated Login, rather than using the UI.
* The AutoLogin script that your desktop shortcut runs can accept 1 parameter, a saved toon list profile. When a parameter is passed, it automatically runs the script in the background, bypassing the Ogre Auto Login UI entirely.
* IMPORTANT *** You MUST create the toon list profile using the Ogre Auto Login UI *BEFORE* you can use this
#Let's assume you saved your toon list profile as "MainGroup".
#Create a new Desktop Shortcut exactly like you did above.
#When you get to the part where you're appending to the Innerspace.exe path, also append "MainGroup" at the very end. Example:
#* <code>D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/OgreAutoLogin/AutoLogin MainGroup</code>
#Now you have two desktop shorcuts. The first one will launch the UI, and the second one will automatically log in your "MainGroup" toons, but will bypass the UI.

== Quirks ==
* It's a good idea to have Innerspace running before you double-click your desktop shortcuts. Double-clicking your shortcuts will launch Innerspace if it is not already running. However:
** If Innerspace needs to patch, it will do so, reload itself, and run the script you were trying to run, but it will not include any parameters you were passing in (i.e. the "MainGroup" toon list profile name.
** If Innerspace is already open, it simply runs the script with the parameters (which is a good thing).
* There is VERY limited user error checking. So use some common sense. For example: If you say you want the toon Kannkor to load on IS8 and that's it, it will load 1 session (IS1), and fail to load Kannkor because it can't find IS8. It's best to start to have the entire set (Kannkor IS1, Kannkor2 IS2 etc), or use the "Any" option.
* The odd time, when changing toons around, 1 session would crash. I can't reproduce this bug other than rarely, and randomly, so I believe it still exists. If this happens to you, look at the uplink console of that computer, and you should see a line such as: Command given: ogre -<stuff>-. I need the <stuff>. It will have your toon name, but if it has anything else (including spaces) I need to know exactly what that other stuff is.
* Note: When you run this, it loads ISXOgre into your uplink. Which should patch ISXOgre fine. However if you are in the game and need to patch ISXOgre, you will need to unload the extension from the uplink console (done via loading the console and ext -unload isxogre).

== Using Multiple Computers ==
If you are using multiple computers, you must have them "connected" prior to running your desktop shortcuts.
Connecting via shortcut example (this is the same as clicking connect on OgreMCP):
* D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/ogreconnect
* When using this shortcut, "nothing" visually you can see will happen. It simply connects your computers.
*'''Ensure all computers are using the same naming in the game profile in Innerspace game configuration.'''

NewUserWalkthrough:Page2

2013-05-22T19:40:03Z

Mooshi:

<big>'''New User Walkthrough - Page 2: EQ2Chars.inc'''</big>
----

== EQ2Chars.inc ==
First thing you have to do, is setup a file called EQ2chars.inc. This file contains private information the bot needs to complete some functions.
This file is used for the following reasons:
* Auto-logging toons in
* Allowing other toons to give commands (such as making you a leader)
* Responding to events from characters (such as accepting group invites, or accepting a res)
* Connecting to other computers via Innerspace's uplink

Navigate to the following directory: /innerspace/scripts/EQ2OgreCommon/DoNotShareWithOthers/

In here you will find 2 files, Blank.EQ2Chars.inc and readme.txt. First thing you need to do, is rename the file from "Blank.EQ2Chars.inc" to "EQ2Chars.inc". Now edit the file (you can right click -edit).

== Setting up your movement keys ==
If you use the standard: w is move forward, s is move backwards, and num lock is autorun, you can skip down to the next section (Setting up the Uplink).

;// Default movement keys for Ogrebot. Only change the letters at the end.
#if !${OgreForwardKey(exists)}
variable(global) string '''OgreForwardKey=w'''
#endif
#if !${OgreBackwardKey(exists)}
variable(global) string '''OgreBackwardKey=s'''
#endif
#if !${OgreAutoRunKey(exists)}
variable(global) string '''OgreAutoRunKey=Num Lock'''
#endif

Simply change the "w", "s", "Num Lock" to the keys you use. Make sure NOT to modify anything else in this section.

== Setting up the Uplink ==
The first function is the Uplink. This allows you to connect to other computers. If you run some of your bot sessions on other computers, make sure they are all listed here. If you only use 1 computer, you can continue to the next section.

The first function you should see is:

function SetUpUplink()
{
UplinkInfo[${UplinkCount:Inc}]:Set[Computername1]
UplinkInfo[${UplinkCount:Inc}]:Set[Computername2]
}

'''** NOTE:''' It's safe to go ahead and add any computers you plan to use with ISXOgre, even if they're not on/connected/active all of the time. 

'''** NOTE:''' It's important that the computer names match the names Innerspace uses. On each computer, right-click the Innerspace icon in your taskbar, then click "Configuration". The computer name will be right there. 

Change the "Computername#" to the names of the other computers you wish to connect to. If you have more than 2 computers, simply add more.

Here are a few examples:

Example 1: Connecting to 1 other computer named "Kannkor1"

function SetUpUplink()
{
UplinkInfo[${UplinkCount:Inc}]:Set[Kannkor1]
}

You will notice I simply deleted the extra line.

Example 2: Connecting to 5 other computers"

function SetUpUplink()
{
UplinkInfo[${UplinkCount:Inc}]:Set[Kannkor1]
UplinkInfo[${UplinkCount:Inc}]:Set[Kannkor2]
UplinkInfo[${UplinkCount:Inc}]:Set[Kannkor3]
UplinkInfo[${UplinkCount:Inc}]:Set[Kannkor4]
UplinkInfo[${UplinkCount:Inc}]:Set[Kannkor5]
}

If you have more computers, just add more lines.

== Setting up Character information ==

The next function is used to set up your character information.

'''NOTE''' - You don't technically need to fill this information out. It is 100% secure as only your computer uses this information. You should NEVER share this file with anyone, not even me - ever. If you are not comfortable filling this out, you do not have to. You will just limit some of the functionality. Either way, continue reading as filling out part of the information will add to functionality.

The next function should look like this:

function SetUpChars()
{
variable int TempCounter=1
CharInfo[${TempCounter},1]:Set[ToonName]
CharInfo[${TempCounter},2]:Set[Password]
CharInfo[${TempCounter},3]:Set[LoginName]
CharInfo[${TempCounter},4]:Set[ServerName]

TempCounter:Inc
CharInfo[${TempCounter},1]:Set[ToonName]
CharInfo[${TempCounter},2]:Set[Password]
CharInfo[${TempCounter},3]:Set[LoginName]
CharInfo[${TempCounter},4]:Set[ServerName]
}

Options:
* Fill out everything - Provides full functionality. Including authorization list, auto login, support for Hireg etc.
** Fill out all 4
* Fill out ToonName only - Provides most functionality - Including authorization list. Lose auto login and Hireg support.
** Fill out "ToonName" only
* Fill out nothing - You lose authorization and auto login. I don't recommend this if you run more than 1 character since your bots will not respond to each other if they give commands (since they won't be authorized).
** Fill nothing out.

In the example, it only gives you room for two characters. For more than two, you copy/paste the following lines. Here is an example of 4 characters with full information (it's obviously fake information, so don't try to log into my account :) ).

function SetUpChars()
{
variable int TempCounter=1
CharInfo[${TempCounter},1]:Set[Kannkor]
CharInfo[${TempCounter},2]:Set[SecretPassword]
CharInfo[${TempCounter},3]:Set[KannkorLoginOne]
CharInfo[${TempCounter},4]:Set[Unrest]

TempCounter:Inc
CharInfo[${TempCounter},1]:Set[KannkorWife]
CharInfo[${TempCounter},2]:Set[SecretPassword]
CharInfo[${TempCounter},3]:Set[KannkorLoginTwo]
CharInfo[${TempCounter},4]:Set[Unrest]

TempCounter:Inc
CharInfo[${TempCounter},1]:Set[KannkorGirlfriend]
CharInfo[${TempCounter},2]:Set[SecretPassword]
CharInfo[${TempCounter},3]:Set[KannkorLoginThree]
CharInfo[${TempCounter},4]:Set[Unrest]

TempCounter:Inc
CharInfo[${TempCounter},1]:Set[KannkorWhore]
CharInfo[${TempCounter},2]:Set[SecretPassword]
CharInfo[${TempCounter},3]:Set[KannkorLoginFour]
CharInfo[${TempCounter},4]:Set[Unrest]
}

If you choose to fill out your character name only, it would look like this:

function SetUpChars()
{
variable int TempCounter=1
CharInfo[${TempCounter},1]:Set[Kannkor]
CharInfo[${TempCounter},2]:Set[Password]
CharInfo[${TempCounter},3]:Set[LoginName]
CharInfo[${TempCounter},4]:Set[ServerName]

TempCounter:Inc
CharInfo[${TempCounter},1]:Set[KannkorWife]
CharInfo[${TempCounter},2]:Set[Password]
CharInfo[${TempCounter},3]:Set[LoginName]
CharInfo[${TempCounter},4]:Set[ServerName]
}

Since you won't be using the auto-login feature, the "Password" field can stay as "Password".

'''NOTE''' - If you play with others that know you bot, or people you trust to be on your authorized list, you can add them also. You can have a mix of full information, and character name only. For example, here is my character information, with a friend's character that gives him authorization. Since I don't know his login information, it won't be used.

function SetUpChars()
{
variable int TempCounter=1
CharInfo[${TempCounter},1]:Set[Kannkor]
CharInfo[${TempCounter},2]:Set[SecretPassword]
CharInfo[${TempCounter},3]:Set[KannkorLoginOne]
CharInfo[${TempCounter},4]:Set[Unrest]

TempCounter:Inc
CharInfo[${TempCounter},1]:Set[Abe] <---- Friends character name
CharInfo[${TempCounter},2]:Set[Password]
CharInfo[${TempCounter},3]:Set[LoginName]
CharInfo[${TempCounter},4]:Set[ServerName]
}

You can always edit this file at any time. Just remember not to share this file with anyone, because it has your character names, and your username and passwords!

Save the file, and continue on.

== Navigation ==
Back to Page 1 [[NewUserWalkthrough:Page1|Introduction]]

Continue to Page 3 [[NewUserWalkthrough:Page3|Tips and Tricks]]

NewUserWalkthrough:Page2

2013-05-22T19:39:25Z

Mooshi:

<big>'''New User Walkthrough - Page 2: EQ2Chars.inc'''</big>
----

== EQ2Chars.inc ==
First thing you have to do, is setup a file called EQ2chars.inc. This file contains private information the bot needs to complete some functions.
This file is used for the following reasons:
* Auto-logging toons in
* Allowing other toons to give commands (such as making you a leader)
* Responding to events from characters (such as accepting group invites, or accepting a res)
* Connecting to other computers via Innerspace's uplink

Navigate to the following directory: /innerspace/scripts/EQ2OgreCommon/DoNotShareWithOthers/

In here you will find 2 files, Blank.EQ2Chars.inc and readme.txt. First thing you need to do, is rename the file from "Blank.EQ2Chars.inc" to "EQ2Chars.inc". Now edit the file (you can right click -edit).

== Setting up your movement keys ==
If you use the standard: w is move forward, s is move backwards, and num lock is autorun, you can skip down to the next section (Setting up the Uplink).

;// Default movement keys for Ogrebot. Only change the letters at the end.
#if !${OgreForwardKey(exists)}
variable(global) string '''OgreForwardKey=w'''
#endif
#if !${OgreBackwardKey(exists)}
variable(global) string '''OgreBackwardKey=s'''
#endif
#if !${OgreAutoRunKey(exists)}
variable(global) string '''OgreAutoRunKey=Num Lock'''
#endif

Simply change the "w", "s", "Num Lock" to the keys you use. Make sure NOT to modify anything else in this section.

== Setting up the Uplink ==
The first function is the Uplink. This allows you to connect to other computers. If you run some of your bot sessions on other computers, make sure they are all listed here. If you only use 1 computer, you can continue to the next section.

The first function you should see is:

function SetUpUplink()
{
UplinkInfo[${UplinkCount:Inc}]:Set[Computername1]
UplinkInfo[${UplinkCount:Inc}]:Set[Computername2]
}

'''** NOTE:''' It's safe to go ahead and add any computers you plan to use with ISXOgre, even if they're not on/connected/active all of the time. 

'''** NOTE:''' It's important that the computer names match the names Innerspace uses. On each computer, right-click the Innerspace icon in your taskbar, then click "Configuration". The computer name will be right there.

Change the "Computername#" to the names of the other computers you wish to connect to. If you have more than 2 computers, simply add more.

Here are a few examples:

Example 1: Connecting to 1 other computer named "Kannkor1"

function SetUpUplink()
{
UplinkInfo[${UplinkCount:Inc}]:Set[Kannkor1]
}

You will notice I simply deleted the extra line.

Example 2: Connecting to 5 other computers"

function SetUpUplink()
{
UplinkInfo[${UplinkCount:Inc}]:Set[Kannkor1]
UplinkInfo[${UplinkCount:Inc}]:Set[Kannkor2]
UplinkInfo[${UplinkCount:Inc}]:Set[Kannkor3]
UplinkInfo[${UplinkCount:Inc}]:Set[Kannkor4]
UplinkInfo[${UplinkCount:Inc}]:Set[Kannkor5]
}

If you have more computers, just add more lines.

== Setting up Character information ==

The next function is used to set up your character information.

'''NOTE''' - You don't technically need to fill this information out. It is 100% secure as only your computer uses this information. You should NEVER share this file with anyone, not even me - ever. If you are not comfortable filling this out, you do not have to. You will just limit some of the functionality. Either way, continue reading as filling out part of the information will add to functionality.

The next function should look like this:

function SetUpChars()
{
variable int TempCounter=1
CharInfo[${TempCounter},1]:Set[ToonName]
CharInfo[${TempCounter},2]:Set[Password]
CharInfo[${TempCounter},3]:Set[LoginName]
CharInfo[${TempCounter},4]:Set[ServerName]

TempCounter:Inc
CharInfo[${TempCounter},1]:Set[ToonName]
CharInfo[${TempCounter},2]:Set[Password]
CharInfo[${TempCounter},3]:Set[LoginName]
CharInfo[${TempCounter},4]:Set[ServerName]
}

Options:
* Fill out everything - Provides full functionality. Including authorization list, auto login, support for Hireg etc.
** Fill out all 4
* Fill out ToonName only - Provides most functionality - Including authorization list. Lose auto login and Hireg support.
** Fill out "ToonName" only
* Fill out nothing - You lose authorization and auto login. I don't recommend this if you run more than 1 character since your bots will not respond to each other if they give commands (since they won't be authorized).
** Fill nothing out.

In the example, it only gives you room for two characters. For more than two, you copy/paste the following lines. Here is an example of 4 characters with full information (it's obviously fake information, so don't try to log into my account :) ).

function SetUpChars()
{
variable int TempCounter=1
CharInfo[${TempCounter},1]:Set[Kannkor]
CharInfo[${TempCounter},2]:Set[SecretPassword]
CharInfo[${TempCounter},3]:Set[KannkorLoginOne]
CharInfo[${TempCounter},4]:Set[Unrest]

TempCounter:Inc
CharInfo[${TempCounter},1]:Set[KannkorWife]
CharInfo[${TempCounter},2]:Set[SecretPassword]
CharInfo[${TempCounter},3]:Set[KannkorLoginTwo]
CharInfo[${TempCounter},4]:Set[Unrest]

TempCounter:Inc
CharInfo[${TempCounter},1]:Set[KannkorGirlfriend]
CharInfo[${TempCounter},2]:Set[SecretPassword]
CharInfo[${TempCounter},3]:Set[KannkorLoginThree]
CharInfo[${TempCounter},4]:Set[Unrest]

TempCounter:Inc
CharInfo[${TempCounter},1]:Set[KannkorWhore]
CharInfo[${TempCounter},2]:Set[SecretPassword]
CharInfo[${TempCounter},3]:Set[KannkorLoginFour]
CharInfo[${TempCounter},4]:Set[Unrest]
}

If you choose to fill out your character name only, it would look like this:

function SetUpChars()
{
variable int TempCounter=1
CharInfo[${TempCounter},1]:Set[Kannkor]
CharInfo[${TempCounter},2]:Set[Password]
CharInfo[${TempCounter},3]:Set[LoginName]
CharInfo[${TempCounter},4]:Set[ServerName]

TempCounter:Inc
CharInfo[${TempCounter},1]:Set[KannkorWife]
CharInfo[${TempCounter},2]:Set[Password]
CharInfo[${TempCounter},3]:Set[LoginName]
CharInfo[${TempCounter},4]:Set[ServerName]
}

Since you won't be using the auto-login feature, the "Password" field can stay as "Password".

'''NOTE''' - If you play with others that know you bot, or people you trust to be on your authorized list, you can add them also. You can have a mix of full information, and character name only. For example, here is my character information, with a friend's character that gives him authorization. Since I don't know his login information, it won't be used.

function SetUpChars()
{
variable int TempCounter=1
CharInfo[${TempCounter},1]:Set[Kannkor]
CharInfo[${TempCounter},2]:Set[SecretPassword]
CharInfo[${TempCounter},3]:Set[KannkorLoginOne]
CharInfo[${TempCounter},4]:Set[Unrest]

TempCounter:Inc
CharInfo[${TempCounter},1]:Set[Abe] <---- Friends character name
CharInfo[${TempCounter},2]:Set[Password]
CharInfo[${TempCounter},3]:Set[LoginName]
CharInfo[${TempCounter},4]:Set[ServerName]
}

You can always edit this file at any time. Just remember not to share this file with anyone, because it has your character names, and your username and passwords!

Save the file, and continue on.

== Navigation ==
Back to Page 1 [[NewUserWalkthrough:Page1|Introduction]]

Continue to Page 3 [[NewUserWalkthrough:Page3|Tips and Tricks]]