THE MANA VERSE CLIENT
=====================

 Builds:
  ManaVerse CI: https://git.themanaworld.org/mana/verse/-/pipelines
  Windows:      https://git.themanaworld.org/mana/docker-windows-builder/-/jobs/artifacts/master/browse?job=mxe_gcc5
  AppImg:       https://git.themanaworld.org/mana/appimg-builder/-/jobs/artifacts/master/browse?job=x86_64-AppImage
  deb:          https://git.themanaworld.org/mana/appimg-builder/-/jobs/artifacts/master/browse?job=deb_pkg

  See file INSTALL for build instructions.

 Development team:
  - See AUTHORS file for a list

 Dependencies:

  - SDL, SDL_image, SDL_mixer, SDL_ttf, SDL_net (Media framework), SDL_gfx
  - libxml2 or pugixml or tinyxml2 (XML parsing and writing)
  - libcurl (HTTP downloads)
  - libpng (save screenshots)
  - zlib (Archives)

 Optional dependencies:

  - gettext (translations)

 Embedded libs:

  - catch and doctest for unit testing.
  - nvwa for debug memory leaks.
  - SaferCPlusPlus for debug issues in std::vector usage.

 Additiona run time deps:
  - xsel (for clipboard access, used only in SDL 1.2)
  - xdg-open (from xdg-utils, for open url in browser)

 Images and fonts sources:
  - data/icons
  - data/fonts/src


0. Index
--------

1. Account
2. Commands
3. Skills
4. Support
5. License

1. Account
----------

To create an account you can usually press the "Register" button after
choosing your server. When this doesn't work, visit the website of the server
you'd like to register on, since they may be using an online registration
form instead.

2. Commands
-----------

KEYBOARD:

Use arrow keys to move around. Other keys:

- Ctrl               attack
- F1                 toggle the online help
- F2                 toggle profile window
- F3                 toggle inventory window
- F4                 toggle equipment window
- F5                 toggle skills window
- F6                 toggle minimap
- F7                 toggle chat window
- F8                 toggle shortcut window
- F9                 show setup window
- F10                toggle debug window
- Alt + 0-9,-, etc   show emotions.
- S                  sit down / stand up.
- F                  toggle debug pathfinding feature (change map mode)
- P                  take screenshot
- R                  turns on anti-trade function.
- A                  target nearest monster
- H                  hide all non-sticky windows
- Z                  pick up item
- Enter              focus chat window / send message

MOUSE:

Left click to execute default action: walk, pick up an item, attack a monster
and talk to NPCs (be sure to click on their feet). Right click to show up a
context menu. Holding [Left Shift] prevents from walking when attacking.

/Commands:

Please refer to chat commands entry in built-in help pages

4. Support
----------

Please report any issues you are having with this client.
You can report them at:

- bugtracker: https://git.themanaworld.org/mana/verse/-/issues/
- forum: http://forums.themanaworld.org/viewforum.php?f=56
- IRC: https://web.libera.chat/?channels=themanaworld-irc
- Discord https://shields.io/discord/775612630836445206.svg?label=Discord
- In game: to game masters, developers or #world channel.

If you have feedback about a specific game that uses the ManaVerse client, be sure
to instead contact the developers of that game.

5. Licenses
-----------

All code in this repository is under GPL 2+ license. Art can be under CC-BY-SA or GPL 2+.

GitHub or other non-free hosting providers may use strange Terms of Service that may violate these licenses.
If any of their terms violate these licenses then these providers should remove ManaVerse repositories from their platforms.

ManaVerse is a fork of ManaPlus, the main repository of the latter is hosted on https://gitlab.com/manaplus/manaplus/
