From The Mana World
(Rule)
 
(6 intermediate revisions by 2 users not shown)
Line 4: Line 4:


The Mana Launcher allows you to use the [[Mirror_Lake|Mirror Lake]] features.
The Mana Launcher allows you to use the [[Mirror_Lake|Mirror Lake]] features.
[https://youtu.be/JvwkpRWVDPk A video guide is available on YouTube].


== Downloading the Launcher ==
== Downloading the Launcher ==
Line 18: Line 20:


[[File:MLP_Register.png|200px|thumb|left|Register Screen]]
[[File:MLP_Register.png|200px|thumb|left|Register Screen]]
NOTE: If you already have a TMW Classic or TMW Moubootaur Legends account, you will use ''these'' credentials on linking section.


# Start the software by running the appropriate .sh or .exe file
# Start the software by running the appropriate .sh or .exe file
# On the first time, it'll ask you about configurations. Tweak them as you wish, or press to "continue" ─ they should have good defaults. Make sure to use "ManaVerse" if you changed them. You can edit the settings later, but the button to do so is obscure (but ESC should work, most of time).
# On the first time, it'll ask you about configurations. Tweak them as you wish, or press to "continue" ─ they should have good defaults. Make sure to use "ManaVerse" if you changed them. You can edit the settings later, but the button to do so is obscure (but ESC should work, most of time).
# Create an account. Make sure the email is valid. TOTP field can be left empty. Mark both "remember" checkboxes, to make your life simpler.
# Create an account. Make sure the email is valid. TOTP field can be left empty (000000). Mark both "remember" checkboxes, to make your life simpler. There will be an * remaining in the password field after you delete the default entry. Disregard this and enter your password as explained below.
# If you can't press "OK", you know what they say ─ press ENTER and call it a day.
# If you can't press "OK", you know what they say ─ press ENTER and call it a day.


Line 40: Line 44:
# On the account management screen, for each world you play, click on "LINK ACCOUNT"
# On the account management screen, for each world you play, click on "LINK ACCOUNT"
# Fill the email and username associated to the linked account. '''Make sure the email works''', as you'll need to follow a link.
# Fill the email and username associated to the linked account. '''Make sure the email works''', as you'll need to follow a link.
# Wait for the email to be delivered; it can take up to 5 minutes.
# The linked page should redirect you [https://tmw2.org/api/linked to the success page] ─ keep in mind bad clients may access the page first to generate a preview. This '''will''' execute the linking. After that, using the link will show you the [https://tmw2.org/api/link_error 403 error page] which as the description says, might mean the account was already linked.
# The linked page should redirect you [https://tmw2.org/api/linked to the success page] ─ keep in mind bad clients may access the page first to generate a preview. This '''will''' execute the linking. After that, using the link will show you the [https://tmw2.org/api/link_error 403 error page] which as the description says, might mean the account was already linked.
# If it says anything else, it failed.
# If it says anything else, it failed.
Line 62: Line 67:
Most features, including the "Crossroads" Server (where multi-server events happen), require you to have set a homeworld.
Most features, including the "Crossroads" Server (where multi-server events happen), require you to have set a homeworld.


Once you set one, you'll not be able to change it, so chose wisely. Also, '''if you unlink your homeworld, you'll not be able to link it again'''.
Once you set one, you'll not be able to change it, so chose wisely (Hint: The one with the most EXP). Also, '''if you unlink your homeworld, you'll not be able to link it again'''.


Before you can select "Crossroads", you need to:
Before you can select "Crossroads", you need to:
Line 81: Line 86:
# Select the world and click "Play"
# Select the world and click "Play"
# In the client window which opened, select the char.
# In the client window which opened, select the char.
 
(Hint: If you see a login screen already filled in, don't change it. Just continue.)
There's literally nothing else you need to do after setup is done, you even spared yourself from a few clicks.
There's literally nothing else you need to do after setup is done, you even spared yourself from a few clicks.


Line 102: Line 107:
== Copying existing M+ configuration ==
== Copying existing M+ configuration ==


Everything is stored in manaplus/ folder. Including updates and configuration files.
Everything is stored in the manaplus/ folder in the launcher, including updates and configuration files. In ManaPlus or ManaVerse clients, you can use the command /dirs to see where your settings, logs, etc are located.


You might want to copy over the stuff from your local M+ folders. To do this, you can copy the configuration files (on linux, it's in ~/.config/mana) to manaplus/Config.
If you want to copy over the files from your M+ folders, you can copy the configuration files and overwrite the launcher ones.
On linux, copy the files in (~/.config/mana) to manaplus/Config and (~/.local/share/mana) to manaplus/Local. Do not overwrite the Config directory in the root launcher folder, unless you wish to overwrite the default settings.


== Keeping it updated ==
== Keeping it updated ==

Latest revision as of 23:20, 26 July 2023

Installation Instructions

These instructions are for installing the Mana Launcher (whatever version is latest), linking accounts and copying ManaPlus installation files (if you're an existing player), and keeping it up-to-date.

The Mana Launcher allows you to use the Mirror Lake features.

A video guide is available on YouTube.

Downloading the Launcher

The Mana Launcher has two versions, depending on your needs. The "Complete" version is the one also on Steam ─ it comes pre-configured and pre-installed, and with all updates to give you the most seamless experience possible. You're implicitly signing a bunch of agreements and licenses (the privacy policy, however, is the same), which is why the "Minimal" version contains only the Ren'Py component ─ it is a much smaller download, will make easier to read the licenses and agreements, and will allow you to keep only what you intend to use, but will also have additional prompts and downloads.

You can also see all versions and checksums.

Login & Registration

Register Screen

NOTE: If you already have a TMW Classic or TMW Moubootaur Legends account, you will use these credentials on linking section.

  1. Start the software by running the appropriate .sh or .exe file
  2. On the first time, it'll ask you about configurations. Tweak them as you wish, or press to "continue" ─ they should have good defaults. Make sure to use "ManaVerse" if you changed them. You can edit the settings later, but the button to do so is obscure (but ESC should work, most of time).
  3. Create an account. Make sure the email is valid. TOTP field can be left empty (000000). Mark both "remember" checkboxes, to make your life simpler. There will be an * remaining in the password field after you delete the default entry. Disregard this and enter your password as explained below.
  4. If you can't press "OK", you know what they say ─ press ENTER and call it a day.

The minimal version will have more prompts. If "mask password" is enabled, the first star will never disappear ─ this is to ensure you can always find the invisible input field. Well, it is a bug, but then this is a beta software and Ren'Py was most definitely not made for this.

Linking Accounts

If you're a new player, you can skip this section.

You'll only do this on the first time. DO IT BEFORE PRESSING ANY OTHER BUTTON. When asked if you already played TMW, say "Yes", or go to The Void and Manage Account. If you don't, it might create a new account and you might need an admin to remove it in order to linking to work.

Linking Screen
"Link" button
  1. Click on "Yes" when it asks if you want to import. Otherwise, follow the additional steps:
    1. Go to "The Void"
    2. Click on "Manage Account"
  2. On the account management screen, for each world you play, click on "LINK ACCOUNT"
  3. Fill the email and username associated to the linked account. Make sure the email works, as you'll need to follow a link.
  4. Wait for the email to be delivered; it can take up to 5 minutes.
  5. The linked page should redirect you to the success page ─ keep in mind bad clients may access the page first to generate a preview. This will execute the linking. After that, using the link will show you the 403 error page which as the description says, might mean the account was already linked.
  6. If it says anything else, it failed.

After the account was linked (see step #4 to determine if it worked), you can go back to the world selection and play on it.

You must wait 1 (one) minute between linkings or unlinkings.

If it is a TmwAthena account, you might need to wait up to 15 minutes for the changes to be propagated properly.

Also, feel free to enable or disable 2FA in that screen, but it'll prevent other account operations for 15 minutes.

If anything goes wrong, you'll need to bribe the sysadmin with cake to get this mess fixed. The System Administrator Appreciation Day is July 28th, ya'know?

Once you have linked all accounts you wish to use, keep in mind you might be unable to use them with ManaPlus/ManaVerse until you "unlink" them again.

Setting a home world

The Void Screen
Selecting a Homeworld

Most features, including the "Crossroads" Server (where multi-server events happen), require you to have set a homeworld.

Once you set one, you'll not be able to change it, so chose wisely (Hint: The one with the most EXP). Also, if you unlink your homeworld, you'll not be able to link it again.

Before you can select "Crossroads", you need to:

  1. Go to "The Void"
  2. Click on "Set"
  3. Select the world your main is and confirm

Again, you cannot revert this if you change your mind later. You might be able to get help from support team, though.

Setting a home world has several perks, like bonus experience in all other worlds and access to the Crossroads server. You can find more about it in Mirror Lake.

Playing the Game

Playing with the launcher is extremely simple, specially if auto-login is enabled on settings (the dim "Prefs" button on bottom-center area).

  1. Start the launcher with the .sh or .exe
  2. Select the world and click "Play"
  3. In the client window which opened, select the char.

(Hint: If you see a login screen already filled in, don't change it. Just continue.) There's literally nothing else you need to do after setup is done, you even spared yourself from a few clicks.

Keep in mind that you may find portals which move you to a different world. A cutscene will play out in some cases (such as the first time you use them). If you enabled "iconify", you might need to maximize the launcher again. These portals are still highly experimental.

NOTE: You can delete characters in any Evol2 server ─ just write whatever you want in the prompt, it'll work, even if it is "a@a.com". This however will not work in TmwAthena. Go figure...

Unlinking Account

If you wish to stop using the Launcher and go back to use the Mana Plus client directly, you can unlink your game accounts:

  1. Go to "The Void"
  2. Click on "Manage Account"
  3. For each world you want, click on "UNLINK"
  4. Fill the email and username which you want to use.
  5. It is done, you can already use the email to ask for a password reset.

NOTE: In TMWA, the username field must be filled with at least four characters, but will ultimately do nothing.

Copying existing M+ configuration

Everything is stored in the manaplus/ folder in the launcher, including updates and configuration files. In ManaPlus or ManaVerse clients, you can use the command /dirs to see where your settings, logs, etc are located.

If you want to copy over the files from your M+ folders, you can copy the configuration files and overwrite the launcher ones. On linux, copy the files in (~/.config/mana) to manaplus/Config and (~/.local/share/mana) to manaplus/Local. Do not overwrite the Config directory in the root launcher folder, unless you wish to overwrite the default settings.

Keeping it updated

If you press "ESC" on the world selection, you'll find an "Update" button. This will allow you to update the Mana Launcher itself. (We haven't tested it, in case you're wondering).

You can also press "Check updates" in the settings screen to update ManaPlus/ManaVerse.

Miscellaneous

You can also use F10 or F12 to take a screenshot from the launcher itself, which will be kept on the base directory, but honestly who cares? All the good stuff happen in the game client.

"ManaVerse" client is available for Linux and Windows (64 bits). "ManaPlus" client is available for Linux only. Built-in client does not work, please refrain from selecting it.

"Iconify" may not work in Windows. It minimizes the launcher while a game is running.

Under most Operating Systems, it is safe to close the launcher after launching the M+ client. They are sent as external, non-daemonized, independent sub-processes (or as independent as your OS allows). Do this if you're running low in RAM, but the mirror lake portals will not work in this case.

TOTP field stands for Time-based One Time Padlock. It is a type of Two Factor Authentication, for additional security. By default, new accounts come with TOTP disabled (so you can ignore the field), but you can both configure a two-factor authentication (enable it in "Manage Account"), and use the Mana Launcher itself as your totp token generator.

Storing passwords is considered "unsafe" because the password will be stored unencrypted in your computer. It is however obfuscated. In other words, we do not expect any leaks, but we'll not take any responsibility for it, you were warned.

You can always find us on Discord, IRC and Forums willing to help. But if all else fails, you can just use the game client directly. Use of the Mana Launcher is encouraged, but by no means mandatory.

You are NOT allowed to create multiple accounts on the Mana Launcher. However, you can create as many accounts on TMW Classic as your heart desires with the client.

Testimonials

Hocus — Today at 16:42
well it is a big step towards what was micks and my vision for where the project should go (unfortunately the other parts developed in an unfavourable direction so not sure if this will be able to kit it)

Jesusalva — Today at 01:42
It is what it is. Critique is welcome, as long that it is "publish as-is" or "discard as-is". Anything else, I hope it comes with a volunteer attached. Discarding means less maintenance upkeep, Publishing means we'll have something to actually put on Steam. To be honest, Ren'Py is horrible at handling input and I would rather not have used it at all, but what's done is done and I'm not going to waste more time on this.

Ledmitz — Today at 03:28
I'm extremely impressed. Small details can be worked out, but it was amazing to just walk onto a server without ever having registered there before. Seeing what is possible and hearing what's to come makes me very excited. This makes so much more possible and will create inter-server traffic, without a doubt.