Difference between revisions of "OgreOther:AutoLogin"

From ISXOgre
Jump to: navigation, search
(Before You Begin)
 
(41 intermediate revisions by 5 users not shown)
Line 1: Line 1:
* AutoLogin ( Cleaner documentation coming soon... )
+
== Overview ==
** OgreAutoLogin can open sessions, and/or use existing sessions, and log characters into specific sessions.
+
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.
+
 
** 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.
+
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.
** Currently it performs the following checks
+
 
*** If session is "Any"
+
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).
**** Toon will stay logged on
+
 
*** If Session is specific "IS1" / "IS2" etc
+
==Before You Begin==
**** If toon online: Checks to see if the toon is on that specific session. If not, log off.
+
In order to use OgreAutoLogin, you need the following set up prior.
**** If toon offline: If that specific session is in use, log that session off.
+
* A blank loginscene. Information on obtaining one can be found in the [[NewUserWalkthrough:Page07|NewUserWalkthrough:Page07]]. (Scroll down to the section titled <b>Blank loginscene</b>)
*** 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.
+
* Your characters login informations must be filled first. This is done directly by starting ogre and using the EQ2Chars tab
** Script edits
+
[[File:EQ2Chars.png]]
*** If you don't run with the default names for the Game Name and Profile name, you can edit the script /scripts/eq2ogrecommon/ogreautologin/autologin.iss
+
* You need to use the Uplink Info tab to fill out your computer(s) name(s)
**** At the top you will see it explain what everything does. If you use the defaults, no reason to change them.
+
* You need to have ISXOgre autoload. [[Help:AutoLoadingISXOgre|Auto loading ISXOgre]].
** 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.
+
* You should add to make sure your pc is plugged in and turned on too [per ali in irc]
** 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).
+
* Be running Innerspace in 64 bit mode. This is the default so you should not have to change it. You can check by right clicking on Innerspace -> Configuration and ensuring the option [x] Use 64-bit Inner Space Uplink is checked.
** Note: If you are using multiple computers, you must have them "connected" prior to running this script.
+
 
** Creating desktop links (shortcuts).  
+
== Step By Step ==
*** Note: This is a brief overview of how to manage the Windows shortcuts. You should already understand how to make them if you plan to use this.
+
#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.
*** All shortcuts run innerspace with parameters. Some things to note:
+
#Locate and edit the following file:
**** If innerspace patches, when it reloads itself, it doesn't reload with the parameters passed.
+
# - Patch 237 and above: Innerspace/Scripts/EQ2OgreCommon/OgreAutoLogin/AutoLoginSettings.xml
**** If innerspace is already open, it simply does the parameters (which is a good thing).
+
#:<code>    <!-- Change the below 2 to match what you have. Below are the defaults. All computers must have the same names. Use uniformity. --></code>
*** Connecting via shortcut example (this is the same as clicking connect on OgreMCP):
+
#:<code>    <Setting Name="GameName">Everquest 2</Setting></code>
**** D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/ogreconnect
+
#:<code>    <Setting Name="ProfileName">everquest 2 default profile</Setting>  </code>
*** Loading the Ogre Automated login UI
+
#:<code>    <!-- This amount of time should be LONGER than it takes for the session to load, then for ISXEQ2 and ISXOgre to become ready. --></code>
**** D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/OgreAutoLogin/AutoLogin
+
#:<code>    <!-- 100 = 10s --></code>
**** 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.
+
#:<code>    <Setting Name="TimeToWaitAfterLoadingASession">150</Setting></code>
*** Loading a specific toon list profile to be loaded with Ogre Automated login.
+
#:<code>    <!-- Time between loading sessions. Some times when loading sessions quickly, they are out of order. Meaning IS1, IS3, IS2, IS4. --></code>
**** Accepts 1 parameter, a saved toon list profile. When a parameter is passed, it automatically runs the script in the background.
+
#:<code>    <!-- 10 = 1s --></code>
**** When no parameter is passed, it opens the uplink with the UI for you to select the options. (This is also where you create your toon list profiles). An example: Mains - Would load your main toons. Alts - Would load your alts etc.
+
#:<code>    <Setting Name="TimeToWaitBetweenLoadingSessions">50</Setting></code>
**** D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/OgreAutoLogin/AutoLogin Mains
+
#*Edit the values of the <b>GameName</b> and <b>ProfileName</b> settings to match the values you used when you configured Innerspace. NOTE: DO NOT CHANGE THE WORDS "GameName" and "ProfileName". You change the VALUE beside it. In this example above, you are changing "Everquest 2" and "everquest 2 default profile" to match what you have.
**** D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/OgreAutoLogin/AutoLogin Alts
+
#*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 AutoLoginSettings.xml 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<br />
 +
