PioneerWiki - User contributions [en]

User:Joonicks

2026-02-08T16:08:36Z

Nozmajner: Created page with "How about now?"

How about now?

Timeline of the Pioneer universe

2026-02-08T16:08:03Z

Nozmajner: Test edit

* '''2200 - 2300 Humanity expands into the solar system.'''
** Third World War erupts against the two main governing bodies of Earth, United Countries of the West (UCW) and Asia Revolutionist Party (ARP).
** WW3 ends on Earth, but space is another matter. Moon is UCW territory, and it reaches to Mars. ARP aims for Io and Titan.
* '''2259 - first colony ship launched.'''
** Earth's Pride headed to Epsilon Eridani.
** No other colony ship is launched for decades, due to cost and policy restrictions.
** ARP also tries to launch its colonization effort, but hit several roadblocks. The only finished ship is allegedly destroyed during departure from Jupiter's vicinity by a reactor failure. Rumors still circulate about it surviving the explosion and still wandering in interstellar space.
* '''2279 - Earth's Pride makes landfall''', establishing New Hope, mankind's first extra-solar colony.
* '''2281 ARP concentrates on Io''', but a catastrophe in 2281 leaves it crippled.
** Haber reacts quickly and a coup later it assumes control over its territory, converting it a corporate state.
** With this move Haber gained enough power, to initiate a covert coup in UCW leadership too within years. With this move Earth and the solar system are united under one rule for the first time.

* '''2285-2325 - [[Diaspora]]''' to the surrounding star systems on relativistic colony ships.
** 25 registered colony ship leaves Earth.
*** 17 reported landfall in 12 systems.
*** The rest were never heard from again. Presumed lost.
** Haber aims for the stars.
* '''2328 - 2350 Earth is ravaged''', its environment is in ruins. No intention from the leadership to renovate it. Extrasolar colonies start to make a foothold.
** Haber loses rooting on Earth and in the solar system. Stretched thin by trying to manage 17 colonies without any means of superluminal travel or communications makes it weak and disorganized.
** Civil war erupts, and eventually Haber is removed. It's CEO board members either got killed or flee.
** The surviving Haber personnel and mercenary body along with as much civilians they could kidnap flee the solar system with the last commissioned colony ship to a then unknown system.
** Earth fell into a dark and chaotic and stagnant period.
** Epsilon Eridani, Arcturus, Tau Ceti, Sirius colonies are starting to thrive.
* '''2350 - Solar Federation emerges''' from the chaos as the new government of Sol.
** After almost 25 years of chaos a new governmental body finally emerges from the anarchy and slowly assumes control of Mars, and then the inner Sol system.
** Communication is restored with the now independent and growing Epsilon Eridani colony New Hope, and indirectly with other colonies. Mars welcomes New Hope to the Federation, only to receive no word back.
** After a period of rebuilding and fighting, SolFed brings the whole balkanized outer solar system under its control.
** Now SolFed is able to slowly concentrate on proper expansion and exploration.
* '''2337 - Tolan Oberon''' - leader of one presumed lost colony ship makes landfall in the far out system which later become the Tolan Kingdom.
* '''2452 - The fleeing Haber''' generation ship makes landfall in Ioqufa, and slowly start to rebuild its corporate state far from the eyes of humanity.
* '''2595 - Hyperdrive''' is serendipitously invented by the team of Henry Winkler experimenting with space-time manipulation.
** Fifty years of directed research and development on space-time manipulation lead to discoveries which then manifested in the birth of the first hyperdrive.
** The first examples were rudimentary, and limited to short ranges and long travel times compared to later models, but a 5 year torchship trip to Alpha Centauri reduced into several months.
** This gave the means of massive expansion into the hands of the SolFed.
* '''2600 - 2700 - Re-establishing contact''' with the colonies. Founding of new colonies.
** SolFed is the largest military power, which came from the need to take control of the chaos in Sol.
** The colonies were eventually swept under indirect SolFed control, turned into tributaries.
** With the new way of travel among the stars, large scale exploration started, which then led to the constant founding of new colonies.
** SolFed exerts tight control over hyperdrive manufacturing, trade and research, since it is one of the edge they have over the colonies. It can't uphold this monopoly too long though, thanks to industrial espionage and reverse-engineering.
** Sol's focused government means tight and controlled life, which gave a strong appeal to these emerging and less controlled colonies. This led to a massive diaspora not only from SolFed, but the old worlds too. Secessionist mood gets stronger around the colonies, which slowly shifts to radical proportions.
** 2612 - Explorers make contact with the Tolan kingdom. A seemingly simple isolationist feudal society largely uninterested in the rest of the galaxy.
** Around 2650 the first explorers reach Haber's small sphere of influence to quickly disappear and get their hyperdrives poorly reverse engineered.
** 2698 - Haber tries to occupy and integrate the resource-rich Tolan kingdom, but finds itself easily repelled by the surprisingly strong and disciplined Tolan forces.
** By the turn of the century, hyperdrive became widespread technology and SolFed's monopoly on it dwindles.
* '''2714 - 2725 Crushing the uprising.'''The SolFed friendly government of New Hope was overthrown after riots gaining strength planet-wide.
** The secessionist mood erupted into riots and a coup on New Hope, leading to the announcement of the Free Republic. Reinforcements weeks away, the Navy outposts and ships were seized.
** After months of failed negotiations, SolFed sent in its third fleet.
** 2715 - The SolFed navy bombards New Hope from orbit to crush the rebellion, and installs a puppet government.
** SolFed rules the inner parts of Epsilon Eridani, but peripheral bases were able to grow secretly under the oppression to the point where they can oppose the SolFed fleet.
** Haber explorer crafts cautiously start to gather intelligence on the state of affairs around Sol right around the start of the war. While a good opportunity, the Haber CEO board opts to wait until the dust is settled, because they aren't powerful enough yet.
* '''2723 -2725 The War of Hope''' soon reached an impasse, and fell into stagnation.
** 2723 - The first battle signifies the announcement of Commonwealth of Independent Worlds (CIW)
** The newly formed CIW forces fought out of desperation to protect their homeland, and fight off the SolFed fleet three times.
** SolFed has the numbers on its side, with the 4th fleet on its way. The fierce battle after its arrival seemed to bleed out the remaining CIW forces.
** Virtually at the last moment, combined reinforcements arrived from the other colonies fed up with the SolFed oppression, and the situation turns into an impasse.
** The population of SolFed shifted toward anti-war mood by this time, and the government gave up on further attempts on attack and slowly withdrew.
* '''2725 - SolFed abandoned the war''' and the crippled in victory CIW has its much sought after freedom. Peace never formally announced.
** CIW starts to rebuild and expand aggressively, concentrating on habitable worlds. Their main aim is to build a strong military force and stable faction which is able to oppose any SolFed attack in the future.
** Expansion and rebuild alone wouldn't cut it in the beginning, so CIW diplomats start to persuade old worlds and new colonies alike to join their ranks against the oppressive SolFed.
** SolFed also rebuilds and expands extensively, and try to maintain an image of peace, prosperity and freedom among its citizens and outwards. At high levels it still seeks to bring back all of humanity under its wings.
* '''2729 - Haber makes its presence known''' by establishing formal contact in outter SolFed systems on the SolFed-CIW border. Allegedly with peaceful and friendly manner.
** SolFed reacts with a cringe, which robs enough concentration from the cold war with CIW to make it solidified.
** The CIW government reacts in a cold and distant manner, knowing Haber's past all too well.
* '''2780 - Stagnant cold war''' period between CIW and SolFed. Borders and trade are tightly controlled, and official communication is minimal. Intelligence operations are everyday business.
** Small scale proxy wars are common, mostly along the SolFed-CIW border, but both parties are actively avoiding open conflict.
** Haber covertly involves itself in some of these proxy wars, aiming to destabilize and to measure up the forces of the opponents.
* '''3012 - Ambassador Meredith Pells''' diplomatic visit for trade talks and her alleged spying attempt erupts into the largest military mobilization in almost 200 years, around New Hope. It turns into a stalemate. which is later broken, nobody knows by whom, and the SolFed fleet withdraws. Ambassador Pell, or her body is unaccounted for, and both parties prohibit media speculation on the matter.
* '''3012-3098 - After the Pell incident''', the relationship between the two factions became tight and cold for a long time.
* '''3098 - present''' - Negotiations slowly start again on trade and travel, which again loosens the tight mood after the Pell incident. Both parties actively avoid mentioning anything related to it, or the never announced peace, and the talks became very formal in the end.
** Borders are formally opened up in a limited and controlled manner, and trade slowly starts to gain traction.
** The parties agree on a border plane perpendicular to the line between Epsilon Eridani and Sol, and that their expansion is limited to their side of the border.
** Isolation of the two superpower loosens, but their relationship is still distant and cold.

-

FAQ

2025-06-04T16:27:15Z

Nozmajner: /* My OpenGL Version is below 3.2, "Pioneer cannot run on your graphics card" */

= Frequently Asked Questions =

== About the Game ==

=== What is Pioneer? ===

