From The Mana World
m (Only one such section →‎Some organisation)
m (Move page script moved page Dev:Joining the project to Development:Joining the project: Rename Dev: to Development: so the miraheze import works)
 
(62 intermediate revisions by 31 users not shown)
Line 1: Line 1:
''(this is mainly written to address programmers)''
{{Meta}}
{{I18n}}


So you want to join this project, but you have little or no idea where to start? This page should provide you with the necessary starting points. It can always be rather difficult to know what to start with, especially when you're just jumping in. However, any help is most welcome and with some time you should be able to decide what you want to work on yourself.


=== Current projects ===
So you want to help this project, but you have little or no idea how to get into it? '''The Mana World development team is ''not'' a closed circle''' like many other projects. You don't need to 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 anyone who volunteers to do something for the game.


Our current projects include the existing client which is used with eAthena (a Ragnarok Online server emulator), and a new client/server combination which isn't used yet but is being worked on. Hence, check out both the CVS module <code>tmw</code> as the module <code>tmwserv</code>. Try to browse the source to see if you can get a bit familiar with them.
==How-to Contribute==


=== Some organisation ===


To know what is currently happening or what could be worked on, we have a few important pages on the wiki. The [[roadmap]] provides a planning for upcoming releases, where sometimes tasks are assigned or listed to be picked up by somebody. There is a [[bugs|bugs page]] holding a list of known problems which are generally free for anybody to look into. Finally there is the [[suggestions|suggestions page]] where anybody can put his wishlist for the game, and where anybody can look for inspiration when looking for something to do.
The Mana World uses Git. A list of tasks that need to be completed is available at [https://gitlab.com/evol/evol-all/milestones GitLab]. In order to contribute please see these tasks and coordinate with the team either on the forums or IRC. We will be happy to assist you.


These pages and others are linked from the organisation section on the [[Main Page|main page]].
If you need to practice more before contributing directly, feel free to create anything you wish and submit it to the appropriate [https://forums.themanaworld.org/viewforum.php?f=27 development forums], there you will receive feedback and ideas for improvement.


=== Discussion with the team ===


It is very important for you to be available for discussion with other developers on IRC from time to time, as we do most of our discussions there. We also have two important mailing lists, one for development discussion and one that shows all changes made to the source code, that you should subscribe to:
==How-to Develop==


* http://lists.sourceforge.net/lists/listinfo/themanaworld-devel<br>The developers mailing list where discussion about the project happens.
* http://lists.sourceforge.net/lists/listinfo/themanaworld-commit<br>The commit mailing list, so that you can easily stay up to date about the latest change to the source code.


Finally, although not required, you are invited to visit our forums:
* Instructions to set-up a TMW server are at [[How to Develop]].
* [[Dev:Main| Development Documentation]] contains more detailed information than the short summaries below.
* TMW uses git. [[Dev:Working With Git|how to use Git]]
* TMW staff is available for further information, assistance or help in our [https://web.libera.chat/?channels=#evol-dev IRC development channel] or on the [https://forums.themanaworld.org/ forums].


* http://forums.themanaworld.org/
==How-to Help==


=== Finally, how to start ===
Any player can at any time help us in various ways other than development. The most important things that are always useful are:


After you've read the above, you should be ready to start contributing. Your first contributions could be in the form of patches submitted to the SourceForge patches tracker. If it turns out you like the project and you want to keep contributing for a long period, we'll consider adding you to the official team and from then on you can commit your changes to the source yourself.
* [[Dev:Game Wiki Work|Helping to edit this wiki]]
* [[Translators|Translating]]
* [[Testing Server|Testing updates on the test server]]
* [[Reporting Bugs]]
 
==Parts of TMW==
 
 
===Evol-Hercules Server===
 
 
Until recently TMW used TMWA an MMORPG server that forked from eAthena, a Ragnarok Online clone, in early 2004.
The Mana World (Athena) server originated as a snapshot of [http://eathena.ws eAthena]. It has since been extensively kludged, purged, optimized, and strictened, to the point that it will usually bitch at you if your scripts or config are wrong instead of silently doing the wrong thing.
During the summer of 2016 the devs decided to move on to the  [http://herc.ws/board/ hercules] server, an active developed fork of the original eathena. They wrote plugins to support the TMW specific bits.
 
===Content===
 
 
Content means: new monsters, new equipment, new maps, new NPCs, new quests, new anything into the game.
Content does not mean: GFX, SFX.
 
Before anything can get into the game, it should be designed. After that it should be implemented server-sided. Then GFX and potentially also SFX can be requested for it and it can go into the game once they're done. Currently visioning ideas is a collective process anyone can take part in and the people doing scripting are cherry-picking whatever ideas they want to get into the game. Scripting stuff is also a free for all process. Once there is a good idea to expand the world, in general new maps can be requested. Reading the forums thoroughly and asking publicly usually gets you answers rather well.
 
===Graphics===
 
 
Graphics development could currently use a few pixel artists going about and retouching old mistakes in tilesets and sprite sets. Also if the content development crowd picks up and starts to provide concepts which would require new GFX work to be done, then there is going to be a demand for new equipment work, tilesets and sprite sets. Please remember to pay attention to our [[guidelines]].
 
Also do hunt for unfulfilled REQ topics on the forums if you're looking for something to do. Newbie pixel artists or people doing their first pixel art piece ever are also very welcome. The community can be pretty harsh at times, but there are also people around who actually do know what they're talking about. It is up to you to distinguish between these two.
 
===SFX / Music===
 
 
[https://gitlab.com/evol/evol-all/issues/77 gitlab link]
 
See also: [[Dev:SFX]]
 
===Game Client===
 
 
Originally just a fork of the official Mana client, ManaPlus is currently the most popular game client for The Mana World, it is actively developed and supports various operating systems.
 
* [https://manaplus.org/ Site and downloads]
* [https://gitlab.com/manaplus git repository]
* [https://manaplus.germantmw.de/ Steam version]
 
=See Also=
* [[Dev:Main| Development Documentation]]
* [[Testing Server]]
* [[Reporting Bugs]]
* [[How to Develop]]
* [[Game Wiki Work]]
* [[Projects and Teams]]
 
[[Category:Development]]

Latest revision as of 03:56, 27 March 2024


So you want to help this project, but you have little or no idea how to get into it? The Mana World development team is not a closed circle like many other projects. You don't need to 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 anyone who volunteers to do something for the game.

How-to Contribute

The Mana World uses Git. A list of tasks that need to be completed is available at GitLab. In order to contribute please see these tasks and coordinate with the team either on the forums or IRC. We will be happy to assist you.

If you need to practice more before contributing directly, feel free to create anything you wish and submit it to the appropriate development forums, there you will receive feedback and ideas for improvement.


How-to Develop

How-to Help

Any player can at any time help us in various ways other than development. The most important things that are always useful are:

Parts of TMW

Evol-Hercules Server

Until recently TMW used TMWA an MMORPG server that forked from eAthena, a Ragnarok Online clone, in early 2004. The Mana World (Athena) server originated as a snapshot of eAthena. It has since been extensively kludged, purged, optimized, and strictened, to the point that it will usually bitch at you if your scripts or config are wrong instead of silently doing the wrong thing.

During the summer of 2016 the devs decided to move on to the hercules server, an active developed fork of the original eathena. They wrote plugins to support the TMW specific bits.

Content

Content means: new monsters, new equipment, new maps, new NPCs, new quests, new anything into the game. Content does not mean: GFX, SFX.

Before anything can get into the game, it should be designed. After that it should be implemented server-sided. Then GFX and potentially also SFX can be requested for it and it can go into the game once they're done. Currently visioning ideas is a collective process anyone can take part in and the people doing scripting are cherry-picking whatever ideas they want to get into the game. Scripting stuff is also a free for all process. Once there is a good idea to expand the world, in general new maps can be requested. Reading the forums thoroughly and asking publicly usually gets you answers rather well.

Graphics

Graphics development could currently use a few pixel artists going about and retouching old mistakes in tilesets and sprite sets. Also if the content development crowd picks up and starts to provide concepts which would require new GFX work to be done, then there is going to be a demand for new equipment work, tilesets and sprite sets. Please remember to pay attention to our guidelines.

Also do hunt for unfulfilled REQ topics on the forums if you're looking for something to do. Newbie pixel artists or people doing their first pixel art piece ever are also very welcome. The community can be pretty harsh at times, but there are also people around who actually do know what they're talking about. It is up to you to distinguish between these two.

SFX / Music

gitlab link

See also: Dev:SFX

Game Client

Originally just a fork of the official Mana client, ManaPlus is currently the most popular game client for The Mana World, it is actively developed and supports various operating systems.

See Also