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

 Builds:
  ManaVerse CI: https://git.themanaworld.org/mana/plus/-/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:

Whispers:
- /closeall          close all whispers.
- /ignoreall         add all whispers to ignore list.
- /msg NICK text
- /whisper NICK text
- /w NICK text       send whisper message to nick.
- /query NICK
- /q NICK            open new whisper tab for nick.

Actions:
- /help              show small help about chat commands. /target NICK - select nick as target. Can be monster or player nick.
- /outfit N          wear outfit number N.
- /outfit next       wear next outfit.
- /outfit prev       wear previous outfit.
- /emote N           use emotion number N.
- /away
- /away MSG          set away mode.
- /follow NICK       start follow mode.
- /imitation NICK    start imitation mode.
- /heal NICK         heal somebody by nickname
- /move X Y          move to X,Y position in short distance.
- /navigate x y      move to position x,y in current map in any distance.
- /mail NICK MSG     send offline message to NICK. Working only in servers with mail support.
- /disconnect        quick disconnect from server.
- /attack            attack target.

Trade:
- /trade NICK        start trade with nick.
- /priceload         load shop price from disk.
- /pricesave         save shop price to disk.

Player relations:
- /ignore NICK       add nick to ignore list.
- /unignore NICK     Remove nick from ignore list.
- /friend NICK
- /befriend NICK     add nick to friends list.
- /disregard NICK    add nick to disregarded list.
- /neutral NICK      add nick to neutral relation list.
- /erase NICK        add nick to erased list.
- /clear             clear current chat tab.
- /createparty NAME  create party with selected name.
- /me text           send text to chat as /me command in irc.

Debug:
- /who               print online players number to chat.
- /all               show visible beings list in debug tab.
- /where             Show map and coordiantes of your avatar
- /cacheinfo         show text cache info.
- /dirs              show client directories in debug window.

Other:
- /help              Displays the list of commands
- /announce          (GM) broadcasts a global msg

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

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

- bugtracker: https://git.themanaworld.org/mana/plus/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/