Pioneer is a freeform single player space adventure in the spirit of [https://en.wikipedia.org/wiki/Frontier:_Elite_II Frontier: Elite II].

=== Is this a game or a simulation? ===

Frontier was a game, but with a newtonian flight model and a slightly more scientific flavour to the universe than usually in space games. Pioneer follows this same path.

=== Can I play multiplayer online? ===

There will be no multiplayer. This does not rule out the possibility of minor network features, but multiplayer as it is commonly known is not compatible with the core mechanics of Pioneer. See for instance [[Network_features|Network features]], and [[ServerAgent|ServerAgent]] for more, or our dev forum [https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=216 here]. Pioneer will never have multiple players in different ships, as this is incompatible with time acceleration feature. For comparison: the Elite Dangerous dev-team chose to prioritize multiplayer over Newtonian mechanics, and make it more like the original Elite, we choose to stay true to the core concepts of Frontier Elite II, which is Newtonian mechanics, with time acceleration.

=== Can I colonize planets, build space stations or conquer the universe? ===

No, these are out of the game scope. While the game universe might not stay static for the duration of a game, the player can not generally influence major events.

=== Can I walk around space stations and planets? ===

No, you cannot exit your ship. The ship is always your avatar. The development team does have [https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=454 aspirations] to push in this direction, for future versions.

=== Is the universe pre-defined or randomly generated? ===

There are millions of stars in the galaxy. A few hundred on them are based on real-world astronomic catalogues. some of the planets (obvious ones being in the Sol system) are pre-defined, but most things are procedurally generated. This means that a planet does not exist until you actually visit it, but it will be generated the same way for every player.

=== Can I hire crew for my ship? ===

Yes. You can hire crew. But they don't do very much at the moment.

=== Are savegames compatible between releases? ===

The development of the game can happen in sudden bursts, some of which change the game universe, or save/load routine, such that old saves are blocked from loading, lest the game might crash. The player can start a new game, and "give" themselves back money, kills, reputation, ship, as it was in the old save, by using the [[Lua_Console|lua console]]. You probably want to keep a copy of your old Pioneer, to read off your player statistics, write them down, then download and open the latest Pioneer version, and give yourself those stats. Note: it's only cheating if you give yourself back more than you had, remember: God is watching over your shoulder!

=== Are savegames compatible between Mods? ===

Again as with savegames between different versions of pioneer, compatibility between mods can not be guaranteed. It all depends on what mods you have installed.

=== Where is star system X from Frontier? Can I buy ship Y? ===

Although Pioneer started out as a clone of Frontier, it no longer is, thus references to the Frontier universe have been removed, and we aim at making Pioneer far better than Frontier. Thus, you will have to figure out new trade routes! But don't worry, Newtonian physics will remain, as well as single player.

=== Can I build and control a fleet, or a factory, or run/own a station? ===

No, this is not on the agenda, and none of the developers are motivated to push for this, but who knows, perhaps in the future, some skilled developer, who knows how to implement this in a way that makes game play interesting, joins the dev-team. However, we are currently planning to have mining machines (like in Frontier Elite II), and ship system management (heat, energy, repair components, etc.) on the agenda.

== Gameplay ==

=== How do I take screenshots? ===

Ctrl+Printscreen saves .png files in the same directory where the game .ini and savegames are. You can cycle through full HUD/HUD without labels and cursor/No HUD and cockpit using TAB as described in [http://pioneerwiki.com/wiki/Keyboard_and_mouse_controls#In_flight [1]].

=== How do I record a video? ===
To record video directly from Pioneer you will need to add the line RecordVideo=1 somewhere within your config.ini file. Then once ingame you can press Ctrl+ScrLk to start or stop recording.

=== How do I find star X in the star map ===

First it is important to note that just like in real life, names are not unique. The star map allows the player to search for either name or coordinates of a system. The search is done in the local region of the currently selected system.

Thus a standard way of finding a system is to type in the name in the search field in the star map (generally refereed to as "sector view"). If you know the system is within a few ly from your position, then have your current location selected when you do the search, since it only does a "local" search in space. If the search fails, go to the sector where the star is supposed to be, either by typing the coordinates into the search field, or by using arrows, mark a nearby star in that system, and do another search. You can scroll the star map super fast by holding in the Shift key.

=== I have a Taxi mission to system X, but which starport? ===

For Taxi missions any starport will do, as long as you dock before the deadline.

=== Starsystem names are not unique ===

This is not a bug, space is big, and just here on Earth it is quite common with cities and villages sharing the same name, sometimes quite close.

=== I picked up a mission to a starport in a system, but when I search for the system, it seems that it doesn't have the destination starport, or even uninhabited. ===

As mentioned above, there could be multiple systems with the same name. Each mission states the coordinates (Sirius (1,0,-1) for example) of the destination system, and you can enter them into the search field on the sector map, to find the correct system.

=== I end up "a big number" AU away from the star when I hyper jump to a system ===

This happens in binary star systems. You can select the star you want to jump to from the [[Manual#System_info|System View]].

=== Map survey / scan mission does not progress ===
Make sure:
* if you have an orbit scan mission, you need an orbit scanner, and if you have a surface scan mission you need a surface scanner.
* Also make sure you're flying above the minimum altitude, and below the max.
* Also make sure you're in the right system (both coordinates and name must match), and at the right body.

=== Major/Minor Import/Export is wrong ===
There are two levels: system and station. A system can be an importer of X, but a station in that system can be an exporter of X relative the system as a whole, meaning the import/export of a specific station is relative to the import/export price of the system as a whole.

== Technical FAQ ==

=== What is the system requirement for runing the game? ===

Current "stable" (if indeed we have one) [https://pioneerspacesim.net/page/download/ release] is 2021-02-03, and is built on Ubuntu 20.04 Linux machine and a Windows machine, and requires OpenGL 3.2 compatible hardware.
We also offer a [https://flathub.org/apps/details/net.pioneerspacesim.Pioneer flatpak] script. If you want to compile the game, then please install requirements listed in [https://github.com/pioneerspacesim/pioneer/blob/master/COMPILING.txt COMPILING.txt]

=== Installing the game ===

The releases are made when developers feel it's been "a while", relative to the number of new additions that have been added that they want players to enjoy / playtest. Releases for Windows and GNU/Linux are now (2021) found on the [https://github.com/pioneerspacesim/pioneer/releases github releases page], and Linux versions are currently built on a [https://github.com/pioneerspacesim/pioneer/blob/master/.github/workflows/build-ci.yml Ubuntu 20.04] (virtual) machine, thus that system should not have any compatibility issues.

==== Build from source ====

The best way to ensure your pioneer is compatible with you Linux system, and of latest, "bleeding edge", version is to install from source. This is described in [https://github.com/pioneerspacesim/pioneer/blob/master/COMPILING.txt COMPILING.txt]. Playing this way is also the best way you can help the developers, i.e. find and report the latest bugs you encounter.

==== Installing using flatpak ====
If you're having trouble getting pioneer to run on your Linux distribution, and you do not want to build from source, then we recommend [https://flathub.org/apps/details/net.pioneerspacesim.Pioneer flatpak] that resolves dependencies for you. Follow [https://flatpak.org/setup/ this] on how to use it, if need be. E.g. on Linux Mint these images are already [https://flatpak.org/setup/Linux%20Mint included] by default in their app store. On other distributions it is at most needed to install flatpak and then issue, from a terminal:

flatpak install net.pioneerspacesim.Pioneer

==== Error loading shared libraries (e.g.libassimp.so.<x>) ====

The linux version of Pioneer is build on a Ubuntu 20 machine. Currenlty (2021-05), this can cause some debian machines, that have an older verison of libassimp, to throw an error, e.g.:

error while loading shared libraries: libassimp.so.5:
cannot open shared object file: No such file or directory

This is fixed either by building pioneer from source, against the shared libraries that are on your particular machine (then you get an even more updated "bleeding edge" build of pioneer!), or install the correct version of the package that is missing: https://packages.debian.org/unstable/libassimp5 (or try to find an older release)

==== Where is the Mac version? ====

Pioneer's development team is mainly on Linux and Windows, and does currently not have the ability to build and maintain a Mac version. To build a Mac release we actually need access to a Mac machine, which, unfortunately, none of the developers currently have. If you have a Mac which can compile and upload pioneer for us on a regular basis, then please contact us (IRC).

Update: OSX builds have been discontinued due to lack of maintainer and Apple's deprecation of OpenGL. We do not intend to offer them in the near future - we will need to migrate the rendering path to Vulkan and have enough of a user base to warrant spending time on OSX compatibility.

==== Where do I find nightly builds of Pioneer ====

They're available on github [https://github.com/pioneerspacesim/pioneer/actions?query=workflow%3A%22Build+Pioneer%22+branch%3Amaster actions page]. Note: thuis currently requires [https://github.com/actions/upload-artifact/issues/51 login to github] to download. A new build is made each time a pull request is merged with new code, and also each proposed pull request is built, which is a great way to test features prior to them being merged into the master branch.

==== Where do I find older versions of Pioneer ====

You can find older versions starting from December 2014 (2014-12-05) on our [http://sourceforge.net/projects/pioneerspacesim/files sourceforge] page. 2014-11-18 was the last version supporting OpenGL 2, between 2014-11-19 to 2014-12-07 Pioneer required OpenGL 3.2. From 2014-12-08 only OpenGL 3.1 is required. Over at [http://www.moddb.com/games/pioneer/downloads moddb] they have windows version going further back in time.

==== How do I play on old computer ====

Your best bet is to use an older version, or if you have another computer you can use virtualGL to let pioneer run on a remote (modern) machine and forward it to an older machine, as described on the [https://spacesimcentral.com/community/pioneer/a-request-for-instrumental-pioneer/ forum], this command works best (but combat/action is too laggy, so it is only a viable solution for playing peaceful missions):

vglconnect user@server_executing_pioneer_ip -CY -p SSH_port 'cd /path_of_pioneer_compilation_folderme/ && ./pioneer'

=== How/where do I report my bug/crash ===

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 issue tracker], but you can also stop by the [[IRC|IRC channel]]. When you report it, always mention pioneer verision (shown in lower right hand corner in the starting screen [https://user-images.githubusercontent.com/18342621/118388006-6ee03080-b62a-11eb-8d48-bf66f0820d5f.png png])

When having problems with graphics, or pioneer not starting/crashing, please attach the files '''output.txt''' and '''opengl.txt''' from the pioneer [http://pioneerwiki.com/wiki/FAQ#Where_is_the_configuration_file.2C_saved_games.2C_screenshots.3F config folder] in your home folder / My Documents folder. If you didn't get the '''output.txt''' file, then make sure '''RedirectStdio=1''' in '''config.ini'''.

It is important to include as much of the following information as possible in each issue report, much of this is available to use from the '''output.txt''' and '''opengl.txt''' but if you cannot attach them then please tell us:

*The version of pioneer you are trying to run (''build date or ingame version number'')
*What operating system you are running, Windows XP/Vista/7/8/10, Linux (''what distribution''), OSX.
*Your computers system specifications - CPU / RAM / Graphics card.
*Whether you have downloaded it from our site, or if you are building it from the source code.

=== Debug backtrace ===
When the game crashes, one of most valuable pieces of information you can provide the development team, is a backtrace. To get a backtrace, the game must have been compiled in debug mode, and then started through a debugger. If you compile the game yourself, from source, it will by default build a debug mode.

==== Windows Visual Studio ====

* Compile the game in debug mode (should be the default setting).
* After building it, press F5 or go to Debug->Start Debugging. Note: it will run slowly, starting a new game or loading a new one in particular. That's normal.
* Instead of a full out crash, you'll get a freeze and it should automatically switch back to Visual Studio. If it freezes and doesn't switch back, do that manually.
* At that point, Visual Studio should have opened a couple new panes/sub windows at the bottom. One of these is 'Call Stack.' Right click in it, select 'Select All.' Then right click in there again and select 'Copy with source paths.'
* Then paste that information into the bug-report (preferably as a [https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet code formatted block])
* After that you can Debug->Stop to shut down Pioneer again.

==== Linux gdb ====
* Make sure gdb (The GNU Debugger) is installed on you system (available in package managers of all Linux distributions).
* Then start pioneer by prefixing the command with gdb followed by the normal command to start pioneer. Eg. if you normally do:

cd pioneer/
./build/pioneer

then to run in debug mode, you need to run it through gdb:

cd pioneer/
gdb ./build/pioneer

then from inside gdb, type "run", which starts pioneer. Play until you get the crash, which drops you out to gdb again. Type 'bt' or 'backtrace' in the gdb command line, and save the output to you bug-report.

=== Where is the configuration file, saved games, screenshots? ===

*Windows: My Documents\Pioneer
*OS X: /Users/your_username/Library/Application Support/Pioneer
*Linux: /home/your_username/.pioneer
Update 2024-10: Pioneer now prefers storing its user data in $XDG_DATA_HOME/pioneer, falling back to ~/.local/share/pioneer if that variable is not set. ~/.pioneer is used only for backwards-compatibility reasons.

=== New pioneer version doesn't start ===
This could be because new configuration is incompatible with the local, try removing your pioneer configuration folder, such that the game will auto-generate new configuration file anew.

=== I'm getting blank black screen on start ===
This is usually an antialiasing issue. Change "AntiAliasingMode" to 0 in config.ini.

=== I'm getting graphical issues ===

Such as wrong textures, ships missing from the view, text display glitches. '''Updating the display drivers usually solve these problems.'''

These usually occur on older graphics adapters, or because of outdated GPU drivers. Not too old NVidia and ATI cards are usually enough to play the game, but integrated GPUs are usually not enough.

=== I'm getting graphical issues, such as snow-like sky and transparent terrain ===

This is probably caused by the eclipse shader which isn't supported by some open source graphic drivers. You could install the proprietary drivers, if available, or disable the eclipse effect by adding DisableEclipse=1 to your pioneer configuration file (config.ini).

=== My OpenGL Version is below 4.2, "Pioneer cannot run on your graphics card" ===

UPDATE: Pioneer dropped 2.1 support in September, 2018. You need to checkout and compile a version prior to this, and do:

If your hardware isn't extraordinarily old, OpenGL 4.3 should be supported if you update your drivers.

You can also find older versions (pre 20141119) on [http://www.moddb.com/games/pioneer/downloads moddb].

=== I see blank untextured Gas Giants and I'm using an ATI graphic card under GNU/Linux with open source drivers (Mesa R600) ===

With chipsets using the R600 gallium drivers the shader fails to compile. There is a workaround that uses less noise octaves. This produces less detailed texture maps for the gas/ice giants but they still look good and at least the program runs.

Try setting <code>AMD_MESA_HACKS=1</code> in ~/.pioneer/config.ini or disable GPU jobs entirely by setting <code>EnableGpujobs=0</code>

=== I'm getting text rendering artefacts ===

Some system monitoring HUD utilities, like MSI Afterburner, and Steam overlay can cause distorted text rendering. Try switching them off. 

=== The game freezes at the intro screen ===

If you cannot start the game at all, edit the configuration file and change value DisableShaders to 1.

=== The game crashes on start with an error message about imgui_draw.cpp ===

Check if any parent folder of Pioneer has any accented letters (e.g éáűúóü etc.). If so, copy the game to somewhere, where there's none of these in the folder tree.

=== The game crashes after the loading screen. I'm using ATI free drivers on GNU/Linux. ===

If you are getting a GL_INVALID_ENUM in console, could be because some ships uses textures in a format that, because of patents, is not included in the main mesa package. Search for libtxc-dxtn or libtxc_dxtn in your distribution and install it.

=== The game hangs when I turn on the ''Enable Cockpit (EXPERIMENTAL)'' option ===

It's because it's an experimental feature right now, infrastructure mostly. You need a cockpit model for to be able to use it.

You can find one heavily WIP one posted on the Community Forums. Note that it's a highly experimental feature right no, so please treat it accordingly.

=== My joystick is "drifting" ===

It's recommended that you calibrate your joystick using the OS facilities (Joystick Settings on Windows, jstest-gtk on linux) as this fixes 99% of all issues with incorrectly configured joysticks. However, if you want to adjust specific parameters for each joystick axis, support for customizable deadzone and sensitivity is available through the configuration file. Open config.ini and adjust the deadzone (DZ) and sensitivity exponent curve (CV) values of the corresponding axis to your liking.

; example joystick configuration
[Joystick.03000000a30600006404000000010000]
Axis0=DZ0.0 CV1.0
Axis1=DZ0.0 CV1.0
Axis2=DZ0.0 CV1.0
Axis3=DZ0.0 CV1.0
Name=Saitek Cyborg USB Stick

=== I'm getting poor performance ===

The heaviest part of the game is planetary terrain generation. Turn down the "Detail distance" and "Fractal detail" settings, they have the most impact for performance. Reducing screen resolution is also recommended, this can be done in the [[Settings_Menu|Settings Menu]], or manually to a custom values by editing your personal configuration file, on Linux: <code>~/.pioneer/config.ini</code>. On Windows: <code>Documents/pioneer/config.ini</code> Look for <code>ScrHeight</code> and <code>ScrWidth</code> entries. Also consider reducing number of buildings in cities.

=== I've enabled anti-aliasing in the config file, but it does not work ===

Make sure the AA settings are not overridden by your graphics card settings, on NVidia AA should be set to "application controlled" mode.

=== Full screen mode is incorrectly scaled ===

If you are on Windows, try:
<pre>Sounds like windows 7 desktop-scaling issues.
Try adding some compatability modes to the Pioneer.exe.
Right click it and Choose properties -> Compatability -> Tick
Disable desktop scaling, and Disable desktop composition.
</pre>

== Development ==

=== What's the history of Pioneer ===

The project started in 2008 by Tom Morton, and was [https://web.archive.org/web/20150326115725/http://spacesimcentral.com/ssc/topic/742-pioneer-new-gpl-frontier-elite-2-style-game/ announced in 2010] on the Space Sim Central forum (for space games), and on [https://forums.frontier.co.uk/threads/the-pioneer-thread.1596/ frontier forum]. For more history, see [http://www.rockpapershotgun.com/2011/12/06/back-to-frontier-pioneer/ Rock Paper Shotgun article], and [[Media_Coverage]]

=== How much development is being made? ===

Development is sporadic, but no month goes by without some change to the source, fixing bugs, cleaning up code, introducing new content and/or features; see [https://github.com/pioneerspacesim/pioneer/blob/master/Changelog.txt Changelog.txt]. All contributors work on pioneer for free when they have time and motivation.

=== What's the deal with the inconsistent UI interface? ===
Basically, Pioneer has during the 2013-2020s had up to three different, simulteneous, UI systems, for a background and screen shots, please refer to:
[[GUI_introduction#Background_history]]

=== Do you accept contributions? ===

Hell yes! Pioneer is not any one persons personal project. It is the sum of the contributions made by the people who play and care about the continued development of the game. See: [[How_you_can_contribute|How to contribute]].

Mods

2025-04-09T15:00:53Z

Nozmajner: /* List of known Mods */ Adding pebblegarden's skyboxes

== Available Mods ==

=== How to install Mods ===

Since Alpha 22, Pioneer has had support for modding. This is done by allowing core game data to be added to or given preference by data in your userdir (that is, <code>'My Docs/Pioneer/mods'</code> for Windows, <code>'~/.pioneer/mods'</code> for Linux, and <code>'~/Library/Application Support/Pioneer/mods'</code> for OSX).

Once you have downloaded a mod, you simply place the .zip file in the /mods folder described above. There is no need to extract the files.

If a file in a .zip is identically named with one found in the Main pioneer/data directory, the version in the .zip will be used. You can use this fact to easily modify the core game files of Pioneer

This method can be used for any file under the main Pioneer/data directory and applies to ships, buildings and stations, systems, music, fonts, textures, whatever.

However, there are still some mods not packaged in the mod format (.zip). Overtime these are being repackaged by members of the Pioneer community, but in case you have a mod that is not in the correct format then the data in these style of mods must be placed in the correct folder within your main Pioneer/data directory and not in the mods directory described above. But be warned, make a back up of the files you are about to overwrite as this can not be undone and if you do want to return to a 'vanilla' Pioneer, you will have to re-install Pioneer.

== List of known Mods ==

Overtime all the mods here can also be found on the Pioneer Mods page at sourceforge https://sourceforge.net/projects/modsforpioneer/files/Alpha%2030%20mods/

{| class="wikitable"
|+Current known Mod Packages
|-
!Mod Name
!Mod Description
!Author(s)
!Version
!Tested with Pioneer*
!Size
!Download link
|-
|Skyboxes
|Seven new skyboxes, ranging from slight variations on the Milky Way backdrop to spectacular nebulae.
|[https://github.com/pebblegarden pebblegarden]
|0.1
|20250203
|12 mb
|[https://www.dropbox.com/scl/fi/cbzretcjuvgg2sxjivjcq/pebblegarden-skyboxes-v0.1.zip?rlkey=74byb7c1phsgqhx4jpvi6vet5&st=jk13ntui&dl=0 skyboxes]
|-
|Retro ships
|A mod containing the original versions of four reworked OPLI ships: Amphiesma, Xylophis Sinonatrix and Natrix.
|[https://github.com/Maks2103 Maks2103]
|0.7
|20250203
|2.19 mb
|[https://www.dropbox.com/scl/fi/fx4w9j1nvo7ydevgb33rh/retro-0.7.zip?rlkey=0wu609kk5isv4r7v1p1u9wcgo&st=bsbf0epi&dl=0 retro ships]
|-
|Retro ships
|A mod containing the original versions of three reworked OPLI ships: Amphiesma, Xylophis and Sinonatrix.
|[https://github.com/Maks2103 Maks2103]
|0.6
|20240710
|2.19 mb
|[https://www.dropbox.com/scl/fi/wf2r59dzr2sfvfwto812x/retro-0.6.zip?rlkey=cqlbhf4ctkm5cztzedt65sgvy&e=1&st=phbzmg0k&dl=0 retro ships]
|-
|ARGH's original unabridged Extend Sol
|The original unabridged version of extended Sol, with additional dwarfs, many more major asteroids and a high populated system
|ARGHouse
|1.3.1
|20210818
|65.7 kb
|[https://drive.google.com/file/d/1NGTbK1xLdjY4NkN92FtvZc5L6seXlgvW/view?usp=sharing]
|-
|Sol Extended
|Extends the Sol system with additional dwarf planets and spaceports.
|EpsilonEridani
|Work-In-Progress
|20210818
|25.5 kb
|[https://libera.ems.host/_matrix/media/r0/download/matrix.org/BJozxFpJFXnoHiRMQNqpVPiG/00_sol_extended.lua 00_sol_extended.lua]
|-
|Honk
|A simple mod which gives the player the ability to sound various car or ship horns.
|[[User:WKFO|WKFO]]
|1.0
|2021-02-03
|~60 kb
|[https://www.dropbox.com/s/nq0rh3dexibi0pe/honk.zip?dl=0]
|-
|Monolithic Carrier
|A not-that-big bulk cargo ship by Haber Corporation.
|[[User:WKFO|WKFO]]
|0.9
|2022-02-03
|3.3 MB
|[https://www.dropbox.com/s/n2gyaqbt9e5xe79/monocarrier.zip?dl=0]
|-
|Graveyard
|Example of bundling multiple files in a mod. Adds a custom system "Graveyard" (up and to the right of Sol) and a script that does something when you jump there.
|[[User:RobN|RobN]]
|1.0
|20131229
|1kb
|[http://eatenbyagrue.org/f/pioneer/graveyard.zip graveyard.zip]
|-
|RedSol
|Example of replacing a core file. Replaces the system def for Sol with one that has a red star.
|[[User:RobN|RobN]]
|1.0
|Alpha22
|1kb
|[http://eatenbyagrue.org/f/pioneer/redsol.zip redsol.zip]
|-
|Skyboxes
|Nebula backgrounds when in space
|[https://spacesimcentral.com/community/pioneer/i-dont-like-the-skybox/#post-46527 pebblegarden]
|1.0
|2015
|8Mb
|[http://spacesimcentral.com/ssc/index.php?app=core&module=attach&section=attach&attach_id=2563]
|-
|Lanner ship
|The Lanner ship
|unclear
|1.0
|2015
|1.58 Mb
|[https://spacesimcentral.com/community/pioneer-mods/lanner-for-current-pioneer-build/#post-4439]
|-
|-
|Vuzz's Milkyway skybox
|Vuzz's skybox is the most realistic version of the Milky Way for Pioneer.
|[[User:impaktor|impaktor]]
|
|20150912
|1.34MB
|[https://spacesimcentral.com/community/pioneer-mods/vuzzs-milky-way-skybox-mod/#post-4460]
|-
|Moon Heightmap
|Higher res heightmap which replaces the 2mb default heightmap.
|Ae-2222
|1.0
|Alpha26 - - (all current versions)
|33Mb
|[http://wikisend.com/download/359748/moon-hi-res-heightmap.zip moon-hi-res-heightmap.zip]
|-
|Character Generator Upgrade (facegen mod)
|A small upgrade that adds some new hair, eyes, clothing, uniforms, additional accessories and other improvements to the existing character
generator.
|[[User:baobobafet|baobobafet]]
|1.1
|Compatible with most as well as current v20140217
|8Mb
|[http://www.mediafire.com/download/pr55p4r7g87s9uf/facegen_mod_bao_pioneer20140205_bao_V1.1.zip]
|-
|Wave Explorer (ship mod) includes 2 custom pilots
|HiRes2048x2048_Wave-e -see info below or visit https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=89
|[[User:baobobafet|baobobafet]]
|3.5
|v20140217 - (all current versions)
|18Mb
|[http://www.mediafire.com/download/s7d4rqk2fio9gwu/Ship2048x2048_wave-e-w-pilots_bao_pioneer20140217_bao_V3.5.zip]
|-
|-
|Wave Explorer (ship mod) includes 2 custom pilots
|LoRes1024x1024 version of the Wave-e (for increased graphics performance on lower end systems) see info below or visit: https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=89
|[[User:baobobafet|baobobafet]]
|3.5
|v20140217 - (all current versions)
|8Mb
|[http://www.mediafire.com/download/dgxjgo2tf7dgob3/Ship1024x1024_wave-e-w-pilots_bao_pioneer20140217_bao_V3.5.zip]
|-
|-
|Apollo LEM Lunar orbit save file for Alpha26
|Low fuel LEM landing challenge (-w- cargo to jettison) 3 saves with Lunar lander in unpowered orbit over moon with low fuel(requires HighRes.Moon_Apollo.LEM.a26Mod)
|[[User:baobobafet|baobobafet]]
|1.0
|Alpha26
|520kb
|[http://www.mediafire.com/?sy5d6i4n8vz10c4]
|-
|Interstellar Shuttle 1700
|Adds a modified version of the standard shuttle to the ship roster with hyperdrive capability, ecm, missile, cargo/fuel scoop options and more cargo space.(includes a new shuttle skin and solar array for bottom of existing standard shuttle (readme inside zip file)
|[[User:baobobafet|baobobafet]]
|1.3
|Alpha 30
|3560kb
|[http://www.mediafire.com/?46ci6m4677y5wg3]
|-
|Enterprise 1701a (static ship)
|Replaces the Long Range Cruiser (static Ship) with the NCC 1701a "Enterprise" at realistic scale. (readme inside zip file)
|[[User:baobobafet|baobobafet]]
|1.2
|Alpha 30
|1.78mb
|[http://www.mediafire.com/?g4ng4dk46kdns8v]
|-
|-
|Ship Decals Mod 256x256
|This is version 4.0 - includes 8 ship decals. IMAGE here: http://img708.imageshack.us/img708/7146/decalsversion4.png
|[[User:baobobafet|baobobafet]]
|4.0
|Alpha 27-30
|3mb
|[http://www.mediafire.com/?14bchs29dn06nn2]
|-
|-
|-
|Controller Templates
|Not really a Mod - This is for people who have - or are familiar with either Xpadder, 3D Pro Joystick or the G-13 Gameboard. Extreme 3D Pro Joystick Xpadder profile and G-13 gameboard Basic Template - printable key & joystick button reference. Version 3 (More info see above)
|[[User:baobobafet|baobobafet]]
|3.0
|Most Alphas up to 26
|4490kb
|[https://docs.google.com/open?id=0B5dK9aniVGUnM09GRU1qVFJWemM] [http://www.mediafire.com/?ncnh6bpdvna34n2]
|-
|-
|3DPro Joystick Profile
|This is an update supporting the new view keys, for Extreme 3D Pro Joystick Xpadder profile with Template - printable joystick button reference. Version 5 (see pic: http://imageshack.us/a/img822/864/ztf.png )
|[[User:baobobafet|baobobafet]]
|5.0
|Alphas after 28 (all current versions)
|2.31mb
|[http://www.mediafire.com/?btgkn3sjx0ianuu]
|-
|-
|Pioneer default keyboard reference
|In pdf printable format(see PNG pic: http://img203.imageshack.us/img203/2079/5dh.png )
|[[User:baobobafet|baobobafet]]
|v201305.93bao
|Alphas after 28(all current versions)
|7.3mb
|[http://www.mediafire.com/?y5a2sapya7vfhhr]
|-
|-
|Pioneer custom mouse pointers
|Small simple mods containing only custom mouse pointers
|[[User:Joonicks|joonicks]]
|
|20151001
|1-4kb
|[http://joonicks.eu/pioneer_mods]
|}

*'' Version number represents what the module was tested/built against. There is no guarantee that it will work for later versions.''

== List of known Mod Compilations ==

{| class="wikitable"
|+Current known Mod Compilation Packages
|-
!Mod Name
!Mod Description
!Author(s)
!Version
!Tested with Pioneer*
!Size
!Download link
|-
|HiRes Moon & Apollo LEM Mod
|High res Moon heightmap & flyable Apollo Eagle Lander with docs & nav maps.
|contrib by Ae-2222 & [[User:baobobafet|baobobafet]]
|2.0
|Alpha 30
|35.3Mb
|[https://docs.google.com/open?id=0B4TOJEZxkYiVUGZqVklKVEE0WUE]
|}

*'' Version number represents what the module compilation was tested/built against. There is no guarantee that it will work for later versions.''

'''''The who/when/where for mod storage/testing/package compilation is still to be established. As with all things concerning Pioneer it is up to interested parties to resolve this. There is the beginnings of a discussion on the [[Talk:Mods|discussion page]] as not everyone is on the mailing list yet (another could be started on a specific task page if anyone wants to). You need to register to edit pages and contribute.'''''

== Creating A New Ship Mod ==
This is in response to the couple of people who are interested in doing art, perhaps even leading the direction it can go in.

For programmers there's a path which involves creating a GitHub account, forking the Pioneer repository, creating branches, configuring remotes, making commits and submitting Pull Requests.

For Artists and scripters there's another way which is hopefully preferrable for everyone!

To follow this "tutorial" you'll need at least a way of creating ".zip" files, on Windows I use the 7-zip program.

This example is being written for Windows but the ideas are broadly transferrable even if the exact file paths and locations aren't.

=== MyFirstShip mod ===
There's links to a few existing mods above but they're very simple things:
* They're just zip files containing some directories and files,
* Their contents are "Added" to Pioneer unless replace something like a script, ship, texture, etc,
* They use the same directory structure as Pioneer.
The example that most players are enthusiastic about is adding a new ship which is the first step on the long road to a total conversion!

(For additional information see: [https://wiki.pioneerspacesim.net/wiki/Making_your_first_ship Making_your_first_ship] )

To start with we want to make this task easy for ourselves so lets try the following to create a "mod" called "myfirstship":
* Go to wherever you've extracted your Pioneer download to,
* Open the folder "data" and look down the folder names as there's two we're interested in,
** "ships" and "models",
* open the "ships" folder,
** copy and rename the file "wave.lua" to "myfirstship.lua",
** open the file in a text editor and change the following lines like so
*** from: name='Wave Heavy Hypersonic Fighter'
*** from: model='wave',
*** To: name='My First Ship Tutorial'
*** To: model='myfirstship',
*** save your changes to the "myfirstship.lua" file,
*** now go back up to the data folder,
* open the "models" folder, then the "ships" folder,
** copy and rename the folder "wave" to "myfirstship",
** open the "myfirstship" folder,
*** rename the file "wave.model" to "myfirstships.model",
Now run Pioneer with the parameter "-mv myfirstship" so the command line should look like "pioneer.exe -mv myfirstship" this will open it in the modelviewer mode so you can see if everything has worked.

If you run Pioneer as usual then you should be able to go to the ship yard and buy your very own "My First Ship Tutorial" spaceship. Of course it will look like the Wave heavy Hypersonic Fighter, and it will handle like it and be like it in every possible way because it's a perfect copy of it

If you want to make it look different so it's easier to spot then a quick thing you can do is edit the texture "wave.png" in your "/data/models/ships/myfirstship/" folder, perhaps just paint the white a bright red or something which will make it easy to tell that you've changed it.

Obviously we're not done turning all this effort into a mod yet, we've just copied a ship definition ("myfirstship.lua") and the model data for it.

So lets open a new folder window (if on Windows) and:
* Create a new folder somewhere you won't lose it, "My Documents" for windows users or the home folder on Linux etc, call it "tutorial" this time (to avoid confusion),
* In this folder create two more called "ships" and "models",
* With the "models" folder create another folder called "ships",
* by now you should have something that looks like:
** /tutorial/ships/
** /tutorial/models/ships/
* now you're going to _move_ the "myfirstships.lua" file you edited earlier out of the "/pioneer/data/ships/" into the folder "/tutorial/ships/" folder,
* next you must _move_ the folder "myfirstship" from "/pioneer/data/models/ships/" to "/tutorial/models/ships/",
* now create a "readme.txt" file in the "tutorial" folder and add your name to it for now,
* Add everything inside the "tutorial" folder to a zip archive - to do this with 7-zip just selected everything inside the tutorial folder, right-click, open the 7-zip submenu and choose the "Add to archive",
* Make sure that you choose to use "zip" compression and call the archive "myfirstship.zip".
* Finally, put the file "myfirstship.zip" into the "mods" directory - this IS NOT usually where you extracted the Pioneer download.
** On Windows it will be in a folder under your "My Documents"/"Documents" directory for example:
*** "/My Documents/Pioneer/mods/"
* Now double check that you really did MOVE the files and folders, i.e; go back to where you first copied the wave files and folders and make sure that there aren't any "myfirsthip" files or folder there because they should now all be inside the zip file (and safely backed up in the "tutorial" folder).
** The reason this step is important is that you might have made a mistake with the zipping process and the mod is actually now broken, however it will look like it works because the original files are still being found by Pioneer in it's own data directory.
* Finally, the mod should have been packaged up into a zip, it should be in the "mods" directory, and you've made sure the Pioneer data folder is clean.
* Run Pioneer and make sure your mod works.

There are many steps that take just a second or two and lots of bits you can skip once you know what you're doing.

You can have as many ships within a single mod as you like, this technique just gives you a copy of the Wave to edit and play with.

You can, and should, replace it with your own mesh and edit the parameters it uses for thrust and equipment etc.

=== So how does this get my ships into the Pioneer download? ===
Easy, you create your mod, test it, try it out, share it via this forums download area so that others can play it, respond to criticisms to improve it and then ask the Core Team to include it in the main distribution.

This is basically the same process that we go through for programmers submissions but without having to understand Git and GitHub.

It's also more direct to players and fans of the game who often use several mods together to make Pioneer play how they want it too.

How to start

2025-03-15T18:17:51Z

Nozmajner: /* Installing */

== Welcome to Pioneer ==

'''You have found a game called Pioneer? Great!''' Pioneer is a space adventure game, and the best is: it is completely free! Windows, Linux builds are made regularly so you can also have the newest updates if you can't compile the game. Of course you can also pull the latest source from Git and compile it yourself. We'd love for you to take Pioneer for a spin, but you should be aware that this game is not finished, thus may crash and exhibit other weirdness occasionally.

==Installing==
If you want to play the game you can download it on the [https://pioneerspacesim.net/page/download/ pioneer download site]. 
'''Microsoft Windows'''
If you use Microsoft Windows, just download the installer file from the "Windows" section.
Then it can be launched to install the game. If you already have it installed, it will update the existing installation.
To play, simply execute "pioneer.exe" to start the game. That's it!
'''Linux'''
If you use Linux and you want to use the binaries, just download them from the "Linux" section.
To find out if you need the linux-32 or the linux-64 version, open your commandline and enter
'''uname -m'''
If the output is "x86_64", take the linux-64 version, else take the linux-32 version.
If you are not sure what to take, take the linux-32 version.
'''Source'''
You can also compile the game from source code.
The code can be downloaded from here:
https://github.com/pioneerspacesim/pioneer/archive/master.zip
----
For a guide how to compile the source code on Linux, take a look here:
http://pioneerwiki.com/wiki/Compiling

== Playing Pioneer ==

After successfully installing Pioneer and starting it you should see the start screen. On the left hand side of the screen you can see a spinning ship model, and on the right hand side there are a few buttons:

----

*'''Continue Game'''
**Load and continue from your latest saved game if you have one.
*'''Start at Mars'''
**Take off from Cydonia on the planet Mars.
*'''Start at New Hope'''
**Take off from New Hope, an ice planet in the system Epsilon Erdiani.
*'''Start at Barnard's Star'''
**Undock from an orbital platform in Barnard's Star System.
*'''Load Game'''
**If you have saved a game you can load your game here.
*'''Options'''
**Configure Pioneer to best suit your hardware and wishes.
*'''Quit'''
**Exit Pioneer.

----

==Tutorials==
There is a series of tutorials that is work in progress at the moment.
We are sorry for the inconvenience and try to update all tutorials as soon as possible. 
Click here to read the ''' [[Basic_flying_tutorial | Basic Flying tutorials]]. '''

How to start

2025-03-15T18:16:37Z

Nozmajner: /* Welcome to Pioneer */ removing mac

== Welcome to Pioneer ==

'''You have found a game called Pioneer? Great!''' Pioneer is a space adventure game, and the best is: it is completely free! Windows, Linux builds are made regularly so you can also have the newest updates if you can't compile the game. Of course you can also pull the latest source from Git and compile it yourself. We'd love for you to take Pioneer for a spin, but you should be aware that this game is not finished, thus may crash and exhibit other weirdness occasionally.

==Installing==
If you want to play the game you can download it on the [https://pioneerspacesim.net/page/download/ pioneer download site]. 
'''Microsoft Windows'''
If you use Microsoft Windows, just download the file from the "Windows" section.
Then the file can be unzipped with the free archiver [http://www.7-zip.org/ 7zip].
Simply execute "pioneer.exe" to start the game. That's it!
'''Linux'''
If you use Linux and you want to use the binaries, just download them from the "Linux" section.
To find out if you need the linux-32 or the linux-64 version, open your commandline and enter
'''uname -m'''
If the output is "x86_64", take the linux-64 version, else take the linux-32 version.
If you are not sure what to take, take the linux-32 version.
'''Source'''
You can also compile the game from source code.
The code can be downloaded from here:
https://github.com/pioneerspacesim/pioneer/archive/master.zip
----
For a guide how to compile the source code on Linux, take a look here:
http://pioneerwiki.com/wiki/Compiling

== Playing Pioneer ==

After successfully installing Pioneer and starting it you should see the start screen. On the left hand side of the screen you can see a spinning ship model, and on the right hand side there are a few buttons:

----

*'''Continue Game'''
**Load and continue from your latest saved game if you have one.
*'''Start at Mars'''
**Take off from Cydonia on the planet Mars.
*'''Start at New Hope'''
**Take off from New Hope, an ice planet in the system Epsilon Erdiani.
*'''Start at Barnard's Star'''
**Undock from an orbital platform in Barnard's Star System.
*'''Load Game'''
**If you have saved a game you can load your game here.
*'''Options'''
**Configure Pioneer to best suit your hardware and wishes.
*'''Quit'''
**Exit Pioneer.

----

==Tutorials==
There is a series of tutorials that is work in progress at the moment.
We are sorry for the inconvenience and try to update all tutorials as soon as possible. 
Click here to read the ''' [[Basic_flying_tutorial | Basic Flying tutorials]]. '''

How to start

2025-03-15T18:16:04Z

Nozmajner: Removing mac download section

== Welcome to Pioneer ==

'''You have found a game called Pioneer? Great!''' Pioneer is a space adventure game, and the best is: it is completely free! Windows, Linux and Mac OS X builds are made regularly so you can also have the newest updates if you can't compile the game. Of course you can also pull the latest source from Git and compile it yourself. We'd love for you to take Pioneer for a spin, but you should be aware that this game is not finished, thus may crash and exhibit other weirdness occasionally.

==Installing==
If you want to play the game you can download it on the [https://pioneerspacesim.net/page/download/ pioneer download site]. 
'''Microsoft Windows'''
If you use Microsoft Windows, just download the file from the "Windows" section.
Then the file can be unzipped with the free archiver [http://www.7-zip.org/ 7zip].
Simply execute "pioneer.exe" to start the game. That's it!
'''Linux'''
If you use Linux and you want to use the binaries, just download them from the "Linux" section.
To find out if you need the linux-32 or the linux-64 version, open your commandline and enter
'''uname -m'''
If the output is "x86_64", take the linux-64 version, else take the linux-32 version.
If you are not sure what to take, take the linux-32 version.
'''Source'''
You can also compile the game from source code.
The code can be downloaded from here:
https://github.com/pioneerspacesim/pioneer/archive/master.zip
----
For a guide how to compile the source code on Linux, take a look here:
http://pioneerwiki.com/wiki/Compiling

== Playing Pioneer ==

After successfully installing Pioneer and starting it you should see the start screen. On the left hand side of the screen you can see a spinning ship model, and on the right hand side there are a few buttons:

----

*'''Continue Game'''
**Load and continue from your latest saved game if you have one.
*'''Start at Mars'''
**Take off from Cydonia on the planet Mars.
*'''Start at New Hope'''
**Take off from New Hope, an ice planet in the system Epsilon Erdiani.
*'''Start at Barnard's Star'''
**Undock from an orbital platform in Barnard's Star System.
*'''Load Game'''
**If you have saved a game you can load your game here.
*'''Options'''
**Configure Pioneer to best suit your hardware and wishes.
*'''Quit'''
**Exit Pioneer.

----

==Tutorials==
There is a series of tutorials that is work in progress at the moment.
We are sorry for the inconvenience and try to update all tutorials as soon as possible. 
Click here to read the ''' [[Basic_flying_tutorial | Basic Flying tutorials]]. '''

User:Nozmajner

2025-03-11T21:50:15Z

Nozmajner:

Working on modeling and all kinds of visual stuff for Pioneer.

[https://imgur.com/a/ulkoa Newer album.]

bszlrd on irc and github

User:Nozmajner

2025-03-11T21:49:58Z

Nozmajner:

Working on modeling and all kinds of visual stuff for Pioneer.

[http://picasaweb.google.com/114396283540873280380/Pioneer?authuser=0&authkey=Gv1sRgCOPo58agr7ujkgE&feat=directlink Pioneer images.]

[https://imgur.com/a/ulkoa Newer album.]

bszlrd on irc and github

Mods

2025-02-12T22:30:01Z

Nozmajner: /* List of known Mods */

== Available Mods ==

=== How to install Mods ===

Since Alpha 22, Pioneer has had support for modding. This is done by allowing core game data to be added to or given preference by data in your userdir (that is, <code>'My Docs/Pioneer/mods'</code> for Windows, <code>'~/.pioneer/mods'</code> for Linux, and <code>'~/Library/Application Support/Pioneer/mods'</code> for OSX).

Once you have downloaded a mod, you simply place the .zip file in the /mods folder described above. There is no need to extract the files.

If a file in a .zip is identically named with one found in the Main pioneer/data directory, the version in the .zip will be used. You can use this fact to easily modify the core game files of Pioneer

This method can be used for any file under the main Pioneer/data directory and applies to ships, buildings and stations, systems, music, fonts, textures, whatever.

However, there are still some mods not packaged in the mod format (.zip). Overtime these are being repackaged by members of the Pioneer community, but in case you have a mod that is not in the correct format then the data in these style of mods must be placed in the correct folder within your main Pioneer/data directory and not in the mods directory described above. But be warned, make a back up of the files you are about to overwrite as this can not be undone and if you do want to return to a 'vanilla' Pioneer, you will have to re-install Pioneer.

== List of known Mods ==

Overtime all the mods here can also be found on the Pioneer Mods page at sourceforge https://sourceforge.net/projects/modsforpioneer/files/Alpha%2030%20mods/

{| class="wikitable"
|+Current known Mod Packages
|-
!Mod Name
!Mod Description
!Author(s)
!Version
!Tested with Pioneer*
!Size
!Download link
|-
|Retro ships
|A mod containing the original versions of four reworked OPLI ships: Amphiesma, Xylophis Sinonatrix and Natrix.
|Maks2103
|0.7
|20250203
|2.19 mb
|[https://www.dropbox.com/scl/fi/fx4w9j1nvo7ydevgb33rh/retro-0.7.zip?rlkey=0wu609kk5isv4r7v1p1u9wcgo&st=bsbf0epi&dl=0 retro ships]
|-
|Retro ships
|A mod containing the original versions of three reworked OPLI ships: Amphiesma, Xylophis and Sinonatrix.
|Maks2103
|0.6
|20240710
|2.19 mb
|[https://www.dropbox.com/scl/fi/wf2r59dzr2sfvfwto812x/retro-0.6.zip?rlkey=cqlbhf4ctkm5cztzedt65sgvy&e=1&st=phbzmg0k&dl=0 retro ships]
|-
|ARGH's original unabridged Extend Sol
|The original unabridged version of extended Sol, with additional dwarfs, many more major asteroids and a high populated system
|ARGHouse
|1.3.1
|20210818
|65.7 kb
|[https://drive.google.com/file/d/1NGTbK1xLdjY4NkN92FtvZc5L6seXlgvW/view?usp=sharing]
|-
|Sol Extended
|Extends the Sol system with additional dwarf planets and spaceports.
|EpsilonEridani
|Work-In-Progress
|20210818
|25.5 kb
|[https://libera.ems.host/_matrix/media/r0/download/matrix.org/BJozxFpJFXnoHiRMQNqpVPiG/00_sol_extended.lua 00_sol_extended.lua]
|-
|Honk
|A simple mod which gives the player the ability to sound various car or ship horns.
|[[User:WKFO|WKFO]]
|1.0
|2021-02-03
|~60 kb
|[https://www.dropbox.com/s/nq0rh3dexibi0pe/honk.zip?dl=0]
|-
|Monolithic Carrier
|A not-that-big bulk cargo ship by Haber Corporation.
|[[User:WKFO|WKFO]]
|0.9
|2022-02-03
|3.3 MB
|[https://www.dropbox.com/s/n2gyaqbt9e5xe79/monocarrier.zip?dl=0]
|-
|Graveyard
|Example of bundling multiple files in a mod. Adds a custom system "Graveyard" (up and to the right of Sol) and a script that does something when you jump there.
|[[User:RobN|RobN]]
|1.0
|20131229
|1kb
|[http://eatenbyagrue.org/f/pioneer/graveyard.zip graveyard.zip]
|-
|RedSol
|Example of replacing a core file. Replaces the system def for Sol with one that has a red star.
|[[User:RobN|RobN]]
|1.0
|Alpha22
|1kb
|[http://eatenbyagrue.org/f/pioneer/redsol.zip redsol.zip]
|-
|Skyboxes
|Nebula backgrounds when in space
|[https://spacesimcentral.com/community/pioneer/i-dont-like-the-skybox/#post-46527 pebblegarden]
|1.0
|2015
|8Mb
|[http://spacesimcentral.com/ssc/index.php?app=core&module=attach&section=attach&attach_id=2563]
|-
|Lanner ship
|The Lanner ship
|unclear
|1.0
|2015
|1.58 Mb
|[https://spacesimcentral.com/community/pioneer-mods/lanner-for-current-pioneer-build/#post-4439]
|-
|-
|Vuzz's Milkyway skybox
|Vuzz's skybox is the most realistic version of the Milky Way for Pioneer.
|[[User:impaktor|impaktor]]
|
|20150912
|1.34MB
|[https://spacesimcentral.com/community/pioneer-mods/vuzzs-milky-way-skybox-mod/#post-4460]
|-
|Moon Heightmap
|Higher res heightmap which replaces the 2mb default heightmap.
|Ae-2222
|1.0
|Alpha26 - - (all current versions)
|33Mb
|[http://wikisend.com/download/359748/moon-hi-res-heightmap.zip moon-hi-res-heightmap.zip]
|-
|Character Generator Upgrade (facegen mod)
|A small upgrade that adds some new hair, eyes, clothing, uniforms, additional accessories and other improvements to the existing character
generator.
|[[User:baobobafet|baobobafet]]
|1.1
|Compatible with most as well as current v20140217
|8Mb
|[http://www.mediafire.com/download/pr55p4r7g87s9uf/facegen_mod_bao_pioneer20140205_bao_V1.1.zip]
|-
|Wave Explorer (ship mod) includes 2 custom pilots
|HiRes2048x2048_Wave-e -see info below or visit https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=89
|[[User:baobobafet|baobobafet]]
|3.5
|v20140217 - (all current versions)
|18Mb
|[http://www.mediafire.com/download/s7d4rqk2fio9gwu/Ship2048x2048_wave-e-w-pilots_bao_pioneer20140217_bao_V3.5.zip]
|-
|-
|Wave Explorer (ship mod) includes 2 custom pilots
|LoRes1024x1024 version of the Wave-e (for increased graphics performance on lower end systems) see info below or visit: https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=89
|[[User:baobobafet|baobobafet]]
|3.5
|v20140217 - (all current versions)
|8Mb
|[http://www.mediafire.com/download/dgxjgo2tf7dgob3/Ship1024x1024_wave-e-w-pilots_bao_pioneer20140217_bao_V3.5.zip]
|-
|-
|Apollo LEM Lunar orbit save file for Alpha26
|Low fuel LEM landing challenge (-w- cargo to jettison) 3 saves with Lunar lander in unpowered orbit over moon with low fuel(requires HighRes.Moon_Apollo.LEM.a26Mod)
|[[User:baobobafet|baobobafet]]
|1.0
|Alpha26
|520kb
|[http://www.mediafire.com/?sy5d6i4n8vz10c4]
|-
|Interstellar Shuttle 1700
|Adds a modified version of the standard shuttle to the ship roster with hyperdrive capability, ecm, missile, cargo/fuel scoop options and more cargo space.(includes a new shuttle skin and solar array for bottom of existing standard shuttle (readme inside zip file)
|[[User:baobobafet|baobobafet]]
|1.3
|Alpha 30
|3560kb
|[http://www.mediafire.com/?46ci6m4677y5wg3]
|-
|Enterprise 1701a (static ship)
|Replaces the Long Range Cruiser (static Ship) with the NCC 1701a "Enterprise" at realistic scale. (readme inside zip file)
|[[User:baobobafet|baobobafet]]
|1.2
|Alpha 30
|1.78mb
|[http://www.mediafire.com/?g4ng4dk46kdns8v]
|-
|-
|Ship Decals Mod 256x256
|This is version 4.0 - includes 8 ship decals. IMAGE here: http://img708.imageshack.us/img708/7146/decalsversion4.png
|[[User:baobobafet|baobobafet]]
|4.0
|Alpha 27-30
|3mb
|[http://www.mediafire.com/?14bchs29dn06nn2]
|-
|-
|-
|Controller Templates
|Not really a Mod - This is for people who have - or are familiar with either Xpadder, 3D Pro Joystick or the G-13 Gameboard. Extreme 3D Pro Joystick Xpadder profile and G-13 gameboard Basic Template - printable key & joystick button reference. Version 3 (More info see above)
|[[User:baobobafet|baobobafet]]
|3.0
|Most Alphas up to 26
|4490kb
|[https://docs.google.com/open?id=0B5dK9aniVGUnM09GRU1qVFJWemM] [http://www.mediafire.com/?ncnh6bpdvna34n2]
|-
|-
|3DPro Joystick Profile
|This is an update supporting the new view keys, for Extreme 3D Pro Joystick Xpadder profile with Template - printable joystick button reference. Version 5 (see pic: http://imageshack.us/a/img822/864/ztf.png )
|[[User:baobobafet|baobobafet]]
|5.0
|Alphas after 28 (all current versions)
|2.31mb
|[http://www.mediafire.com/?btgkn3sjx0ianuu]
|-
|-
|Pioneer default keyboard reference
|In pdf printable format(see PNG pic: http://img203.imageshack.us/img203/2079/5dh.png )
|[[User:baobobafet|baobobafet]]
|v201305.93bao
|Alphas after 28(all current versions)
|7.3mb
|[http://www.mediafire.com/?y5a2sapya7vfhhr]
|-
|-
|Pioneer custom mouse pointers
|Small simple mods containing only custom mouse pointers
|[[User:Joonicks|joonicks]]
|
|20151001
|1-4kb
|[http://joonicks.eu/pioneer_mods]
|}

*'' Version number represents what the module was tested/built against. There is no guarantee that it will work for later versions.''

== List of known Mod Compilations ==

{| class="wikitable"
|+Current known Mod Compilation Packages
|-
!Mod Name
!Mod Description
!Author(s)
!Version
!Tested with Pioneer*
!Size
!Download link
|-
|HiRes Moon & Apollo LEM Mod
|High res Moon heightmap & flyable Apollo Eagle Lander with docs & nav maps.
|contrib by Ae-2222 & [[User:baobobafet|baobobafet]]
|2.0
|Alpha 30
|35.3Mb
|[https://docs.google.com/open?id=0B4TOJEZxkYiVUGZqVklKVEE0WUE]
|}

*'' Version number represents what the module compilation was tested/built against. There is no guarantee that it will work for later versions.''

'''''The who/when/where for mod storage/testing/package compilation is still to be established. As with all things concerning Pioneer it is up to interested parties to resolve this. There is the beginnings of a discussion on the [[Talk:Mods|discussion page]] as not everyone is on the mailing list yet (another could be started on a specific task page if anyone wants to). You need to register to edit pages and contribute.'''''

== Creating A New Ship Mod ==
This is in response to the couple of people who are interested in doing art, perhaps even leading the direction it can go in.

For programmers there's a path which involves creating a GitHub account, forking the Pioneer repository, creating branches, configuring remotes, making commits and submitting Pull Requests.

For Artists and scripters there's another way which is hopefully preferrable for everyone!

To follow this "tutorial" you'll need at least a way of creating ".zip" files, on Windows I use the 7-zip program.

This example is being written for Windows but the ideas are broadly transferrable even if the exact file paths and locations aren't.

=== MyFirstShip mod ===
There's links to a few existing mods above but they're very simple things:
* They're just zip files containing some directories and files,
* Their contents are "Added" to Pioneer unless replace something like a script, ship, texture, etc,
* They use the same directory structure as Pioneer.
The example that most players are enthusiastic about is adding a new ship which is the first step on the long road to a total conversion!

(For additional information see: [https://wiki.pioneerspacesim.net/wiki/Making_your_first_ship Making_your_first_ship] )

To start with we want to make this task easy for ourselves so lets try the following to create a "mod" called "myfirstship":
* Go to wherever you've extracted your Pioneer download to,
* Open the folder "data" and look down the folder names as there's two we're interested in,
** "ships" and "models",
* open the "ships" folder,
** copy and rename the file "wave.lua" to "myfirstship.lua",
** open the file in a text editor and change the following lines like so
*** from: name='Wave Heavy Hypersonic Fighter'
*** from: model='wave',
*** To: name='My First Ship Tutorial'
*** To: model='myfirstship',
*** save your changes to the "myfirstship.lua" file,
*** now go back up to the data folder,
* open the "models" folder, then the "ships" folder,
** copy and rename the folder "wave" to "myfirstship",
** open the "myfirstship" folder,
*** rename the file "wave.model" to "myfirstships.model",
Now run Pioneer with the parameter "-mv myfirstship" so the command line should look like "pioneer.exe -mv myfirstship" this will open it in the modelviewer mode so you can see if everything has worked.

If you run Pioneer as usual then you should be able to go to the ship yard and buy your very own "My First Ship Tutorial" spaceship. Of course it will look like the Wave heavy Hypersonic Fighter, and it will handle like it and be like it in every possible way because it's a perfect copy of it

If you want to make it look different so it's easier to spot then a quick thing you can do is edit the texture "wave.png" in your "/data/models/ships/myfirstship/" folder, perhaps just paint the white a bright red or something which will make it easy to tell that you've changed it.

Obviously we're not done turning all this effort into a mod yet, we've just copied a ship definition ("myfirstship.lua") and the model data for it.

So lets open a new folder window (if on Windows) and:
* Create a new folder somewhere you won't lose it, "My Documents" for windows users or the home folder on Linux etc, call it "tutorial" this time (to avoid confusion),
* In this folder create two more called "ships" and "models",
* With the "models" folder create another folder called "ships",
* by now you should have something that looks like:
** /tutorial/ships/
** /tutorial/models/ships/
* now you're going to _move_ the "myfirstships.lua" file you edited earlier out of the "/pioneer/data/ships/" into the folder "/tutorial/ships/" folder,
* next you must _move_ the folder "myfirstship" from "/pioneer/data/models/ships/" to "/tutorial/models/ships/",
* now create a "readme.txt" file in the "tutorial" folder and add your name to it for now,
* Add everything inside the "tutorial" folder to a zip archive - to do this with 7-zip just selected everything inside the tutorial folder, right-click, open the 7-zip submenu and choose the "Add to archive",
* Make sure that you choose to use "zip" compression and call the archive "myfirstship.zip".
* Finally, put the file "myfirstship.zip" into the "mods" directory - this IS NOT usually where you extracted the Pioneer download.
** On Windows it will be in a folder under your "My Documents"/"Documents" directory for example:
*** "/My Documents/Pioneer/mods/"
* Now double check that you really did MOVE the files and folders, i.e; go back to where you first copied the wave files and folders and make sure that there aren't any "myfirsthip" files or folder there because they should now all be inside the zip file (and safely backed up in the "tutorial" folder).
** The reason this step is important is that you might have made a mistake with the zipping process and the mod is actually now broken, however it will look like it works because the original files are still being found by Pioneer in it's own data directory.
* Finally, the mod should have been packaged up into a zip, it should be in the "mods" directory, and you've made sure the Pioneer data folder is clean.
* Run Pioneer and make sure your mod works.

There are many steps that take just a second or two and lots of bits you can skip once you know what you're doing.

You can have as many ships within a single mod as you like, this technique just gives you a copy of the Wave to edit and play with.

You can, and should, replace it with your own mesh and edit the parameters it uses for thrust and equipment etc.

=== So how does this get my ships into the Pioneer download? ===
Easy, you create your mod, test it, try it out, share it via this forums download area so that others can play it, respond to criticisms to improve it and then ask the Core Team to include it in the main distribution.

This is basically the same process that we go through for programmers submissions but without having to understand Git and GitHub.

It's also more direct to players and fans of the game who often use several mods together to make Pioneer play how they want it too.

Mods

2025-02-10T15:45:08Z

Nozmajner: /* List of known Mods */

== Available Mods ==

=== How to install Mods ===

Since Alpha 22, Pioneer has had support for modding. This is done by allowing core game data to be added to or given preference by data in your userdir (that is, <code>'My Docs/Pioneer/mods'</code> for Windows, <code>'~/.pioneer/mods'</code> for Linux, and <code>'~/Library/Application Support/Pioneer/mods'</code> for OSX).

Once you have downloaded a mod, you simply place the .zip file in the /mods folder described above. There is no need to extract the files.

If a file in a .zip is identically named with one found in the Main pioneer/data directory, the version in the .zip will be used. You can use this fact to easily modify the core game files of Pioneer

This method can be used for any file under the main Pioneer/data directory and applies to ships, buildings and stations, systems, music, fonts, textures, whatever.

However, there are still some mods not packaged in the mod format (.zip). Overtime these are being repackaged by members of the Pioneer community, but in case you have a mod that is not in the correct format then the data in these style of mods must be placed in the correct folder within your main Pioneer/data directory and not in the mods directory described above. But be warned, make a back up of the files you are about to overwrite as this can not be undone and if you do want to return to a 'vanilla' Pioneer, you will have to re-install Pioneer.

== List of known Mods ==

Overtime all the mods here can also be found on the Pioneer Mods page at sourceforge https://sourceforge.net/projects/modsforpioneer/files/Alpha%2030%20mods/

{| class="wikitable"
|+Current known Mod Packages
|-
!Mod Name
!Mod Description
!Author(s)
!Version
!Tested with Pioneer*
!Size
!Download link
|-
|Retro ships
|A mod containing the original versions of three reworked OPLI ships: Amphiesma, Xylophis Sinonatrix and Natrix.
|Maks2103
|0.7
|20250203
|2.19 mb
|[https://www.dropbox.com/scl/fi/fx4w9j1nvo7ydevgb33rh/retro-0.7.zip?rlkey=0wu609kk5isv4r7v1p1u9wcgo&st=bsbf0epi&dl=0 retro ships]
|-
|Retro ships
|A mod containing the original versions of three reworked OPLI ships: Amphiesma, Xylophis and Sinonatrix.
|Maks2103
|0.6
|20240710
|2.19 mb
|[https://www.dropbox.com/scl/fi/wf2r59dzr2sfvfwto812x/retro-0.6.zip?rlkey=cqlbhf4ctkm5cztzedt65sgvy&e=1&st=phbzmg0k&dl=0 retro ships]
|-
|ARGH's original unabridged Extend Sol
|The original unabridged version of extended Sol, with additional dwarfs, many more major asteroids and a high populated system
|ARGHouse
|1.3.1
|20210818
|65.7 kb
|[https://drive.google.com/file/d/1NGTbK1xLdjY4NkN92FtvZc5L6seXlgvW/view?usp=sharing]
|-
|Sol Extended
|Extends the Sol system with additional dwarf planets and spaceports.
|EpsilonEridani
|Work-In-Progress
|20210818
|25.5 kb
|[https://libera.ems.host/_matrix/media/r0/download/matrix.org/BJozxFpJFXnoHiRMQNqpVPiG/00_sol_extended.lua 00_sol_extended.lua]
|-
|Honk
|A simple mod which gives the player the ability to sound various car or ship horns.
|[[User:WKFO|WKFO]]
|1.0
|2021-02-03
|~60 kb
|[https://www.dropbox.com/s/nq0rh3dexibi0pe/honk.zip?dl=0]
|-
|Monolithic Carrier
|A not-that-big bulk cargo ship by Haber Corporation.
|[[User:WKFO|WKFO]]
|0.9
|2022-02-03
|3.3 MB
|[https://www.dropbox.com/s/n2gyaqbt9e5xe79/monocarrier.zip?dl=0]
|-
|Graveyard
|Example of bundling multiple files in a mod. Adds a custom system "Graveyard" (up and to the right of Sol) and a script that does something when you jump there.
|[[User:RobN|RobN]]
|1.0
|20131229
|1kb
|[http://eatenbyagrue.org/f/pioneer/graveyard.zip graveyard.zip]
|-
|RedSol
|Example of replacing a core file. Replaces the system def for Sol with one that has a red star.
|[[User:RobN|RobN]]
|1.0
|Alpha22
|1kb
|[http://eatenbyagrue.org/f/pioneer/redsol.zip redsol.zip]
|-
|Skyboxes
|Nebula backgrounds when in space
|[https://spacesimcentral.com/community/pioneer/i-dont-like-the-skybox/#post-46527 pebblegarden]
|1.0
|2015
|8Mb
|[http://spacesimcentral.com/ssc/index.php?app=core&module=attach&section=attach&attach_id=2563]
|-
|Lanner ship
|The Lanner ship
|unclear
|1.0
|2015
|1.58 Mb
|[https://spacesimcentral.com/community/pioneer-mods/lanner-for-current-pioneer-build/#post-4439]
|-
|-
|Vuzz's Milkyway skybox
|Vuzz's skybox is the most realistic version of the Milky Way for Pioneer.
|[[User:impaktor|impaktor]]
|
|20150912
|1.34MB
|[https://spacesimcentral.com/community/pioneer-mods/vuzzs-milky-way-skybox-mod/#post-4460]
|-
|Moon Heightmap
|Higher res heightmap which replaces the 2mb default heightmap.
|Ae-2222
|1.0
|Alpha26 - - (all current versions)
|33Mb
|[http://wikisend.com/download/359748/moon-hi-res-heightmap.zip moon-hi-res-heightmap.zip]
|-
|Character Generator Upgrade (facegen mod)
|A small upgrade that adds some new hair, eyes, clothing, uniforms, additional accessories and other improvements to the existing character
generator.
|[[User:baobobafet|baobobafet]]
|1.1
|Compatible with most as well as current v20140217
|8Mb
|[http://www.mediafire.com/download/pr55p4r7g87s9uf/facegen_mod_bao_pioneer20140205_bao_V1.1.zip]
|-
|Wave Explorer (ship mod) includes 2 custom pilots
|HiRes2048x2048_Wave-e -see info below or visit https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=89
|[[User:baobobafet|baobobafet]]
|3.5
|v20140217 - (all current versions)
|18Mb
|[http://www.mediafire.com/download/s7d4rqk2fio9gwu/Ship2048x2048_wave-e-w-pilots_bao_pioneer20140217_bao_V3.5.zip]
|-
|-
|Wave Explorer (ship mod) includes 2 custom pilots
|LoRes1024x1024 version of the Wave-e (for increased graphics performance on lower end systems) see info below or visit: https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=89
|[[User:baobobafet|baobobafet]]
|3.5
|v20140217 - (all current versions)
|8Mb
|[http://www.mediafire.com/download/dgxjgo2tf7dgob3/Ship1024x1024_wave-e-w-pilots_bao_pioneer20140217_bao_V3.5.zip]
|-
|-
|Apollo LEM Lunar orbit save file for Alpha26
|Low fuel LEM landing challenge (-w- cargo to jettison) 3 saves with Lunar lander in unpowered orbit over moon with low fuel(requires HighRes.Moon_Apollo.LEM.a26Mod)
|[[User:baobobafet|baobobafet]]
|1.0
|Alpha26
|520kb
|[http://www.mediafire.com/?sy5d6i4n8vz10c4]
|-
|Interstellar Shuttle 1700
|Adds a modified version of the standard shuttle to the ship roster with hyperdrive capability, ecm, missile, cargo/fuel scoop options and more cargo space.(includes a new shuttle skin and solar array for bottom of existing standard shuttle (readme inside zip file)
|[[User:baobobafet|baobobafet]]
|1.3
|Alpha 30
|3560kb
|[http://www.mediafire.com/?46ci6m4677y5wg3]
|-
|Enterprise 1701a (static ship)
|Replaces the Long Range Cruiser (static Ship) with the NCC 1701a "Enterprise" at realistic scale. (readme inside zip file)
|[[User:baobobafet|baobobafet]]
|1.2
|Alpha 30
|1.78mb
|[http://www.mediafire.com/?g4ng4dk46kdns8v]
|-
|-
|Ship Decals Mod 256x256
|This is version 4.0 - includes 8 ship decals. IMAGE here: http://img708.imageshack.us/img708/7146/decalsversion4.png
|[[User:baobobafet|baobobafet]]
|4.0
|Alpha 27-30
|3mb
|[http://www.mediafire.com/?14bchs29dn06nn2]
|-
|-
|-
|Controller Templates
|Not really a Mod - This is for people who have - or are familiar with either Xpadder, 3D Pro Joystick or the G-13 Gameboard. Extreme 3D Pro Joystick Xpadder profile and G-13 gameboard Basic Template - printable key & joystick button reference. Version 3 (More info see above)
|[[User:baobobafet|baobobafet]]
|3.0
|Most Alphas up to 26
|4490kb
|[https://docs.google.com/open?id=0B5dK9aniVGUnM09GRU1qVFJWemM] [http://www.mediafire.com/?ncnh6bpdvna34n2]
|-
|-
|3DPro Joystick Profile
|This is an update supporting the new view keys, for Extreme 3D Pro Joystick Xpadder profile with Template - printable joystick button reference. Version 5 (see pic: http://imageshack.us/a/img822/864/ztf.png )
|[[User:baobobafet|baobobafet]]
|5.0
|Alphas after 28 (all current versions)
|2.31mb
|[http://www.mediafire.com/?btgkn3sjx0ianuu]
|-
|-
|Pioneer default keyboard reference
|In pdf printable format(see PNG pic: http://img203.imageshack.us/img203/2079/5dh.png )
|[[User:baobobafet|baobobafet]]
|v201305.93bao
|Alphas after 28(all current versions)
|7.3mb
|[http://www.mediafire.com/?y5a2sapya7vfhhr]
|-
|-
|Pioneer custom mouse pointers
|Small simple mods containing only custom mouse pointers
|[[User:Joonicks|joonicks]]
|
|20151001
|1-4kb
|[http://joonicks.eu/pioneer_mods]
|}

*'' Version number represents what the module was tested/built against. There is no guarantee that it will work for later versions.''

== List of known Mod Compilations ==

{| class="wikitable"
|+Current known Mod Compilation Packages
|-
!Mod Name
!Mod Description
!Author(s)
!Version
!Tested with Pioneer*
!Size
!Download link
|-
|HiRes Moon & Apollo LEM Mod
|High res Moon heightmap & flyable Apollo Eagle Lander with docs & nav maps.
|contrib by Ae-2222 & [[User:baobobafet|baobobafet]]
|2.0
|Alpha 30
|35.3Mb
|[https://docs.google.com/open?id=0B4TOJEZxkYiVUGZqVklKVEE0WUE]
|}

*'' Version number represents what the module compilation was tested/built against. There is no guarantee that it will work for later versions.''

'''''The who/when/where for mod storage/testing/package compilation is still to be established. As with all things concerning Pioneer it is up to interested parties to resolve this. There is the beginnings of a discussion on the [[Talk:Mods|discussion page]] as not everyone is on the mailing list yet (another could be started on a specific task page if anyone wants to). You need to register to edit pages and contribute.'''''

== Creating A New Ship Mod ==
This is in response to the couple of people who are interested in doing art, perhaps even leading the direction it can go in.

For programmers there's a path which involves creating a GitHub account, forking the Pioneer repository, creating branches, configuring remotes, making commits and submitting Pull Requests.

For Artists and scripters there's another way which is hopefully preferrable for everyone!

To follow this "tutorial" you'll need at least a way of creating ".zip" files, on Windows I use the 7-zip program.

This example is being written for Windows but the ideas are broadly transferrable even if the exact file paths and locations aren't.

=== MyFirstShip mod ===
There's links to a few existing mods above but they're very simple things:
* They're just zip files containing some directories and files,
* Their contents are "Added" to Pioneer unless replace something like a script, ship, texture, etc,
* They use the same directory structure as Pioneer.
The example that most players are enthusiastic about is adding a new ship which is the first step on the long road to a total conversion!

(For additional information see: [https://wiki.pioneerspacesim.net/wiki/Making_your_first_ship Making_your_first_ship] )

To start with we want to make this task easy for ourselves so lets try the following to create a "mod" called "myfirstship":
* Go to wherever you've extracted your Pioneer download to,
* Open the folder "data" and look down the folder names as there's two we're interested in,
** "ships" and "models",
* open the "ships" folder,
** copy and rename the file "wave.lua" to "myfirstship.lua",
** open the file in a text editor and change the following lines like so
*** from: name='Wave Heavy Hypersonic Fighter'
*** from: model='wave',
*** To: name='My First Ship Tutorial'
*** To: model='myfirstship',
*** save your changes to the "myfirstship.lua" file,
*** now go back up to the data folder,
* open the "models" folder, then the "ships" folder,
** copy and rename the folder "wave" to "myfirstship",
** open the "myfirstship" folder,
*** rename the file "wave.model" to "myfirstships.model",
Now run Pioneer with the parameter "-mv myfirstship" so the command line should look like "pioneer.exe -mv myfirstship" this will open it in the modelviewer mode so you can see if everything has worked.

If you run Pioneer as usual then you should be able to go to the ship yard and buy your very own "My First Ship Tutorial" spaceship. Of course it will look like the Wave heavy Hypersonic Fighter, and it will handle like it and be like it in every possible way because it's a perfect copy of it

If you want to make it look different so it's easier to spot then a quick thing you can do is edit the texture "wave.png" in your "/data/models/ships/myfirstship/" folder, perhaps just paint the white a bright red or something which will make it easy to tell that you've changed it.

Obviously we're not done turning all this effort into a mod yet, we've just copied a ship definition ("myfirstship.lua") and the model data for it.

So lets open a new folder window (if on Windows) and:
* Create a new folder somewhere you won't lose it, "My Documents" for windows users or the home folder on Linux etc, call it "tutorial" this time (to avoid confusion),
* In this folder create two more called "ships" and "models",
* With the "models" folder create another folder called "ships",
* by now you should have something that looks like:
** /tutorial/ships/
** /tutorial/models/ships/
* now you're going to _move_ the "myfirstships.lua" file you edited earlier out of the "/pioneer/data/ships/" into the folder "/tutorial/ships/" folder,
* next you must _move_ the folder "myfirstship" from "/pioneer/data/models/ships/" to "/tutorial/models/ships/",
* now create a "readme.txt" file in the "tutorial" folder and add your name to it for now,
* Add everything inside the "tutorial" folder to a zip archive - to do this with 7-zip just selected everything inside the tutorial folder, right-click, open the 7-zip submenu and choose the "Add to archive",
* Make sure that you choose to use "zip" compression and call the archive "myfirstship.zip".
* Finally, put the file "myfirstship.zip" into the "mods" directory - this IS NOT usually where you extracted the Pioneer download.
** On Windows it will be in a folder under your "My Documents"/"Documents" directory for example:
*** "/My Documents/Pioneer/mods/"
* Now double check that you really did MOVE the files and folders, i.e; go back to where you first copied the wave files and folders and make sure that there aren't any "myfirsthip" files or folder there because they should now all be inside the zip file (and safely backed up in the "tutorial" folder).
** The reason this step is important is that you might have made a mistake with the zipping process and the mod is actually now broken, however it will look like it works because the original files are still being found by Pioneer in it's own data directory.
* Finally, the mod should have been packaged up into a zip, it should be in the "mods" directory, and you've made sure the Pioneer data folder is clean.
* Run Pioneer and make sure your mod works.

There are many steps that take just a second or two and lots of bits you can skip once you know what you're doing.

You can have as many ships within a single mod as you like, this technique just gives you a copy of the Wave to edit and play with.

You can, and should, replace it with your own mesh and edit the parameters it uses for thrust and equipment etc.

=== So how does this get my ships into the Pioneer download? ===
Easy, you create your mod, test it, try it out, share it via this forums download area so that others can play it, respond to criticisms to improve it and then ask the Core Team to include it in the main distribution.

This is basically the same process that we go through for programmers submissions but without having to understand Git and GitHub.

It's also more direct to players and fans of the game who often use several mods together to make Pioneer play how they want it too.

Mods

2025-02-10T13:37:11Z

Nozmajner: Adding v.07 of the retro ships mod

== Available Mods ==

=== How to install Mods ===

Since Alpha 22, Pioneer has had support for modding. This is done by allowing core game data to be added to or given preference by data in your userdir (that is, <code>'My Docs/Pioneer/mods'</code> for Windows, <code>'~/.pioneer/mods'</code> for Linux, and <code>'~/Library/Application Support/Pioneer/mods'</code> for OSX).

Once you have downloaded a mod, you simply place the .zip file in the /mods folder described above. There is no need to extract the files.

If a file in a .zip is identically named with one found in the Main pioneer/data directory, the version in the .zip will be used. You can use this fact to easily modify the core game files of Pioneer

This method can be used for any file under the main Pioneer/data directory and applies to ships, buildings and stations, systems, music, fonts, textures, whatever.

However, there are still some mods not packaged in the mod format (.zip). Overtime these are being repackaged by members of the Pioneer community, but in case you have a mod that is not in the correct format then the data in these style of mods must be placed in the correct folder within your main Pioneer/data directory and not in the mods directory described above. But be warned, make a back up of the files you are about to overwrite as this can not be undone and if you do want to return to a 'vanilla' Pioneer, you will have to re-install Pioneer.

== List of known Mods ==

Overtime all the mods here can also be found on the Pioneer Mods page at sourceforge https://sourceforge.net/projects/modsforpioneer/files/Alpha%2030%20mods/

{| class="wikitable"
|+Current known Mod Packages
|-
!Mod Name
!Mod Description
!Author(s)
!Version
!Tested with Pioneer*
!Size
!Download link
|-
|Retro ships
|A mod containing the original versions of three reworked OPLI ships: Amphiesma, Xylophis and Sinonatrix.
|Maks2103
|0.7
|20240710
|2.19 mb
|[https://www.dropbox.com/scl/fi/fx4w9j1nvo7ydevgb33rh/retro-0.7.zip?rlkey=0wu609kk5isv4r7v1p1u9wcgo&st=bsbf0epi&dl=0 retro ships]
|-
|ARGH's original unabridged Extend Sol
|The original unabridged version of extended Sol, with additional dwarfs, many more major asteroids and a high populated system
|ARGHouse
|1.3.1
|20210818
|65.7 kb
|[https://drive.google.com/file/d/1NGTbK1xLdjY4NkN92FtvZc5L6seXlgvW/view?usp=sharing]
|-
|Sol Extended
|Extends the Sol system with additional dwarf planets and spaceports.
|EpsilonEridani
|Work-In-Progress
|20210818
|25.5 kb
|[https://libera.ems.host/_matrix/media/r0/download/matrix.org/BJozxFpJFXnoHiRMQNqpVPiG/00_sol_extended.lua 00_sol_extended.lua]
|-
|Honk
|A simple mod which gives the player the ability to sound various car or ship horns.
|[[User:WKFO|WKFO]]
|1.0
|2021-02-03
|~60 kb
|[https://www.dropbox.com/s/nq0rh3dexibi0pe/honk.zip?dl=0]
|-
|Monolithic Carrier
|A not-that-big bulk cargo ship by Haber Corporation.
|[[User:WKFO|WKFO]]
|0.9
|2022-02-03
|3.3 MB
|[https://www.dropbox.com/s/n2gyaqbt9e5xe79/monocarrier.zip?dl=0]
|-
|Graveyard
|Example of bundling multiple files in a mod. Adds a custom system "Graveyard" (up and to the right of Sol) and a script that does something when you jump there.
|[[User:RobN|RobN]]
|1.0
|20131229
|1kb
|[http://eatenbyagrue.org/f/pioneer/graveyard.zip graveyard.zip]
|-
|RedSol
|Example of replacing a core file. Replaces the system def for Sol with one that has a red star.
|[[User:RobN|RobN]]
|1.0
|Alpha22
|1kb
|[http://eatenbyagrue.org/f/pioneer/redsol.zip redsol.zip]
|-
|Skyboxes
|Nebula backgrounds when in space
|[https://spacesimcentral.com/community/pioneer/i-dont-like-the-skybox/#post-46527 pebblegarden]
|1.0
|2015
|8Mb
|[http://spacesimcentral.com/ssc/index.php?app=core&module=attach&section=attach&attach_id=2563]
|-
|Lanner ship
|The Lanner ship
|unclear
|1.0
|2015
|1.58 Mb
|[https://spacesimcentral.com/community/pioneer-mods/lanner-for-current-pioneer-build/#post-4439]
|-
|-
|Vuzz's Milkyway skybox
|Vuzz's skybox is the most realistic version of the Milky Way for Pioneer.
|[[User:impaktor|impaktor]]
|
|20150912
|1.34MB
|[https://spacesimcentral.com/community/pioneer-mods/vuzzs-milky-way-skybox-mod/#post-4460]
|-
|Moon Heightmap
|Higher res heightmap which replaces the 2mb default heightmap.
|Ae-2222
|1.0
|Alpha26 - - (all current versions)
|33Mb
|[http://wikisend.com/download/359748/moon-hi-res-heightmap.zip moon-hi-res-heightmap.zip]
|-
|Character Generator Upgrade (facegen mod)
|A small upgrade that adds some new hair, eyes, clothing, uniforms, additional accessories and other improvements to the existing character
generator.
|[[User:baobobafet|baobobafet]]
|1.1
|Compatible with most as well as current v20140217
|8Mb
|[http://www.mediafire.com/download/pr55p4r7g87s9uf/facegen_mod_bao_pioneer20140205_bao_V1.1.zip]
|-
|Wave Explorer (ship mod) includes 2 custom pilots
|HiRes2048x2048_Wave-e -see info below or visit https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=89
|[[User:baobobafet|baobobafet]]
|3.5
|v20140217 - (all current versions)
|18Mb
|[http://www.mediafire.com/download/s7d4rqk2fio9gwu/Ship2048x2048_wave-e-w-pilots_bao_pioneer20140217_bao_V3.5.zip]
|-
|-
|Wave Explorer (ship mod) includes 2 custom pilots
|LoRes1024x1024 version of the Wave-e (for increased graphics performance on lower end systems) see info below or visit: https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=89
|[[User:baobobafet|baobobafet]]
|3.5
|v20140217 - (all current versions)
|8Mb
|[http://www.mediafire.com/download/dgxjgo2tf7dgob3/Ship1024x1024_wave-e-w-pilots_bao_pioneer20140217_bao_V3.5.zip]
|-
|-
|Apollo LEM Lunar orbit save file for Alpha26
|Low fuel LEM landing challenge (-w- cargo to jettison) 3 saves with Lunar lander in unpowered orbit over moon with low fuel(requires HighRes.Moon_Apollo.LEM.a26Mod)
|[[User:baobobafet|baobobafet]]
|1.0
|Alpha26
|520kb
|[http://www.mediafire.com/?sy5d6i4n8vz10c4]
|-
|Interstellar Shuttle 1700
|Adds a modified version of the standard shuttle to the ship roster with hyperdrive capability, ecm, missile, cargo/fuel scoop options and more cargo space.(includes a new shuttle skin and solar array for bottom of existing standard shuttle (readme inside zip file)
|[[User:baobobafet|baobobafet]]
|1.3
|Alpha 30
|3560kb
|[http://www.mediafire.com/?46ci6m4677y5wg3]
|-
|Enterprise 1701a (static ship)
|Replaces the Long Range Cruiser (static Ship) with the NCC 1701a "Enterprise" at realistic scale. (readme inside zip file)
|[[User:baobobafet|baobobafet]]
|1.2
|Alpha 30
|1.78mb
|[http://www.mediafire.com/?g4ng4dk46kdns8v]
|-
|-
|Ship Decals Mod 256x256
|This is version 4.0 - includes 8 ship decals. IMAGE here: http://img708.imageshack.us/img708/7146/decalsversion4.png
|[[User:baobobafet|baobobafet]]
|4.0
|Alpha 27-30
|3mb
|[http://www.mediafire.com/?14bchs29dn06nn2]
|-
|-
|-
|Controller Templates
|Not really a Mod - This is for people who have - or are familiar with either Xpadder, 3D Pro Joystick or the G-13 Gameboard. Extreme 3D Pro Joystick Xpadder profile and G-13 gameboard Basic Template - printable key & joystick button reference. Version 3 (More info see above)
|[[User:baobobafet|baobobafet]]
|3.0
|Most Alphas up to 26
|4490kb
|[https://docs.google.com/open?id=0B5dK9aniVGUnM09GRU1qVFJWemM] [http://www.mediafire.com/?ncnh6bpdvna34n2]
|-
|-
|3DPro Joystick Profile
|This is an update supporting the new view keys, for Extreme 3D Pro Joystick Xpadder profile with Template - printable joystick button reference. Version 5 (see pic: http://imageshack.us/a/img822/864/ztf.png )
|[[User:baobobafet|baobobafet]]
|5.0
|Alphas after 28 (all current versions)
|2.31mb
|[http://www.mediafire.com/?btgkn3sjx0ianuu]
|-
|-
|Pioneer default keyboard reference
|In pdf printable format(see PNG pic: http://img203.imageshack.us/img203/2079/5dh.png )
|[[User:baobobafet|baobobafet]]
|v201305.93bao
|Alphas after 28(all current versions)
|7.3mb
|[http://www.mediafire.com/?y5a2sapya7vfhhr]
|-
|-
|Pioneer custom mouse pointers
|Small simple mods containing only custom mouse pointers
|[[User:Joonicks|joonicks]]
|
|20151001
|1-4kb
|[http://joonicks.eu/pioneer_mods]
|}

*'' Version number represents what the module was tested/built against. There is no guarantee that it will work for later versions.''

== List of known Mod Compilations ==

{| class="wikitable"
|+Current known Mod Compilation Packages
|-
!Mod Name
!Mod Description
!Author(s)
!Version
!Tested with Pioneer*
!Size
!Download link
|-
|HiRes Moon & Apollo LEM Mod
|High res Moon heightmap & flyable Apollo Eagle Lander with docs & nav maps.
|contrib by Ae-2222 & [[User:baobobafet|baobobafet]]
|2.0
|Alpha 30
|35.3Mb
|[https://docs.google.com/open?id=0B4TOJEZxkYiVUGZqVklKVEE0WUE]
|}

*'' Version number represents what the module compilation was tested/built against. There is no guarantee that it will work for later versions.''

'''''The who/when/where for mod storage/testing/package compilation is still to be established. As with all things concerning Pioneer it is up to interested parties to resolve this. There is the beginnings of a discussion on the [[Talk:Mods|discussion page]] as not everyone is on the mailing list yet (another could be started on a specific task page if anyone wants to). You need to register to edit pages and contribute.'''''

== Creating A New Ship Mod ==
This is in response to the couple of people who are interested in doing art, perhaps even leading the direction it can go in.

For programmers there's a path which involves creating a GitHub account, forking the Pioneer repository, creating branches, configuring remotes, making commits and submitting Pull Requests.

For Artists and scripters there's another way which is hopefully preferrable for everyone!

To follow this "tutorial" you'll need at least a way of creating ".zip" files, on Windows I use the 7-zip program.

This example is being written for Windows but the ideas are broadly transferrable even if the exact file paths and locations aren't.

=== MyFirstShip mod ===
There's links to a few existing mods above but they're very simple things:
* They're just zip files containing some directories and files,
* Their contents are "Added" to Pioneer unless replace something like a script, ship, texture, etc,
* They use the same directory structure as Pioneer.
The example that most players are enthusiastic about is adding a new ship which is the first step on the long road to a total conversion!

(For additional information see: [https://wiki.pioneerspacesim.net/wiki/Making_your_first_ship Making_your_first_ship] )

To start with we want to make this task easy for ourselves so lets try the following to create a "mod" called "myfirstship":
* Go to wherever you've extracted your Pioneer download to,
* Open the folder "data" and look down the folder names as there's two we're interested in,
** "ships" and "models",
* open the "ships" folder,
** copy and rename the file "wave.lua" to "myfirstship.lua",
** open the file in a text editor and change the following lines like so
*** from: name='Wave Heavy Hypersonic Fighter'
*** from: model='wave',
*** To: name='My First Ship Tutorial'
*** To: model='myfirstship',
*** save your changes to the "myfirstship.lua" file,
*** now go back up to the data folder,
* open the "models" folder, then the "ships" folder,
** copy and rename the folder "wave" to "myfirstship",
** open the "myfirstship" folder,
*** rename the file "wave.model" to "myfirstships.model",
Now run Pioneer with the parameter "-mv myfirstship" so the command line should look like "pioneer.exe -mv myfirstship" this will open it in the modelviewer mode so you can see if everything has worked.

If you run Pioneer as usual then you should be able to go to the ship yard and buy your very own "My First Ship Tutorial" spaceship. Of course it will look like the Wave heavy Hypersonic Fighter, and it will handle like it and be like it in every possible way because it's a perfect copy of it

If you want to make it look different so it's easier to spot then a quick thing you can do is edit the texture "wave.png" in your "/data/models/ships/myfirstship/" folder, perhaps just paint the white a bright red or something which will make it easy to tell that you've changed it.

Obviously we're not done turning all this effort into a mod yet, we've just copied a ship definition ("myfirstship.lua") and the model data for it.

So lets open a new folder window (if on Windows) and:
* Create a new folder somewhere you won't lose it, "My Documents" for windows users or the home folder on Linux etc, call it "tutorial" this time (to avoid confusion),
* In this folder create two more called "ships" and "models",
* With the "models" folder create another folder called "ships",
* by now you should have something that looks like:
** /tutorial/ships/
** /tutorial/models/ships/
* now you're going to _move_ the "myfirstships.lua" file you edited earlier out of the "/pioneer/data/ships/" into the folder "/tutorial/ships/" folder,
* next you must _move_ the folder "myfirstship" from "/pioneer/data/models/ships/" to "/tutorial/models/ships/",
* now create a "readme.txt" file in the "tutorial" folder and add your name to it for now,
* Add everything inside the "tutorial" folder to a zip archive - to do this with 7-zip just selected everything inside the tutorial folder, right-click, open the 7-zip submenu and choose the "Add to archive",
* Make sure that you choose to use "zip" compression and call the archive "myfirstship.zip".
* Finally, put the file "myfirstship.zip" into the "mods" directory - this IS NOT usually where you extracted the Pioneer download.
** On Windows it will be in a folder under your "My Documents"/"Documents" directory for example:
*** "/My Documents/Pioneer/mods/"
* Now double check that you really did MOVE the files and folders, i.e; go back to where you first copied the wave files and folders and make sure that there aren't any "myfirsthip" files or folder there because they should now all be inside the zip file (and safely backed up in the "tutorial" folder).
** The reason this step is important is that you might have made a mistake with the zipping process and the mod is actually now broken, however it will look like it works because the original files are still being found by Pioneer in it's own data directory.
* Finally, the mod should have been packaged up into a zip, it should be in the "mods" directory, and you've made sure the Pioneer data folder is clean.
* Run Pioneer and make sure your mod works.

There are many steps that take just a second or two and lots of bits you can skip once you know what you're doing.

You can have as many ships within a single mod as you like, this technique just gives you a copy of the Wave to edit and play with.

You can, and should, replace it with your own mesh and edit the parameters it uses for thrust and equipment etc.

=== So how does this get my ships into the Pioneer download? ===
Easy, you create your mod, test it, try it out, share it via this forums download area so that others can play it, respond to criticisms to improve it and then ask the Core Team to include it in the main distribution.

This is basically the same process that we go through for programmers submissions but without having to understand Git and GitHub.

It's also more direct to players and fans of the game who often use several mods together to make Pioneer play how they want it too.

FAQ

2025-01-02T19:47:41Z

Nozmajner: Adding blank screen error

= Frequently Asked Questions =

== About the Game ==

=== What is Pioneer? ===

Pioneer is a freeform single player space adventure in the spirit of [https://en.wikipedia.org/wiki/Frontier:_Elite_II Frontier: Elite II].

=== Is this a game or a simulation? ===

Frontier was a game, but with a newtonian flight model and a slightly more scientific flavour to the universe than usually in space games. Pioneer follows this same path.

=== Can I play multiplayer online? ===

There will be no multiplayer. This does not rule out the possibility of minor network features, but multiplayer as it is commonly known is not compatible with the core mechanics of Pioneer. See for instance [[Network_features|Network features]], and [[ServerAgent|ServerAgent]] for more, or our dev forum [https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=216 here]. Pioneer will never have multiple players in different ships, as this is incompatible with time acceleration feature. For comparison: the Elite Dangerous dev-team chose to prioritize multiplayer over Newtonian mechanics, and make it more like the original Elite, we choose to stay true to the core concepts of Frontier Elite II, which is Newtonian mechanics, with time acceleration.

=== Can I colonize planets, build space stations or conquer the universe? ===

No, these are out of the game scope. While the game universe might not stay static for the duration of a game, the player can not generally influence major events.

=== Can I walk around space stations and planets? ===

No, you cannot exit your ship. The ship is always your avatar. The development team does have [https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=454 aspirations] to push in this direction, for future versions.

=== Is the universe pre-defined or randomly generated? ===

There are millions of stars in the galaxy. A few hundred on them are based on real-world astronomic catalogues. some of the planets (obvious ones being in the Sol system) are pre-defined, but most things are procedurally generated. This means that a planet does not exist until you actually visit it, but it will be generated the same way for every player.

=== Can I hire crew for my ship? ===

Yes. You can hire crew. But they don't do very much at the moment.

=== Are savegames compatible between releases? ===

The development of the game can happen in sudden bursts, some of which change the game universe, or save/load routine, such that old saves are blocked from loading, lest the game might crash. The player can start a new game, and "give" themselves back money, kills, reputation, ship, as it was in the old save, by using the [[Lua_Console|lua console]]. You probably want to keep a copy of your old Pioneer, to read off your player statistics, write them down, then download and open the latest Pioneer version, and give yourself those stats. Note: it's only cheating if you give yourself back more than you had, remember: God is watching over your shoulder!

=== Are savegames compatible between Mods? ===

Again as with savegames between different versions of pioneer, compatibility between mods can not be guaranteed. It all depends on what mods you have installed.

=== Where is star system X from Frontier? Can I buy ship Y? ===

Although Pioneer started out as a clone of Frontier, it no longer is, thus references to the Frontier universe have been removed, and we aim at making Pioneer far better than Frontier. Thus, you will have to figure out new trade routes! But don't worry, Newtonian physics will remain, as well as single player.

=== Can I build and control a fleet, or a factory, or run/own a station? ===

No, this is not on the agenda, and none of the developers are motivated to push for this, but who knows, perhaps in the future, some skilled developer, who knows how to implement this in a way that makes game play interesting, joins the dev-team. However, we are currently planning to have mining machines (like in Frontier Elite II), and ship system management (heat, energy, repair components, etc.) on the agenda.

== Gameplay ==

=== How do I take screenshots? ===

Ctrl+Printscreen saves .png files in the same directory where the game .ini and savegames are. You can cycle through full HUD/HUD without labels and cursor/No HUD and cockpit using TAB as described in [http://pioneerwiki.com/wiki/Keyboard_and_mouse_controls#In_flight [1]].

=== How do I record a video? ===
To record video directly from Pioneer you will need to add the line RecordVideo=1 somewhere within your config.ini file. Then once ingame you can press Ctrl+ScrLk to start or stop recording.

=== How do I find star X in the star map ===

First it is important to note that just like in real life, names are not unique. The star map allows the player to search for either name or coordinates of a system. The search is done in the local region of the currently selected system.

Thus a standard way of finding a system is to type in the name in the search field in the star map (generally refereed to as "sector view"). If you know the system is within a few ly from your position, then have your current location selected when you do the search, since it only does a "local" search in space. If the search fails, go to the sector where the star is supposed to be, either by typing the coordinates into the search field, or by using arrows, mark a nearby star in that system, and do another search. You can scroll the star map super fast by holding in the Shift key.

=== I have a Taxi mission to system X, but which starport? ===

For Taxi missions any starport will do, as long as you dock before the deadline.

=== Starsystem names are not unique ===

This is not a bug, space is big, and just here on Earth it is quite common with cities and villages sharing the same name, sometimes quite close.

=== I picked up a mission to a starport in a system, but when I search for the system, it seems that it doesn't have the destination starport, or even uninhabited. ===

As mentioned above, there could be multiple systems with the same name. Each mission states the coordinates (Sirius (1,0,-1) for example) of the destination system, and you can enter them into the search field on the sector map, to find the correct system.

=== I end up "a big number" AU away from the star when I hyper jump to a system ===

This happens in binary star systems. You can select the star you want to jump to from the [[Manual#System_info|System View]].

=== Map survey / scan mission does not progress ===
Make sure:
* if you have an orbit scan mission, you need an orbit scanner, and if you have a surface scan mission you need a surface scanner.
* Also make sure you're flying above the minimum altitude, and below the max.
* Also make sure you're in the right system (both coordinates and name must match), and at the right body.

=== Major/Minor Import/Export is wrong ===
There are two levels: system and station. A system can be an importer of X, but a station in that system can be an exporter of X relative the system as a whole, meaning the import/export of a specific station is relative to the import/export price of the system as a whole.

== Technical FAQ ==

=== What is the system requirement for runing the game? ===

Current "stable" (if indeed we have one) [https://pioneerspacesim.net/page/download/ release] is 2021-02-03, and is built on Ubuntu 20.04 Linux machine and a Windows machine, and requires OpenGL 3.2 compatible hardware.
We also offer a [https://flathub.org/apps/details/net.pioneerspacesim.Pioneer flatpak] script. If you want to compile the game, then please install requirements listed in [https://github.com/pioneerspacesim/pioneer/blob/master/COMPILING.txt COMPILING.txt]

=== Installing the game ===

The releases are made when developers feel it's been "a while", relative to the number of new additions that have been added that they want players to enjoy / playtest. Releases for Windows and GNU/Linux are now (2021) found on the [https://github.com/pioneerspacesim/pioneer/releases github releases page], and Linux versions are currently built on a [https://github.com/pioneerspacesim/pioneer/blob/master/.github/workflows/build-ci.yml Ubuntu 20.04] (virtual) machine, thus that system should not have any compatibility issues.

==== Build from source ====

The best way to ensure your pioneer is compatible with you Linux system, and of latest, "bleeding edge", version is to install from source. This is described in [https://github.com/pioneerspacesim/pioneer/blob/master/COMPILING.txt COMPILING.txt]. Playing this way is also the best way you can help the developers, i.e. find and report the latest bugs you encounter.

==== Installing using flatpak ====
If you're having trouble getting pioneer to run on your Linux distribution, and you do not want to build from source, then we recommend [https://flathub.org/apps/details/net.pioneerspacesim.Pioneer flatpak] that resolves dependencies for you. Follow [https://flatpak.org/setup/ this] on how to use it, if need be. E.g. on Linux Mint these images are already [https://flatpak.org/setup/Linux%20Mint included] by default in their app store. On other distributions it is at most needed to install flatpak and then issue, from a terminal:

flatpak install net.pioneerspacesim.Pioneer

==== Error loading shared libraries (e.g.libassimp.so.<x>) ====

The linux version of Pioneer is build on a Ubuntu 20 machine. Currenlty (2021-05), this can cause some debian machines, that have an older verison of libassimp, to throw an error, e.g.:

error while loading shared libraries: libassimp.so.5:
cannot open shared object file: No such file or directory

This is fixed either by building pioneer from source, against the shared libraries that are on your particular machine (then you get an even more updated "bleeding edge" build of pioneer!), or install the correct version of the package that is missing: https://packages.debian.org/unstable/libassimp5 (or try to find an older release)

==== Where is the Mac version? ====

Pioneer's development team is mainly on Linux and Windows, and does currently not have the ability to build and maintain a Mac version. To build a Mac release we actually need access to a Mac machine, which, unfortunately, none of the developers currently have. If you have a Mac which can compile and upload pioneer for us on a regular basis, then please contact us (IRC).

Update: OSX builds have been discontinued due to lack of maintainer and Apple's deprecation of OpenGL. We do not intend to offer them in the near future - we will need to migrate the rendering path to Vulkan and have enough of a user base to warrant spending time on OSX compatibility.

==== Where do I find nightly builds of Pioneer ====

They're available on github [https://github.com/pioneerspacesim/pioneer/actions?query=workflow%3A%22Build+Pioneer%22+branch%3Amaster actions page]. Note: thuis currently requires [https://github.com/actions/upload-artifact/issues/51 login to github] to download. A new build is made each time a pull request is merged with new code, and also each proposed pull request is built, which is a great way to test features prior to them being merged into the master branch.

==== Where do I find older versions of Pioneer ====

You can find older versions starting from December 2014 (2014-12-05) on our [http://sourceforge.net/projects/pioneerspacesim/files sourceforge] page. 2014-11-18 was the last version supporting OpenGL 2, between 2014-11-19 to 2014-12-07 Pioneer required OpenGL 3.2. From 2014-12-08 only OpenGL 3.1 is required. Over at [http://www.moddb.com/games/pioneer/downloads moddb] they have windows version going further back in time.

==== How do I play on old computer ====

Your best bet is to use an older version, or if you have another computer you can use virtualGL to let pioneer run on a remote (modern) machine and forward it to an older machine, as described on the [https://spacesimcentral.com/community/pioneer/a-request-for-instrumental-pioneer/ forum], this command works best (but combat/action is too laggy, so it is only a viable solution for playing peaceful missions):

vglconnect user@server_executing_pioneer_ip -CY -p SSH_port 'cd /path_of_pioneer_compilation_folderme/ && ./pioneer'

=== How/where do I report my bug/crash ===

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 issue tracker], but you can also stop by the [[IRC|IRC channel]]. When you report it, always mention pioneer verision (shown in lower right hand corner in the starting screen [https://user-images.githubusercontent.com/18342621/118388006-6ee03080-b62a-11eb-8d48-bf66f0820d5f.png png])

When having problems with graphics, or pioneer not starting/crashing, please attach the files '''output.txt''' and '''opengl.txt''' from the pioneer [http://pioneerwiki.com/wiki/FAQ#Where_is_the_configuration_file.2C_saved_games.2C_screenshots.3F config folder] in your home folder / My Documents folder. If you didn't get the '''output.txt''' file, then make sure '''RedirectStdio=1''' in '''config.ini'''.

It is important to include as much of the following information as possible in each issue report, much of this is available to use from the '''output.txt''' and '''opengl.txt''' but if you cannot attach them then please tell us:

*The version of pioneer you are trying to run (''build date or ingame version number'')
*What operating system you are running, Windows XP/Vista/7/8/10, Linux (''what distribution''), OSX.
*Your computers system specifications - CPU / RAM / Graphics card.
*Whether you have downloaded it from our site, or if you are building it from the source code.

=== Debug backtrace ===
When the game crashes, one of most valuable pieces of information you can provide the development team, is a backtrace. To get a backtrace, the game must have been compiled in debug mode, and then started through a debugger. If you compile the game yourself, from source, it will by default build a debug mode.

==== Windows Visual Studio ====

* Compile the game in debug mode (should be the default setting).
* After building it, press F5 or go to Debug->Start Debugging. Note: it will run slowly, starting a new game or loading a new one in particular. That's normal.
* Instead of a full out crash, you'll get a freeze and it should automatically switch back to Visual Studio. If it freezes and doesn't switch back, do that manually.
* At that point, Visual Studio should have opened a couple new panes/sub windows at the bottom. One of these is 'Call Stack.' Right click in it, select 'Select All.' Then right click in there again and select 'Copy with source paths.'
* Then paste that information into the bug-report (preferably as a [https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet code formatted block])
* After that you can Debug->Stop to shut down Pioneer again.

==== Linux gdb ====
* Make sure gdb (The GNU Debugger) is installed on you system (available in package managers of all Linux distributions).
* Then start pioneer by prefixing the command with gdb followed by the normal command to start pioneer. Eg. if you normally do:

cd pioneer/
./build/pioneer

then to run in debug mode, you need to run it through gdb:

cd pioneer/
gdb ./build/pioneer

then from inside gdb, type "run", which starts pioneer. Play until you get the crash, which drops you out to gdb again. Type 'bt' or 'backtrace' in the gdb command line, and save the output to you bug-report.

=== Where is the configuration file, saved games, screenshots? ===

*Windows: My Documents\Pioneer
*OS X: /Users/your_username/Library/Application Support/Pioneer
*Linux: /home/your_username/.pioneer
Update 2024-10: Pioneer now prefers storing its user data in $XDG_DATA_HOME/pioneer, falling back to ~/.local/share/pioneer if that variable is not set. ~/.pioneer is used only for backwards-compatibility reasons.

=== New pioneer version doesn't start ===
This could be because new configuration is incompatible with the local, try removing your pioneer configuration folder, such that the game will auto-generate new configuration file anew.

=== I'm getting blank black screen on start ===
This is usually an antialiasing issue. Change "AntiAliasingMode" to 0 in config.ini.

=== I'm getting graphical issues ===

Such as wrong textures, ships missing from the view, text display glitches. '''Updating the display drivers usually solve these problems.'''

These usually occur on older graphics adapters, or because of outdated GPU drivers. Not too old NVidia and ATI cards are usually enough to play the game, but integrated GPUs are usually not enough.

=== I'm getting graphical issues, such as snow-like sky and transparent terrain ===

This is probably caused by the eclipse shader which isn't supported by some open source graphic drivers. You could install the proprietary drivers, if available, or disable the eclipse effect by adding DisableEclipse=1 to your pioneer configuration file (config.ini).

=== My OpenGL Version is below 3.2, "Pioneer cannot run on your graphics card" ===

UPDATE: Pioneer dropped 2.1 support in September, 2018. You need to checkout and compile a version prior to this, and do:

Open your pioneer configuration file, and set: "RendererName=Opengl 2.1". This should allow pioneer to run, provided your hardware supports OpenGL 2.1, which it should if you were able to run Pioneer up until 2014-11-18 when support was dropped. Note, support for multiple renderers was added 2017-03-03, i.e. both OpenGL 2.1 and 3.1; however, you need to edit your configuration file to select the proper one, as no auto-detection is done. Actually, if your hardware isn't extraordinarily old, OpenGL 3.2 should be supported if you update your drivers.

You can also find older versions (pre 20141119) on [http://www.moddb.com/games/pioneer/downloads moddb].

=== I see blank untextured Gas Giants and I'm using an ATI graphic card under GNU/Linux with open source drivers (Mesa R600) ===

With chipsets using the R600 gallium drivers the shader fails to compile. There is a workaround that uses less noise octaves. This produces less detailed texture maps for the gas/ice giants but they still look good and at least the program runs.

Try setting <code>AMD_MESA_HACKS=1</code> in ~/.pioneer/config.ini or disable GPU jobs entirely by setting <code>EnableGpujobs=0</code>

=== I'm getting text rendering artefacts ===

Some system monitoring HUD utilities, like MSI Afterburner, and Steam overlay can cause distorted text rendering. Try switching them off. 

=== The game freezes at the intro screen ===

If you cannot start the game at all, edit the configuration file and change value DisableShaders to 1.

=== The game crashes on start with an error message about imgui_draw.cpp ===

Check if any parent folder of Pioneer has any accented letters (e.g éáűúóü etc.). If so, copy the game to somewhere, where there's none of these in the folder tree.

=== The game crashes after the loading screen. I'm using ATI free drivers on GNU/Linux. ===

If you are getting a GL_INVALID_ENUM in console, could be because some ships uses textures in a format that, because of patents, is not included in the main mesa package. Search for libtxc-dxtn or libtxc_dxtn in your distribution and install it.

=== The game hangs when I turn on the ''Enable Cockpit (EXPERIMENTAL)'' option ===

It's because it's an experimental feature right now, infrastructure mostly. You need a cockpit model for to be able to use it.

You can find one heavily WIP one posted on the Community Forums. Note that it's a highly experimental feature right no, so please treat it accordingly.

=== My joystick is "drifting" ===

It's recommended that you calibrate your joystick using the OS facilities (Joystick Settings on Windows, jstest-gtk on linux) as this fixes 99% of all issues with incorrectly configured joysticks. However, if you want to adjust specific parameters for each joystick axis, support for customizable deadzone and sensitivity is available through the configuration file. Open config.ini and adjust the deadzone (DZ) and sensitivity exponent curve (CV) values of the corresponding axis to your liking.

; example joystick configuration
[Joystick.03000000a30600006404000000010000]
Axis0=DZ0.0 CV1.0
Axis1=DZ0.0 CV1.0
Axis2=DZ0.0 CV1.0
Axis3=DZ0.0 CV1.0
Name=Saitek Cyborg USB Stick

=== I'm getting poor performance ===

The heaviest part of the game is planetary terrain generation. Turn down the "Detail distance" and "Fractal detail" settings, they have the most impact for performance. Reducing screen resolution is also recommended, this can be done in the [[Settings_Menu|Settings Menu]], or manually to a custom values by editing your personal configuration file, on Linux: <code>~/.pioneer/config.ini</code>. On Windows: <code>Documents/pioneer/config.ini</code> Look for <code>ScrHeight</code> and <code>ScrWidth</code> entries. Also consider reducing number of buildings in cities.

=== I've enabled anti-aliasing in the config file, but it does not work ===

Make sure the AA settings are not overridden by your graphics card settings, on NVidia AA should be set to "application controlled" mode.

=== Full screen mode is incorrectly scaled ===

If you are on Windows, try:
<pre>Sounds like windows 7 desktop-scaling issues.
Try adding some compatability modes to the Pioneer.exe.
Right click it and Choose properties -> Compatability -> Tick
Disable desktop scaling, and Disable desktop composition.
</pre>

== Development ==

=== What's the history of Pioneer ===

The project started in 2008 by Tom Morton, and was [https://web.archive.org/web/20150326115725/http://spacesimcentral.com/ssc/topic/742-pioneer-new-gpl-frontier-elite-2-style-game/ announced in 2010] on the Space Sim Central forum (for space games), and on [https://forums.frontier.co.uk/threads/the-pioneer-thread.1596/ frontier forum]. For more history, see [http://www.rockpapershotgun.com/2011/12/06/back-to-frontier-pioneer/ Rock Paper Shotgun article], and [[Media_Coverage]]

=== How much development is being made? ===

Development is sporadic, but no month goes by without some change to the source, fixing bugs, cleaning up code, introducing new content and/or features; see [https://github.com/pioneerspacesim/pioneer/blob/master/Changelog.txt Changelog.txt]. All contributors work on pioneer for free when they have time and motivation.

=== What's the deal with the inconsistent UI interface? ===
Basically, Pioneer has during the 2013-2020s had up to three different, simulteneous, UI systems, for a background and screen shots, please refer to:
[[GUI_introduction#Background_history]]

=== Do you accept contributions? ===

Hell yes! Pioneer is not any one persons personal project. It is the sum of the contributions made by the people who play and care about the continued development of the game. See: [[How_you_can_contribute|How to contribute]].

OKB Kaluri

2024-09-11T17:33:02Z

Nozmajner: Addnig Mola Ramsayi

{{Infobox_Company
|name = OKB Kaluri
|slogan = Sail to the furthest sea.
|foundation = 9th of January 2719
|system = Epsilon Eridani
|planet = N/A
|city = N/A
|faction = CIW
|nr_employees = 197 000
|ships = [[Mola Mola]], [[Pumpkinseed]], [[Bowfin fighter]], [[Bluenose]]
}}

 

== Description ==

OKB Kaluri is a major CIW shipyard famous for it's dependable vessels. A typical Kaluri has robust but flowing, somewhat aerodynamic round form even if it's not atmosphere capable craft. They usually seem a bit low-tech, and they confirm that with equally spartan instrumentation and interior. But this modesty comes from a craft which is easy to maintain and would last for several decades in caring hands. They are direct competitors of the Mandarava-Csepel Shipworks from the Solar Federation. The name OKB means Experimental Design Bureau, Kaluri is for fisherman as the founder Rebane came from a family of fishers.

== History ==

OKB Kaluri was a minor shipyard barely getting by during the Solar Federation occupation of Epsilon Eridani. Kaluri Shipyard was founded by Koidu Rebane as a way of passive resistance to the puppet government of the Federation. At first it mainly refitted ships for smuggling and illegal migration under Federation radar, but grew fairly fast before the first strikes of the war. At the wake of the War for Hope it already had a prototype strike ship partially reverse-engineered from several captured Federatation vehicles. As the war gained momentum, it merged with other minor yards to become the research bureau OKB Kaluri.

It's main task was combat vessel development during the war. It suffered heavily from sabotage and assaults, and barely survived the war. Rebane herself died a few month before the end of the war, but her children managed to maintain business by repairing anything that came by.

After years of lobbying and hard work they managed to win a tender to build a ship that's capable of cleaning up the thick layers of debris of war orbiting the Confederation worlds. That ship, called Plecostomus was a so successful design, it propelled business forward and established their main production philosophy of preferring dependability over high performance.

Currently they maintain a good business relationship with both the CIW Government and People's Freedom Militia.

== Ships in service ==

*[[Mola_Mola|Mola Mola Light Transport]]
*[[Mola_Ramsayi|Mola Ramsayi Medium Transport]]
*[[Pumpkinseed|Pumpkinseed Light Courier]]
*[[Bowfin fighter|Bowfin Medium Fighter]]
*[[Bluenose|Bluenose]]

== Other products and services ==

Apart from ship manufacturing, they maintain one of the largest Research and Development branch, mostly focusing on safety and dependability.

They also provide maintenance and repair services for the Militia and government and civilians too.

Mods

2024-07-16T07:29:48Z

Nozmajner: /* List of known Mods */ Adding Maks' old ship version restoring mod

== Available Mods ==

=== How to install Mods ===

Since Alpha 22, Pioneer has had support for modding. This is done by allowing core game data to be added to or given preference by data in your userdir (that is, <code>'My Docs/Pioneer/mods'</code> for Windows, <code>'~/.pioneer/mods'</code> for Linux, and <code>'~/Library/Application Support/Pioneer/mods'</code> for OSX).

Once you have downloaded a mod, you simply place the .zip file in the /mods folder described above. There is no need to extract the files.

If a file in a .zip is identically named with one found in the Main pioneer/data directory, the version in the .zip will be used. You can use this fact to easily modify the core game files of Pioneer

This method can be used for any file under the main Pioneer/data directory and applies to ships, buildings and stations, systems, music, fonts, textures, whatever.

However, there are still some mods not packaged in the mod format (.zip). Overtime these are being repackaged by members of the Pioneer community, but in case you have a mod that is not in the correct format then the data in these style of mods must be placed in the correct folder within your main Pioneer/data directory and not in the mods directory described above. But be warned, make a back up of the files you are about to overwrite as this can not be undone and if you do want to return to a 'vanilla' Pioneer, you will have to re-install Pioneer.

== List of known Mods ==

Overtime all the mods here can also be found on the Pioneer Mods page at sourceforge https://sourceforge.net/projects/modsforpioneer/files/Alpha%2030%20mods/

{| class="wikitable"
|+Current known Mod Packages
|-
!Mod Name
!Mod Description
!Author(s)
!Version
!Tested with Pioneer*
!Size
!Download link
|-
|Retro ships
|A mod containing the original versions of three reworked OPLI ships: Amphiesma, Xylophis and Sinonatrix.
|Maks2103
|0.6
|20240710
|2.19 mb
|https://www.dropbox.com/scl/fi/wf2r59dzr2sfvfwto812x/retro-0.6.zip?rlkey=cqlbhf4ctkm5cztzedt65sgvy&st=phbzmg0k&dl=0
|-
|ARGH's original unabridged Extend Sol
|The original unabridged version of extended Sol, with additional dwarfs, many more major asteroids and a high populated system
|ARGHouse
|1.3.1
|20210818
|65.7 kb
|[https://drive.google.com/file/d/1NGTbK1xLdjY4NkN92FtvZc5L6seXlgvW/view?usp=sharing]
|-
|Sol Extended
|Extends the Sol system with additional dwarf planets and spaceports.
|EpsilonEridani
|Work-In-Progress
|20210818
|25.5 kb
|[https://libera.ems.host/_matrix/media/r0/download/matrix.org/BJozxFpJFXnoHiRMQNqpVPiG/00_sol_extended.lua 00_sol_extended.lua]
|-
|Honk
|A simple mod which gives the player the ability to sound various car or ship horns.
|[[User:WKFO|WKFO]]
|1.0
|2021-02-03
|~60 kb
|[https://www.dropbox.com/s/nq0rh3dexibi0pe/honk.zip?dl=0]
|-
|Monolithic Carrier
|A not-that-big bulk cargo ship by Haber Corporation.
|[[User:WKFO|WKFO]]
|0.9
|2022-02-03
|3.3 MB
|[https://www.dropbox.com/s/n2gyaqbt9e5xe79/monocarrier.zip?dl=0]
|-
|Graveyard
|Example of bundling multiple files in a mod. Adds a custom system "Graveyard" (up and to the right of Sol) and a script that does something when you jump there.
|[[User:RobN|RobN]]
|1.0
|20131229
|1kb
|[http://eatenbyagrue.org/f/pioneer/graveyard.zip graveyard.zip]
|-
|RedSol
|Example of replacing a core file. Replaces the system def for Sol with one that has a red star.
|[[User:RobN|RobN]]
|1.0
|Alpha22
|1kb
|[http://eatenbyagrue.org/f/pioneer/redsol.zip redsol.zip]
|-
|Skyboxes
|Nebula backgrounds when in space
|[https://spacesimcentral.com/community/pioneer/i-dont-like-the-skybox/#post-46527 pebblegarden]
|1.0
|2015
|8Mb
|[http://spacesimcentral.com/ssc/index.php?app=core&module=attach&section=attach&attach_id=2563]
|-
|Lanner ship
|The Lanner ship
|unclear
|1.0
|2015
|1.58 Mb
|[https://spacesimcentral.com/community/pioneer-mods/lanner-for-current-pioneer-build/#post-4439]
|-
|-
|Vuzz's Milkyway skybox
|Vuzz's skybox is the most realistic version of the Milky Way for Pioneer.
|[[User:impaktor|impaktor]]
|
|20150912
|1.34MB
|[https://spacesimcentral.com/community/pioneer-mods/vuzzs-milky-way-skybox-mod/#post-4460]
|-
|Moon Heightmap
|Higher res heightmap which replaces the 2mb default heightmap.
|Ae-2222
|1.0
|Alpha26 - - (all current versions)
|33Mb
|[http://wikisend.com/download/359748/moon-hi-res-heightmap.zip moon-hi-res-heightmap.zip]
|-
|Character Generator Upgrade (facegen mod)
|A small upgrade that adds some new hair, eyes, clothing, uniforms, additional accessories and other improvements to the existing character
generator.
|[[User:baobobafet|baobobafet]]
|1.1
|Compatible with most as well as current v20140217
|8Mb
|[http://www.mediafire.com/download/pr55p4r7g87s9uf/facegen_mod_bao_pioneer20140205_bao_V1.1.zip]
|-
|Wave Explorer (ship mod) includes 2 custom pilots
|HiRes2048x2048_Wave-e -see info below or visit https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=89
|[[User:baobobafet|baobobafet]]
|3.5
|v20140217 - (all current versions)
|18Mb
|[http://www.mediafire.com/download/s7d4rqk2fio9gwu/Ship2048x2048_wave-e-w-pilots_bao_pioneer20140217_bao_V3.5.zip]
|-
|-
|Wave Explorer (ship mod) includes 2 custom pilots
|LoRes1024x1024 version of the Wave-e (for increased graphics performance on lower end systems) see info below or visit: https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=89
|[[User:baobobafet|baobobafet]]
|3.5
|v20140217 - (all current versions)
|8Mb
|[http://www.mediafire.com/download/dgxjgo2tf7dgob3/Ship1024x1024_wave-e-w-pilots_bao_pioneer20140217_bao_V3.5.zip]
|-
|-
|Apollo LEM Lunar orbit save file for Alpha26
|Low fuel LEM landing challenge (-w- cargo to jettison) 3 saves with Lunar lander in unpowered orbit over moon with low fuel(requires HighRes.Moon_Apollo.LEM.a26Mod)
|[[User:baobobafet|baobobafet]]
|1.0
|Alpha26
|520kb
|[http://www.mediafire.com/?sy5d6i4n8vz10c4]
|-
|Interstellar Shuttle 1700
|Adds a modified version of the standard shuttle to the ship roster with hyperdrive capability, ecm, missile, cargo/fuel scoop options and more cargo space.(includes a new shuttle skin and solar array for bottom of existing standard shuttle (readme inside zip file)
|[[User:baobobafet|baobobafet]]
|1.3
|Alpha 30
|3560kb
|[http://www.mediafire.com/?46ci6m4677y5wg3]
|-
|Enterprise 1701a (static ship)
|Replaces the Long Range Cruiser (static Ship) with the NCC 1701a "Enterprise" at realistic scale. (readme inside zip file)
|[[User:baobobafet|baobobafet]]
|1.2
|Alpha 30
|1.78mb
|[http://www.mediafire.com/?g4ng4dk46kdns8v]
|-
|-
|Ship Decals Mod 256x256
|This is version 4.0 - includes 8 ship decals. IMAGE here: http://img708.imageshack.us/img708/7146/decalsversion4.png
|[[User:baobobafet|baobobafet]]
|4.0
|Alpha 27-30
|3mb
|[http://www.mediafire.com/?14bchs29dn06nn2]
|-
|-
|-
|Controller Templates
|Not really a Mod - This is for people who have - or are familiar with either Xpadder, 3D Pro Joystick or the G-13 Gameboard. Extreme 3D Pro Joystick Xpadder profile and G-13 gameboard Basic Template - printable key & joystick button reference. Version 3 (More info see above)
|[[User:baobobafet|baobobafet]]
|3.0
|Most Alphas up to 26
|4490kb
|[https://docs.google.com/open?id=0B5dK9aniVGUnM09GRU1qVFJWemM] [http://www.mediafire.com/?ncnh6bpdvna34n2]
|-
|-
|3DPro Joystick Profile
|This is an update supporting the new view keys, for Extreme 3D Pro Joystick Xpadder profile with Template - printable joystick button reference. Version 5 (see pic: http://imageshack.us/a/img822/864/ztf.png )
|[[User:baobobafet|baobobafet]]
|5.0
|Alphas after 28 (all current versions)
|2.31mb
|[http://www.mediafire.com/?btgkn3sjx0ianuu]
|-
|-
|Pioneer default keyboard reference
|In pdf printable format(see PNG pic: http://img203.imageshack.us/img203/2079/5dh.png )
|[[User:baobobafet|baobobafet]]
|v201305.93bao
|Alphas after 28(all current versions)
|7.3mb
|[http://www.mediafire.com/?y5a2sapya7vfhhr]
|-
|-
|Pioneer custom mouse pointers
|Small simple mods containing only custom mouse pointers
|[[User:Joonicks|joonicks]]
|
|20151001
|1-4kb
|[http://joonicks.eu/pioneer_mods]
|}

*'' Version number represents what the module was tested/built against. There is no guarantee that it will work for later versions.''

== List of known Mod Compilations ==

{| class="wikitable"
|+Current known Mod Compilation Packages
|-
!Mod Name
!Mod Description
!Author(s)
!Version
!Tested with Pioneer*
!Size
!Download link
|-
|HiRes Moon & Apollo LEM Mod
|High res Moon heightmap & flyable Apollo Eagle Lander with docs & nav maps.
|contrib by Ae-2222 & [[User:baobobafet|baobobafet]]
|2.0
|Alpha 30
|35.3Mb
|[https://docs.google.com/open?id=0B4TOJEZxkYiVUGZqVklKVEE0WUE]
|}

*'' Version number represents what the module compilation was tested/built against. There is no guarantee that it will work for later versions.''

'''''The who/when/where for mod storage/testing/package compilation is still to be established. As with all things concerning Pioneer it is up to interested parties to resolve this. There is the beginnings of a discussion on the [[Talk:Mods|discussion page]] as not everyone is on the mailing list yet (another could be started on a specific task page if anyone wants to). You need to register to edit pages and contribute.'''''

== Creating A New Ship Mod ==
This is in response to the couple of people who are interested in doing art, perhaps even leading the direction it can go in.

For programmers there's a path which involves creating a GitHub account, forking the Pioneer repository, creating branches, configuring remotes, making commits and submitting Pull Requests.

For Artists and scripters there's another way which is hopefully preferrable for everyone!

To follow this "tutorial" you'll need at least a way of creating ".zip" files, on Windows I use the 7-zip program.

This example is being written for Windows but the ideas are broadly transferrable even if the exact file paths and locations aren't.

=== MyFirstShip mod ===
There's links to a few existing mods above but they're very simple things:
* They're just zip files containing some directories and files,
* Their contents are "Added" to Pioneer unless replace something like a script, ship, texture, etc,
* They use the same directory structure as Pioneer.
The example that most players are enthusiastic about is adding a new ship which is the first step on the long road to a total conversion!

(For additional information see: [http://pioneerwiki.com/wiki/Making_your_first_ship Making_your_first_ship] )

To start with we want to make this task easy for ourselves so lets try the following to create a "mod" called "myfirstship":
* Go to wherever you've extracted your Pioneer download to,
* Open the folder "data" and look down the folder names as there's two we're interested in,
** "ships" and "models",
* open the "ships" folder,
** copy and rename the file "wave.lua" to "myfirstship.lua",
** open the file in a text editor and change the following lines like so
*** from: name='Wave Heavy Hypersonic Fighter'
*** from: model='wave',
*** To: name='My First Ship Tutorial'
*** To: model='myfirstship',
*** save your changes to the "myfirstship.lua" file,
*** now go back up to the data folder,
* open the "models" folder, then the "ships" folder,
** copy and rename the folder "wave" to "myfirstship",
** open the "myfirstship" folder,
*** rename the file "wave.model" to "myfirstships.model",
Now run Pioneer with the parameter "-mv myfirstship" so the command line should look like "pioneer.exe -mv myfirstship" this will open it in the modelviewer mode so you can see if everything has worked.

If you run Pioneer as usual then you should be able to go to the ship yard and buy your very own "My First Ship Tutorial" spaceship. Of course it will look like the Wave heavy Hypersonic Fighter, and it will handle like it and be like it in every possible way because it's a perfect copy of it

If you want to make it look different so it's easier to spot then a quick thing you can do is edit the texture "wave.png" in your "/data/models/ships/myfirstship/" folder, perhaps just paint the white a bright red or something which will make it easy to tell that you've changed it.

Obviously we're not done turning all this effort into a mod yet, we've just copied a ship definition ("myfirstship.lua") and the model data for it.

So lets open a new folder window (if on Windows) and:
* Create a new folder somewhere you won't lose it, "My Documents" for windows users or the home folder on Linux etc, call it "tutorial" this time (to avoid confusion),
* In this folder create two more called "ships" and "models",
* With the "models" folder create another folder called "ships",
* by now you should have something that looks like:
** /tutorial/ships/
** /tutorial/models/ships/
* now you're going to _move_ the "myfirstships.lua" file you edited earlier out of the "/pioneer/data/ships/" into the folder "/tutorial/ships/" folder,
* next you must _move_ the folder "myfirstship" from "/pioneer/data/models/ships/" to "/tutorial/models/ships/",
* now create a "readme.txt" file in the "tutorial" folder and add your name to it for now,
* Add everything inside the "tutorial" folder to a zip archive - to do this with 7-zip just selected everything inside the tutorial folder, right-click, open the 7-zip submenu and choose the "Add to archive",
* Make sure that you choose to use "zip" compression and call the archive "myfirstship.zip".
* Finally, put the file "myfirstship.zip" into the "mods" directory - this IS NOT usually where you extracted the Pioneer download.
** On Windows it will be in a folder under your "My Documents"/"Documents" directory for example:
*** "/My Documents/Pioneer/mods/"
* Now double check that you really did MOVE the files and folders, i.e; go back to where you first copied the wave files and folders and make sure that there aren't any "myfirsthip" files or folder there because they should now all be inside the zip file (and safely backed up in the "tutorial" folder).
** The reason this step is important is that you might have made a mistake with the zipping process and the mod is actually now broken, however it will look like it works because the original files are still being found by Pioneer in it's own data directory.
* Finally, the mod should have been packaged up into a zip, it should be in the "mods" directory, and you've made sure the Pioneer data folder is clean.
* Run Pioneer and make sure your mod works.

There are many steps that take just a second or two and lots of bits you can skip once you know what you're doing.

You can have as many ships within a single mod as you like, this technique just gives you a copy of the Wave to edit and play with.

You can, and should, replace it with your own mesh and edit the parameters it uses for thrust and equipment etc.

=== So how does this get my ships into the Pioneer download? ===
Easy, you create your mod, test it, try it out, share it via this forums download area so that others can play it, respond to criticisms to improve it and then ask the Core Team to include it in the main distribution.

This is basically the same process that we go through for programmers submissions but without having to understand Git and GitHub.

It's also more direct to players and fans of the game who often use several mods together to make Pioneer play how they want it too.

Mods

2024-07-11T14:13:34Z

Nozmajner:

== Available Mods ==

=== How to install Mods ===

Since Alpha 22, Pioneer has had support for modding. This is done by allowing core game data to be added to or given preference by data in your userdir (that is, <code>'My Docs/Pioneer/mods'</code> for Windows, <code>'~/.pioneer/mods'</code> for Linux, and <code>'~/Library/Application Support/Pioneer/mods'</code> for OSX).

Once you have downloaded a mod, you simply place the .zip file in the /mods folder described above. There is no need to extract the files.

If a file in a .zip is identically named with one found in the Main pioneer/data directory, the version in the .zip will be used. You can use this fact to easily modify the core game files of Pioneer

This method can be used for any file under the main Pioneer/data directory and applies to ships, buildings and stations, systems, music, fonts, textures, whatever.

However, there are still some mods not packaged in the mod format (.zip). Overtime these are being repackaged by members of the Pioneer community, but in case you have a mod that is not in the correct format then the data in these style of mods must be placed in the correct folder within your main Pioneer/data directory and not in the mods directory described above. But be warned, make a back up of the files you are about to overwrite as this can not be undone and if you do want to return to a 'vanilla' Pioneer, you will have to re-install Pioneer.

== List of known Mods ==

Overtime all the mods here can also be found on the Pioneer Mods page at sourceforge https://sourceforge.net/projects/modsforpioneer/files/Alpha%2030%20mods/

{| class="wikitable"
|+Current known Mod Packages
|-
!Mod Name
!Mod Description
!Author(s)
!Version
!Tested with Pioneer*
!Size
!Download link
|-
|ARGH's original unabridged Extend Sol
|The original unabridged version of extended Sol, with additional dwarfs, many more major asteroids and a high populated system
|ARGHouse
|1.3.1
|20210818
|65.7 kb
|[https://drive.google.com/file/d/1NGTbK1xLdjY4NkN92FtvZc5L6seXlgvW/view?usp=sharing]
|-
|Sol Extended
|Extends the Sol system with additional dwarf planets and spaceports.
|EpsilonEridani
|Work-In-Progress
|20210818
|25.5 kb
|[https://libera.ems.host/_matrix/media/r0/download/matrix.org/BJozxFpJFXnoHiRMQNqpVPiG/00_sol_extended.lua 00_sol_extended.lua]
|-
|Honk
|A simple mod which gives the player the ability to sound various car or ship horns.
|[[User:WKFO|WKFO]]
|1.0
|2021-02-03
|~60 kb
|[https://www.dropbox.com/s/nq0rh3dexibi0pe/honk.zip?dl=0]
|-
|Monolithic Carrier
|A not-that-big bulk cargo ship by Haber Corporation.
|[[User:WKFO|WKFO]]
|0.9
|2022-02-03
|3.3 MB
|[https://www.dropbox.com/s/n2gyaqbt9e5xe79/monocarrier.zip?dl=0]
|-
|Graveyard
|Example of bundling multiple files in a mod. Adds a custom system "Graveyard" (up and to the right of Sol) and a script that does something when you jump there.
|[[User:RobN|RobN]]
|1.0
|20131229
|1kb
|[http://eatenbyagrue.org/f/pioneer/graveyard.zip graveyard.zip]
|-
|RedSol
|Example of replacing a core file. Replaces the system def for Sol with one that has a red star.
|[[User:RobN|RobN]]
|1.0
|Alpha22
|1kb
|[http://eatenbyagrue.org/f/pioneer/redsol.zip redsol.zip]
|-
|Skyboxes
|Nebula backgrounds when in space
|[https://spacesimcentral.com/community/pioneer/i-dont-like-the-skybox/#post-46527 pebblegarden]
|1.0
|2015
|8Mb
|[http://spacesimcentral.com/ssc/index.php?app=core&module=attach&section=attach&attach_id=2563]
|-
|Lanner ship
|The Lanner ship
|unclear
|1.0
|2015
|1.58 Mb
|[https://spacesimcentral.com/community/pioneer-mods/lanner-for-current-pioneer-build/#post-4439]
|-
|-
|Vuzz's Milkyway skybox
|Vuzz's skybox is the most realistic version of the Milky Way for Pioneer.
|[[User:impaktor|impaktor]]
|
|20150912
|1.34MB
|[https://spacesimcentral.com/community/pioneer-mods/vuzzs-milky-way-skybox-mod/#post-4460]
|-
|Moon Heightmap
|Higher res heightmap which replaces the 2mb default heightmap.
|Ae-2222
|1.0
|Alpha26 - - (all current versions)
|33Mb
|[http://wikisend.com/download/359748/moon-hi-res-heightmap.zip moon-hi-res-heightmap.zip]
|-
|Character Generator Upgrade (facegen mod)
|A small upgrade that adds some new hair, eyes, clothing, uniforms, additional accessories and other improvements to the existing character
generator.
|[[User:baobobafet|baobobafet]]
|1.1
|Compatible with most as well as current v20140217
|8Mb
|[http://www.mediafire.com/download/pr55p4r7g87s9uf/facegen_mod_bao_pioneer20140205_bao_V1.1.zip]
|-
|Wave Explorer (ship mod) includes 2 custom pilots
|HiRes2048x2048_Wave-e -see info below or visit https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=89
|[[User:baobobafet|baobobafet]]
|3.5
|v20140217 - (all current versions)
|18Mb
|[http://www.mediafire.com/download/s7d4rqk2fio9gwu/Ship2048x2048_wave-e-w-pilots_bao_pioneer20140217_bao_V3.5.zip]
|-
|-
|Wave Explorer (ship mod) includes 2 custom pilots
|LoRes1024x1024 version of the Wave-e (for increased graphics performance on lower end systems) see info below or visit: https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=89
|[[User:baobobafet|baobobafet]]
|3.5
|v20140217 - (all current versions)
|8Mb
|[http://www.mediafire.com/download/dgxjgo2tf7dgob3/Ship1024x1024_wave-e-w-pilots_bao_pioneer20140217_bao_V3.5.zip]
|-
|-
|Apollo LEM Lunar orbit save file for Alpha26
|Low fuel LEM landing challenge (-w- cargo to jettison) 3 saves with Lunar lander in unpowered orbit over moon with low fuel(requires HighRes.Moon_Apollo.LEM.a26Mod)
|[[User:baobobafet|baobobafet]]
|1.0
|Alpha26
|520kb
|[http://www.mediafire.com/?sy5d6i4n8vz10c4]
|-
|Interstellar Shuttle 1700
|Adds a modified version of the standard shuttle to the ship roster with hyperdrive capability, ecm, missile, cargo/fuel scoop options and more cargo space.(includes a new shuttle skin and solar array for bottom of existing standard shuttle (readme inside zip file)
|[[User:baobobafet|baobobafet]]
|1.3
|Alpha 30
|3560kb
|[http://www.mediafire.com/?46ci6m4677y5wg3]
|-
|Enterprise 1701a (static ship)
|Replaces the Long Range Cruiser (static Ship) with the NCC 1701a "Enterprise" at realistic scale. (readme inside zip file)
|[[User:baobobafet|baobobafet]]
|1.2
|Alpha 30
|1.78mb
|[http://www.mediafire.com/?g4ng4dk46kdns8v]
|-
|-
|Ship Decals Mod 256x256
|This is version 4.0 - includes 8 ship decals. IMAGE here: http://img708.imageshack.us/img708/7146/decalsversion4.png
|[[User:baobobafet|baobobafet]]
|4.0
|Alpha 27-30
|3mb
|[http://www.mediafire.com/?14bchs29dn06nn2]
|-
|-
|-
|Controller Templates
|Not really a Mod - This is for people who have - or are familiar with either Xpadder, 3D Pro Joystick or the G-13 Gameboard. Extreme 3D Pro Joystick Xpadder profile and G-13 gameboard Basic Template - printable key & joystick button reference. Version 3 (More info see above)
|[[User:baobobafet|baobobafet]]
|3.0
|Most Alphas up to 26
|4490kb
|[https://docs.google.com/open?id=0B5dK9aniVGUnM09GRU1qVFJWemM] [http://www.mediafire.com/?ncnh6bpdvna34n2]
|-
|-
|3DPro Joystick Profile
|This is an update supporting the new view keys, for Extreme 3D Pro Joystick Xpadder profile with Template - printable joystick button reference. Version 5 (see pic: http://imageshack.us/a/img822/864/ztf.png )
|[[User:baobobafet|baobobafet]]
|5.0
|Alphas after 28 (all current versions)
|2.31mb
|[http://www.mediafire.com/?btgkn3sjx0ianuu]
|-
|-
|Pioneer default keyboard reference
|In pdf printable format(see PNG pic: http://img203.imageshack.us/img203/2079/5dh.png )
|[[User:baobobafet|baobobafet]]
|v201305.93bao
|Alphas after 28(all current versions)
|7.3mb
|[http://www.mediafire.com/?y5a2sapya7vfhhr]
|-
|-
|Pioneer custom mouse pointers
|Small simple mods containing only custom mouse pointers
|[[User:Joonicks|joonicks]]
|
|20151001
|1-4kb
|[http://joonicks.eu/pioneer_mods]
|}

*'' Version number represents what the module was tested/built against. There is no guarantee that it will work for later versions.''

== List of known Mod Compilations ==

{| class="wikitable"
|+Current known Mod Compilation Packages
|-
!Mod Name
!Mod Description
!Author(s)
!Version
!Tested with Pioneer*
!Size
!Download link
|-
|HiRes Moon & Apollo LEM Mod
|High res Moon heightmap & flyable Apollo Eagle Lander with docs & nav maps.
|contrib by Ae-2222 & [[User:baobobafet|baobobafet]]
|2.0
|Alpha 30
|35.3Mb
|[https://docs.google.com/open?id=0B4TOJEZxkYiVUGZqVklKVEE0WUE]
|}

*'' Version number represents what the module compilation was tested/built against. There is no guarantee that it will work for later versions.''

'''''The who/when/where for mod storage/testing/package compilation is still to be established. As with all things concerning Pioneer it is up to interested parties to resolve this. There is the beginnings of a discussion on the [[Talk:Mods|discussion page]] as not everyone is on the mailing list yet (another could be started on a specific task page if anyone wants to). You need to register to edit pages and contribute.'''''

== Creating A New Ship Mod ==
This is in response to the couple of people who are interested in doing art, perhaps even leading the direction it can go in.

For programmers there's a path which involves creating a GitHub account, forking the Pioneer repository, creating branches, configuring remotes, making commits and submitting Pull Requests.

For Artists and scripters there's another way which is hopefully preferrable for everyone!

To follow this "tutorial" you'll need at least a way of creating ".zip" files, on Windows I use the 7-zip program.

This example is being written for Windows but the ideas are broadly transferrable even if the exact file paths and locations aren't.

=== MyFirstShip mod ===
There's links to a few existing mods above but they're very simple things:
* They're just zip files containing some directories and files,
* Their contents are "Added" to Pioneer unless replace something like a script, ship, texture, etc,
* They use the same directory structure as Pioneer.
The example that most players are enthusiastic about is adding a new ship which is the first step on the long road to a total conversion!

(For additional information see: [http://pioneerwiki.com/wiki/Making_your_first_ship Making_your_first_ship] )

To start with we want to make this task easy for ourselves so lets try the following to create a "mod" called "myfirstship":
* Go to wherever you've extracted your Pioneer download to,
* Open the folder "data" and look down the folder names as there's two we're interested in,
** "ships" and "models",
* open the "ships" folder,
** copy and rename the file "wave.lua" to "myfirstship.lua",
** open the file in a text editor and change the following lines like so
*** from: name='Wave Heavy Hypersonic Fighter'
*** from: model='wave',
*** To: name='My First Ship Tutorial'
*** To: model='myfirstship',
*** save your changes to the "myfirstship.lua" file,
*** now go back up to the data folder,
* open the "models" folder, then the "ships" folder,
** copy and rename the folder "wave" to "myfirstship",
** open the "myfirstship" folder,
*** rename the file "wave.model" to "myfirstships.model",
Now run Pioneer with the parameter "-mv myfirstship" so the command line should look like "pioneer.exe -mv myfirstship" this will open it in the modelviewer mode so you can see if everything has worked.

If you run Pioneer as usual then you should be able to go to the ship yard and buy your very own "My First Ship Tutorial" spaceship. Of course it will look like the Wave heavy Hypersonic Fighter, and it will handle like it and be like it in every possible way because it's a perfect copy of it

If you want to make it look different so it's easier to spot then a quick thing you can do is edit the texture "wave.png" in your "/data/models/ships/myfirstship/" folder, perhaps just paint the white a bright red or something which will make it easy to tell that you've changed it.

Obviously we're not done turning all this effort into a mod yet, we've just copied a ship definition ("myfirstship.lua") and the model data for it.

So lets open a new folder window (if on Windows) and:
* Create a new folder somewhere you won't lose it, "My Documents" for windows users or the home folder on Linux etc, call it "tutorial" this time (to avoid confusion),
* In this folder create two more called "ships" and "models",
* With the "models" folder create another folder called "ships",
* by now you should have something that looks like:
** /tutorial/ships/
** /tutorial/models/ships/
* now you're going to _move_ the "myfirstships.lua" file you edited earlier out of the "/pioneer/data/ships/" into the folder "/tutorial/ships/" folder,
* next you must _move_ the folder "myfirstship" from "/pioneer/data/models/ships/" to "/tutorial/models/ships/",
* now create a "readme.txt" file in the "tutorial" folder and add your name to it for now,
* Add everything inside the "tutorial" folder to a zip archive - to do this with 7-zip just selected everything inside the tutorial folder, right-click, open the 7-zip submenu and choose the "Add to archive",
* Make sure that you choose to use "zip" compression and call the archive "myfirstship.zip".
* Finally, put the file "myfirstship.zip" into the "mods" directory - this IS NOT usually where you extracted the Pioneer download.
** On Windows it will be in a folder under your "My Documents"/"Documents" directory for example:
*** "/My Documents/Pioneer/mods/"
* Now double check that you really did MOVE the files and folders, i.e; go back to where you first copied the wave files and folders and make sure that there aren't any "myfirsthip" files or folder there because they should now all be inside the zip file (and safely backed up in the "tutorial" folder).
** The reason this step is important is that you might have made a mistake with the zipping process and the mod is actually now broken, however it will look like it works because the original files are still being found by Pioneer in it's own data directory.
* Finally, the mod should have been packaged up into a zip, it should be in the "mods" directory, and you've made sure the Pioneer data folder is clean.
* Run Pioneer and make sure your mod works.

There are many steps that take just a second or two and lots of bits you can skip once you know what you're doing.

You can have as many ships within a single mod as you like, this technique just gives you a copy of the Wave to edit and play with.

You can, and should, replace it with your own mesh and edit the parameters it uses for thrust and equipment etc.

=== So how does this get my ships into the Pioneer download? ===
Easy, you create your mod, test it, try it out, share it via this forums download area so that others can play it, respond to criticisms to improve it and then ask the Core Team to include it in the main distribution.

This is basically the same process that we go through for programmers submissions but without having to understand Git and GitHub.

It's also more direct to players and fans of the game who often use several mods together to make Pioneer play how they want it too.

Category:Ships

2023-09-17T13:53:50Z

Nozmajner: /* Ship Chart */

==Ships available in Pioneer==
[[File:Ship chart 2016 0402 800px.png|center|link=https://wiki.pioneerspacesim.net/images/a/a9/Ship_chart_2016_0402.png]]

[[Category:Contents]]

== Ship Chart ==

{| class="wikitable sortable"
! Name
!
! Ship Class
! Laser Mounts
! Missile Capacity
! Cargo Capacity (t)
! Tank Capacity (t)
! DeltaV (full)
! Forward Accel (Full)
! Up Accel (Full)
! Price
|-
|[[AC33_Dropstar|AC33 Dropstar]]
|[[File:Ship_class_medium_freighter.svg|32px]]
|Medium freighter
| 2
| 26
| 480
| 870
| 15,210 km/s (8,390 km/s)
| 2.43 G (2.38 G)
| 2.5 G (2.38 G)
| 1,015,644Cr
|-
|[[Bluenose|Bluenose]]
|[[File:Ship_class_medium_freighter.svg|32px]]
|Medium freighter
| 2
| 2
| 550
| 375
| 18,031 km/s (6,696 km/s)
| 2.4 G (1.81 G)
| 2 G (1. 03 G)
| 518,245Cr
|-
|[[Bowfin_fighter|Bowfin fighter]]
|[[File:Ship_class_medium_fighter.svg|32px]]
|Medium fighter
| 1
| 24
| 6
| 26
| 5,989 km/s (4,471 km/s)
| 3.4 G (3.24 G)
| 3 G (2.1 G)
| 32,822Cr
|-
|[[Coronatrix|Coronatrix]]
|[[File:Ship_class_light_courier.svg|32px]]
|Light shuttle
| 1
| 10
| 16
| 23
| 10,372 km/s (4,933 km/s)
| 2.7 G (2.58 G)
| 2.1 G (2.01 G)
| 46,614 Cr
|-
|[[Deneb|Deneb]]
|[[File:Ship_class_medium_freighter.svg|32px]]
|Medium freighter
| 2
| 2
| 360
| 225
| 19,758 km/s (7,557 km/s)
| 2.1 G (2.06 G)
| 2 G (1.77 G)
| 424,104Cr
|-
|[[Deep_Space_Miner|Deep Space Miner]]
|[[File:Ship_class_medium_freighter.svg|32px]]
|Medium freighter
| 1
| 4
| 3,100
| 2,700
| 13,784 km/s (5,328 km/s)
| 1 G (0.59 G)
| 0.51 G (0.17 G)
| 2,676,331Cr
|-
|[[Kanara_Interceptor|Kanara Interceptor]]
|[[File:Ship_class_light_fighter.svg|32px]]
|Light fighter
| 1
| 4
| 8
| 5
| 6,852 km/s (4,143 km/s)
| 3.95 G (3.1 G)
| 2 G (1.33 G)
| 26,409Cr
|-
|[[Lodos|Lodos]]
|[[File:Ship_class_medium_freighter.svg|32px]]
|Medium freighter
| 2
| 2
| 2,800
| 2,100
| 23,518 km/s (8,058 km/s)
| 2.3 G (1.65 G)
| 2 G (0.56 G)
| 2,541,352Cr
|-
|[[Lunar_Shuttle|Lunar Shuttle]]
|[[File:Ship_class_light_passenger_shuttle.svg|32px]]
|Light passenger shuttle
| 1
| 1
| 30
| 25
| 4,788 km/s (2,752 km/s)
| 1.89 G (1.68 G)
| 3 G (1.2 G)
| 35,002Cr
|-
|[[Malabar|Malabar]]
|[[File:Ship_class_medium_passenger_transport.svg|32px]]
|Medium passenger transport
| 2
| 6
| 1,600
| 2,000
| 16,990 km/s (6,673 km/s)
| 1.8 G
| 2 G (0.61 G)
| 2,219,853Cr
|-
|[[Mola_Mola|Mola Mola]]
|[[File:Ship_class_light_freighter.svg|32px]]
|Light freighter
| 1
| 2
| 80
| 40
| 11,815 km/s (4,001 km/s)
| 2.7 G (2.03 G)
| 2.5 G (1.42 G)
| 81,063Cr
|-
|[[Mola_Ramsayi|Mola Ramsayi]]
|[[File:Ship_class_medium_freighter.svg|32px]]
|Medium freighter
| 2
| 3
| 900
| 473
| 14,231 km/s (5,355 km/s)
| 2.2 G (2.04 G)
| 2.2 G (1.81 G)
| 814,201Cr
|-
|[[Natrix|Natrix]]
|[[File:Ship_class_light_freighter.svg|32px]]
|Light freighter
| 2
| 2
| 80
| 60
| 14,192 km/s (6,660 km/s)
| 1.8 G (1.42 G)
| 1.8 G (0.45 G)
| 96,181Cr
|-
|[[Nerodia|Nerodia]]
|[[File:Ship_class_medium_freighter.svg|32px]]
|Medium freighter
| 2
| 2
| 2,500
| 1,000
| 25,625 km/s (6,038 km/s)
| 1.5 G (1.38 G)
| 1 G (0.47 G)
| 2,059,372Cr
|-
|[[Pumpkinseed|Pumpkinseed]]
|[[File:Ship_class_light_courier.svg|32px]]
|Light courier
| 1
| 4
| 10
| 9
| 9,756 km/s (4,373 km/s)
| 4.2 G
| 3.1 G (2.27 G)
| 36,151Cr
|-
|[[Sinonatrix|Sinonatrix]]
|[[File:Ship_class_light_courier.svg|32px]]
|Light courier
| 1
| 4
| 30
| 36
| 13,227 km/s (7,232 km/s)
| 3.9 G (2.1 G)
| 2 G (1.85 G)
| 62,707Cr
|-
|[[Skipjack|Skipjack]]
|[[File:Ship_class_medium_courier.svg|32px]]
|Medium courier
| 2
| 8
| 140
| 135
| 18,685 km/s (7,617 km/s)
| 3.2 G (2.25 G)
| 2.6 G
| 204,838Cr
|-
|[[Storeria|Storeria]]
|[[File:Ship_class_medium_freighter.svg|32px]]
|Medium freighter
| 2
| 1
| 1,500
| 1,000
| 13,073 km/s (4,545 km/s)
| 1.7 G (1.46 G)
| 1.5 G (0.45 G)
| 1,219,170Cr
|-
|[[Varada|Varada]]
|[[File:Ship_class_light_courier.svg|32px]]
|Light courier
| 1
| 0
| 5
| 5
| 7,217 km/s (3,932 km/s)
| 4 G (1.64 G)
| 2.6 G (1.16 G)
| 20,403Cr
|-
|[[Vatakara|Vatakara]]
|[[File:Ship_class_medium_freighter.svg|32px]]
|Medium freighter
| 2
| 6
| 2,900
| 2,200
| 21,036 km/s (7,274 km/s)
| 2 G (1.94 G)
| 2 G (1.05 G)
| 2,655,296Cr
|-
|[[Venturestar|Venturestar]]
|[[File:Ship_class_medium_freighter.svg|32px]]
|Medium freighter
| 2
| 6
| 880
| 700
| 20,071 km/s (7,793 km/s)
| 2.2 G
| 2.5 G
| 1,127,263Cr
|-
|[[Wave|Wave]]
|[[File:Ship_class_medium_fighter.svg|32px]]
|Medium fighter
| 2
| 12
| 16
| 22
| 10,361 km/s (6,852 km/s)
| 4.5 G (4.32 G)
| 4 G (3.09 G)
| 55,305Cr
|-
|[[Xylophis|Xylophis]]
|[[File:Ship_class_light_cargo_shuttle.svg|32px]]
|Light cargo shuttle
| 1
| 0
| 10
| 4
| 5,819 km/s (2,340 km/s)
| 1.5 G
| 2 G (1.34 G)
| 16,873Cr
|}

== Ship classes ==

{|
!
! Heavy
! Medium
! Light
|-
|Fighter || [[File:Ship class heavy fighter.svg|48px]] || [[File:Ship class medium fighter.svg|48px]] || [[File:Ship class light fighter.svg|48px]]
|-
|Courier || [[File:Ship class heavy courier.svg|48px]] || [[File:Ship class medium courier.svg|48px]] || [[File:Ship class light courier.svg|48px]]
|-
|Passenger Shuttle || [[File:Ship class heavy passenger shuttle.svg|48px]] || [[File:Ship class medium passenger shuttle.svg|48px]] || [[File:Ship class light passenger shuttle.svg|48px]]
|-
|Passenger Transport || [[File:Ship class heavy passenger transport.svg|48px]] || [[File:Ship class medium passenger transport.svg|48px]] || [[File:Ship class light passenger transport.svg|48px]]
|-
|Cargo Shuttle || [[File:Ship class heavy cargo shuttle.svg|48px]] || [[File:Ship class medium cargo shuttle.svg|48px]] || [[File:Ship class light cargo shuttle.svg|48px]]
|-
|Freighter || [[File:Ship class heavy freighter.svg|48px]] || [[File:Ship class medium freighter.svg|48px]] || [[File:Ship class light freighter.svg|48px]]
|}

Amphiesma

2023-09-17T13:50:41Z

Nozmajner:

{{Infobox_Ship
|name = Amphiesma
|type = Light Courier [[File:ship_class_light_passenger_shuttle.png]]
|sketchfab = <sketchfab>725a0a7196a74660922a6910d46a4022</sketchfab>
|manufacturer = OPLI-Barnard Inc.

|price = 38,470
|hull_mass = 18
|capacity = 38
|cargo_capacity = 14
|min_crew = 1
|max_crew = 2

|max_engine = no
|hyperdrive_class = 0
|max_scoop_mounts = 2
|max_cabins = 2
|max_weapons = 1
|max_missiles = 2

|fuel_tank_mass = 24
|effective_exhaust_velocity = 6,900
|deltav_empty = 5,846
|deltav_full = 2,461

|forward_accel_empty = 2.7
|forward_accel_full = 2.29
|reverse_accel_empty = 2.1
|reverse_accel_full = 1.17
|up_accel_empty = 2.1
|up_accel_full = 1.78
|down_accel_empty = 1.17
|down_accel_full = 1.17
|lateral_accel_empty = 1.17
|lateral_accel_full = 1.17
|angular_accel_empty = -
|angular_accel_full = -

|atmo_shield = no
|atmo_pressure_limit = 3.1
|lift_coef = 0.1
|aero_stability = 0.35
|front_drag = 0.27
|side_drag = 0.45
|top_drag = 0.96
}}

== Note: This ship has been removed, and worked into the [[Coronatrix]]. The Amphiesma will eventually return as a Light Freighter ==

== Description ==

Smaller and relatively faster sister of the Natrix. It's a no-frills multi-role craft mainly for courier and small cargo tasks, but it often used as a police patrol craft in small outback systems. It has been manufactured with penal labor in one of the Barnard's star penitentiary's shipyard for about 150 years now. It received periodical minor design updates, but the chassis is practically the same. As with any OPLI-Barnard ships, Amphiesma is easy to maintain, but it needs frequent maintenance. Upgrading and tuning is equally simple, but it's not really popular in tuner circles. It's crew compartment is equally simplistic, but it can be easily upgraded to be more comfortable.

== Role ==

It's main role is medium range intra-system shuttle and courier. With a hyperdrive upgrade it can be a decent mid-range courier especially if your finances are tight. It's tuning and upgrading capability makes it a popular racing craft. Most of the time it receives over-sized engines, larger heat sinks and a larger fuel tank at the expense of cargo and crew space. It's widely used in Solar Federation space, and it's popular in independent systems too, due to it's simpleness. It's not a common sight in CIW space. In fact OPLI-Barnard ships are disliked because they are produced with penal labor. It's a popular smugglers ship too.

== Notes ==

Amphiesma could prove to be a dependable and likable craft even in the hands of an inexperienced pilot, if taken care properly. It has a wide margin of error, so it's ideal starter craft. It's main drawback is it's mediocre performance and high maintenance need, but most of these jobs are easy to do even without a proper workshop. They don't get stolen too much.

Coronatrix

2023-09-17T13:48:15Z

Nozmajner: Created page with "{{Infobox_Ship |name = Coronatrix |type = Ship class File:ship_class_light_courier.png |sketchfab = <sketchfab>43b06a832e954c4182434ced57e91015</sketchfab> |manufacturer =..."

{{Infobox_Ship
|name = Coronatrix
|type = Ship class [[File:ship_class_light_courier.png]]
|sketchfab = <sketchfab>43b06a832e954c4182434ced57e91015</sketchfab>
|manufacturer = OPLI-Barnard Inc.

|price = 46,614.00
|hull_mass = 18
|capacity = 30
|cargo_capacity = 16
|min_crew = 1
|max_crew = 1

|max_engine = yes
|hyperdrive_class = 2
|max_scoop_mounts = 2
|max_cabins = 1
|max_weapons = 1
|max_missiles = 10

|fuel_tank_mass = 23
|effective_exhaust_velocity = 12,600,000
|deltav_empty = 10,372
|deltav_full = 4,933

|forward_accel_empty = 2.7
|forward_accel_full = 2.58
|reverse_accel_empty = 2.1
|reverse_accel_full = 1.32
|up_accel_empty = 2.1
|up_accel_full = 2.01
|down_accel_empty = 1.17
|down_accel_full = 1.17
|lateral_accel_empty = 1.17
|lateral_accel_full = 1.17
|angular_accel_empty = -
|angular_accel_full = -

|atmo_shield = yes
|atmo_pressure_limit =3.2
|lift_coef = 0.1
|aero_stability = 0.35
|front_drag = 0.27
|side_drag = 0.45
|top_drag = 0.96
}}

== Description ==

Smaller and relatively faster sister of the Sinonatrix. It's a no-frills craft mainly for courier and small cargo tasks, but it often used as a police patrol craft in small outback systems. It has been manufactured with penal labor in one of the Barnard's star penitentiary's shipyard for about 150 years now. It received periodical minor design updates, but the chassis is practically the same. As with any OPLI-Barnard ships, the Coronatrix is easy to maintain, but it needs frequent maintenance. Upgrading and tuning is equally simple, but it's not really popular in tuner circles. It's crew compartment is equally simplistic, but it can be easily upgraded to be more comfortable.

== Role ==

It's main role is medium range intra-system shuttle and courier. With a hyperdrive upgrade it can be a decent mid-range courier especially if your finances are tight. It's tuning and upgrading capability makes it a popular racing craft. Most of the time it receives over-sized engines, larger heat sinks and a larger fuel tank at the expense of cargo and crew space. It's widely used in Solar Federation space, and it's popular in independent systems too, due to it's simpleness. It's not a common sight in CIW space. In fact OPLI-Barnard ships are disliked because they are produced with penal labor. It's a popular smugglers ship too.

== Notes ==

The Coronatrix could prove to be a dependable and likable craft even in the hands of an inexperienced pilot, if taken care properly. It has a wide margin of error, so it's ideal starter craft. It's main drawback is it's mediocre performance and high maintenance need, but most of these jobs are easy to do even without a proper workshop. They don't get stolen too much.

[[File:Coro_on_pad_01.png|800px]]

[[File:Coro_rom_cockpit_1s.png|800px]]

[[File:Coro_n_pad_03s.png|800px]]

[[File:Coro_on_pad_04s.png|800px]]

[[File:Coro_on_pad_05s.png|800px]]

File:Coro rom cockpit 1s.png

2023-09-17T13:45:28Z

Nozmajner: A Coronatrix chasing another

== Summary ==
A Coronatrix chasing another

File:Coro on pad 05s.png

2023-09-17T13:44:50Z

Nozmajner: Coronatrix on the landing pad

== Summary ==
Coronatrix on the landing pad

File:Coro on pad 04s.png

2023-09-17T13:43:52Z

Nozmajner: Coronatrix and Sinonatrix on the landing pad

== Summary ==
Coronatrix and Sinonatrix on the landing pad

File:Coro n pad 03s.png

2023-09-17T13:43:06Z

Nozmajner: Coronatrix and Sinonatrix on the landing pad

== Summary ==
Coronatrix and Sinonatrix on the landing pad

File:Coro on pad 01.png

2023-09-17T13:40:25Z

Nozmajner: Coronatrix on the landing pad

== Summary ==
Coronatrix on the landing pad

File:Coronatrix silhouette.png

2023-09-17T13:35:59Z

Nozmajner:

FAQ

2023-05-06T12:16:33Z

Nozmajner: /* What is the system requirement for runing the game? */ Upped opengl from 3.1 to 3.2

= Frequently Asked Questions =

== About the Game ==

=== What is Pioneer? ===

Pioneer is a freeform single player space adventure in the spirit of [https://en.wikipedia.org/wiki/Frontier:_Elite_II Frontier: Elite II].

=== Is this a game or a simulation? ===

Frontier was a game, but with a newtonian flight model and a slightly more scientific flavour to the universe than usually in space games. Pioneer follows this same path.

=== Can I play multiplayer online? ===

There will be no multiplayer. This does not rule out the possibility of minor network features, but multiplayer as it is commonly known is not compatible with the core mechanics of Pioneer. See for instance [[Network_features|Network features]], and [[ServerAgent|ServerAgent]] for more, or our dev forum [https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=216 here]. Pioneer will never have multiple players in different ships, as this is incompatible with time acceleration feature. For comparison: the Elite Dangerous dev-team chose to prioritize multiplayer over Newtonian mechanics, and make it more like the original Elite, we choose to stay true to the core concepts of Frontier Elite II, which is Newtonian mechanics, with time acceleration.

=== Can I colonize planets, build space stations or conquer the universe? ===

No, these are out of the game scope. While the game universe might not stay static for the duration of a game, the player can not generally influence major events.

=== Can I walk around space stations and planets? ===

No, you cannot exit your ship. The ship is always your avatar. The development team does have [https://forum.pioneerspacesim.net/viewtopic.php?f=3&t=454 aspirations] to push in this direction, for future versions.

=== Is the universe pre-defined or randomly generated? ===

There are millions of stars in the galaxy. A few hundred on them are based on real-world astronomic catalogues. some of the planets (obvious ones being in the Sol system) are pre-defined, but most things are procedurally generated. This means that a planet does not exist until you actually visit it, but it will be generated the same way for every player.

=== Can I hire crew for my ship? ===

Yes. You can hire crew. But they don't do very much at the moment.

=== Are savegames compatible between releases? ===

The development of the game can happen in sudden bursts, some of which change the game universe, or save/load routine, such that old saves are blocked from loading, lest the game might crash. The player can start a new game, and "give" themselves back money, kills, reputation, ship, as it was in the old save, by using the [[Lua_Console|lua console]]. You probably want to keep a copy of your old Pioneer, to read off your player statistics, write them down, then download and open the latest Pioneer version, and give yourself those stats. Note: it's only cheating if you give yourself back more than you had, remember: God is watching over your shoulder!

=== Are savegames compatible between Mods? ===

Again as with savegames between different versions of pioneer, compatibility between mods can not be guaranteed. It all depends on what mods you have installed.

=== Where is star system X from Frontier? Can I buy ship Y? ===

Although Pioneer started out as a clone of Frontier, it no longer is, thus references to the Frontier universe have been removed, and we aim at making Pioneer far better than Frontier. Thus, you will have to figure out new trade routes! But don't worry, Newtonian physics will remain, as well as single player.

=== Can I build and control a fleet, or a factory, or run/own a station? ===

No, this is not on the agenda, and none of the developers are motivated to push for this, but who knows, perhaps in the future, some skilled developer, who knows how to implement this in a way that makes game play interesting, joins the dev-team. However, we are currently planning to have mining machines (like in Frontier Elite II), and ship system management (heat, energy, repair components, etc.) on the agenda.

== Gameplay ==

=== How do I take screenshots? ===

Ctrl+Printscreen saves .png files in the same directory where the game .ini and savegames are. You can cycle through full HUD/HUD without labels and cursor/No HUD and cockpit using TAB as described in [http://pioneerwiki.com/wiki/Keyboard_and_mouse_controls#In_flight [1]].

=== How do I record a video? ===
To record video directly from Pioneer you will need to add the line RecordVideo=1 somewhere within your config.ini file. Then once ingame you can press Ctrl+ScrLk to start or stop recording.

=== How do I find star X in the star map ===

First it is important to note that just like in real life, names are not unique. The star map allows the player to search for either name or coordinates of a system. The search is done in the local region of the currently selected system.

Thus a standard way of finding a system is to type in the name in the search field in the star map (generally refereed to as "sector view"). If you know the system is within a few ly from your position, then have your current location selected when you do the search, since it only does a "local" search in space. If the search fails, go to the sector where the star is supposed to be, either by typing the coordinates into the search field, or by using arrows, mark a nearby star in that system, and do another search. You can scroll the star map super fast by holding in the Shift key.

=== I have a Taxi mission to system X, but which starport? ===

For Taxi missions any starport will do, as long as you dock before the deadline.

=== Starsystem names are not unique ===

This is not a bug, space is big, and just here on Earth it is quite common with cities and villages sharing the same name, sometimes quite close.

=== I picked up a mission to a starport in a system, but when I search for the system, it seems that it doesn't have the destination starport, or even uninhabited. ===

As mentioned above, there could be multiple systems with the same name. Each mission states the coordinates (Sirius (1,0,-1) for example) of the destination system, and you can enter them into the search field on the sector map, to find the correct system.

=== I end up "a big number" AU away from the star when I hyper jump to a system ===

This happens in binary star systems. You can select the star you want to jump to from the [[Manual#System_info|System View]].

== Technical FAQ ==

=== What is the system requirement for runing the game? ===

Current "stable" (if indeed we have one) [https://pioneerspacesim.net/page/download/ release] is 2021-02-03, and is built on Ubuntu 20.04 Linux machine and a Windows machine, and requires OpenGL 3.2 compatible hardware.
We also offer a [https://flathub.org/apps/details/net.pioneerspacesim.Pioneer flatpak] script. If you want to compile the game, then please install requirements listed in [https://github.com/pioneerspacesim/pioneer/blob/master/COMPILING.txt COMPILING.txt]

=== Installing the game ===

The releases are made when developers feel it's been "a while", relative to the number of new additions that have been added that they want players to enjoy / playtest. Releases for Windows and GNU/Linux are now (2021) found on the [https://github.com/pioneerspacesim/pioneer/releases github releases page], and Linux versions are currently built on a [https://github.com/pioneerspacesim/pioneer/blob/master/.github/workflows/build-ci.yml Ubuntu 20.04] (virtual) machine, thus that system should not have any compatibility issues.

==== Build from source ====

The best way to ensure your pioneer is compatible with you Linux system, and of latest, "bleeding edge", version is to install from source. This is described in [https://github.com/pioneerspacesim/pioneer/blob/master/COMPILING.txt COMPILING.txt]. Playing this way is also the best way you can help the developers, i.e. find and report the latest bugs you encounter.

==== Installing using flatpak ====
If you're having trouble getting pioneer to run on your Linux distribution, and you do not want to build from source, then we recommend [https://flathub.org/apps/details/net.pioneerspacesim.Pioneer flatpak] that resolves dependencies for you. Follow [https://flatpak.org/setup/ this] on how to use it, if need be. E.g. on Linux Mint these images are already [https://flatpak.org/setup/Linux%20Mint included] by default in their app store. On other distributions it is at most needed to install flatpak and then issue, from a terminal:

flatpak install net.pioneerspacesim.Pioneer

==== Error loading shared libraries (e.g.libassimp.so.<x>) ====

The linux version of Pioneer is build on a Ubuntu 20 machine. Currenlty (2021-05), this can cause some debian machines, that have an older verison of libassimp, to throw an error, e.g.:

error while loading shared libraries: libassimp.so.5:
cannot open shared object file: No such file or directory

This is fixed either by building pioneer from source, against the shared libraries that are on your particular machine (then you get an even more updated "bleeding edge" build of pioneer!), or install the correct version of the package that is missing: https://packages.debian.org/unstable/libassimp5 (or try to find an older release)

==== Where is the Mac version? ====

Pioneer's development team is mainly on Linux and Windows, and does currently not have the ability to build and maintain a Mac version. To build a Mac release we actually need access to a Mac machine, which, unfortunately, none of the developers currently have. If you have a Mac which can compile and upload pioneer for us on a regular basis, then please contact us (IRC).

Update: OSX builds have been discontinued due to lack of maintainer and Apple's deprecation of OpenGL. We do not intend to offer them in the near future - we will need to migrate the rendering path to Vulkan and have enough of a user base to warrant spending time on OSX compatibility.

==== Where do I find nightly builds of Pioneer ====

They're available on github [https://github.com/pioneerspacesim/pioneer/actions?query=workflow%3A%22Build+Pioneer%22+branch%3Amaster actions page]. Note: thuis currently requires [https://github.com/actions/upload-artifact/issues/51 login to github] to download. A new build is made each time a pull request is merged with new code, and also each proposed pull request is built, which is a great way to test features prior to them being merged into the master branch.

==== Where do I find older versions of Pioneer ====

You can find older versions starting from December 2014 (2014-12-05) on our [http://sourceforge.net/projects/pioneerspacesim/files sourceforge] page. 2014-11-18 was the last version supporting OpenGL 2, between 2014-11-19 to 2014-12-07 Pioneer required OpenGL 3.2. From 2014-12-08 only OpenGL 3.1 is required. Over at [http://www.moddb.com/games/pioneer/downloads moddb] they have windows version going further back in time.

==== How do I play on old computer ====

Your best bet is to use an older version, or if you have another computer you can use virtualGL to let pioneer run on a remote (modern) machine and forward it to an older machine, as described on the [https://spacesimcentral.com/community/pioneer/a-request-for-instrumental-pioneer/ forum], this command works best (but combat/action is too laggy, so it is only a viable solution for playing peaceful missions):

vglconnect user@server_executing_pioneer_ip -CY -p SSH_port 'cd /path_of_pioneer_compilation_folderme/ && ./pioneer'

=== How/where do I report my bug/crash ===

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 issue tracker], but you can also stop by the [[IRC|IRC channel]]. When you report it, always mention pioneer verision (shown in lower right hand corner in the starting screen [https://user-images.githubusercontent.com/18342621/118388006-6ee03080-b62a-11eb-8d48-bf66f0820d5f.png png])

When having problems with graphics, or pioneer not starting/crashing, please attach the files '''output.txt''' and '''opengl.txt''' from the pioneer [http://pioneerwiki.com/wiki/FAQ#Where_is_the_configuration_file.2C_saved_games.2C_screenshots.3F config folder] in your home folder / My Documents folder. If you didn't get the '''output.txt''' file, then make sure '''RedirectStdio=1''' in '''config.ini'''.

It is important to include as much of the following information as possible in each issue report, much of this is available to use from the '''output.txt''' and '''opengl.txt''' but if you cannot attach them then please tell us:

*The version of pioneer you are trying to run (''build date or ingame version number'')
*What operating system you are running, Windows XP/Vista/7/8/10, Linux (''what distribution''), OSX.
*Your computers system specifications - CPU / RAM / Graphics card.
*Whether you have downloaded it from our site, or if you are building it from the source code.

=== Debug backtrace ===
When the game crashes, one of most valuable pieces of information you can provide the development team, is a backtrace. To get a backtrace, the game must have been compiled in debug mode, and then started through a debugger. If you compile the game yourself, from source, it will by default build a debug mode.

==== Windows Visual Studio ====

* Compile the game in debug mode (should be the default setting).
* After building it, press F5 or go to Debug->Start Debugging. Note: it will run slowly, starting a new game or loading a new one in particular. That's normal.
* Instead of a full out crash, you'll get a freeze and it should automatically switch back to Visual Studio. If it freezes and doesn't switch back, do that manually.
* At that point, Visual Studio should have opened a couple new panes/sub windows at the bottom. One of these is 'Call Stack.' Right click in it, select 'Select All.' Then right click in there again and select 'Copy with source paths.'
* Then paste that information into the bug-report (preferably as a [https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet code formatted block])
* After that you can Debug->Stop to shut down Pioneer again.

==== Linux gdb ====
* Make sure gdb (The GNU Debugger) is installed on you system (available in package managers of all Linux distributions).
* Then start pioneer by prefixing the command with gdb followed by the normal command to start pioneer. Eg. if you normally do:

cd pioneer/
./build/pioneer

then to run in debug mode, you need to run it through gdb:

cd pioneer/
gdb ./build/pioneer

then from inside gdb, type "run", which starts pioneer. Play until you get the crash, which drops you out to gdb again. Type 'bt' or 'backtrace' in the gdb command line, and save the output to you bug-report.

=== Where is the configuration file, saved games, screenshots? ===

*Windows: My Documents\Pioneer
*OS X: /Users/your_username/Library/Application Support/Pioneer
*Linux: /home/your_username/.pioneer

=== New pioneer version doesn't start ===
This could be because new configuration is incompatible with the local, try remmoving your pioneer configuration folder, such that the game will auto-generate new configuration file anew.

=== I'm getting graphical issues ===

Such as wrong textures, ships missing from the view, text display glitches. '''Updating the display drivers usually solve these problems.'''

These usually occur on older graphics adapters, or because of outdated GPU drivers. Not too old NVidia and ATI cards are usually enough to play the game, but integrated GPUs are usually not enough.

=== I'm getting graphical issues, such as snow-like sky and transparent terrain ===

This is probably caused by the eclipse shader which isn't supported by some open source graphic drivers. You could install the proprietary drivers, if available, or disable the eclipse effect by adding DisableEclipse=1 to your pioneer configuration file (config.ini).

=== My OpenGL Version is below 3.1, "Pioneer cannot run on your graphics card" ===

UPDATE: Pioneer dropped 2.1 support in September, 2018. You need to checkout and compile a version prior to this, and do:

Open your pioneer configuration file, and set: "RendererName=Opengl 2.1". This should allow pioneer to run, provided your hardware supports OpenGL 2.1, which it should if you were able to run Pioneer up until 2014-11-18 when support was dropped. Note, support for multiple renderers was added 2017-03-03, i.e. both OpenGL 2.1 and 3.1; however, you need to edit your configuration file to select the proper one, as no auto-detection is done. Actually, if your hardware isn't extraordinarily old, OpenGL 3.1 should be supported if you update your drivers.

You can also find older versions (pre 20141119) on [http://www.moddb.com/games/pioneer/downloads moddb].

=== I see blank untextured Gas Giants and I'm using an ATI graphic card under GNU/Linux with open source drivers (Mesa R600) ===

With chipsets using the R600 gallium drivers the shader fails to compile. There is a workaround that uses less noise octaves. This produces less detailed texture maps for the gas/ice giants but they still look good and at least the program runs.

Try setting <code>AMD_MESA_HACKS=1</code> in ~/.pioneer/config.ini or disable GPU jobs entirely by setting <code>EnableGpujobs=0</code>

=== I'm getting text rendering artefacts ===

Some system monitoring HUD utilities, like MSI Afterburner, and Steam overlay can cause distorted text rendering. Try switching them off. 

=== The game freezes at the intro screen ===

If you cannot start the game at all, edit the configuration file and change value DisableShaders to 1.

=== The game crashes on start with an error message about imgui_draw.cpp ===

Check if any parent folder of Pioneer has any accented letters (e.g éáűúóü etc.). If so, copy the game to somewhere, where there's none of these in the folder tree.

=== The game crashes after the loading screen. I'm using ATI free drivers on GNU/Linux. ===

If you are getting a GL_INVALID_ENUM in console, could be because some ships uses textures in a format that, because of patents, is not included in the main mesa package. Search for libtxc-dxtn or libtxc_dxtn in your distribution and install it.

=== The game hangs when I turn on the ''Enable Cockpit (EXPERIMENTAL)'' option ===

It's because it's an experimental feature right now, infrastructure mostly. You need a cockpit model for to be able to use it.

You can find one heavily WIP one posted on the Community Forums. Note that it's a highly experimental feature right no, so please treat it accordingly.

=== My joystick is "drifting" ===

It's recommended that you calibrate your joystick using the OS facilities (Joystick Settings on Windows, jstest-gtk on linux) as this fixes 99% of all issues with incorrectly configured joysticks. However, if you want to adjust specific parameters for each joystick axis, support for customizable deadzone and sensitivity is available through the configuration file. Open config.ini and adjust the deadzone (DZ) and sensitivity exponent curve (CV) values of the corresponding axis to your liking.

; example joystick configuration
[Joystick.03000000a30600006404000000010000]
Axis0=DZ0.0 CV1.0
Axis1=DZ0.0 CV1.0
Axis2=DZ0.0 CV1.0
Axis3=DZ0.0 CV1.0
Name=Saitek Cyborg USB Stick

=== I'm getting poor performance ===

The heaviest part of the game is planetary terrain generation. Turn down the "Detail distance" and "Fractal detail" settings, they have the most impact for performance. Reducing screen resolution is also recommended, this can be done in the [[Settings_Menu|Settings Menu]], or manually to a custom values by editing your personal configuration file, on Linux: <code>~/.pioneer/config.ini</code>. On Windows: <code>Documents/pioneer/config.ini</code> Look for <code>ScrHeight</code> and <code>ScrWidth</code> entries. Also consider reducing number of buildings in cities.

=== I've enabled anti-aliasing in the config file, but it does not work ===

Make sure the AA settings are not overridden by your graphics card settings, on NVidia AA should be set to "application controlled" mode.

=== Full screen mode is incorrectly scaled ===

If you are on Windows, try:
<pre>Sounds like windows 7 desktop-scaling issues.
Try adding some compatability modes to the Pioneer.exe.
Right click it and Choose properties -> Compatability -> Tick
Disable desktop scaling, and Disable desktop composition.
</pre>

== Development ==

=== What's the history of Pioneer ===

The project started in 2008 by Tom Morton, and was [https://web.archive.org/web/20150326115725/http://spacesimcentral.com/ssc/topic/742-pioneer-new-gpl-frontier-elite-2-style-game/ announced in 2010] on the Space Sim Central forum (for space games), and on [https://forums.frontier.co.uk/threads/the-pioneer-thread.1596/ frontier forum]. For more history, see [http://www.rockpapershotgun.com/2011/12/06/back-to-frontier-pioneer/ Rock Paper Shotgun article], and [[Media_Coverage]]

=== How much development is being made? ===

Development is sporadic, but no month goes by without some change to the source, fixing bugs, cleaning up code, introducing new content and/or features; see [https://github.com/pioneerspacesim/pioneer/blob/master/Changelog.txt Changelog.txt]. All contributors work on pioneer for free when they have time and motivation.

=== What's the deal with the inconsistent UI interface? ===
Basically, Pioneer has during the 2013-2020s had up to three different, simulteneous, UI systems, for a background and screen shots, please refer to:
[[GUI_introduction#Background_history]]

=== Do you accept contributions? ===

Hell yes! Pioneer is not any one persons personal project. It is the sum of the contributions made by the people who play and care about the continued development of the game. See: [[How_you_can_contribute|How to contribute]].

Pioneer Wiki

2023-02-03T09:20:43Z

Nozmajner: /* Community */ Adding our mastodon

Pioneer is a space adventure game set in the Milkyway galaxy at the turn of the 33rd century. The game is open-ended, and you are free to explore the millions of star systems in the game. You can land on planets, slingshot past gas giants, and burn yourself to a crisp flying between binary star systems.

If you are new to pioneer you may want to know [[How_to_start|how to start]].

*[https://pioneerspacesim.net/page/download/ Download Pioneer] for Windows and Linux

Please make this wiki nice. Add stuff about mods, dev, whatever. Be awesome! [[Getting_started|How to get started]].

----

{| width="100%"
|-
| style="background:#bbffbb; border:2px solid #99ee99; padding:2px 2px 4px 4px; vertical-align: top" width="33%" |
=== Community ===

*[https://pioneerspacesim.net/ Pioneer Space Sim Homepage]
*[https://github.com/pioneerspacesim/pioneer/ Main Github repository]
*[https://spacesimcentral.com/community/pioneer/ Community forum]
*[https://forum.pioneerspacesim.net/ Developer forum]
*[https://www.reddit.com/r/pioneerspacesim Pioneer Space Sim on Reddit]
*[https://pioneerspacesim.itch.io/pioneer Pioneer Space Sim on itch]
*[[IRC|Pioneer Space Sim on IRC, Channel: #pioneer, network: libera.chat]] (where devs hang out)
*[https://twitter.com/pioneerspacesim @pioneerspacesim] on Twitter
*[https://mstdn.games/@pioneerspacesim @pioneerspacesim] on Mastodon at [https://mstdn.games mstdn.games]
*[https://www.youtube.com/channel/UCbFD5Oxc1C9zxqnF4OitGjQ Pioneer Space Simulator] on Youtube
*[https://discord.com/invite/RQQe3A7 discord]

----

*[[Manual|Basic Manual]]
*[[Flight_UI|Flight UI]]
*[[Keyboard_and_mouse_controls|Keyboard and mouse controls]]
*[[Tutorials|Tutorials]] (Outdated and WIP)
*[[Mission_Types_and_BBS|Mission Types and BBS]]
*[[Settings_Menu|Settings Menu]]
*[[FAQ|FAQ]]
*[[Media_Coverage|Media Coverage]]

| style="background:#fff9b1; border:2px solid #f0fe66; padding:2px 2px 4px 4px; vertical-align: top" width="33%" |

=== The Pioneer Universe ===

*[[Pioneer_Universe|Pioneer Universe]]
*[[:Category:Ships| Ships]] (work in progress)
*[[:Category:Manufacturers| Manufacturers]] (work in progress)
*[[Places_of_interest|Places of interest]]
*[[Ship_Equipment|Ship Equipment]] (work in progress)

|}

 

{| width="100%"
|-
| style="background:#f0f0ff; border:2px solid #c6c9ff; padding:2px 2px 4px 4px; vertical-align: top" width="33%" |

=== Content Creation ===

*[[Mods|Mods]]
*[[Scripting_and_Mission_Creation|Scripting and Mission Creation]]
*[[Custom_Systems|Custom Systems]]
*[[Design_and_Concept_art|Design and Concept art]]
*[[Modeling,_Texturing,_Graphics_Design|Modeling, Texturing, Graphics Design]]
*[[Music_and_Sound|Music and Sound]]
*[[Translations|Translations]]
*[[Licensing|Licensing]]

| style="background:#fff3e3; border:2px solid #ffc9c9; padding:2px 2px 4px 4px; vertical-align: top" width="33%" |
=== Development ===

*[[Design_Scope|Game Scope]]
*[[How_you_can_contribute|How you can contribute]]
*[[Getting_Started_with_Development|Getting Started with Development]]
**[[How_to_communicate|How to communicate]]
**[[Using_git_and_GitHub|Using git and GitHub]]
**[[Coding Conventions]]
**[[Development_team|Development team]]
**[[Engine_Overview|Engine internals overview]]
**[[Development_Tools| Development tools]]
*[[Development_Model|Development Model]]
*[[Design_Workflow|Design and Project Management Workflow]]
*[https://github.com/pioneerspacesim/pioneer/issues Issue tracker]
*[[Roadmap|Roadmap]]
*[[Making a release]]

|}

Pioneer is brought to you by a flock of [https://github.com/pioneerspacesim/pioneer/blob/master/AUTHORS.txt opensource beardy-weirdies], and is [http://www.gnu.org/licenses/gpl.html Free Software]

__NOTOC__

Flight UI

2022-05-28T19:54:21Z

Nozmajner: /* Vector indicators: */

The flight UI or HUD of Pioneer is made of several different parts:

[[File:01 parts.png|none|Parts of the flight UI]]

 

 

== Central reticule ==

[[File:02 01 deltaV.png|right|02 01 deltaV.png]]Along with the crosshair, the central reticule shows vital flight related information. With the help of them, you can navigate around, perform transits to anywhere without an autopilot.

=== DeltaV bar ===

The bars on the left side of the reticule are displaying the deltaV reserves of your ship.  They can be thought of as a "fuel" display, since deltaV is the capability of the ship to change speed.

There are two bars there. The left one shows current speed. The right one shows the deltaV capacity of the ship. Beneath it, the fainter bar shows the maximum deltaV capacity.

Under them one finds a numerical display of the deltaV reserves. It shows the % of maximum deltaV (with full fuel tanks), and the remaining deltaV in km/s or Mm/s.

As speed increases, the left bar will start to build up, which shows the speed of the ship proportional to its deltaV reserves. Practically, if the speed bar is bigger than the deltaV bar, you will not be able to slow down and stop, because you do not have enough propellant (fuel). Usually it is wise to keep some in reserve, so there is room for corrections for the unexpected. The autopilot uses about 1/3rd of it for acceleration, another 1/3rd for deceleration, and the remainder is saved.

=== Orientation displays ===

[[File:02 02 orient.png|right|Orientation displays]]

There are three orientation displays on the central reticule. There are numerical displays available for each.

#Compass: Shows ship orientation in relation to the cardinal directions of North, East, South, West. Useful if you need to navigate to a downed ship in distress, for example.
#Pitch indicator: Shows pitch relative to the ground. The central tick means you are parallel to the ground, the upper and lower are 90°: looking directly up or down respectively.
#Roll indicator: Shows roll (bank) relative to the ground. The shorter half of the "L"s always point towards the ground. This is also useful in space, where they always point toward the planet or reference frame, so you can easily feel where you need to rotate to find it.

 

 

 

 

 

=== Flight data  ===

[[File:02 03 data.png|right|02 03 data.png]]

Flight related data are displayed on the sides of the reticule. If the frame of reference data is not shown on the right side, a compact version is shown on the left.

#Name of the object for the displayed data.
#Closing speed. The speed of approach to selected target, which might not be the same as the speed of the ship relative to it. If negative, then you are getting closer to your target, if positive, you are getting further away from it.
#Approximate braking distance, measured in the same unit as the speed. An approximation of the distance needed to slow down to a full stop relative to the target or frame respectively. This is a helpful navigation aid, since it shows how far from your target you need to start decelerating in order to stop close to it target. It is based on the thrust of the main thrusters, so you need to turn your ship around, and decelerate with them. If the distance is smaller than the braking distance, there will not be enough time to stop, causing either an overshoot of target or a crash.
#Distance to the target and relative speed. Measured to its surface.
#Display selector: allows switching the display to show data related to the current frame, navigation target or combat target, respectively. Text color also represents it: Light gray for Frame, Green for Nav target and Red for targeted ships (combat target).
#Set speed display, for the Set Speed flight mode, and the reference object it is measuring the speed relative to.
#Braking distance bar, complementing the braking distance readout. A visual display of your braking distance in relation to the distance to target. There are two bars on top of each other that fill up as you are getting close to your target: a gray one for retro thrusters and a white one for mains. If the white bar is filled up, it's 100%. This is the right time to start decelerating. At 95% it will start to turn green. If it starts to fill up from above with a red bar, then you will overshoot. Only shows if you are getting closer to your target (closing speed is negative). Note that the bar will fill up as you are getting closer to your target, even without any acceleration. Since it represents the proportion of your current distance, it can fill up fast when you are getting close to your target.

You can access the autopilot functions mainly from the reticule. Right mouse on the name of the target, the target itself, or in the system overview panel will bring up the autopilot command. Alt+right mouse on the name on the reticule will bring up the directional holds: Prograde, retrograde, normal, anti-normal, radial in and -out.

 

== Functions and views ==

There is a row of buttons on the top of the HUD. Several screens and functions can be accessed trough them:

[[File:Functions.png|left|Functions.png]]

 

===   ===

=== Views and screens ===

*[[File:Views.png|middle|Views.png]] Internal and external views.
*[[File:Infoview.png|middle|Infoview.png]] Info screen: Shows information about ship, pilot, crew, cargo and missions.
*[[File:Comms.png|middle|Comms.png]] Comms and Autopilot controls. Also used to access starport services.

=== Maps ===

*[[File:Sectormap.png|middle|Sectormap.png]] Sector map: for interstellar navigation.
*[[File:Orbitmap.png|middle|Orbitmap.png]] Orbit map of the current system, or the one selected in the Sector map.
*[[File:Sys overview.png|middle|Sys overview.png]] System overview of the current system, or the one selected in the sector map. Shows general body information, starports, trade and population information.
*[[File:Galaxy.png|middle|Galaxy.png]] Galaxy map: shows the general placement of the current or selected system in the galaxy.

=== Functions ===

*[[File:Wheel.png|middle|Wheel.png]] Landing gear control and status. Grayed out if it is in movement.
*[[File:Hyperdrive.png|middle|Hyperdrive.png]] Engage hyperdrive. [[File:Hyperdrive-illegal.png|middle|Hyperdrive-illegal.png]] indicates that jump is illegal in current location (eg. close to starports).
*[[File:Rotdamping.png|middle|Rotdamping.png]] Rotation damping control and status. If on it will halt ship rotation.
*[[File:Equipment.png|middle|Equipment.png]] Switches between equipments and radar at the bottom of the screen. Missiles and ECM are accessible from there.

=== Flight mode display ===

*[[File:Manualflight.png|middle|Manualflight.png]] Manual flight.
*[[File:Setspeed.png|middle|Setspeed.png]] Set Speed flight mode. The flight computer tries to maintain the selected speed relative the selected frame of reference.
The autopilot functions bellow are accessible by right clickin on the name of the target either at the reticule, in the system overview list or on the target directly.
*[[File:Goto.png|middle|Goto.png]] Autopilot: Flying to target.
*[[File:Dock.png|middle|Dock.png]] Autopilot: Docking with target.
*[[File:Orbits.png|middle|Orbits.png]] Autopilot: Entering low, medium or high orbit.
The autpilot functions bellow are accessible by alt+right clicking on the name of the target at the reticule.
*[[File:Proretro.png|middle|Proretro.png]] Autopilot: Holding Prograde or Retrograde orientation (with respect to orbit).
*[[File:Radial.png|middle|Radial.png]] Autopilot: Holding Radial Out or In  orientation (with respect to orbit).
*[[File:Normal.png|middle|Normal.png]] Autopilot: Holding Normal or Antinormal orientation (with respect to orbit). 

 

== Ship status ==

[[File:Status.png|right|Status.png]]

#Weapon temperature. Increases with weapon fire until full, at which point the weapon can not be fired, until it has cooled off. Each fitted weapon (e.g. front and back) has its own gauge.
#Atmospheric pressure. Left number is in % of the hull's pressure tolerance; number on the right is preassure in atm units (Earth sea level pressure)
#Hull temperature, in % of the hull's tolerance. Flying fast in the atmosphere raises it quickly, especially without heat shielding. As with flying with lowered landing gear.
#Hull status in %.
#Shield status in %.

== Time controls ==

Shows the current time and date, and provides time acceleration controls.

Time acceleration levels are:

*|| Pause - Pressing it twice will open the Settings window.
*> 1x
*>> 10x
*>>> 100x
*>>>> 1 000x
*>>>>> 10 000x

Depending on the location of the ship, available time acceleration levels can be limited, e.g. near planets. One can still force higher levels pressing the time acceleration button while holding '''[Ctrl]'''. However, forcing time acceleration can be dangerous and unpredictable, and it might not switch back to 1x when the autopilot has arrived at its destination.

== Radar and ground data ==

=== Radar ===

If the Radar equipment is installed on the ship, a disc shaped planar radar is shown. It shows a representation of the relative position of surrounding ships, stations and objects to the position the pilot's ship.

There are two kinds of radar displays in the game, that can be toggled by pressing '''[right mouse button] '''on the radar display.

*'''3D Planar: '''The classical Elite style radar display.[[File:Planar radar.png|right|Planar radar.png]] [[File:Azimuthal.png|right|Azimuthal.png]]

The plane of it shows the plane of the ship, as if it was viewed from up top and behind. The ship is in center, and contacts are shown as small dots. If they are above or bellow the plane of the ship, these dots will have a thin line above or bellow them, indicating their height to the plane.  There are two sizes available, can be switched with the ''Compact scanner ''option in the Settings window. There are some keyboard shortcuts available:

*
**\: Toggle scanner mode. Auto will put the furthermost contact on the edge, and dynamically adjust the range based on that. In manual mode, a specific range can be selected.
**]: Increase scanner range
**[: Decrease scanner range
*'''2D Azimuthal: '''Projecting the globe onto a 2D plane. It only shows directional data, not distance, but it is omnidirectional. The range can be adjusted with the '''[mouse wheel]. '''The dots fade out as they are getting out of the set range.
**The inner circle shows what's in front of the ship.
**The four segmented ring show what is to each side of the ship.
**The outter circle shows what is behind the ship. The circle itself is what is exactly behind.

=== Ground data ===
When in the vincinity of a planetary body, the following information is presented:
*[[File:Ground.png|right]]Altitude above ground.
*Vetical speed relative to the ground. Positive if gaining altitude, negative if loosing altitude.
*Latitude coordinates.
*Longtitude coordinates.

 

== Indicators ==

There are several indicators visible on the flight display to aid navigation and orientation: If out of view, the most important ones are also displayed on the inside of the central reticule, to show their direction.

=== Vector indicators: ===

*[[File:Prograde.png|middle|Prograde.png]] Prograde: The direction of flight. There is a white one for the current frame of reference and also a yellow one for the navigation target if it is moving, when you are not in its frame (like an orbiting space station or planet).
*[[File:Retrograde.png|middle|Retrograde.png]]Retrograde: The opposite of the direction of flight. Likewise, there is a yellow equivalent for this one too.
*[[File:Maneuver.png|middle|Maneuver.png]]Maneuver direction: If there is a maneuver planned in the orbital map, this will show the direction needed to accelerate towards to complete the maneuver. The central reticule will also display the time of burn at the bottom.
*[[File:Zenit.png|middle|Zenit.png]]Zenit: The direction away from the center of your reference frame. Useful for blastoff for example.
*[[File:Target.png|middle|Target.png]]Target: Displayed on the center of the selected navigation (yellow) and combat (red) target.

=== Direction indicators: ===

These are essentially the crosshairs for each viewing direction (Numpad 8,4,6,2,9,3). They also show up when rotating the view using the middle mouse button.

*[[File:Crosshair fwd.png|middle|Crosshair fwd.png]]Forward crosshair: Points to the front direction.
*[[File:Crosshair bwd.png|middle|Crosshair bwd.png]]Backward crosshair: Points to the rear direction.
*[[File:Direction.png|middle|Direction.png]]View direction crosshairs: Down, Right, Up, Left. Practically little arrows that are pointing towards forward direction. (e.g.: if the arrow points up, you have to look up for forward view.)
*[[File:Crosshair dir.png|middle|Crosshair dir.png]]Direction to front: This is only visible if the view is rotated, and it always points towards the crosshair, so the pilot always knows where forward is.

=== In-space Indicators ===

[[File:Indicator-pluto.jpg|right|Indicator-pluto.jpg]] [[File:Indicator-pluto-opened.jpg|right|Indicator-pluto-opened.jpg]] Bodies in space are shown with an icon and a name. If multiple bodies are close together, they are collapsed, and only the most "important" one is shown, with a "+" after its name, to show that it represents multiple bodies.

If you click on a body, you will select it as your nav target (or combat target in case of a ship). You can de-select it by Ctrl-clicking on it. If you click on a body that represents multiple collapsed bodies, you will get a pop-up menu that lets you pick which one you actually want to target.

'''Icons:'''

*[[File:Icon sun.png|middle|Icon sun.png]] Star
*[[File:Icon gasgiant.png|middle|Icon gasgiant.png]] Gas giant
*[[File:Icon planet.png|middle|Icon planet.png]] Planet
*[[File:Icon moon.png|middle|Icon moon.png]] Moon
*[[File:Icon asteroid.png|middle|Icon asteroid.png]] Asteroid
*[[File:Icon orbital.png|middle|Icon orbital.png]]Orbital station
*[[File:Icon surfaceport.png|middle|Icon surfaceport.png]]Surface starport
*[[File:Icons ships.png|middle|Icons ships.png]] Different types of spaceships (Fighter, Courier, Shuttle, Transport, Cargo shuttle, Freighter)
[[File:Shipclass_icons.png|right]]

Xylophis

2022-05-28T19:46:35Z

Nozmajner: Adding cockpit image

{{Infobox_Ship
|name = Xylophis
|type = Light cargo shuttle [[File:ship_class_light_passenger_shuttle.png]]
|sketchfab = <sketchfab>f856b8f01dd545a2941c654286079c6c</sketchfab>
|manufacturer = OPLI-Barnard Inc.

|price = 16,872
|hull_mass = 5
|capacity = 10
|cargo_capacity = 10
|min_crew = 1
|max_crew = 2

|max_engine = yes
|hyperdrive_class = 0
|max_scoop_mounts = 0
|max_cabins = 1
|max_weapons = 1
|max_missiles = 0

|fuel_tank_mass = 4
|effective_exhaust_velocity = 9,900
|deltav_empty = 5,819
|deltav_full = 2,340

|forward_accel_empty = 1.5
|forward_accel_full = 1.5
|reverse_accel_empty = 1.5
|reverse_accel_full = 1.34
|up_accel_empty = 2
|up_accel_full = 1.34
|down_accel_empty = 1
|down_accel_full = 0.8
|lateral_accel_empty = 1
|lateral_accel_full = 0.8
|angular_accel_empty = -
|angular_accel_full = -

|atmo_shield = yes
|atmo_pressure_limit = 3
|lift_coef = 0
|aero_stability = 0.25
|front_drag = 0.56
|side_drag = 0.84
|top_drag = 0.95
}}
== Description ==

The smallest and lightest vessel from the OPLI shipyard. A simply built, easy to operate light shuttle mainly intended for short station to station or station to ship hops.

The Xylophis is hyperspace capable, but only barely. Which allows for short interstellar trips.

As with any OPLI-Barnard ships, Xylophis is easy to maintain, but it needs frequent maintenance. Upgrading and tuning is difficult because the space is limited. Despite its limitations, the ship became a favorite among space enthusiast who want a cheap ship to fly around once in a while.

Currently, this is the beginner ship for the pilots who begin their journey at Barnard's Star.

==Role==
It's main role is low range intra-system shuttle and courier. With a hyperdrive installed it can be used for fun flights to other systems or to hop away from enemies to a safe system.
Due to its size it can't be efficiently used for a lot of purposes but its size makes it more difficult to detect and in asteroid field it is nearly impossible to get it.
It is most popular in Solar Federation space and among independent systems, but not a common sight in CIW space. In fact OPLI-Barnard ships are disliked because they are produced with penal labor.

==Notes==
Xylophis is a good ship for people with low demands. It is often used by hobbyists and people interested in space because it is small, easy to control and dependable.
Like most other OPLI ships it has a wide margin of error, so it's ideal starter craft. Its main drawback is the very small cargo space.

==Images==
[[File:Xylo01.png|1280px]]

[[File:Xylo02.png|1280px]]

[[File:Xylo03.png|1280px]]

[[File:Xylo04.png|1280px]]

[[File:Xylo_cockpit_sketchfab.png|1280px]]

Cockpit (upcoming)

Xylophis

2022-05-28T19:44:34Z

Nozmajner: Adding cockpit image

File:Xylo cockpit sketchfab.png

2022-05-28T19:43:40Z

Nozmajner:

Model system

2022-05-09T08:45:55Z

Nozmajner: /* Importing models */

== Overview ==

tl;dr: a simple scenegraph-based approach that has nothing to do with the old system or Lua, focus is on easy importing, supports some animation.

== Debuging models ==
You can access some in-game debug functionality regarding models. Wire-frame display, tag display, collision and bounding box display, among other things. Details: [[Model debug flags]]

== Importing models ==

The import system theoretically supports [http://assimp.sourceforge.net/main_features_formats.html many different formats] but you are expected to use only some:

*When node structure, node names and animations matter, use '''Collada (.dae).'''
*For static geometry, such as buildings, OBJ is recommended, this may allow for some optimizations

The only officially tested 3D modelling program at the moment is [http://www.blender.org/ Blender 3.1]. For blender, a quick checklist is:

*Coordinates: X right, Y forward, Z up
*Always generate UV coordinates for the model
*Versions downloaded from blender.org support Collada out of the box, while the version distributed with some Linux distros doesn't.
*There is an alternative Collada exporter [https://github.com/godotengine/collada-exporter made by the Godot team].

The [[Model_viewer|Model viewer]] is supplied with the game.

=== Model definition file ===

Models must be placed under '''data/models'''

To define a model, create a simple <code>name_here.model</code> text file along with your exported meshes:

#Comments can be written like this
#Define all used materials first
Material some-material
tex_diff some_texture.png
diffuse 0.8 0.7 0.7

#Meshes to be imported into this model, should be in the current folder
#Mixing different formats should be OK
mesh part1.obj
mesh part2.obj

== Materials ==

Only material names are imported from 3D models, to set material properties use a small definition like this:

material CobraI_body
tex_diff CobraI_diff.png
tex_glow CobraI_emit.png
tex_spec CobraI_spec.png
tex_norm CobraI_norm.png
diffuse 1.0 1.0 1.0
specular 1.0 1.0 1.0
shininess 150

=== Material properties ===

{| class="wikitable"
|-
| material
| Name. Mandatory! If exporting from Blender, you can use the name of the Material as is. It's case-sensitive. (Note, in the past some exporters modified the names from what is visible in the modeling program, for example the Blender 2.6 Collada exporter adds "-material" to each name. You'll have to use this final name. If in doubt, note that both .obj and .dae files are human readable, and you can find the assigned names in them with a text editor.)
|-
| diffuse
| Diffuse colour RGB. Default white.
|-
| specular
| Colour of specular highlights, RGB. Default white. Set to black to disable highlights.
|-
| emissive
| Self-illumination colour, RGB. Default black.
|-
| shininess
| Sharpness/size of specular highlights, 0 - 128. Default 100.
|-
| opacity
| 0-100, controls transparency of the material. A node with a material opacity less than 100 is treated as transparent, otherwise opaque.
|-
| tex_diff
| Diffuse texture, file name (in the same folder). If you don't specify this, a white dummy texture is generated.
|-
| tex_ambi
| Ambient occlusion texture, file name (in the same folder). Used for faking ambient occlusion, by multiplying the diffuse with this. So the darker the AO texture, the darker it will make the diffuse.
|-
| tex_glow
| Self-illumination texture, overrides emissive colour parameter. Default none.
|-
| tex_spec
| Specular highlight colour/intensity texture. Default none. Multiplied by specular colour parameter, so set it to white to leave control entirely to the texture.
|-
| tex_norm
| Normal map. Default none. You can create surface detail with it, which interacts with lighting.
|-
| use_patterns
| This material will use the pattern/colour system. Read more below.
|-
| unlit
| No lighting, diffuse value can still be used to tint the result
|-
| two_sided
| Removed function. Duplicate face and flip normals if needed.
|-
| alpha_test
| Pixels with alpha value < 0.5 are discarded, this is good for fences and such. It produces sharp edges but the geometry does not need to be sorted.
|}

[[File:Newmodel specularmap.png|RTENOTITLE]] Flat specular lighting improved by a specular map

[[File:Newmodel glowmap.png|RTENOTITLE]] A model lit only by the self-illumination texture

=== Patterns ===

A system to mark customizable color areas on a model without splitting it to separate materials.

Patterns are small grayscale textures placed in the model folder, named pattern*.png. Using gray or white colour you can mark the areas tinted by one of the customizable colours (black marks unaffected areas). The colours are set by the game (faction-specific ship colours, shipyard UI for the player).

The value ranges are:
* 0-63: not affecting (black)
* 64-127: first color (dark gray)
* 128-191: second color (mid gray)
* 192-255: third color (light gray/white)
You can set all three channels to these in RGB, or only the L channel in HSL (Hue, Saturation, Level) to get the needed gray.

The alpha channel of the pattern defines it's transparency. It can be used for gradual changes from colored to blank, but not for gradients between different gray ranges. Useful for showing wear on the pattern, or coloring some parts more lightly. Alpha channel can be created by using a layer mask.

Antialiasing (which generates small gradients) can cause artifacts, especially at black-white boundaries. To avoid it, try lowering the contrast on problematic places. Even different grays can be used from the same range, they will indicate the same color.

The system has several limitations: it is not meant to do fine details, transitioning from one color to another is sharp and it works best with white/light textures. You'll have to experiment.

[[File:newmodel_patterns_asp.png]]

== Detail levels ==

Meshes can be grouped into detail levels using the <code>lod pixelsize</code> directive:

lod 100
mesh hull_low.dae

lod 200
mesh hull_med.dae

lod 1000
mesh hull_hi.dae
mesh landing_gear.dae

A detail level will be picked if the approximate radius of the model on screen is less than <code>pixelsize</code> (for the highest level it does not matter as long as it's larger than the others). Use the modelviewer to find optimal sizes.

You may specify any number of detail levels in any order, they will be sorted according to size.

== Shield mesh ==
If you name an object '''''shipname''_shield''', it will be used as the shield mesh for the ship. It can be in the top LoD .dae (.obj, etc), or in a separate file, but then you have to define that .dae for the top LoD too in the .model file.
If not present, then the game will generate a spherical shield around the ship.

== Animations ==

Position, rotation and scale keyframe animation is supported. Since the Blender 2.6 Collada exporter cannot export multiple animations in one file, you will have to put it all in one timeline and split it at the import stage (this is also the only reliable way to get named animations). An animation is defined after all the meshes in format <code>anim name startframe endframe</code>:

anim gear_down 0 10
anim something_else 12 25

Note, Collada uses seconds instead of frame numbers. For the conversion to work, you should create the animations at '''24FPS'''.

The game will recognize animations by name, the list of supported animations is to be decided.

Currently we support animation for landing gear (anim gear_down) and an idle loop (anim idle).

There is no animation blending, so two animations shouldn't be directly controlling the same node.

== Attachments ==

Models may have special "tag point" nodes where other models may be attached. You may define a tag point in Blender by placing an Empty object and giving it one of the predefined names.

The system is meant for attaching equipment: guns, cargo pods, turrets...

Example: A generic gun model attached to a point "tag_gun_right":

[[File:newmodel_tagpoints01.png]]

Tag points have not been fully implemented. If you want to use this feature, please contact the devs.

=== Tag points ===

As at 29 January 2014.
Tags are only need to be present on the top level LOD, they will be visible on all LOD levels.
These tags are mandatory for the ship to work as expected, e. g. missing tags for the camera(s) might lead to front lasers firing in the wrong direction.

{| class="wikitable"
|-
| tag_camera_front tag_camera_rear tag_camera_left tag_camera_right tag_camera_top tag_camera_bottom
|| [[File:Tag_orient_s.png|right|200px]]Position and orientation for the six internal view cameras. X "left", Y "up", Z "out" of the ship (in the direction the camera is facing). If one is missing, tag_camera will be used with its orientation adjusted for the appropriate direction. '''Camera tag scaling should be 1 on all three axes to avoid glitches.'''

|-
| tag_camera || Fallback for the specific camera tags. Useful if you don't want to specify all points. Defaults to the ship origin.
|-
| tag_gunmount_N || Gun positions, X "left", Y "up", Z "out" of the ship (in the fire direction). Note at this time, only N = 0 or 1 will work, and they correspond to "front" and "rear" guns in the UI. The "max_lasers" ship definition field still takes precedence (ie if max_lasers = 1, tag_gunmount_1 will never be used). Defaults to the ship origin.
|-
| tag_landing || A point at the lowest point of the ship with gear extended. Used during landing to make sure the ship sits at the right place on the surface. Defaults to the lowest point in the ships AABB, which is usually unsuitable because it includes the shield mesh.
|-
|}

== Collisions ==

By default, the collision mesh of a model is the bounding box of all the meshes.

For more control, name objects with the prefix "collision_" and they will be added to form a collision mesh (these objects will not be visible geometry, and the bounding box will not be generated).

Note, these names are reserved for station collision trigger surfaces:

* collision_pad1
* collision_pad2
* collision_pad3
* collision_pad4

You can also import a separate mesh using the <code>collision</code> directive in the model definition:

collision collision.obj

The collision mesh is separate from all detail levels, so it should be only defined once.

[[File:newmodel_collmesh01.png]]

== Decals ==

Decals are meant for customizable insignia on spaceships and changing advertisements on space stations. Up to four unique decals are available for a model (multiple identical decals are allowed). Place a piece of geometry, usually a flat quad, with proper UV coordinates and name it decal_01, 02, 03 or 04. The game will then use a special material on the geometry, or make it invisible if no decal is to be used.

[[File:newmodel_decals01.png]]

== Labels ==

Dynamic 3D labels are meant for naming ships and space stations. Put an empty node in the model and give it a name beginning with "label". The text is set by the game at runtime if supported.

Node scale can be used as usual but the text is not constrained to the node bounds or anything like that, so some trial will be required.

You can use multiple label nodes but they will all show the same text.

[[File:newmodel_labels01.png]]

== Minor features ==

Note, these special nodes are only imported from the most detailed LOD, there is no need to duplicate them. They are rendered outside the detail level system.

=== Billboard lights ===

Simple light sprites placed using empty nodes with special naming (navlight_*). This feature will be more customizable someday, but for now the following name prefixes are recognized:

* navlight_red: blinking red light, with ships when landing gear is down, with stations constantly
* navlight_green: blinking green light when landing gear is down
any other navlight_ is blue, on when landing gear is down.
* space stations, navlight_pad<number> lights change according to landing pad reservation status

=== Thrusters ===

Thrusters are marked with dummy objects. In Blender, create an "Empty" object and point its Z-axis (change the object display type to "arrows" or "single arrow" to visualize this) where the thruster should point. Thruster size is taken from the object scale. Begin the object name with either <code>thruster_</code> or <code>thruster_linear</code> so the importer can recognize them (linear thrusters light up only when moving up/down/left/right/forward/backward, not when turning).

Thruster colour can be modified, see: https://github.com/pioneerspacesim/pioneer/pull/3948

== Internals ==

You can find some testcase models at git://github.com/Luomu/newmodels.git.

The internal scene graph consists of several of these nodes:

{| class="wikitable"
|-
| Node|| Base class. A node can have a name and one or more parents.
|-
| Group|| A group is a Node that can have several children.
|-
| MatrixTransform|| A Group that applies a transformation to its child nodes when rendering.
|-
| StaticGeometry|| Contains one or more StaticMeshes.
|-
| LOD|| Detail level control node, picks one of the child nodes based on the approximate size of the model on screen.
|-
| ModelNode || Can be used to attach another Model as a submodel. Use case: dynamic equipment on ships.
|-
| More!||Some marginal nodes that exist at the moment are:

* Thruster: spaceship thruster
* Billboard: can be used for light sprites (navlights on ships)
* Label3D: dynamic 2d text, meant for labeling ships
|}

MatrixTransform nodes are the most commonly used, if a geometry is rotated or scaled it will be parented to a MatrixTransform. A simple form of instancing can be achieved by adding a geometry as the child of several separate MatrixTransforms.

During rendering, the graph is traversed twice. Once for opaque objects, and once for transparent objects (which includes decals, thrusters). The model system does not perform any depth sorting, this improvement job needs to be done elsewhere.

=== Animations ===

An animation consists of Channels. Each channel controls one node (always a MatrixTransform) and has a list of position and rotation Keys. Each key has a time and value. Keys are always linearly interpolated.

At first the animations had proper play/pause/loop functionality but right now it is not so. Animation progress (and fun things like serialization) needs to be controlled directly by whatever feature uses the animation (see: landing gear).

=== Export settings ===

Collada (.dae) export settings for Blender 2.6:

[[File:newmodel_exportsettings01.png]]

[[Category:Art]]

Modeling cockpits

2022-05-09T08:11:27Z

Nozmajner: /* Modeling */ Adding tag update

Making cockpits is quite similar to modeling ships technically.

 

== Placement ==

Placement for the point of view is the origin: X:0, Y:0, Z:0. Take care to line up the interior properly with the help of the forward camera tag on the ship. It's generaly wise to have the ship model in the scene on a separate layer, to check if everything fits in there.

Alignment is the same as for ships: Y+ is forward, X+ is right, Z+ is up. (in Blender axis convention).

It's useful to place a camera at the POV, so the view can be checked easily. The default vertical FOV in Pioneer is 65°, which correspond to 97° in Blender (which uses horizontal FOV), or 14mm focal length if you are using 16:9 aspect ratio (1920*1080). I usually add rotation keyframe to the camera when it's looking forward, so if I move in the timeline, the camera resets to that direction. You don't need to export the camera.

== Modeling ==

Pretty much the same as with ships. There are some prefab and material collections in the works which should speed up furnishing and texture creation.

Triangle budget is more loose though, since only one cockpit will be shown at any time. Don't push it to the millions though, but a couple 100 000 should be fine.

Don't use a lot of materials though, a lot of those can decrease performance. One for transparent stuff and one for solid should be enough in most cases, and with proper texturing.

[[Model_System|'''.model '''files work the same as for ships]], but there won't be any shield, collision mesh or LoD levels for it. Idle and gear down animations are untested.

Right now thruster exhausts won't show up even if they would be visible from the cockpit. But there's a PR that will allow for using thruster tags. They should be named the same as they are in the ship.

== Interactivity ==

There are no interactive features for cockpits yet, apart from looking around. Dispays aren't showing anything, buttons aren't working. They are purely cosmetical right now (apart from the fact that they differentiate between ships, by limiting the view in different ways and amounts). 

Interactivity is planned, but there's not even an estimate on when or how they would work. If you are planning on making cockpits for the official Pioneer release, then you should keep this in mind, and make them so they are easily extendable, editable when interactivity comes.

== Setup ==

#You need to place your cockpit files in a directory, and place that into the pioneer/data/models/. The default cockpit is in /misc, but in the future cockpits will have their own directory (/data/models/cockpits/ for example). 
#Edit the given ship's '''ships.json''' file in /data/ship. The cockpit line is usually empty. Add in the name of the '''cockpit.model''' file, without extension:
<pre>"cockpit" : "myship_cockpit",</pre>

If everything's in order, you should be able to try it out in-game. Make sure to enable the cockpits in the settings, which is off by default. You can also view it in the [[Model_viewer|model viewer]]. Zooming in all the way should place the camera at the POV of the pilot.

=== Putting it into a mod ===

You can pack up your creation as a mod, which is easier to distribute. Useful for testing and discussing it during development.

In a mod file you basically replicate the directory structure of pioneer, but you only put in the data you want to change or introduce. So in this case (/data is ommited):
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">/models/cockpits/myship_cockpit/files of my cockpit /ships/myship.json</div>
Just zip this structure up you can use it by [[Mods|placing it in the mods directory.]]

Sinonatrix

2022-05-07T15:03:08Z

Nozmajner: Adding cockpit image

{{Infobox_Ship
|name = Sinonatrix
|type = Light courier [[File:ship_class_light_courier.png]]
|sketchfab = <sketchfab>881e28769ecf4ba9991c8e93757a945f</sketchfab>
|manufacturer = OPLI-Barnard Inc.

|price = 62,707
|hull_mass = 28
|capacity = 35
|cargo_capacity = 30
|min_crew = 1
|max_crew = 2

|max_engine = yes
|hyperdrive_class = 2
|max_scoop_mounts = 2
|max_cabins = 3
|max_weapons = 1
|max_missiles = 4

|fuel_tank_mass = 36
|effective_exhaust_velocity = 16,000
|deltav_empty = 13,227
|deltav_full = 7,232

|forward_accel_empty = 3.9
|forward_accel_full = 2.05
|reverse_accel_empty = 1.8
|reverse_accel_full = 0.92
|up_accel_empty = 2
|up_accel_full = 1.85
|down_accel_empty = 1.5
|down_accel_full = 0.61
|lateral_accel_empty = 1.5
|lateral_accel_full = 0.61
|angular_accel_empty = -
|angular_accel_full = -

|atmo_shield = yes
|atmo_pressure_limit = 3.2
|lift_coef = 0.2
|aero_stability = 0.6
|front_drag = 0.3
|side_drag = 0.5
|top_drag = 0.98
}}
== Description ==

Sinonatrix is an older OPLI Barnard courier model which shares some parts and structural elements with the Natrix. A very rugged but relatively easy to maintain craft. It's built mainly for speed. It's already excellent speed performance can be further boosted by Modified Thrusters, Optimized Thrusters or Bespoke Thrusters; with proper piloting, this ship can fulfill every mission deadline.

Currently, this is the beginner ship for those players who start their journey at Mars.

==Role==
It's main role is mid to long range courier. It's intended to avoid combat, rather then fight. It's a popular model among racing pilots due to it's easy tweak-ability and abundance of spare parts.

==Images==
[[File:Sinonatrix 06 1080.png | 1000px]]

[[File:Pretty_01_1080.png | 1000px]]

[[File:Sinonatrix 03 1080.png | 1000px]]

[[File:Sinonatrix 04 1080.png | 1000px]]

[[File:Sinonatrix 05 1080.png | 1000px]]

[[File:Renders 0112 1080.png | 1000px]]

[[File:Sinonatrix_cockpit_018.png | 1000px]]

Cockpit (upcoming)

File:Sinonatrix cockpit 018.png

2022-05-07T15:00:22Z

Nozmajner:

Xylophis

2022-02-04T15:46:04Z

Nozmajner: Updating the Xylophis descriotion for the overhauled model. Adjusted the description a bit too.

File:Xylo04.png

2022-02-04T15:45:15Z

Nozmajner:

File:Xylo03.png

2022-02-04T15:45:04Z

Nozmajner:

File:Xylo02.png

2022-02-04T15:44:39Z

Nozmajner:

File:Xylo01.png

2022-02-04T15:42:54Z

Nozmajner:

File:Xylophis silhouette.png

2022-02-04T15:40:37Z

Nozmajner: Nozmajner uploaded a new version of File:Xylophis silhouette.png

Xylophis

2022-02-04T15:26:19Z

Nozmajner: /* Role */

{{Infobox_Ship
|name = Xylophis
|type = Light cargo shuttle [[File:ship_class_light_passenger_shuttle.png]]
|sketchfab = <sketchfab>d592ec9bad7244b6a385669370f8357c</sketchfab>
|manufacturer = OPLI-Barnard Inc.

|price = 16,872
|hull_mass = 5
|capacity = 10
|cargo_capacity = 10
|min_crew = 1
|max_crew = 2

|max_engine = yes
|hyperdrive_class = 0
|max_scoop_mounts = 0
|max_cabins = 1
|max_weapons = 1
|max_missiles = 0

|fuel_tank_mass = 4
|effective_exhaust_velocity = 9,900
|deltav_empty = 5,819
|deltav_full = 2,340

|forward_accel_empty = 1.5
|forward_accel_full = 1.5
|reverse_accel_empty = 1.5
|reverse_accel_full = 1.34
|up_accel_empty = 2
|up_accel_full = 1.34
|down_accel_empty = 1
|down_accel_full = 0.8
|lateral_accel_empty = 1
|lateral_accel_full = 0.8
|angular_accel_empty = -
|angular_accel_full = -

|atmo_shield = yes
|atmo_pressure_limit = 3
|lift_coef = 0
|aero_stability = 0.25
|front_drag = 0.56
|side_drag = 0.84
|top_drag = 0.95
}}
== Description ==

The smallest and lightest vessel from the OPLI shipyard. A simply built, easy to operate light shuttle mainly intended for short station to station or station to ship hops.

The Xylophis is hyperspace capable, but only barely. Which allows for short interstellar trips.

As with any OPLI-Barnard ships, Xylophis is easy to maintain, but it needs frequent maintenance. Upgrading and tuning is difficult because the space is limited. Despite its limitations, the ship became a favorite among space enthusiast who want a cheap ship to fly around once in a while.

Currently, this is the beginner ship for the pilots who begin their journey at Barnard's Star.

==Role==
It's main role is low range intra-system shuttle and courier. With a hyperdrive installed it can be used for fun flights to other systems or to hop away from enemies to a safe system.
Due to its size it can't be efficiently used for a lot of purposes but its size makes it more difficult to detect and in asteroid field it is nearly impossible to get it.
It is most popular in Solar Federation space and among independent systems, but not a common sight in CIW space. In fact OPLI-Barnard ships are disliked because they are produced with penal labor.

==Notes==
Xylophis is a good ship for people with low demands. It is often used by hobbyists and people interested in space because it is small, easy to control and dependable.
Like most other OPLI ships it has a wide margin of error, so it's ideal starter craft. Its main drawback is the very small cargo space.

Xylophis

2022-02-04T15:24:31Z

Nozmajner: /* Description */

{{Infobox_Ship
|name = Xylophis
|type = Light cargo shuttle [[File:ship_class_light_passenger_shuttle.png]]
|sketchfab = <sketchfab>d592ec9bad7244b6a385669370f8357c</sketchfab>
|manufacturer = OPLI-Barnard Inc.

|price = 16,872
|hull_mass = 5
|capacity = 10
|cargo_capacity = 10
|min_crew = 1
|max_crew = 2

|max_engine = yes
|hyperdrive_class = 0
|max_scoop_mounts = 0
|max_cabins = 1
|max_weapons = 1
|max_missiles = 0

|fuel_tank_mass = 4
|effective_exhaust_velocity = 9,900
|deltav_empty = 5,819
|deltav_full = 2,340

|forward_accel_empty = 1.5
|forward_accel_full = 1.5
|reverse_accel_empty = 1.5
|reverse_accel_full = 1.34
|up_accel_empty = 2
|up_accel_full = 1.34
|down_accel_empty = 1
|down_accel_full = 0.8
|lateral_accel_empty = 1
|lateral_accel_full = 0.8
|angular_accel_empty = -
|angular_accel_full = -

|atmo_shield = yes
|atmo_pressure_limit = 3
|lift_coef = 0
|aero_stability = 0.25
|front_drag = 0.56
|side_drag = 0.84
|top_drag = 0.95
}}
== Description ==

The smallest and lightest vessel from the OPLI shipyard. A simply built, easy to operate light shuttle mainly intended for short station to station or station to ship hops.

The Xylophis is hyperspace capable, but only barely. Which allows for short interstellar trips.

As with any OPLI-Barnard ships, Xylophis is easy to maintain, but it needs frequent maintenance. Upgrading and tuning is difficult because the space is limited. Despite its limitations, the ship became a favorite among space enthusiast who want a cheap ship to fly around once in a while.

Currently, this is the beginner ship for the pilots who begin their journey at Barnard's Star.

==Role==
It's main role is low range intra-system shuttle and courier. With a hyperdrive installed it can be used for fun flights to other systems or to hop away from enemies to a safe system.
Due to its size it can't be efficiently used for a lot of purposes but its size makes it more difficult to detect and in asteroid field it is nearly impossible to get it.
It can occasionally be seen in Solar Federation space, in independent systems its popularity is a bit lower. It's not a common sight in CIW space. In fact OPLI-Barnard ships are disliked because they are produced with penal labor.

==Notes==
Xylophis is a good ship for people with low demands. It is often used by hobbyists and people interested in space because it is small, easy to control and dependable.
Like most other OPLI ships it has a wide margin of error, so it's ideal starter craft. Its main drawback is the very small cargo space.

Mola Ramsayi

2021-09-30T16:43:53Z

Nozmajner:

{{Infobox_Ship
|name = Mola Ramsayi
|type = Medium courier [[File:ship_class_medium_freighter.png]]
|sketchfab = <sketchfab>66ad0e5640a841d19f3d9b6b1e661ea7</sketchfab>
|manufacturer = OKB Kaluri

|price = 814,200
|hull_mass = 380
|capacity = 950
|cargo_capacity = 900
|min_crew = 1
|max_crew = 5

|max_engine = yes
|hyperdrive_class = 5
|max_scoop_mounts = 2
|max_cabins = 60
|max_weapons = 2
|max_missiles = 3

|fuel_tank_mass = 473
|effective_exhaust_velocity = 17,600
|deltav_empty = 14,231
|deltav_full = 5,355

|forward_accel_empty = 2.2
|forward_accel_full = 2.03
|reverse_accel_empty = 2.2
|reverse_accel_full = 1.13
|up_accel_empty = 2.2
|up_accel_full = 1.8
|down_accel_empty = 1.7
|down_accel_full = 0.73
|lateral_accel_empty = 1.7
|lateral_accel_full = 0.73
|angular_accel_empty = -
|angular_accel_full = -

|atmo_shield = yes
|atmo_pressure_limit = 3.8
|lift_coef = 0.12
|aero_stability = 1.1
|front_drag = 0.34
|side_drag = 0.56
|top_drag = 0.56
}}
=WIP=
== Description ==

==Role==

Bowfin fighter

2021-08-22T13:06:53Z

Nozmajner: /* Role */

{{Infobox_Ship
|name = Bowfin fighter
|type = Medium fighter [[File:ship_class_medium_fighter.png]]
|sketchfab = <sketchfab>c7e7abb845ff44e3aca5265286373ac6</sketchfab>
|manufacturer = OKB Kaluri

|price = 32,822
|hull_mass = 25
|capacity = 12
|cargo_capacity = 6
|min_crew = 1
|max_crew = 1

|max_engine = yes
|hyperdrive_class = 1
|max_scoop_mounts = 0
|max_cabins = 0
|max_weapons = 1
|max_missiles = 24

|fuel_tank_mass = 26
|effective_exhaust_velocity = 8,400
|deltav_empty = 5,989
|deltav_full = 4,471

|forward_accel_empty = 3.4
|forward_accel_full = 3.23
|reverse_accel_empty = 2.5
|reverse_accel_full = 2.02
|up_accel_empty = 3
|up_accel_full = 2.1
|down_accel_empty = 2.5
|down_accel_full = 1.61
|lateral_accel_empty = 2.5
|lateral_accel_full = 1.61
|angular_accel_empty = -
|angular_accel_full = -

|atmo_shield = yes
|atmo_pressure_limit = 6.5
|lift_coef = 0.42
|aero_stability = 0.5
|front_drag = 0.4
|side_drag = 0.78
|top_drag = 0.92
}}

== Description ==

The Bowfin fighter is a six-engine single-seater short range combat and patrol spacecraft designed and manufactured by OKB-Kaluri of CIW in the early 3100's for the military. It's development was dotted with problems due to it being a testbed for some new technologies and shifting requirements. In the beginning it was plagued by frequent malfunctions and constant need of maintenance. And to make the matters worse, the Bowfin is quite hard and time consuming to maintain. The upside was its very good performance, combat effectiveness and survivability.

The tender request that brought this craft to life indicated a very large quantity to be ordered which resulted in heavy competition among the shipyards. But the tender experienced several delays and changes in requirements, which made the development harder. Eventually OKB Kaluri emerged as winner with a very small margin, and started mass producing the craft. It seemed to be a bright era for the shipyard for a while, but changes in the fleet funding policies due to the somewhat thawing cold war resulted in the withdrawal of most of the orders.

A lot of those crafts were already built by then. To mitigate losses as much as possible, Kaluri started for looking other markets for it. At first this wasn't really successful due to the ships complex high maintenance needs, so Kaluri was forced to refine the design further if it wanted to sell them.

The CIW Fleet had a large number of ships in operation despite the reduced order, and started to accumulate deployment experience and feedback. Spare part demand drove up, and also the need for refinement, so the life of the Bowfin marched on.

During its long operation history most of the initial kinks were eventually ironed out to a good extent which resulted in an increase of reliability and somewhat easier maintenance, but with some performance loss. Which wasn't too much of a problem, since the craft never saw any extended wartime deployment in its life, but the better dependability was invaluable for the border patrol support duty of a cold war, where it was mostly employed in.

The surplus stock of the Bowfin were still high, and with the refinement of most early issues, Kaluri was able to start iterating on the design for the civilian market. The original design hid the cockpit away close to the center of mass, right above its ventral docking port in order to protect the pilot as much as possible. This meant very meager capacities for additional equipment, not to mention cargo. So the engineers decided to remove the internal encapsulated cockpit, and put on a more traditional bubble cockpit on top of the craft. This, and the removal of some military components they weren't even allowed to sell for civilians freed up enough room, so it can compete in the market of autonomously deploy-able mutli-role combat crafts.

The civilian grade components reduced the performance further, but additional reliability came with it. Thus the craft found some success in the market, and brought Kaluri to almost break even with its investions to this craft.(not counting what was to be lifted to other designs). These days Bowfin isn't the most popular choice for combatants, but it is well represented nonetheless. In some circles it is a classic, due to it's central role in the VR action movie "Mavericks of Parker Citadel"

The civilian Bowfin widely available has a really decent acceleration and good maneuverability, but low capacity for additional equipment and even lower cargo capacity. It makes up for that with a good weapons capacity and armour, and great redundancy for reliability.

==Role==
The military version of the Bowfin is still mostly used in short to mid range border patrol and defense roles, acting as extended reach craft from carriers and orbital patrols. It can fulfill superiority tasks to a good extend too if the need arises, and can hold up well against most current light and medium fighters.

The civilian version is proved to be a really good fleet defense craft against pirates, so it is a well represented craft around less lawful spaces. Smaller governments and militias like to use it as well for this reason. Not so liked among pirates and other criminals because its maintenance is still complex, and parts can be harder to obtain, even if they are actually in abundance.

Some pilots retrofit it to light courier jobs in these rough parts of the galaxy, trading capacity and speed for the possibility to put up a good fight against freebooters.

==Images==

[[File:Kaluri-med-fighter_crop.png||left|frame|Bowfin concept art]]

Xylophis

2021-07-17T08:23:10Z

Nozmajner: Updating with rebalance

{{Infobox_Ship
|name = Xylophis
|type = Light cargo shuttle [[File:ship_class_light_passenger_shuttle.png]]
|sketchfab = <sketchfab>d592ec9bad7244b6a385669370f8357c</sketchfab>
|manufacturer = OPLI-Barnard Inc.

|price = 16,872
|hull_mass = 5
|capacity = 10
|cargo_capacity = 10
|min_crew = 1
|max_crew = 2

|max_engine = yes
|hyperdrive_class = 0
|max_scoop_mounts = 0
|max_cabins = 1
|max_weapons = 1
|max_missiles = 0

|fuel_tank_mass = 4
|effective_exhaust_velocity = 9,900
|deltav_empty = 5,819
|deltav_full = 2,340

|forward_accel_empty = 1.5
|forward_accel_full = 1.5
|reverse_accel_empty = 1.5
|reverse_accel_full = 1.34
|up_accel_empty = 2
|up_accel_full = 1.34
|down_accel_empty = 1
|down_accel_full = 0.8
|lateral_accel_empty = 1
|lateral_accel_full = 0.8
|angular_accel_empty = -
|angular_accel_full = -

|atmo_shield = yes
|atmo_pressure_limit = 3
|lift_coef = 0
|aero_stability = 0.25
|front_drag = 0.56
|side_drag = 0.84
|top_drag = 0.95
}}
== Description ==

The smallest and lightest vessel from the OPLI shipyard. It has the same design as the other OPLI ships due to technology restrictions: The prisoners mustn't get in contact with sensible apperatures that could be sabotaged. This ship is used as small transfer vehicle for people who want to have a bit of fun flying around the solar system or higher generals who want to travel to starports where their large ships can't dock without showing much radar signature. The xylophis is hyperspace capable, allowing short trips to other systems or to flee when under fire. As with any OPLI-Barnard ships, Xylophis is easy to maintain, but it needs frequent maintenance. Upgrading and tuning is difficult because the space is limited and since there is nearly no demand there are not much parts for tuning it up.

Currently, this is the beginner ship for the pilots who begin their journey at Barnard's Star.

==Role==
It's main role is low range intra-system shuttle and courier. With a hyperdrive installed it can be used for fun flights to other systems or to hop away from enemies to a safe system.
Due to its size it can't be efficiently used for a lot of purposes but its size makes it more difficult to detect and in asteroid field it is nearly impossible to get it.
It can occasionally be seen in Solar Federation space, in independent systems its popularity is a bit lower. It's not a common sight in CIW space. In fact OPLI-Barnard ships are disliked because they are produced with penal labor.

==Notes==
Xylophis is a good ship for people with low demands. It is often used by hobbyists and people interested in space because it is small, easy to control and dependable.
Like most other OPLI ships it has a wide margin of error, so it's ideal starter craft. Its main drawback is the very small cargo space.

Wave

2021-07-17T08:19:43Z

Nozmajner: Updating with rebalance

{{Infobox_Ship
|name = Wave
|type = Medium fighter [[File:ship_class_medium_fighter.png]]
|sketchfab = <sketchfab>ce88ef9b914b47a8a4c75e1ca5aad7f4</sketchfab>
|manufacturer = Auronox Corporation

|price = 55,305
|hull_mass = 26
|capacity = 18
|cargo_capacity = 16
|min_crew = 1
|max_crew = 1

|max_engine = yes
|hyperdrive_class = 1
|max_scoop_mounts = 2
|max_cabins = 0
|max_weapons = 2
|max_missiles = 12

|fuel_tank_mass = 22
|effective_exhaust_velocity = 16,900
|deltav_empty = 10,361
|deltav_full = 6,852

|forward_accel_empty = 4.5
|forward_accel_full = 4.32
|reverse_accel_empty = 1.2
|reverse_accel_full = 1.08
|up_accel_empty = 4
|up_accel_full = 3.08
|down_accel_empty = 2
|down_accel_full = 1.23
|lateral_accel_empty = 2
|lateral_accel_full = 1.23
|angular_accel_empty = -
|angular_accel_full = -

|atmo_shield = yes
|atmo_pressure_limit = 14
|lift_coef = 1
|aero_stability = 2.6
|front_drag = 0.04
|side_drag = 0.1
|top_drag = 0.85
}}
==Description==
The Wave is a medium-sized, yet highly capable, multi-role craft. Designed by [[Auronox Corporation]] for privateers operating in and around dense nebulae and thick atmospheres, the flat, delta-wing design and X-shaped supporting fins provide extra stability, lift, and control whilst reducing drag. The careful hull design, combined with modern composite materials, allow the 13 metric tonne craft to transport over twice its mass in cargo, whilst brandishing a moderate array of weaponry. Additionally, its fuel tanks have a capacity of 22 tonnes, for relatively good range between waypoints.

==Known Issues==
At this time, Auronox have not admitted to any defects in the Wave's design, or construction.

Venturestar

2021-07-17T08:17:11Z

Nozmajner: Updating with rebalance

{{Infobox_Ship
|name = Venturestar
|type = Medium freighter [[File:ship_class_medium_freighter.png]]
|sketchfab = <sketchfab>0d9dec8e501045c89664931c79d263a0</sketchfab>
|manufacturer = Albr Corp

|price = 1,127,263
|hull_mass = 460
|capacity = 1,160
|cargo_capacity = 880
|min_crew = 2
|max_crew = 5

|max_engine = yes
|hyperdrive_class = 6
|max_scoop_mounts = 2
|max_cabins = 35
|max_weapons = 2
|max_missiles = 6

|fuel_tank_mass = 700
|effective_exhaust_velocity = 21,700
|deltav_empty = 20,071
|deltav_full = 7,793

|forward_accel_empty = 2.2
|forward_accel_full = 2.41
|reverse_accel_empty = 2
|reverse_accel_full = 2.63
|up_accel_empty = 2.5
|up_accel_full = 2.63
|down_accel_empty = 1.76
|down_accel_full = 1.31
|lateral_accel_empty = 1.76
|lateral_accel_full = 1.31
|angular_accel_empty = -
|angular_accel_full = -

|atmo_shield = yes
|atmo_pressure_limit = 7.2
|lift_coef = 0.76
|aero_stability = 1.8
|front_drag = 0.06
|side_drag = 0.21
|top_drag = 0.95
}}
==Venturestar==
Once the initial rush of manufacturing the [[AC33]] had tailed off, Albr Corp saw the opportunity to make more money with a civilian version.
The original designs were edited, removing the large engines and fitting regular more economical versions (which also drastically improved cargo space), removing much of the bulky military grade armour plating, adding crew bunks and finishing the interior with less sparse fittings.

==Improvements and changes==
Initial uptake of the Venturestar was not as high as expected, so after a few months of very low sales, the design was modified to add the same main engine nozzles (the cooling fins of the Dropstar are now redundant with normal engines and are purely cosmetic now) and wing end plates as the Dropstar, giving it a more utilitarian look.

The advertising campaign was stepped up to market the Venturestar as a military grade civilian freighter which set it apart from all the other similar ships which were marketed as "Luxury" freighters.

These small changes, as superficial as they were, pushed the Venturestar from obscurity to being a ship that can be found throughout the known galaxy.

Vatakara

2021-07-17T08:15:55Z

Nozmajner: Updating with rebalance

{{Infobox_Ship
|name = Vatakara
|type = Medium freighter [[File:ship_class_heavy_freighter.png]]
|sketchfab = <sketchfab></sketchfab>
|manufacturer = Mandarava-Csepel

|price = 2,655,296
|hull_mass = 890
|capacity = 3,200
|cargo_capacity = 2,900
|min_crew = 1
|max_crew = 8

|max_engine = yes
|hyperdrive_class = 9
|max_scoop_mounts = 2
|max_cabins = 10
|max_weapons = 2
|max_missiles = 6

|fuel_tank_mass = 2,200
|effective_exhaust_velocity = 16,900
|deltav_empty = 21,036
|deltav_full = 7,274

|forward_accel_empty = 2
|forward_accel_full = 1.94
|reverse_accel_empty = 1.8
|reverse_accel_full = 1.05
|up_accel_empty = 2
|up_accel_full = 1.05
|down_accel_empty = 1.24
|down_accel_full = 0.43
|lateral_accel_empty = 1.24
|lateral_accel_full = 0.43
|angular_accel_empty = -
|angular_accel_full = -

|atmo_shield = yes
|atmo_pressure_limit = 4.9
|lift_coef = 0.12
|aero_stability = 0.65
|front_drag = 1.3
|side_drag = 1.21
|top_drag = 0.91
}}
==Description==
Vatakara is the mainline mid-to-long range medium cargo freighter vessel from Mandarava-Csepel Shipworks, a variant of [[Malabar]]. An older model that saw continuous tweaking of its design for decades, Mandarava-Csepel phased it out in 3140. However, its popularity proved sufficient enough for M-C Shipworks to license it out to several independent shipyards throughout the galaxy.
The Vatakara is still a very popular model due to its sturdiness, generous cargo hold and relatively good performance.

==Role==
Its main role is short to midrange cargo hauling and equipment lifting.

==Notes==
...

Varada

2021-07-17T08:13:34Z

Nozmajner: Updating with rebalance

{{Infobox_Ship
|name = Varada
|type = Light courier [[File:ship_class_light_courier.png]]
|sketchfab = <sketchfab>3a659e9dd8e246b8a623a1f396c50cb9</sketchfab>
|manufacturer = Mandarava-Csepel

|price = 20,403
|hull_mass = 4
|capacity = 5
|cargo_capacity = 5
|min_crew = 1
|max_crew = 1

|max_engine = yes
|hyperdrive_class = 1
|max_scoop_mounts = 0
|max_cabins = 0
|max_weapons = 1
|max_missiles = 0

|fuel_tank_mass = 5
|effective_exhaust_velocity = 8,900
|deltav_empty = 7,217
|deltav_full = 3,932

|forward_accel_empty = 4
|forward_accel_full = 1.45
|reverse_accel_empty = 2.3
|reverse_accel_full = 0.72
|up_accel_empty = 3
|up_accel_full = 1.16
|down_accel_empty = 2.3
|down_accel_full = 0.58
|lateral_accel_empty = 2
|lateral_accel_full = 0.36
|angular_accel_empty = -
|angular_accel_full = -

|atmo_shield = yes
|atmo_pressure_limit = 4
|lift_coef = 0.2
|aero_stability = 0.6
|front_drag = 0.7
|side_drag = 0.9
|top_drag = 0.3
}}
==Description==
A small but fast one seater shuttle which is widely used as short range courier. It has a very small cargo hold and no weapon hard-point, but it makes up for that by its superb acceleration and maneuverability. The Varada is in production for about a hundred years, with only minor modifications.

Originally it was intended for short range travels, especially between stations orbiting the same planet. It was an instant hit among independent couriers. Also well known and appreciated model amongst sportsmen the tuning communities around the galaxy due to it's simple and reliable build.

It's a niche craft in some regards, because of its small size, which limits its usefulness for longer trips. Even this doesn't discourage the hardcore couriers, who compete constantly, who can endure the longest trip in its cramped cockpit. It's common practice to squeeze a Class 1 Hyperdrive and one ton of Hydrogen in. This gives gives the Varada about 60 light year range. It's not for the faint of heart though since typical travel times are at about 60 days for that range which is quite taxing both for the pilot and the craft. And this practice is strongly discouraged by most governments.
There are even official endurance rallies spanning over several weeks or months.

Apart from endurance competitions, there are several fast paced racing events around SolFed space, with a slightly modified version. All pilots fly similarly built crafts, to make sure that it's a test of the pilots ability, not the amount of money available to any given team.

The Varada is also popular amongst ordinary people, due to its good performance and relative cheapness. It makes for a very fine recreational craft.

==Improvements and changes==

The Varada saw several updates to its components throughout the century. These were mostly regarding engine performance and handling. The basic model could be easily refitted with a fuel scoop adapter to its air intake, making it able to endure quite long trips.

== Other uses ==

Varada's uses are quite limited due to its small size and capacity. It's sometimes used as a cheap police vessel in poorer systems, usually with some kind of jury rigged weaponry. It doesn't really make a good fighter, because it lacks the needed protection, but it can be a formidable opponent in the hands of an experienced pilot, because of its good maneuverability and low profile.

It's common for bulk ships to bring along one or two of these crafts, so there's a good, flexible, and light vessel available if the need arises. Its vertically pronounced layout makes it easy to store.