Difference between revisions of "How you can contribute"
(API has moved to new url) |
Zonkmachine (talk | contribs) (→Help gather information: fix links) |
||
(6 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
− | == 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 [ | + | == 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 [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) | ||
== Art Creation == | == Art Creation == | ||
− | If you think you can improve or contribute with something to the game then please feel free post on the [ | + | |
+ | 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 [ | + | |
− | 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 | + | |
− | * Landing pads / ground station | + | *City buildings/domes for worlds without atmosphere |
− | * Orbital space stations | + | *Landing pads / ground station |
− | * Ships | + | *Orbital space stations |
+ | *Ships | ||
=== 2D Graphics === | === 2D Graphics === | ||
− | * Face generation (currently (2015-06) [ | + | |
− | * Ship textures and patterns | + | *Face generation (currently (2015-06) [https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=218 being undertaken] by Evarchart) |
− | * Medals / ribbons for future military missions for 3-4 different factions | + | *Ship textures and patterns |
− | * Various icons and logos | + | *Medals / ribbons for future military missions for 3-4 different factions |
− | * Ship Equipment icons (similar to commodity market icons) | + | *Various icons and logos |
+ | *Ship Equipment icons (similar to commodity market icons) | ||
=== 3D Modelling === | === 3D Modelling === | ||
+ | |||
If you know how to create 3D models (or are willing to learn), then we always need more of the following. | 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 | + | *City buildings/domes for worlds without atmosphere |
− | * Orbital space stations | + | *Landing pads / ground station |
− | * Ships | + | *Orbital space stations |
− | * Cockpits (WIP feature) | + | *Ships |
+ | *Cockpits (WIP feature) | ||
See the tutorials and documentation of Content Creation on the main page of [[Pioneer_Wiki|Pioneer Wiki]] for further details. | See the tutorials and documentation of Content Creation on the main page of [[Pioneer_Wiki|Pioneer Wiki]] for further details. | ||
== Code == | == 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 [http://pioneerwiki.com/wiki/Category:Ideas Category:Ideas], as well as a [[Roadmap|Roadmap]], both brainstorming where we want to go, although these two pages can be slightly stale. |
− | 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 | + | |
+ | === C++ === | ||
+ | |||
+ | See [[Getting_Started_with_Development|Getting Started with Development]], and have a look at the [https://github.com/pioneerspacesim/pioneer/issues issue tracker] for feature requests and [[Roadmap|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 === | ||
Line 44: | 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. | ||
− | + | 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: | ||
− | *EASY: Extend Taxi missions to systems so far away they require miltiple jumps. | + | *EASY: Extend Taxi missions to systems so far away they require miltiple jumps. |
− | *EASY: Reverse delivery mission: go to X and pick up | + | *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: 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. | + | *EASY/MEDIUM: Spy/tail/track mission: follow a ship and report to which station it lands. |
− | *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 === | ||
+ | |||
If you know perl (or want to learn it), you can help improve, and extend the IRC-bot [https://github.com/robn/jameson/issues jameson] used in the pioneer IRC channel. | If you know perl (or want to learn it), you can help improve, and extend the IRC-bot [https://github.com/robn/jameson/issues jameson] used in the pioneer IRC channel. | ||
=== html/web === | === html/web === | ||
− | |||
− | == Help gather information == | + | If you feel like improving our homepage, then feel free to dig in. [https://github.com/pioneerspacesim/pioneer-hugo 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: | 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 [ | + | |
− | * Edit the wiki page detailing how [[Commodity Prices]] should be goverened by planet environments, etc. See various posts on dev forum, like [ | + | *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 [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 == | ||
+ | |||
Anyone proficient in English may help out with writing, either for the in game content, or for the wiki. | 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 | + | *One sentence description of each piece of ship equipment (to be shown in the game when selecting the item to buy). |
− | * Background (short and long) of star systems, like the ones seen when clicking on Epsilon Eridani in game. | + | *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 == | == 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. | + | 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 / fix currently (2014-06) broken links to images of ships | + | |
− | See [[Getting started]] for wiki howto. | + | *Update outdated images showing the old user interfaces. |
+ | *Update / fix currently (2014-06) broken links to images of ships | ||
+ | |||
+ | See [[Getting_started|Getting started]] for wiki howto. | ||
== Translate == | == Translate == | ||
− | If you know a language other than English you can help out with [[Translations]] of the game. Even the ones that are [https://www.transifex.com/projects/p/pioneer/ translated] could need improvements. | + | |
+ | If you know a language other than English you can help out with [[Translations|Translations]] of the game. Even the ones that are [https://www.transifex.com/projects/p/pioneer/ translated] could need improvements. |
Latest revision as of 04:23, 1 January 2023
Contents
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:
- 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 dev forum post for more info.
- Edit the wiki page detailing how Commodity Prices should be goverened by planet environments, etc. See various posts on dev forum, like Rethinking the planets and Life in Pioneer, Unorthodox orbital configurations (about Lagrange points), and this post.
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.