#:<i>D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/OgreAutoLogin/AutoLogin</i><br />
 +
#::or<br />
 +
#:<i>"C:\Program Files\Innerspace\InnerSpace.exe" runscript eq2ogrecommon/OgreAutoLogin/AutoLogin</i><br />
 +
#:(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 you add in the EQ2Chars tab in Ogre.
 +
#*#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 tab 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)<br />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.<br />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.

Latest revision as of 15:06, 3 February 2024

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:Page07. (Scroll down to the section titled Blank loginscene)
  • Your characters login informations must be filled first. This is done directly by starting ogre and using the EQ2Chars tab

EQ2Chars.png

  • You need to use the Uplink Info tab to fill out your computer(s) name(s)
  • You need to have ISXOgre autoload. Auto loading ISXOgre.
  • You should add to make sure your pc is plugged in and turned on too [per ali in irc]
  • Be running Innerspace in 64 bit mode. This is the default so you should not have to change it. You can check by right clicking on Innerspace -> Configuration and ensuring the option [x] Use 64-bit Inner Space Uplink is checked.

Step By Step

  1. 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.
  2. Locate and edit the following file:
  3. - Patch 237 and above: Innerspace/Scripts/EQ2OgreCommon/OgreAutoLogin/AutoLoginSettings.xml
    <Setting Name="GameName">Everquest 2</Setting>
    <Setting Name="ProfileName">everquest 2 default profile</Setting>
    <Setting Name="TimeToWaitAfterLoadingASession">150</Setting>
    <Setting Name="TimeToWaitBetweenLoadingSessions">50</Setting>
    • Edit the values of the GameName and ProfileName settings to match the values you used when you configured Innerspace. NOTE: DO NOT CHANGE THE WORDS "GameName" and "ProfileName". You change the VALUE beside it. In this example above, you are changing "Everquest 2" and "everquest 2 default profile" to match what you have.
    • If you are unsure of what your game name is you can right click the innerspace taskbar notification window
    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 AutoLoginSettings.xml file.
  4. 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.
  5. 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.
    Console.autologin.png
    • The Character List (on the left) will contain all your characters you add in the EQ2Chars tab in Ogre.
      1. Select the first Character from Character List
      2. Select the PC you wish to use for this character.
      3. 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 tab list) is logged on, they will be logged off to allow the characters you have selected to be logged on.
      4. Click Add Selection
      5. 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.
  6. 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
  1. Let's assume you saved your toon list profile as "MainGroup".
  2. Create a new Desktop Shortcut exactly like you did above.
  3. When you get to the part where you're appending to the Innerspace.exe path, also append "MainGroup" at the very end.
    Example:
    • D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/OgreAutoLogin/AutoLogin MainGroup
  4. 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:

runscript eq2ogrecommon/ogreconnect

So your full shortcut link should look like this:

D:\Games\InnerSpace\InnerSpace.exe runscript eq2ogrecommon/ogreconnect

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:

  1. Launch Innerspace on all computers.
  2. Double-Click your "Ogre Connect" desktop shortcut.
  3. 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.