Difference between revisions of "How you can contribute"

From PioneerWiki
Jump to: navigation, search
(C++)
(Help gather information: fix links)
 
(4 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
== Report bugs ==
 
== 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 [https://github.com/pioneerspacesim/pioneer/issues?direction=desc&sort=created&state=open issue tracker], but you can also stop by the [http://webchat.freenode.net/?channels=#pioneer IRC channel] or the [http://pioneerspacesim.net/forum dev forum], although devforum isn't quite the place for bug reports.
+
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 [https://github.com/pioneerspacesim/pioneer/issues?direction=desc&sort=created&state=open issue tracker], but you can also stop by the [http://webchat.freenode.net/?channels=#pioneer IRC channel] or the [https://forum.pioneerspacesim.net/ dev forum], although devforum isn't quite the place for bug reports.
  
 
(Our issue tracker on github uses [https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet markdown] for typesetting text)
 
(Our issue tracker on github uses [https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet markdown] for typesetting text)
Line 8: Line 8:
 
== Art Creation ==
 
== Art Creation ==
  
If you think you can improve or contribute with something to the game then please feel free post on the [http://pioneerspacesim.net/forum dev forum], or pay a visit to the IRC channel. All contributions that improve the game are most welcome.
+
If you think you can improve or contribute with something to the game then please feel free post on the [https://forum.pioneerspacesim.net/ dev forum], or pay a visit to the IRC channel. All contributions that improve the game are most welcome.
  
 
=== Concept Art ===
 
=== Concept Art ===
  
There are some [[Visual_Style_guide|articles in the works]] about the intended style of Pioneer. And a [http://pioneerspacesim.net/forum/viewtopic.php?f=3&t=31 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.
+
There are some [[Visual_Style_guide|articles in the works]] about the intended style of Pioneer. And a [https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=31 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  
 
*City buildings/domes for worlds without atmosphere  
Line 21: Line 21:
 
=== 2D Graphics ===
 
=== 2D Graphics ===
  
*Face generation (currently (2015-06) [http://pioneerspacesim.net/forum/viewtopic.php?f=3&t=218 being undertaken] by Evarchart)  
+
*Face generation (currently (2015-06) [https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=218 being undertaken] by Evarchart)  
 
*Ship textures and patterns  
 
*Ship textures and patterns  
 
*Medals / ribbons for future military missions for 3-4 different factions  
 
*Medals / ribbons for future military missions for 3-4 different factions  
Line 53: Line 53:
 
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.
 
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|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.
+
To get started, see [[Scripting_and_Mission_Creation|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 [http://pioneerspacesim.net/codedoc/ Lua API] we have today:
 
Here are some ideas for missions that can be implemented with the [http://pioneerspacesim.net/codedoc/ Lua API] we have today:
Line 63: Line 63:
 
*Some kind of distress signal / rescue pilot?  
 
*Some kind of distress signal / rescue pilot?  
 
*Towing service?  
 
*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?  
+
*Something that makes use of persistant characters. Maybe find a missing person, or someone on crew contracts is lost by someone somewhere else?
  
 
=== Perl ===
 
=== Perl ===
Line 71: Line 71:
 
=== html/web ===
 
=== html/web ===
  
If you feel like improving our homepage, then feel free to dig in. [https://github.com/pioneerspacesim/pioneer-web/ web-source]
+
If you feel like improving our homepage, then feel free to dig in. [https://github.com/pioneerspacesim/pioneer-hugo web-source]
  
 
== Help gather information ==
 
== Help gather information ==
Line 77: Line 77:
 
It helps the developers greatly to know the goal they're working towards. You can help with brainstorming on various topics, and 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:
  
*Hipparcos and Tycho-2 catalogue data of star position in some, easy to parse, raw text format. We/FluffyFreak need this to make the stars (on the skybox/backdrop) seen when flying to reflect their actual positions. See [http://pioneerspacesim.net/forum/viewtopic.php?f=3&t=302 dev forum post] for more info.  
+
*Hipparcos and Tycho-2 catalogue data of star position in some, easy to parse, raw text format. We/FluffyFreak need this to make the stars (on the skybox/backdrop) seen when flying to reflect their actual positions. See [https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=302 dev forum post] for more info.  
*Edit the wiki page detailing how [[Commodity_Prices|Commodity Prices]] should be goverened by planet environments, etc. See various posts on dev forum, like [http://pioneerspacesim.net/forum/viewtopic.php?f=3&t=201 Rethinking the planets] and [http://pioneerspacesim.net/forum/viewtopic.php?f=3&t=145&start=20 Life in Pioneer], [http://pioneerspacesim.net/forum/viewtopic.php?f=3&t=204 Unorthodox orbital configurations] (about Lagrange points), and [http://pioneerspacesim.net/forum/viewtopic.php?p=2275#p2275 this] post.  
+
*Edit the wiki page detailing how [[Commodity_Prices|Commodity Prices]] should be goverened by planet environments, etc. See various posts on dev forum, like [https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=201 Rethinking the planets] and [https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=145&start=20 Life in Pioneer], [https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=204 Unorthodox orbital configurations] (about Lagrange points), and [https://forum.pioneerspacesim.net/viewtopic.php?p=2275#p2275 this] post.
  
 
== Writing ==
 
== Writing ==

Latest revision as of 04:23, 1 January 2023

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 VS2019 is the most popular IDE and is maintained. 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.

To get 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.