Difference between revisions of "How you can contribute"

From PioneerWiki
Jump to: navigation, search
(2D Graphics)
m (c++: link to code::blocks article)
Line 36: Line 36:
  
 
=== c++ ===
 
=== c++ ===
See [[Getting Started with Development]], and have a look at the [https://github.com/pioneerspacesim/pioneer/issues issue tracker] for feature requests and [[Roadmap]] for further details, or if you think there's a bug you can track down.
+
See [[Getting Started with Development]], and have a look at the [https://github.com/pioneerspacesim/pioneer/issues issue tracker] for feature requests and [[Roadmap]] for further details, or if you think there's a bug you can track down. On MS Windows VS2015 is the most popular IDE and is maintained, but there is also an (old) guide on setting up pioneer with [http://pioneerwiki.com/wiki/Building_with_Code::Blocks Code::Blocks]. For GNU/Linux most developers use Vim or GNU/Emacs.
  
 
=== Lua ===
 
=== Lua ===

Revision as of 12:05, 5 November 2015

Report bugs

Believe it or not, but most developers don't have time to actually play the game. Thus, bug reporting is the most important part where you as a player can help the community. When you encounter something that seems strange or odd in the game, please report it, preferably to our issue tracker, but you can also stop by the IRC channel or the dev forum, although devforum isn't quite the place for bug reports.

(Our issue tracker on github uses markdown for typesetting text)

Art Creation

If you think you can improve or contribute with something to the game then please feel free post on the dev forum, or pay a visit to the IRC channel. All contributions that improve the game are most welcome.

Concept Art

There are some articles in the works about the intended style of Pioneer. And a sketch topic on the dev forums. Basically every model in the game could (should) start it's life as concept sketch, especially if it's properly iterated.

  • City buildings/domes for worlds without atmosphere
  • Landing pads / ground station
  • Orbital space stations
  • Ships

2D Graphics

  • Face generation (currently (2015-06) being undertaken by Evarchart)
  • Ship textures and patterns
  • Medals / ribbons for future military missions for 3-4 different factions
  • Various icons and logos
  • Ship Equipment icons (similar to commodity market icons)

3D Modelling

If you know how to create 3D models (or are willing to learn), then we always need more of the following.

  • City buildings/domes for worlds without atmosphere
  • Landing pads / ground station
  • Orbital space stations
  • Ships
  • Cockpits (WIP feature)

See the tutorials and documentation of Content Creation on the main page of Pioneer Wiki for further details.

Code

Pioneer uses two different programming languages (not counting various configuration files). The main/core part is written in c++, which requires knowledge in this area to contribute. However, the functionality of the core is exported into the scripting language Lua, used by pioneer. Lua is easy to learn, once one has grasped the basic programming concept of if-statements and for-loops, making it perfect for the novice willing to learn basic programming. We have a category for Category:Ideas, as well as a Roadmap, both brainstorming where we want to go, although these two pages can be slightly stale.

c++

See Getting Started with Development, and have a look at the issue tracker for feature requests and Roadmap for further details, or if you think there's a bug you can track down. On MS Windows VS2015 is the most popular IDE and is maintained, but there is also an (old) guide on setting up pioneer with Code::Blocks. For GNU/Linux most developers use Vim or GNU/Emacs.

Lua

Lua is easy to learn even for inexperienced programmers, and it will let you easily add new content to the game, such as missions, ads on the BBS, or events that are triggered by various actions from the player.

If you don't know how to use github (used for submitting and reviewing code contributions), someone on IRC or the dev forum can create a pull/merge request for you, since learning github can be a daunting task for a beginner.

Toget started, see Scripting and Mission Creation, or just digg into the code we have. data/modules/DonateToCranks is a simple easy to read lua script that implements the donation charity on the BBS. For a full mission data/modules/DeliverPackage.lua is recommended.

Here are some ideas for missions that can be implemented with the Lua API we have today:

  • EASY: Extend Taxi missions to systems so far away they require miltiple jumps.
  • EASY: Reverse delivery mission: go to X and pick up <something> bring back here.
  • EASY: Science mission: Scoop x tonnes of Hydrogen samples from a star atmosphere, or mininglaser for rocky planet.
  • EASY/MEDIUM: Spy/tail/track mission: follow a ship and report to which station it lands.
  • Some kind of distress signal / rescue pilot?
  • Towing service?
  • Something that makes use of persistant characters. Maybe find a missing person, or someone on crew contracts is lost by someone somewhere else?

Perl

If you know perl (or want to learn it), you can help improve, and extend the IRC-bot jameson used in the pioneer IRC channel.

html/web

If you feel like improving our homepage, then feel free to dig in. web-source

Help gather information

It helps the developers greatly to know the goal they're working towards. You can help with brainstorming on various topics, and gather information:

Writing

Anyone proficient in English may help out with writing, either for the in game content, or for the wiki.

  • One sentence description of each piece of ship equipment (to be shown in the game when selecting the item to buy).
  • Description of each ship equipment here on the wiki
  • Background (short and long) of star systems, like the ones seen when clicking on Epsilon Eridani in game.

Wiki maintenance

If you know English you can help write tutorials, manuals, info on systems, locations, equipment, ships, and proofreading for this wiki. You can also help

  • Update outdated images showing the old user interfaces.
  • Update / fix currently (2014-06) broken links to images of ships

See Getting started for wiki howto.

Translate

If you know a language other than English you can help out with Translations of the game. Even the ones that are translated could need improvements.