http://doc.manasource.org/ 2012-05-18T21:23:10+02:00 http://doc.manasource.org/ http://doc.manasource.org/lib/tpl/default/images/favicon.ico text/html 2010-06-03T18:37:29+02:00 http://doc.manasource.org/account_manager?rev=1275583049&do=diff The Mana World Account Manager The Account Manager also known as ManaWeb is the web interface for users and administrators to manage their accounts from outside the game. Users can reset their password, see their character stats, and change the email associated with the account. text/html 2010-09-22T10:47:20+02:00 http://doc.manasource.org/attributes.xml?rev=1285145240&do=diff The attributes.xml file is used to set up the different usable attributes for beings in the game world. Attribute scopes are typically as being, but monster and character scopes are available as well. The attribute types are still hardcoded into the game-server - this file determines how the attribute can be further modified past the base value. Calculation of the base value is hardcoded - see the virtual being updateDerivedAttributes() method for details. text/html 2011-03-18T21:03:21+02:00 http://doc.manasource.org/ban?rev=1300478601&do=diff Synopsis @ban [character] [duration](m|h|d|w|y) Prevents login with the account of the character for a specific duration and kicks the character from the game. Examples @ban Abuser 5m Bans the account of Abuser for five minutes @ban # 1h Bans your own account for one hour. text/html 2010-06-09T00:49:13+02:00 http://doc.manasource.org/bertram_new_start?rev=1276037353&do=diff The Manasource project aims at bringing a real innovative, complete and Free 2D-MMORPG generic platform. With both our server and client provided, you'll be able to set up your own world, or take part of one already set up by our community. If you want to get on board, why not try to come on IRC, or try the forums. text/html 2011-01-27T19:59:48+02:00 http://doc.manasource.org/branding.xml?rev=1296154788&do=diff The branding.mana file is to be given to the mana client binary on the command line, and is used to customize it in many ways, explained below: E.g: $./mana my_branding_file.mana Here is a branding.mana file sample: <?xml version="1.0" encoding="utf-8"?> <configuration> <option name="appName" value="Manasource"/> <option name="appShort" value="Mana"/> <option name="appIcon" value="icons/mana"/> <option name="loginMusic" value="login.ogg"/> <option name="onlineServerList" value="http://ma… text/html 2010-05-05T12:53:44+02:00 http://doc.manasource.org/character_transfer_interface?rev=1273056824&do=diff To allow a multi world server landscape there should be a standardized way to transfer characters to different servers to make it easier for players to switch servers. The system should be: * decentralized * tampering-proof * allow control for servers from where they import characters and how text/html 2012-03-05T20:36:51+02:00 http://doc.manasource.org/chat_commands?rev=1330976211&do=diff The Manasource server reacts on the following chat commands when a player enters them. The commands which are available to different user groups can be set in permissions.xml. Implemented and working Command Function @announce Sends a chat message to all characters in the game @attribute Changes the character attributes of a character @ban Bans the character and all characters on the same account from the game @charwarp Warps a character @craft Attempts to craft something @die Kills the … text/html 2010-04-25T21:11:24+02:00 http://doc.manasource.org/client_actor_hierarchy?rev=1272222684&do=diff With c22ea2f169f58e765fc699fcd71bfd3a3cd4f859, the client now has an actor class that underlies Being, FloorItem, and Particle. The hierarchy is currently this: * Actor * Being * Monster * Player * LocalPlayer * NPC * FloorItem * Particle * ImageParticle * AnimationParticle * RotationalParticle text/html 2011-10-29T13:59:25+02:00 http://doc.manasource.org/client_configuration?rev=1319889565&do=diff Note: This article is about setting up your own basic Mana client data, either for testing purposes or because you want to provide an alternative to the official server. There are several steps to achieve this: Running Mana * Create a data/ folder text/html 2011-10-29T13:57:50+02:00 http://doc.manasource.org/client_data_handling?rev=1319889470&do=diff A MMORPG client such as the Mana client needs manage a lot of data. Mana tries to remain flexible, but easy to use, for server maintainers to make and maintain client data. Mana will load data from several places. Each has it's own purpose. Depending on the operating system, the Mana client won't locate its data in the same place, here is where each data type is stored, depending on the main supported OSes. '%appShort%' is a branding value (of the same name, taken from the branding file, if pro… text/html 2010-05-06T15:28:24+02:00 http://doc.manasource.org/client_design_overview?rev=1273152504&do=diff This page is made to gather documentation about the client design, technically speaking: Architecture: * Client actor hierarchy: Gives a short description of the current split made between actors and sprites, two main class in the mana client. text/html 2010-08-18T18:50:28+02:00 http://doc.manasource.org/client_events?rev=1282150228&do=diff The client uses an event system to pass information as needed. Events are triggered on specific channels and have names and optional parameters (integers, double precision floating point, and strings). Events in the client are detailed in this article. Events are organized by channel. text/html 2011-05-02T10:11:05+02:00 http://doc.manasource.org/client_features?rev=1304323865&do=diff The Mana client has the following features and capabilities: General * Consists entirely of free, open source software * Runs on Windows, Linux and several other operating systems * Can download content updates from the web * Support for custom branding * Capable of connecting to different game worlds * Support for a modified eAthena server (named Tmw-eAthena) and ManaServ text/html 2012-05-09T22:03:34+02:00 http://doc.manasource.org/client_installation?rev=1336593814&do=diff This page contains information about how to install the client on your system. Windows For latest release get the installer from <http://manasource.org/downloads> and install it. For daily builds check out <http://nightlies.manasource.org/> Ubuntu, Mint and other Ubuntu based distros Using synaptic * Open Synaptic * Go to Settings -> Repositories * Select the Other Software tab * Click Add and insert this line: ppa:mana-developers/ppa text/html 2012-04-01T19:41:59+02:00 http://doc.manasource.org/client_release_how-to?rev=1333302119&do=diff How to release a new client version WIP: This page is currently under heavy work in progress. Use what's written below with caution. This page will describe how-to bring a new mana (unbranded) client version Windows Installer, but also how to make a new TMW release (The branded mana version). This page was made for developers, and for people willing to try to brand their own flavour of the mana client. We'll assume here that you have knowledge with the Linux shell (or CLI) and are familiar wi… text/html 2012-03-29T06:45:13+02:00 http://doc.manasource.org/compile_mana_from_source?rev=1332996313&do=diff Mana client compilation This page will try to help compiling the latest mana version corresponding to your platform and development tools used. First of all, be sure to download all the dependencies needed by the client and to install them where appropriate. text/html 2011-04-03T23:14:57+02:00 http://doc.manasource.org/compile_mana_on_windows_with_cmake?rev=1301865297&do=diff Compiling Mana on Windows using CMake * Get the Mana sources either from git or download the latest release. We'll assume they are at C:\mana * Get the mana_libs.zip package * Extract mana_libs.zip somewhere (current version creates a tmw_libs directory). For this howto we'll assume C:\tmw_libs * Install CMake. Be sure to tell it to add itself to the system PATH during the installation (unless you know wat you're doing), either for current or all users. * Install MinGW. Take the lates… text/html 2012-02-15T20:06:30+02:00 http://doc.manasource.org/compile_manaserv_from_source?rev=1329332790&do=diff Compilation of the ManaServ server Linux Here is how to set up a ManaServ server on a Linux/Unix system. Be sure to get all the needed dependencies and corresponding headers before trying to compile. Cloning and compiling Start with cloning ManaServ from the Git repository and compile it. We're using the cmake build system: text/html 2010-09-24T11:23:27+02:00 http://doc.manasource.org/config.xml?rev=1285320207&do=diff The config.xml file is auto-generated by the client when it doesn't already exists to store setup data such as the application resolution, the bounded keys, ... This file can be located at different locations, depending on your OS. Here is a config.xml file sample: text/html 2011-04-27T15:48:40+02:00 http://doc.manasource.org/craft?rev=1303912120&do=diff Synopsis @craft <item1> <amount1> { <item2> <amount2> } ... { <itemN> <amountN> } This command is a temporary solution for implementing a crafting system until a GUI for crafting is implemented. Examples @craft "Iron Bar" 2 Wood 1 This tries to combine two iron bars and a piece of wood into a new item. text/html 2011-05-02T17:04:49+02:00 http://doc.manasource.org/crafting?rev=1304348689&do=diff Manaserv includes a fully scripted crafting system which allows a server administrator to script an own crafting logic in LUA. Client side Currently crafting is done through the @craft command. Replacing this workaround with a GUI is planned (<http://bugs.manasource.org/view.php?id=335>) text/html 2012-01-08T10:55:39+02:00 http://doc.manasource.org/database_installation?rev=1326016539&do=diff Before you can set up your own server you have to decide wich database backend you want to use. Currently, the server supports three different types of database backends: * mySQL * SQLite * PostgreSQL Settings up SQLite (Default database) Requirements So far, the Mana Server has been tested with SQLite version 3.6.23.1 text/html 2010-03-21T21:03:12+02:00 http://doc.manasource.org/database_specifications?rev=1269201792&do=diff mana_accountsColumn nameDatatypeNullableReferencesDescriptionidint(10)PRIMARY KEY usernamevarchar(64)UNIQUE KEY passwordvarchar(64)NOT NULL emailvarchar(32)UNIQUE KEY leveltinyint(3) NOT NULL bannedint(10) NOT NULL registrationint(10)NOT NULL lastloginint(10)NOT NULL authorizationtext for manawebexpirationint(10) for manaweb * email * The email is stored as a one-way sha256 hash value. This ensures, that the email address a user enters cannot be used to send spam mails. It is only… text/html 2012-02-25T14:04:54+02:00 http://doc.manasource.org/dependencies?rev=1330175094&do=diff Mana Client Here is the list of libraries currently used by the Mana client: * SDL - <http://www.libsdl.org/> * SDL_mixer - <http://www.libsdl.org/projects/SDL_mixer> * SDL_image - <http://www.libsdl.org/projects/SDL_image> * SDL_net - <http://www.libsdl.org/projects/SDL_net> * SDL_ttf - <http://www.libsdl.org/projects/SDL_ttf> * SDL_gfx - <http://www.ferzkopp.net/joomla/software-mainmenu-14/4-ferzkopps-linux-software/19-sdlgfx> * Guichan 0.8.x - <http://code.google.com/p/gu… text/html 2012-02-04T22:11:17+02:00 http://doc.manasource.org/developers?rev=1328389877&do=diff Nick Name Real Name E-mail Location bjorn Thorbjørn Lindeijer thorbjorn lindeijer nl Germany Bertram Yohann Ferreira yohann_<dot<_ferreira_<at<orange_dot_efer France Crush Philipp Sehmisch mana@crushnet.org Germany Ablu Erik Schilling ablu.erikschilling googlemail.com Germany ... text/html 2012-02-04T22:01:12+02:00 http://doc.manasource.org/developers_list?rev=1328389272&do=diff moved to developers text/html 2011-09-12T19:32:17+02:00 http://doc.manasource.org/development_process?rev=1315848737&do=diff Manasource is a bazaar-style project which is open to input from users and invites everyone to contribute code. But we still need a bit of red tape to keep the development organized. This article describes how a change gets into the official codebase. text/html 2011-03-17T16:34:10+02:00 http://doc.manasource.org/die?rev=1300376050&do=diff Synopsis @die Kills your own character by setting its hit points to 0. This will trigger the normal on_chr_death handler and on_chr_death_accept handler. Security Exploitable Making this command available to everyone can be very useful during the public beta testing stage of your game, because it allows players to free themself when they are stuck (which can happen very easily through a misconfigured map warp or teleport script). text/html 2011-03-17T16:08:50+02:00 http://doc.manasource.org/drop?rev=1300374530&do=diff Synopsis @drop <item> [amount] Creates a stack of items on the ground at your current location. The item can be indicated with an item name (case insensitive) or an item ID. An amount of items can be indicated optionally. Examples Create a stack of 10 candy: text/html 2011-05-05T11:34:51+02:00 http://doc.manasource.org/effects.xml?rev=1304588091&do=diff The effects.xml file is used to define status and magic particle effects seen around the character. Here is a description of the different parameters of this file: Here is a effects.xml file sample: <?xml version="1.0" encoding="utf-8"?> <effects> <effect id="0" audio="sfx/system/levelup.ogg" particle="graphics/particles/levelup.particle.xml" /> <effect id="1" audio="sfx/system/levelup.ogg" particle="graphics/particles/skillup.particle.xml" /> <effect id="2" particle="graphics/particle… text/html 2010-09-30T17:57:27+02:00 http://doc.manasource.org/emotes.xml?rev=1285862247&do=diff The emotes.xml files is used to set up available emoticons the player can display to show his/her mood to others while in-game. Here is an example of the emotes.xml file: <emotes> <emote id="0"><sprite name="Disgust" variant="0">emote.xml</sprite></emote> <emote id="1"><sprite name="Surprise" variant="1">emote.xml</sprite></emote> <emote id="2"><sprite name="Happy" variant="2">emote.xml</sprite></emote> <emote id="3"><sprite name="Sad" variant="3">emote.xml</sprite></emote> <emote id="4"… text/html 2011-11-14T14:06:40+02:00 http://doc.manasource.org/equip.xml?rev=1321276000&do=diff The equip.xml file is used to set up the different equipment slots for the player's characters in the game world. Here is an example of the currently default equip.xml file: <?xml version="1.0" encoding="utf-8"?> <equip-slots> <slot id="1" name="Hand" capacity="2" visible="true" weapon="true"> <box x="8" y="123" background="equip-box-hands.png" /> <box x="129" y="123" background="equip-box-shield.png" /> </slot> <slot id="2" name="Torso" capacity="1" visible="true… text/html 2009-10-29T09:45:37+02:00 http://doc.manasource.org/executing_sql_statements?rev=1256805937&do=diff The current Data access layer (DAL) of manaserv provides an abstract interface to execute SQL statements against several types of database engines. SQL statement can be executed using two different methods whereas the second one is the preferred way. text/html 2012-02-26T12:07:48+02:00 http://doc.manasource.org/games_based_on_manasource?rev=1330254468&do=diff Manasource is a platform used by many independent teams to create their online world. While some make use of their freedom to fork and modify the Mana plattform to fit their individual needs others use the software in the default state and contribute to its development directly. text/html 2011-08-15T17:38:10+02:00 http://doc.manasource.org/git_repository?rev=1313422690&do=diff Introduction We are using the version control system Git as our main collaboration tool. You can use it to obtain all the source code and content files you need to take part in the development or to create your own fork. See the Wikipedia article about Git and the Git homepage for details about Git. text/html 2011-03-14T15:28:40+02:00 http://doc.manasource.org/givepermission?rev=1300112920&do=diff Synopsis @givepermission [charactername] [permissiongroup] Adds a permission group to the account of a player. This command can be used to appoint game masters, administrators or other privileged users. Note that permissions are handled on account level, not character level, although you have to specify a character name from the account when using this command. This means that all characters from the same account will gain the permission group. The character must be online for this command to wo… text/html 2010-12-08T20:31:32+02:00 http://doc.manasource.org/global_events.lua?rev=1291836692&do=diff Server admins might want to modify how certain events which happen frequently in the game on different maps are supposed to be handled. Examples for this could be death penalties and the respawn system. Currently it is only possible to catch such events by local scripts on the map where they happen and this in many cases only with some nasty hacks to make sure that every being gets the appropriate death listener function. For that reason there should be a central file to define the behavior in c… text/html 2011-03-14T16:08:51+02:00 http://doc.manasource.org/goto?rev=1300115331&do=diff Synopsis @goto [charactername] Warps your character to the location of another character. Examples @goto "Mr. Foo" Warps you to the location of the player “Mr. Foo”. Security Exploitable This command can be used to give the user an unfair advantage and to go to areas which are not supposed to be accessible to them. It should only be given to selected users. text/html 2010-10-07T16:09:08+02:00 http://doc.manasource.org/gui_colors?rev=1286460548&do=diff Note: Don't misunderstand it with the data/colors.xml file used to set image colors using the image dyeing system. The colors.xml file located per default in the graphics/gui folder, or in a custom theme folder (See GUI configuration), is used to specify the different text and progress bars colors using the RGB format. text/html 2010-10-07T16:02:13+02:00 http://doc.manasource.org/gui_configuration?rev=1286460133&do=diff You'll find below the files and options available in order to customize the Mana client's GUI. GUI Theme support The Mana client is aimed at being a generic client, supporting the necessary branding functions for other maintainers. Hence, a GUI theming support has been added through the following branding option: guiThemePath. See the branding.xml page. text/html 2010-08-05T08:57:29+02:00 http://doc.manasource.org/hacking?rev=1280991449&do=diff With multiple coders working on the same source files, there needs to be a standard specifying how code is written down. Not doing so can cause quite some annoyance for certain coders and easily creates more version conflicts than necessary. Indentation Code is indented using 4 spaces, no tabs. text/html 2010-08-17T10:31:23+02:00 http://doc.manasource.org/hair.xml?rev=1282033883&do=diff The colors.xml and hair.xml files are used to dynamically dye a sprite image (for characters hair, notably ) using a pre-defined dye channel. Here is a description of the different parameters of this file: Here is a colors.xml file sample: <?xml version="1.0" encoding="utf-8"?> <colors> <color id="0" value="#8c4b41,da9041,ffffff" name="light brown"/> <color id="1" value="#06372b,489e25,fdedcc" name="green"/> <color id="2" value="#5f0b33,91191c,f9ad81" name="red"/> <color id="3" value… text/html 2010-12-28T02:19:49+02:00 http://doc.manasource.org/help?rev=1293499189&do=diff Synopsis @help [command] Shows a list of chat commands available to the user or the detailed usage syntax and synopsis of a specific chat command. The list of available commands is generated from the permission level of the users account. The help texts are hardcoded in the sourcecode file game-server/commandhandler.cpp and can currently not be localized. text/html 2012-01-27T13:55:30+02:00 http://doc.manasource.org/ideas?rev=1327668930&do=diff Ideas collected here are not well-ordered. This is only supposed to be a collection of stuff that came into people's mind and should not get lost. Merging equipment and inventory window (suggested by bjorn) Currently items get removed from the inventory when equipping them. You have to open the equipment window then to be able to unequip them again. So why not merge the two windows? The equipment preview in the equipment window is not needed anyway since it is exactly the same image like the r… text/html 2011-06-15T09:03:51+02:00 http://doc.manasource.org/image_dyeing_system?rev=1308121431&do=diff The image dyeing system is a very clever automatic image recoloring system, permitting to reuse the same image for different versions. The main use of it is to recolor gray-scaled version of monster sprites images, to easily create many different ones with a single sprite file. text/html 2009-11-13T11:01:32+02:00 http://doc.manasource.org/irc?rev=1258106492&do=diff The Mana Project operates the following IRC channel: #mana on irc.freenode.net. text/html 2011-03-17T16:16:42+02:00 http://doc.manasource.org/item?rev=1300375002&do=diff Synopsis @item <character> <item> [amount] Creates a stack of items in the inventory of a character. The item can be indicated with an item name (case insensitive) or an item ID. An amount of items can be indicated optionally. Examples Give yourself one candy: text/html 2011-11-01T11:40:13+02:00 http://doc.manasource.org/items.xml?rev=1320144013&do=diff items.xml file configuration Data from the items.xml file are used to set up configuration values about every items the players will be able to carry during his/her online experience. The items.xml file has to be located in the data directory. Each configuration option in this xml file, is defined using a <item> tag within the <items> main node. Here is an example: text/html 2011-03-17T16:48:07+02:00 http://doc.manasource.org/jail_map?rev=1300376887&do=diff A jail map is a map you design without any regular way to enter or leave. It can thus only be entered or left with the help of a chat command like @warp, @goto or @recall. Such a map can have various purposes: * an environment for testing on a production server without any interference by regular players * “parking lot” for your own bots * private meeting place for server personnel * temporary confinement of characters suspected of breaking server rules, especially illicit bots. * an… text/html 2011-09-12T19:43:16+02:00 http://doc.manasource.org/joining_the_project?rev=1315849396&do=diff Joining the Mana project So you want to join this project, but you have little or no idea how to get into? The Mana development team is not a closed circle like other projects. You needn't apply to anyone or ask for “being taken into the team”. You don't have to ask for permission to work on something or wait for someone to assign a task to you. A team member is basically everyone who volunteers to do something for the project. text/html 2011-03-17T17:10:27+02:00 http://doc.manasource.org/kick?rev=1300378227&do=diff Synopsis @kick <character> Forcefully disconnects a player character from the game. Other characters which are on the same account or connected from the same IP address are unaffected. The user can immediately reconnect with the character unless this is prevented by other means. text/html 2011-03-17T17:02:00+02:00 http://doc.manasource.org/kill?rev=1300377720&do=diff Synopsis @kill <character> Kills a player character by setting its hit points to 0. This will trigger the on_chr_death handler and on_chr_death_accept handler like any “natural” death. Examples Kill the character “Bob” @kill Bob Kill the character “Bob the Builder” (note the spaces in the name) text/html 2011-03-18T13:00:04+02:00 http://doc.manasource.org/killmonsters?rev=1300449604&do=diff Synopsis @killmonsters Kills all monsters on the current map. They will drop their normal loot, their on_death script handlers will be triggered, and experience will be awarded to all characters who damaged them as normally. Security Exploitable Note that this command does not just remove the monsters but also causes drops and experience to be generated. text/html 2012-05-05T21:43:16+02:00 http://doc.manasource.org/lpc?rev=1336246996&do=diff This page contains some basic information about the Liberated Pixel Cup project based on the Mana client and server. Here are some decisions that have been discussed and decided. * Inventory and equipment will be slot based. Rationale: this is the way the Mana server currently implements them, and it's not something we want to spend a lot of time on right now. Implications: Inventory will be displayed in a grid and will not mention equipped items. Equipment slots will be displayed separately… text/html 2009-12-26T11:22:04+02:00 http://doc.manasource.org/making_money_with_manasource?rev=1261822924&do=diff Manasource is a free software licensed under the GNU GPL. This means it is free as in freedom, not necessarily free as in free beer. The GNU GPL might not be the best software license to maximize profit, but it nevertheless permits to make profit from developing, distributing and using it. text/html 2011-04-28T23:50:50+02:00 http://doc.manasource.org/mana-skills.xml?rev=1304027450&do=diff The mana-skills.xml file is the old name used by the client versions: 0.0.29.1, 0.5.1 and 0.5.2. The versions 0.5.3 and 1.x will use the new file. See skills.xml for the current available definition. text/html 2010-11-05T21:48:56+02:00 http://doc.manasource.org/mana_mobile?rev=1288990136&do=diff Mana Mobile is basically a Qt 4.7 based version of the client, written from scratch. The “Mobile” suffix is mainly because I believe mobile should be our primary target, but there is nothing stopping anybody from using Mana Mobile on the desktop and it should also be doable to write a customized UI for the desktop eventually. text/html 2010-04-08T18:00:05+02:00 http://doc.manasource.org/manaserv-use_cases-characters_movement_system?rev=1270742405&do=diff Here is a list of proposed use cases to test the quality of the movement system under ManaServ: Component description: The server sided movement system is tile-based under ManaServ. On the contrary, the client emulates pixel coordinates handling in order to attempt to smooth the user experience. Please keep in mind that characters/monsters/ NPC/... are moving pixel-wise while keeping a tile logic, expecially for collision handling. text/html 2012-04-13T10:26:08+02:00 http://doc.manasource.org/manaserv.xml?rev=1334305568&do=diff manaserv.xml file configuration Data from the manaserv.xml file or .manaserv.xml store central configuration values for the account and the game servers. Each configuration option is defined using an <option> tag within the <configuration> main node, for instance: text/html 2011-11-01T10:37:28+02:00 http://doc.manasource.org/manaserv_protocol?rev=1320140248&do=diff ManaServ server protocol When playing on a ManaServ server, the player will interact with different other entities, includinf his/her own character, use item, chat, fight monsters, use skills, ... In order to deal with all players real-time requests in an efficient way, a ManaServ server message protocol has been defined to give the client all the necessary information, in a minimalistic approach, to save bandwidth and server computation cycles. text/html 2010-09-28T13:58:13+02:00 http://doc.manasource.org/manaserv_statistics_system?rev=1285675093&do=diff This page tries to gather latest discussion about the statistic system used in ManaServ, here. Would the gaps and lacks be filled, the given page would then become a reference for developers and high-level players. I especially invite the senior developers to make review of this page and/or take part of the forum's thread to make things happen. :) text/html 2010-06-03T18:30:58+02:00 http://doc.manasource.org/manaweb_connectors?rev=1275582658&do=diff What is a ManaWeb Connector? The ManaWeb Connector is a package of methods provided by ManaWeb to allow foreign applications to access data of the running ManaServ server. A common example is a list of online users that are currently connected to the server. ManaWeb is able to deliver the data in different formats to be as open as possible for all kinds of applications, e.g. plain text or XML. text/html 2011-02-03T14:07:18+02:00 http://doc.manasource.org/mantis_workflow?rev=1296738438&do=diff Here is the documentation about the workflow used to deal with new bugs and features in Mana, and ManaServ. The Mantis issue tracker is our tool to deal with task assignment, mainly for development purpose. This tool is used to display, filter, and order the team development work. text/html 2012-03-11T00:33:52+02:00 http://doc.manasource.org/mapping?rev=1331422432&do=diff Basics Making maps for The Mana World is not a task that requires a lot of knowledge but is a very good way to become creative and help the game to become more attractive. But getting started can be a little frustrating. Here is a guide that will help you to learn how to make maps. text/html 2010-04-14T12:20:02+02:00 http://doc.manasource.org/maps.xml?rev=1271240402&do=diff The maps.xml file is used to each map files a unique ID, used by both the game and account server. <?xml version="1.0" encoding="utf-8"?> <maps> <map id="1" name="tulimshar"/> <map id="2" name="eastwoods"/> <map id="3" name="greathouse"/> ... </maps> text/html 2012-01-06T15:00:42+02:00 http://doc.manasource.org/monsters.xml?rev=1325858442&do=diff monsters.xml file configuration Data from the monsters.xml file are used to set up configuration values about every computered related beings the players will encounter during the online experience. The monsters.xml file has to be located in the data directory. text/html 2010-09-30T17:54:16+02:00 http://doc.manasource.org/npcs.xml?rev=1285862056&do=diff The npcs.xml files is used to display and animates the non-playable-characters (NPC) the player will interact with while in-game. Here is an example of the npcs.xml file: <npcs> <npc id="180"><sprite>npcs/npc-savannahman.xml</sprite></npc><!-- Blue Savannah Man with idle animation --> <npc id="181"><sprite variant="81">npcs/npc.xml</sprite></npc><!-- Green Savannah Man --> <npc id="182"><sprite variant="82">npcs/npc.xml</sprite></npc><!-- Young archer --> <npc id="183"><sprite variant… text/html 2010-10-16T22:21:09+02:00 http://doc.manasource.org/particle_system?rev=1287260469&do=diff The particle system The particle system and its related files is a key-feature engine working throughout the client. particle files can indeed be used for animating smoothly any visual eye-candy, from the surrounding glow seen around a player casting a spell, to emote effects for NPCs, for instance... text/html 2011-05-05T11:43:53+02:00 http://doc.manasource.org/paths.xml?rev=1304588633&do=diff The paths.xml file is used by the client to override default data paths and some default filenames not already handled by the branding file. Here is a description of the currently available options: Here is a paths.xml file sample: <?xml version="1.0"? encoding="utf-8"> <configuration> <option name="itemIcons" value="graphics/items/" /> <option name="unknownItemFile" value="unknown-item.png" /> <option name="sprites" value="graphics/sprites/" /> <option name="spriteErrorFile"… text/html 2010-01-17T03:23:45+02:00 http://doc.manasource.org/permissions.xml?rev=1263695025&do=diff Account Permission File permissions.xml This file is for managing the permission model of the server. Manaserv supports up to 8 permission classes which can include different permissions. Every player account can have any combination of permission classes, so it is rarely neccessary to put the same permission into different classes. Every newly created account has the class 1 automatically, so permissions of a normal player should be placed here. text/html 2010-12-08T20:09:30+02:00 http://doc.manasource.org/persistent_variables_for_lua_script_engine?rev=1291835370&do=diff Current situation Currently the LUA script engine has two ways to save variables. Internal LUA variables and quest variables. LUA variables are very fast but unfortunately not persistent. This means that they are lost when the server is restarted. Quest variables, on the other hand, are saved in the database, but they have several issues: text/html 2010-04-25T20:58:26+02:00 http://doc.manasource.org/physfs?rev=1272221906&do=diff Mana (and the old TMW clients) uses PhysFS to load data. Any archive format supported by it should be usable. Only zip has been tested as far as we know. The extension of the file doesn't matter (only tested with zip; Custom data archives need to have the zip extension), just needs to be one of the following formats: text/html 2011-01-20T20:24:05+02:00 http://doc.manasource.org/pixel-accurate_route_finding?rev=1295551445&do=diff Introduction * Why we need it * Examples showing that it is possible Theory * Part 1: partitioning the pixel plane into rectangles which are blocked or unblocked * Part 2: putting dynamic blocks into the plane * Part 3: storing the plane in a data structure * Part 4: finding routes through the mesh for dimensionless objects * Part 5: finding routes through the mesh for two-dimensional objects text/html 2010-06-03T14:07:22+02:00 http://doc.manasource.org/playerset_handling_improvement?rev=1275566842&do=diff This page will attempt to provide specifications improving the current playerset layer definition, including race specific sprites for the body, equipment, and hairstyles support: Currently, the layer specification is made of these layers for each supported protocols: text/html 2010-04-13T09:48:09+02:00 http://doc.manasource.org/ports?rev=1271144889&do=diff Mana Client The Mana Client has currently only nightlies and a beta port for Windows. See here for downloading it. You can also see the ports page from the Mana World wiki, which is technically the previous and latest stable version of the current Mana client. text/html 2010-03-18T13:11:27+02:00 http://doc.manasource.org/quality_insurance?rev=1268914287&do=diff In order to keep a minimum level of software development quality, here are simple points one should try to follow when willing to do 'perfect commits': * Every commits should follow entirely the Hacking convention when possible. * Commits should be reviewed by another developers and questions should cleared out before committing. * The problem should be fully understood before committing. Obvious isn't it ;) * Commits should be clearly summarized in the message's first line for better r… text/html 2011-03-14T16:10:52+02:00 http://doc.manasource.org/recall?rev=1300115452&do=diff Synopsis @recall [charactername] Warps another character to your location Examples @recall "Mr. Foo" Warps the character “Mr. Foo” to your location. Security Critical Other players will feel harassed when this command is used on them without a good reason. The command can also be used to move other characters to areas which are not supposed to be accessible to them. It should only be given to selected users. text/html 2011-08-17T16:52:49+02:00 http://doc.manasource.org/requests_for_comments?rev=1313592769&do=diff This section is for collecting concepts for technical improvements Bertram * Playerset layers handling improvement proposal Crush * Pixel-accurate route finding * Runtime map modification * permissions.xml * global_events.lua * character transfer interface * persistent variables for LUA script engine * Visual manaserv configuration interface * Server-sided special handling concept text/html 2011-03-14T14:58:36+02:00 http://doc.manasource.org/rights?rev=1300111116&do=diff Synopsis @rights Shows a list of the permission groups the account of the character is a part of. Permission groups determine which chat commands are available to the user (the exact list of commands can be obtained with the @help command). Permission groups can be customized in the server configuration file permissions.xml and be assigned to accounts using @givepermission and @takepermission. text/html 2010-04-04T22:15:49+02:00 http://doc.manasource.org/rights.xml?rev=1270412149&do=diff Account Permission File permissions.xml Current state Currently Manaserv knows 8 permission classes (player, tester, gm, developer, administrator and 3 reserved for future use). The permissions of every class are hardcoded. Target state To allow server administrators to decide their server management policy it should be possible to freely name the 8 available classes and define the extent of their permissions. The limitation of 8 classes should stay because it allows the economic and perform… text/html 2010-03-31T16:55:05+02:00 http://doc.manasource.org/runtime_map_modification?rev=1270047305&do=diff For some situations it might be a useful feature to be able to change the map layout while the players are playing. This will allow us to implement features which allow the players to affect the ingame world with their actions. Examples are: * Events which make bridges or walls appear or disappear (like switches or trigger areas) * Gates which open or close * Cities which lie in ruins after an invasion * Constructions created by players * Even maps which are entirely procedurally gene… text/html 2012-05-13T08:46:18+02:00 http://doc.manasource.org/scripting?rev=1336891578&do=diff The Mana server uses the scripting language LUA for scripting. This is a list of the script commands currently implemented in addition to the standard lua statements and functions. Also, if you want to look at actual working samples, you can have a look at the example/serverdata/scripts folder in the Manaserv's source which has always the latest working set. text/html 2011-08-22T14:55:01+02:00 http://doc.manasource.org/server-sided_special_handling_concept?rev=1314017701&do=diff Introduction A special, in Manaserv terminology, is what some other games call a “Skill” or “Ability”. It is a character property which is acquired during gameplay and gives an advantage to the character. It can either be an action the character can perform, like a spell, a special attack or just performing an emote. Or it can be a passive ability which does not need to be activated but always gives a bonus after acquiring it. text/html 2010-10-23T11:37:53+02:00 http://doc.manasource.org/server_code_of_conduct?rev=1287826673&do=diff This document is a draft written by me (Philipp “Crush” Sehmisch). It is not rectified by the Manasource development team. Code of Conduct for Manaserv Server Administrators Manasource is free software licensed under the GNU General Public License. Everyone is allowed to use it for any purpose. But when you offer a service on the internet other people can use, you have a responsibility. That's why we ask administrators of public servers to follow this code of conduct, although it is not part o… text/html 2011-10-29T13:58:33+02:00 http://doc.manasource.org/server_configuration?rev=1319889513&do=diff Note: This article is about setting up your own Mana server, either for testing purposes or because you want to provide an alternative to the official server. To get support about setting up a TmwAthena server, please have a look at The Mana World wiki. text/html 2011-10-29T13:58:49+02:00 http://doc.manasource.org/server_data_handling?rev=1319889529&do=diff Manaserv, as a MMORPG server, will need rather a lot of different data. Depending on their scope, the data can used by the server, the client or both. Maintainers usually tend to put data used by both in the client data along with the rest, and have the server points to it using the clientDataPath option from manaserv.xml. text/html 2011-04-27T17:17:19+02:00 http://doc.manasource.org/server_features?rev=1303917439&do=diff The Mana server has the following features and capabilities: General * Consists entirely of free, open source software (GPL v2) * Runs on Windows, Linux and several other operating systems * Encrypted communication between the different server engines. * Several database supported (SQLite, MySQL, PostGreSQL) text/html 2010-05-07T00:22:46+02:00 http://doc.manasource.org/serverlist.xml?rev=1273184566&do=diff The serverlist.xml file is used to advertised available servers, giving information about them like their name, type, address, port, and minimum client version supported. The server list is specified in the branding file. If a server isn't given on the command-line, the file is downloaded (or used from disk if it can't be) and the user presented with the servers it lists, along with the X most recent servers the client has connected (identical type, address, and port are shown as a single entry… text/html 2011-11-01T11:00:18+02:00 http://doc.manasource.org/skills.xml?rev=1320141618&do=diff The skills.xml file is used to set up the different skills used by the player to gain experience while in game. Warning: WIP Currently, the implementation isn't fully tested. Feel free to report bug in our mantis. Here is an example of a skills.xml file: text/html 2010-12-28T02:33:35+02:00 http://doc.manasource.org/spawn?rev=1293500015&do=diff Synopsis @spawn <monster id> <number> Creates a number of monsters on your current location. Examples Create 3 scorpions: @spawn 1 3 Monster IDs can be looked up and changed in the config file monsters.xml Security Dangerous! This command can be more dangerous to your game than it seems at first. While excessive spawning of monsters sounds like annoying but harmless shenanigans which can be reverted with a single use of @killmonster, keep in mind that the creation of monsters also means cr… text/html 2010-06-30T07:57:15+02:00 http://doc.manasource.org/specials?rev=1277877435&do=diff Specials are special actions the characters can perform. They can be used to implement magic systems, special attack systems or emotion systems. Script engine responsibilities * Telling the C++ engine which special IDs the character may use * Calculate the cost (recharge pool, points pool, cooldown time) of using the special ID for the C++ engine. * Implement the effects of using special IDs text/html 2010-09-23T14:25:31+02:00 http://doc.manasource.org/specials.xml?rev=1285244731&do=diff The specials.xml file is used to set up the different special moves and capacity used by the player while in game. Warning: WIP Currently, the implementation isn't fully tested. Feel free to report bug in our mantis. Here is an example of a specials.xml file: text/html 2010-10-07T16:11:40+02:00 http://doc.manasource.org/speechbubble.xml?rev=1286460700&do=diff The speechbubble.xml file located per default in the graphics/gui folder, or in a custom theme folder (See GUI configuration), is used to specify how to display the speech bubbles when characters chat while in game. Here is an example of a usable speechbubble.xml file: text/html 2012-01-30T20:53:06+02:00 http://doc.manasource.org/sprite_system?rev=1327953186&do=diff The sprite system The animation system and its related files is the most wide spread engine system working throughout the client. Animation files can indeed be used for animating the characters, the monsters, the maps tiles, the emoticons, and so on... text/html 2012-02-13T21:31:24+02:00 http://doc.manasource.org/start?rev=1329165084&do=diff The Manasource project aims at bringing a real innovative, complete and Free 2D-MMORPG generic platform. With both our server and client provided, you'll be able to set up your own world, or take part of one already set up by our community. If you want to get on board, why not try to come on IRC, or try the forums. text/html 2010-08-17T10:46:42+02:00 http://doc.manasource.org/status-effects.xml?rev=1282034802&do=diff The status-effects.xml file is used to define positive and negative status effects seen around the character. Here is a description of the different parameters of this file: Here is a status-effects.xml file sample: <?xml version="1.0" encoding="utf-8"?> <status-effects> <status-effect name="item-healing" id="70" block-id="24" persistent-particle-effect="true" start-particle="graphics/particles/circle.particle.xml" /> <status-effect name="speed" id="37" block-id="21" … text/html 2011-03-14T15:36:48+02:00 http://doc.manasource.org/takepermission?rev=1300113408&do=diff Synopsis @takepermission [charactername] [permissiongroup] Removes a permission group from the account of a player. This command can be used to demote game masters, administrators or other privileged users. Note that permissions are handled on account level, not character level, although you have to specify a character name from the account when using this command. This means that all characters from the same account will lose the permission group. The character must be online for this command t… text/html 2011-05-07T10:29:26+02:00 http://doc.manasource.org/test_data?rev=1304756966&do=diff Usable test data for client and server is available in the example/ folder of the manaserv source folder. text/html 2010-09-23T14:59:07+02:00 http://doc.manasource.org/tools?rev=1285246747&do=diff In order to ease the work of Manaserv's maintainers, several tools have been created and are in a continuous progress to lower the time and energy needed to do daily tasks, and such. Tools for managing the client data Here is a list of useful tools used to deal with client data, which is most visible thing you'll do for your players! text/html 2010-03-16T05:32:16+02:00 http://doc.manasource.org/translations?rev=1268713936&do=diff Translations in the Mana client are handled by the gettext system. This page presents an overview in the context of the game. Please refer to the manual for additional details. Translations are supposed to work out-of-the-box. If they are not, complain to the maintainer of your binary package. This section is dedicated to users compiling mana themselves. text/html 2010-08-13T14:53:22+02:00 http://doc.manasource.org/units.xml?rev=1281704002&do=diff units.xml file configuration Data from the units.xml file are used to set up the currency name and its subdivisions, but also weight unit names. The units.xml file has to be located in the data directory. Each configuration option in this xml file, is defined using a <unit> tag within the <units> main node, which itself has got an <level> child node, ... Here is an example: text/html 2010-04-25T19:26:27+02:00 http://doc.manasource.org/update_system?rev=1272216387&do=diff Mana supports a full world data automatic update system. This makes it easy to update a game world without players having to manually download the updates. Updates to World data are checked for after login/account registration. The update system can be blocked on the command-line with -u/--skip-update. text/html 2012-02-26T12:04:29+02:00 http://doc.manasource.org/upgrade_database?rev=1330254269&do=diff When necessary, the database model used by ManaServ will be extended or modified. To prevent inconsistencies between the database model and the account server, the database model has its own version number which has to match the known version of the account server. text/html 2010-03-18T13:24:33+02:00 http://doc.manasource.org/use_cases?rev=1268915073&do=diff In the Quality Insurance term of a project, use cases are simple tests to be made on a software to ensure that a random functionality is working as expected. To help people doing so, the use cases listed below are grouped into aspects and follow the given scheme: text/html 2011-02-03T14:00:58+02:00 http://doc.manasource.org/visual_manaserv_configuration_interface?rev=1296738058&do=diff Current Situation Setting up and administrating a Manaserv server is currently a task which requires to learn a lot of knowledge. To create a server with really basic gameplay, a server administrator has to know how to edit various XML files, learn the LUA scripting language and some basic SQL. To make the learning curve mre newbie-friendly and also allow seasoned system administrators to perform simple changes more quickly, we should start a new project to create a configuration tool for Manas… text/html 2010-09-24T11:55:00+02:00 http://doc.manasource.org/wallpaper?rev=1285322100&do=diff Wallpapers handling The background wallpapers are shown at client startup and are handled by the client in a specific way. Default Paths and files The different usable wallpaper paths will be searched in that order: * From the wallpapersPath in the branding.xml file if there is one and if some fitting files are found there, * From the wallpapers options isn't set in the paths.xml file if there is one and if some fitting files are found there, * In the graphics/images/ otherwise. text/html 2011-03-14T15:53:34+02:00 http://doc.manasource.org/warp?rev=1300114414&do=diff Synopsis @warp [map] [x] [y] Warps your character to a different location in the game world. The command doesn't check if the target location is actually walkable. When it isn't, your character won't be able to move. You should be able to fix this by using the command again with different target coordinates. text/html 2011-03-14T14:09:09+02:00 http://doc.manasource.org/where?rev=1300108149&do=diff Synopsis @where Reports the map ID and pixel coordinates of the invoking character. Examples Entering @where might return something like Your current location is map 12 [1056:2845] This means that the current character is on map 12, 1056 pixels away from the left map border and 2845 pixels away from the upper border. To find out which map ID corresponds to which TMX file, you need to take a look at the maps.xml of the server. text/html 2010-10-07T16:13:08+02:00 http://doc.manasource.org/window.xml?rev=1286460788&do=diff The window.xml file located per default in the graphics/gui folder, or in a custom theme folder (See GUI configuration), is used to specify how to display every GUI window of the Mana client. Here is an example of a usable window.xml file: <skinset name="Default" image="window.png"> <widget type="Window"> <!-- Top Row --> <part type="top-left-corner" xpos="0" ypos="0" width="4" height="4" /> <part type="top-edge" xpos="4" ypos="0" width="32" height="4" /> <part type="top-right-corner…