.. sectnum::
Deep Space Trader 1.3.0
-----------------------
.. image:: images/readme_image.png
Deep Space Trader is a turn-based strategy game inspired by, and similar in gameplay to,
the old DOS game "Drugwars".
..
.. contents:: Table Of Contents
Install
=======
Pre-built windows binary
########################
Download the `Windows x64 installer <https://github.com/eriknyquist/deep_space_trader/releases/latest>`_
Python package
##############
Install as a python package:
::
pip install deep_space_trader
Introduction
============
The player starts off on a planet within a system of 8 randomly-generated planets.
Each planet has various raw materials available for trading (13 types of raw material in total),
all with prices that differ from planet to planet, and fluctuate over time. The goal of the game
is to make as much money as possible by buying and selling raw materials between planets.
The player has an item inventory for raw materials, with a fixed (but upgradeable) capacity.
Only items in the inventory can be bought or sold. The player also has a warehouse with unlimited
capacity. Items can be transferred between the item inventory and the warehouse, but only
a certain number of transfers between item inventory and warehouse can be made per day.
Travelling between planets always incurs a risk of encountering pirates, who may
kill the player or rob them of their money / raw materials. The greater the value that the
player is travelling with (combined value of player's money and items in the player's inventory,
but not the warehouse), the greater the chance of encountering pirates.
The player can use any earned money to buy "upgrades" from a store. Only a certain number of
store purchases can be made per day. Some of the upgrades
allow the player to:
* Destroy planets altogether and acquire all their raw materials
(Destroying a planet incurs a risk that the planet may fight to resist, which may kill the player)
* Buy and upgrade a battle fleet, which increases chances of winning fights against pirates,
and against planets that resist destruction
* Buy and upgrade a scout fleet, which allows the player to discover thousands of
new planets
* Upgrade the player's inventory capacity, which increases the number of items that can
be bought or sold at once.
* Increment the number of warehouse trips allowed per day
Complete Game Reference
=======================
This following section describes the functionality of all sections of all game windows
in detail. Each game window has its own section in this document, with further document subsections
for sections within the game window.
**Main window**
###############
This section describes the functionality of all sections on the main game window
(the largest window, which opens on game startup). Each section in the main game window
has its own section in this document.
**"Information" section**
+++++++++++++++++++++++++
.. image:: images/information_section.png
This section describes the functionality of the "Information" section of the main game window.
The "Information" section stretches across the entire top of the main game window, and
shows useful information about the current state of the game.
* **"Current Planet"**: Shows the name of, and an image of, the current planet the player is on.
* **"Current Day"**: Shows the current day number, against the total number of days before the game ends.
* **"Money"**: Shows the amount of money currently held by the player.
* **"Purchases"**: Shows the number of store purchases made by the player so far on the current day, against
the total number of store purchases allowed on the current day (see `"Store" window`_ for more information).
* **"Planets discovered"**: Shows the total number of planets that have been discovered by the player.
This number includes planets that have not been visited by the player, and planets that have been
destroyed by the player.
* **"Scout fleet level"**: Shows the current upgrade level of the players scout fleet, against the
maximum possible upgrade level for the players scout fleet. (see `"Store" window`_ for more information
about upgrading the scout fleet).
* **"Battle fleet"**: Shows the current upgrade level of the players battle fleet, against the
maximum possible upgrade level for the players battle fleet. Also shows the chance (percentage) of
the player winning a battle, based on current battle fleet upgrade level. (see `"Store" window`_ for more
information about upgrading the battle fleet).
**Global buttons section**
++++++++++++++++++++++++++
.. image:: images/global_buttons_section.png
This section describes the functionality of the 3 large buttons at the top of the
main game window, directly underneath the "Information" section.
* **"Reset" button**: Aborts the current game and starts a new game (Warning: player will lose
all progress in the current game. When clicked, this button will first show a prompt,
asking the player to confirm that they want to reset the game).
* **"Go to store" button**: Opens the Store window. See `"Store" window`_ for more details.
* **"Go to next day" button**: Advances the current day by 1. Often, the next day is reached by
travelling to another planet, but this button advances to the next day without travelling.
**"Planets" section**
+++++++++++++++++++++
.. image:: images/planets_section.png
This section describes the functionality of the "Planets" section of the main game
window. The "Planets" section is used for travelling between planets, and allows the player
to select the planet they want to travel to. The "Planets" section is displayed in the middle
left area of the main game window.
* **"Travel..." button**: Causes the player to travel to the selected planet. The player can also
travel to a planet by double-clicking on the planet name in the "Planets" section. Travelling
to a planet costs 100 of the player's money, and advances the current day by 1. Travelling always
incurs a risk of encountering a pirate fleet. When encountered, the player will be given the choice
to fight or not. If the player chooses to fight, and wins, then the player can continue their journey
unscathed. If the player chooses to fight, and loses, then the player will die, and the game will end.
The chance of the player winning a fight against pirates is directly correlated to the upgrade level
of the players battle fleet (See `"Store" window`_). If the player chooses not to fight, then they
will not die, but the pirates will steal (almost) all of the players money, and all of the items
stored on the players ship. Items stored in the warehouse cannot be touched by pirates.
* **"Travel to previous" button**: Causes the player to travel to the planet that they were on
directly before the current planet. Travelling to a planet costs 100 of the player's money,
and advances the current day by 1.
* **Planet display table**: shows a list of all planets available to the player. Consists of two
columns: The rightmost column, labelled "visited?", shows "yes" or "no" indicating whether
the player has travelled to the planet. The leftmost column, labelled "Planet", shows the
name of the planet. The player can travel to a planet by double-clicking on the planet name
within the planet display table.
**"Items on current planet" section**
+++++++++++++++++++++++++++++++++++++
.. image:: images/planet_items_section.png
This section describes the functionality of the "Items on current planet" section of the main
game window. The "Items on current planet" section is used for browsing & buying items from
the planet that the player is currently on. The "Items on current planet" section is displayed
in the bottom left area of the main game window.
* **"Buy item" button**: Allows the player to purchase 1 or more of the selected items in the
item display table. When clicked, this button will open a new window that allows the player to
select the quantity they wish to purchase of the selected item (See `"Buy item" window`_ reference
section in this document for more details about this window).
* **Item display table**: Displays all items available for purchase on the current planet.
Consists of three columns: The rightmost column, labelled "Cost", displays the cost of 1
item. The middle column, labelled "Quantity available", shows the number of items available
for purchase on the current planet. The leftmost column, labelled "Item type", shows the
item name. The player can attempt to buy an item by double-clicking on the item name
within the item display table. Pressing enter with an item selected will display a new
window showing the item price over time (from day 1 until the current day).
**"Items on your ship" section**
++++++++++++++++++++++++++++++++
.. image:: images/ship_items_section.png
This section describes the functionality of the "Items on your ship" section of the main
game window. The "Items on your ship" section is used for browsing / managing items that
reside on the players ship, that have either been purchased from a planet or that have been
retrieved from the warehouse. The "Items on your ship" section is displayed in the middle
right area of the main game window.
* **"Sell items" button**: Allows the player to attempt to sell 1 or more of the selected
item to the current planet. When clicked, this button will open a new window that allows
the player to select the quantity they wish to sell of the selected item (See `"Sell items" window`_).
If the current planet does not already hold any of the selected item, then the player
will be asked if they want to provide a free (small quantity) sample of the item.
If the player does not provide a free sample, then the item cannot be sold to the current
planet. If the player does provide a free sample, then the planet may or may not decide to
begin trading in the selected item. Only one free sample of a given item may be given to
the same planet in the same day.
* **"Sell all" button**: Allows the player to attempt to sell all items on the ship to
the current planet. Only items that the current planet already holds will be sold
(free samples can only be provided via the "Sell items" button).
* **"Add to warehouse" button**: Allows the player to move 1 or more of the selected item
from their ship to the warehouse. Unlike the player's ship, the warehouse has infinite
capacity, but only one move to/from the warehouse per day is allowed (i.e. one trip
to the warehouse per day). Additional warehouse trips per day can be purchased from the Store
(See `"Store" window`_ for more details about the store window).
Clicking this button opens a new window that allows the player to select the quantity of
the item they want to move to the warehouse (see `"Move to warehouse" window`_).
* **"Dump selected" button**: Throws away the selected items to free up capacity on the
player's ship. Opens a new window that allows the player to select the quantity they wish to
dump of the selected item (See `"Dump player items" window`_).
* **"Dump all" button**: Throws away all items on the players ship.
* **Item display table**: Displays all items stored on the player's ship. Consists of
two columns: The rightmost column, labelled "Quantity", shows the number of items stored
on the player's ship. The leftmost column, labelled "Item type", shows the item name. The
player can attempt to sell an item by double-clicking on the item name within the item
display table.
**"Items in warehouse" section**
++++++++++++++++++++++++++++++++
.. image:: images/warehouse_section.png
This section describes the functionality of the "Items in warehouse" section of the main
game window. The "Items in warehouse" section is used for browsing / managing items that
reside in the warehouse. The "Items in warehouse" section is displayed in the bottom
right area of the main game window.
* **"Retrieve items" button**: Allows the player to move 1 or more of the selected items
from the warehouse to their ship. Only one move to/from the warehouse per day is allowed
(i.e. one trip to the warehouse per day). Clicking this button opens a new window that
allows the player to select the quantity of the item they want to move to their ship (see
`"Retrieve from warehouse" window`_).
* **"Retrieve all" button**: Moves all warehouse items (or however many will fit) to the
player's ship.
* **"Dump selected" button**: Throws away the selected items from the warehouse. Opens a new
window that allows the player to select the quantity they wish to dump of the selected items
(see `"Dump warehouse items" window`_).
* **"Dump all" button**: Throws away all items in the warehouse.
* **Item display table**: Displays all items stored in the warehouse. Consists of
two columns: The rightmost column, labelled "Quantity", shows the number of items stored
in the warehouse. The leftmost column, labelled "Item type", shows the item name. The
player can move an item to their ship by double-clicking on the item name within the item
display table.
**"Store" window**
##################
.. image:: images/store.png
This section describes the functionality of the "Store" window. The store window can be reached
by clicking the "Go to store" button in the `Global buttons section`_ of the main window. The
store window allows the player to exchange money for various upgrades and services. Only 4 store
purchases can be made per day, but this number is increased when the player reaches certain scores
(see `Score bonuses`_ for more information).
* **Increase item capacity**: Buying this item doubles the number of items that can be
stored on the players ship. This item can be bought an unlimited number of times.
* **Scout expedition**: Buying this item allows the player to discover between 4-8 new planets,
which will become available in the `"Planets" section`_. More planets can be discovered per
scout expedition by purchasing the "Upgrade scout fleet" store item.
* **Planet destruction kit**: Buying this item allows the player to destroy one planet and obtain
all of its materials. The planet will disappear from the `"Planets" section`_ and all materials
held by the planet will be transferred to the player's warehouse. Opens a new window that allows
the player to pick which planet they want to destroy, or optionally destroy all planets at once
(except for the current planet) for a higher price. There is a small chance that a single planet may
resist destruction and attempt to fight back. The higher number of planets being destroyed, the
higher the chance of one planet resisting will be. The player must decide whether to fight, or leave
the planet alone. If the player fights and loses, the player will die and the game will be over.
If the player fights and wins, then planet destruction will continue normally. The chance of
the player winning this fight depends on the player's battle fleet level.
* **Upgrade scout fleet**: Buying this item increases the number of planets than can be
discovered on a single scout expedition. This item can be bought a maximum of 9 times,
to upgrade the scout fleet through levels 1 to 10.
* *Scout fleet level 1*: between 4 and 8 new planets per scout expedition
* *Scout fleet level 2*: between 4 and 16 new planets per scout expedition
* *Scout fleet level 3*: between 4 and 32 new planets per scout expedition
* *Scout fleet level 4*: between 4 and 64 new planets per scout expedition
* *Scout fleet level 5*: between 4 and 128 new planets per scout expedition
* *Scout fleet level 6*: between 4 and 256 new planets per scout expedition
* *Scout fleet level 7*: between 4 and 512 new planets per scout expedition
* *Scout fleet level 8*: between 4 and 1024 new planets per scout expedition
* *Scout fleet level 9*: between 4 and 2048 new planets per scout expedition
* *Scout fleet level 10*: between 4 and 4096 new planets per scout expedition
* **Buy/upgrade battle fleet**: Buying this item for the first time gives the player a
battle fleet, which increases the chances of the player winning battles against planets
that resist destruction, or when being robbed while travelling between planets. Subsequent
purchases of this item upgrade the battle fleet through levels 1-10.
* *Battle fleet level 0 (no battle fleet)*: 1% chance of winning battles
* *Battle fleet level 1*: 10% chance of winning battles
* *Battle fleet level 2*: 15% chance of winning battles
* *Battle fleet level 3*: 20% chance of winning battles
* *Battle fleet level 4*: 25% chance of winning battles
* *Battle fleet level 5*: 35% chance of winning battles
* *Battle fleet level 6*: 50% chance of winning battles
* *Battle fleet level 7*: 65% chance of winning battles
* *Battle fleet level 8*: 80% chance of winning battles
* *Battle fleet level 9*: 95% chance of winning battles
* *Battle fleet level 10*: 99% chance of winning battles
* **Increase warehouse limit**: Buying this item will increase by 1 the number of warehouse trips
that the player can make in a single day.
**"Buy item" window**
#####################
.. image:: images/buy_window.png
This section describes the functionality of the "Buy" window. The "Buy" window is displayed
when the player clicks the "Buy item" button in the `"Items on current planet" section`_.
* **"Buy" button**: Purchases the selected quantity of the item. This button will do nothing
when the selected quantity is 0.
* **"Cancel" button**: Cancels the transaction.
* **"Max" button**: Automatically sets the quantity to the maximum number of items available,
or the maximum number of items that the player can afford (whichever is smaller).
**"Sell items" window**
#######################
.. image:: images/sell_window.png
This section describes the functionality of the "Sell" window. The "Sell" window is displayed
when the player clicks the "Sell items" button in the `"Items on your ship" section`_.
* **"Sell" button**: Sells the selected quantity of the item. This button will do nothing
when the selected quantity is 0.
* **"Cancel" button**: Cancels the transaction.
* **"Max" button**: Automatically sets the quantity to the maximum number of items available
to sell.
**"Dump player items" window**
##############################
.. image:: images/dump_ship_window.png
This section describes the functionality of the "Dump player items" window. The "Dump player items"
window is displayed when the player clicks the "Dump selected" button in the `"Items on your ship" section`_.
* **"Dump" button**: Dumps the selected quantity of the item. This button will do nothing
when the selected quantity is 0.
* **"Cancel" button**: Cancels the item dump.
* **"Max" button**: Automatically sets the quantity to the maximum number of items available
on the players ship.
**"Move to warehouse" window**
##############################
.. image:: images/to_warehouse_window.png
This section describes the functionality of the "Move to warehouse" window. The "Move to warehouse"
window is displayed when the player clicks the "Add to warehouse" button in the `"Items on your ship" section`_.
* **"Move" button**: Moves the selected quantity of the item to the warehouse. This button will do nothing
when the selected quantity is 0.
* **"Cancel" button**: Cancels the item move.
* **"Max" button**: Automatically sets the quantity to the maximum number of items available
on the players ship.
**"Dump warehouse items" window**
#################################
.. image:: images/dump_warehouse_window.png
This section describes the functionality of the "Dump warehouse items" window. The "Dump warehouse items"
window is displayed when the player clicks the "Dump selected" button in the `"Items in warehouse" section`_.
* **"Dump" button**: Dumps the selected quantity of the item. This button will do nothing
when the selected quantity is 0.
* **"Cancel" button**: Cancels the item dump.
* **"Max" button**: Automatically sets the quantity to the maximum number of items available
in the warehouse.
**"Retrieve from warehouse" window**
####################################
.. image:: images/from_warehouse_window.png
This section describes the functionality of the "Retrieve from warehouse" window. The "Retrieve from warehouse"
window is displayed when the player clicks the "Retrieve items" button in the `"Items in warehouse" section`_.
* **"Move" button**: Moves the selected quantity of the item to the player's ship. This button will do nothing
when the selected quantity is 0.
* **"Cancel" button**: Cancels the item move.
* **"Max" button**: Automatically sets the quantity to the maximum number of items available
in the warehouse, or the maximum number of items that can fit on the player's ship (whichever is smaller).
**Item price history window**
#############################
.. image:: images/price_graph_window.png
The price graph window shows the changing price of an item on a particular planet over time
(from day 1 until the current day). The price graph window is displayed when the player selects
an item in the `"Planets" section`_ and presses enter.
**"High score sharing" window**
###############################
.. image:: images/high_score_sharing_window.png
This section describes the functionality of the "High score sharing" window. The "High score sharing"
window is displayed when the "High score sharing" option is selected from the "File" menu in the
main game window (e.g. **File->High score sharing**). The "High score sharing" window can also be
opened via the keyboard shortcut Ctrl-R.
The "High score sharing" window allows players to share high scores, by copying/sharing an "encrypted"
string containing the players high scores. When a player copies another player's string into their
"High score sharing" window, then the scores contained within the string will be added to the player's
own high scores.
* **To share your high scores with someone else**: Copy the string displayed in the top section of
the "High score sharing" window, and give it to the other player that you wish to share scores with.
* **To add someone elses high scores to your game**: Paste the string provided by another player into
the bottom section of the "High score sharing" window, and click the "Add high scores" button at the
bottom of the "High score sharing" window. The other players scores will be added to your high score table.
**"Prices" window**
###################
.. image:: images/material_prices_window.png
The section describes the functionality of the "Prices" window. The "Prices" window is displayed
when the "Material prices" option is selected from the "Tools" menu in the main game window
(e.g. **Tools->Material Prices**). The "Prices" window can also be opened via the keyboard shortcut Ctrl-A.
The "Prices" window shows the usual price for all materials, and can be used as a trading reference.
The "Prices" window does *not* show the exact item prices for any particular planet. Planets will set their
own item prices, and the prices in the "Prices" window are merely suggestions for them.
**"Travel log" window**
#######################
.. image:: images/travel_log_window.png
This section describes the functionality of the "Travel log" window. The "Travel log" window
is displayed when the "Show travel log" option is selected from the "Tools" menu (e.g.
**Tools->Show travel log**). The "Travel log" window can also be opened via the keyboard shortcut
Ctrl-S.
The "Travel log" shows all planets that the player has travelled to, in chronological order, along
with the day on which they were travelled to.
**"Transaction log" window**
############################
.. image:: images/transaction_log_window.png
This section describes the functionality of the "Transaction log" window. The "Transaction log" window
is displayed when the "Show transaction log" option is selected from the "Tools" menu (e.g.
**Tools->Show transaction log**). The "Transaction log" window can also be opened via the keyboard shortcut
Ctrl-T.
The "Transaction log" shows all material sales/purchases made by the player, in chronological order, along
with the day on which the transaction occurred and the planet involved in the transaction.
**Miscellaneous details**
#########################
This section describes miscellaneous functionality that is not necessarily related
to any particular game window.
Score bonuses
+++++++++++++
When the player reaches 1,000,000,000 money, the total number of days is increased from 30 to 35,
and the number of store purchases allowed per day is increased from 4 to 5.
When the player reaches 100,000,000,000 money, the total number of days is increased from 35 to 40,
and the number of store purchases allowed per day is increased from 5 to 6.
Raw data
{
"_id": null,
"home_page": "http://github.com/eriknyquist/deep_space_trader",
"name": "deep-space-trader",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Erik Nyquist",
"author_email": "eknyquist@gmail.com",
"download_url": null,
"platform": null,
"description": ".. sectnum::\n\nDeep Space Trader 1.3.0\n-----------------------\n\n.. image:: images/readme_image.png\n\nDeep Space Trader is a turn-based strategy game inspired by, and similar in gameplay to,\nthe old DOS game \"Drugwars\".\n\n..\n .. contents:: Table Of Contents\n\nInstall\n=======\n\nPre-built windows binary\n########################\n\nDownload the `Windows x64 installer <https://github.com/eriknyquist/deep_space_trader/releases/latest>`_\n\nPython package\n##############\n\nInstall as a python package:\n\n::\n\n pip install deep_space_trader\n\nIntroduction\n============\n\nThe player starts off on a planet within a system of 8 randomly-generated planets.\nEach planet has various raw materials available for trading (13 types of raw material in total),\nall with prices that differ from planet to planet, and fluctuate over time. The goal of the game\nis to make as much money as possible by buying and selling raw materials between planets.\n\nThe player has an item inventory for raw materials, with a fixed (but upgradeable) capacity.\nOnly items in the inventory can be bought or sold. The player also has a warehouse with unlimited\ncapacity. Items can be transferred between the item inventory and the warehouse, but only\na certain number of transfers between item inventory and warehouse can be made per day.\n\nTravelling between planets always incurs a risk of encountering pirates, who may\nkill the player or rob them of their money / raw materials. The greater the value that the\nplayer is travelling with (combined value of player's money and items in the player's inventory,\nbut not the warehouse), the greater the chance of encountering pirates.\n\nThe player can use any earned money to buy \"upgrades\" from a store. Only a certain number of\nstore purchases can be made per day. Some of the upgrades\nallow the player to:\n\n* Destroy planets altogether and acquire all their raw materials\n (Destroying a planet incurs a risk that the planet may fight to resist, which may kill the player)\n\n* Buy and upgrade a battle fleet, which increases chances of winning fights against pirates,\n and against planets that resist destruction\n\n* Buy and upgrade a scout fleet, which allows the player to discover thousands of\n new planets\n\n* Upgrade the player's inventory capacity, which increases the number of items that can\n be bought or sold at once.\n\n* Increment the number of warehouse trips allowed per day\n\nComplete Game Reference\n=======================\n\nThis following section describes the functionality of all sections of all game windows\nin detail. Each game window has its own section in this document, with further document subsections\nfor sections within the game window.\n\n**Main window**\n###############\n\nThis section describes the functionality of all sections on the main game window\n(the largest window, which opens on game startup). Each section in the main game window\nhas its own section in this document.\n\n**\"Information\" section**\n+++++++++++++++++++++++++\n\n.. image:: images/information_section.png\n\nThis section describes the functionality of the \"Information\" section of the main game window.\nThe \"Information\" section stretches across the entire top of the main game window, and\nshows useful information about the current state of the game.\n\n* **\"Current Planet\"**: Shows the name of, and an image of, the current planet the player is on.\n* **\"Current Day\"**: Shows the current day number, against the total number of days before the game ends.\n* **\"Money\"**: Shows the amount of money currently held by the player.\n* **\"Purchases\"**: Shows the number of store purchases made by the player so far on the current day, against\n the total number of store purchases allowed on the current day (see `\"Store\" window`_ for more information).\n* **\"Planets discovered\"**: Shows the total number of planets that have been discovered by the player.\n This number includes planets that have not been visited by the player, and planets that have been\n destroyed by the player.\n* **\"Scout fleet level\"**: Shows the current upgrade level of the players scout fleet, against the\n maximum possible upgrade level for the players scout fleet. (see `\"Store\" window`_ for more information\n about upgrading the scout fleet).\n* **\"Battle fleet\"**: Shows the current upgrade level of the players battle fleet, against the\n maximum possible upgrade level for the players battle fleet. Also shows the chance (percentage) of\n the player winning a battle, based on current battle fleet upgrade level. (see `\"Store\" window`_ for more\n information about upgrading the battle fleet).\n\n**Global buttons section**\n++++++++++++++++++++++++++\n\n.. image:: images/global_buttons_section.png\n\nThis section describes the functionality of the 3 large buttons at the top of the\nmain game window, directly underneath the \"Information\" section.\n\n* **\"Reset\" button**: Aborts the current game and starts a new game (Warning: player will lose\n all progress in the current game. When clicked, this button will first show a prompt,\n asking the player to confirm that they want to reset the game).\n\n* **\"Go to store\" button**: Opens the Store window. See `\"Store\" window`_ for more details.\n\n* **\"Go to next day\" button**: Advances the current day by 1. Often, the next day is reached by\n travelling to another planet, but this button advances to the next day without travelling.\n\n**\"Planets\" section**\n+++++++++++++++++++++\n\n.. image:: images/planets_section.png\n\nThis section describes the functionality of the \"Planets\" section of the main game\nwindow. The \"Planets\" section is used for travelling between planets, and allows the player\nto select the planet they want to travel to. The \"Planets\" section is displayed in the middle\nleft area of the main game window.\n\n* **\"Travel...\" button**: Causes the player to travel to the selected planet. The player can also\n travel to a planet by double-clicking on the planet name in the \"Planets\" section. Travelling\n to a planet costs 100 of the player's money, and advances the current day by 1. Travelling always\n incurs a risk of encountering a pirate fleet. When encountered, the player will be given the choice\n to fight or not. If the player chooses to fight, and wins, then the player can continue their journey\n unscathed. If the player chooses to fight, and loses, then the player will die, and the game will end.\n The chance of the player winning a fight against pirates is directly correlated to the upgrade level\n of the players battle fleet (See `\"Store\" window`_). If the player chooses not to fight, then they\n will not die, but the pirates will steal (almost) all of the players money, and all of the items\n stored on the players ship. Items stored in the warehouse cannot be touched by pirates.\n\n* **\"Travel to previous\" button**: Causes the player to travel to the planet that they were on\n directly before the current planet. Travelling to a planet costs 100 of the player's money,\n and advances the current day by 1.\n\n* **Planet display table**: shows a list of all planets available to the player. Consists of two\n columns: The rightmost column, labelled \"visited?\", shows \"yes\" or \"no\" indicating whether\n the player has travelled to the planet. The leftmost column, labelled \"Planet\", shows the\n name of the planet. The player can travel to a planet by double-clicking on the planet name\n within the planet display table.\n\n\n**\"Items on current planet\" section**\n+++++++++++++++++++++++++++++++++++++\n\n.. image:: images/planet_items_section.png\n\nThis section describes the functionality of the \"Items on current planet\" section of the main\ngame window. The \"Items on current planet\" section is used for browsing & buying items from\nthe planet that the player is currently on. The \"Items on current planet\" section is displayed\nin the bottom left area of the main game window.\n\n* **\"Buy item\" button**: Allows the player to purchase 1 or more of the selected items in the\n item display table. When clicked, this button will open a new window that allows the player to\n select the quantity they wish to purchase of the selected item (See `\"Buy item\" window`_ reference\n section in this document for more details about this window).\n\n* **Item display table**: Displays all items available for purchase on the current planet.\n Consists of three columns: The rightmost column, labelled \"Cost\", displays the cost of 1\n item. The middle column, labelled \"Quantity available\", shows the number of items available\n for purchase on the current planet. The leftmost column, labelled \"Item type\", shows the\n item name. The player can attempt to buy an item by double-clicking on the item name\n within the item display table. Pressing enter with an item selected will display a new\n window showing the item price over time (from day 1 until the current day).\n\n\n**\"Items on your ship\" section**\n++++++++++++++++++++++++++++++++\n\n.. image:: images/ship_items_section.png\n\nThis section describes the functionality of the \"Items on your ship\" section of the main\ngame window. The \"Items on your ship\" section is used for browsing / managing items that\nreside on the players ship, that have either been purchased from a planet or that have been\nretrieved from the warehouse. The \"Items on your ship\" section is displayed in the middle\nright area of the main game window.\n\n* **\"Sell items\" button**: Allows the player to attempt to sell 1 or more of the selected\n item to the current planet. When clicked, this button will open a new window that allows\n the player to select the quantity they wish to sell of the selected item (See `\"Sell items\" window`_).\n If the current planet does not already hold any of the selected item, then the player\n will be asked if they want to provide a free (small quantity) sample of the item.\n If the player does not provide a free sample, then the item cannot be sold to the current\n planet. If the player does provide a free sample, then the planet may or may not decide to\n begin trading in the selected item. Only one free sample of a given item may be given to\n the same planet in the same day.\n\n* **\"Sell all\" button**: Allows the player to attempt to sell all items on the ship to\n the current planet. Only items that the current planet already holds will be sold\n (free samples can only be provided via the \"Sell items\" button).\n\n* **\"Add to warehouse\" button**: Allows the player to move 1 or more of the selected item\n from their ship to the warehouse. Unlike the player's ship, the warehouse has infinite\n capacity, but only one move to/from the warehouse per day is allowed (i.e. one trip\n to the warehouse per day). Additional warehouse trips per day can be purchased from the Store\n (See `\"Store\" window`_ for more details about the store window).\n Clicking this button opens a new window that allows the player to select the quantity of\n the item they want to move to the warehouse (see `\"Move to warehouse\" window`_).\n\n* **\"Dump selected\" button**: Throws away the selected items to free up capacity on the\n player's ship. Opens a new window that allows the player to select the quantity they wish to\n dump of the selected item (See `\"Dump player items\" window`_).\n\n* **\"Dump all\" button**: Throws away all items on the players ship.\n\n* **Item display table**: Displays all items stored on the player's ship. Consists of\n two columns: The rightmost column, labelled \"Quantity\", shows the number of items stored\n on the player's ship. The leftmost column, labelled \"Item type\", shows the item name. The\n player can attempt to sell an item by double-clicking on the item name within the item\n display table.\n\n**\"Items in warehouse\" section**\n++++++++++++++++++++++++++++++++\n\n.. image:: images/warehouse_section.png\n\nThis section describes the functionality of the \"Items in warehouse\" section of the main\ngame window. The \"Items in warehouse\" section is used for browsing / managing items that\nreside in the warehouse. The \"Items in warehouse\" section is displayed in the bottom\nright area of the main game window.\n\n* **\"Retrieve items\" button**: Allows the player to move 1 or more of the selected items\n from the warehouse to their ship. Only one move to/from the warehouse per day is allowed\n (i.e. one trip to the warehouse per day). Clicking this button opens a new window that\n allows the player to select the quantity of the item they want to move to their ship (see\n `\"Retrieve from warehouse\" window`_).\n\n* **\"Retrieve all\" button**: Moves all warehouse items (or however many will fit) to the\n player's ship.\n\n* **\"Dump selected\" button**: Throws away the selected items from the warehouse. Opens a new\n window that allows the player to select the quantity they wish to dump of the selected items\n (see `\"Dump warehouse items\" window`_).\n\n* **\"Dump all\" button**: Throws away all items in the warehouse.\n\n* **Item display table**: Displays all items stored in the warehouse. Consists of\n two columns: The rightmost column, labelled \"Quantity\", shows the number of items stored\n in the warehouse. The leftmost column, labelled \"Item type\", shows the item name. The\n player can move an item to their ship by double-clicking on the item name within the item\n display table.\n\n**\"Store\" window**\n##################\n\n.. image:: images/store.png\n\nThis section describes the functionality of the \"Store\" window. The store window can be reached\nby clicking the \"Go to store\" button in the `Global buttons section`_ of the main window. The\nstore window allows the player to exchange money for various upgrades and services. Only 4 store\npurchases can be made per day, but this number is increased when the player reaches certain scores\n(see `Score bonuses`_ for more information).\n\n* **Increase item capacity**: Buying this item doubles the number of items that can be\n stored on the players ship. This item can be bought an unlimited number of times.\n\n* **Scout expedition**: Buying this item allows the player to discover between 4-8 new planets,\n which will become available in the `\"Planets\" section`_. More planets can be discovered per\n scout expedition by purchasing the \"Upgrade scout fleet\" store item.\n\n* **Planet destruction kit**: Buying this item allows the player to destroy one planet and obtain\n all of its materials. The planet will disappear from the `\"Planets\" section`_ and all materials\n held by the planet will be transferred to the player's warehouse. Opens a new window that allows\n the player to pick which planet they want to destroy, or optionally destroy all planets at once\n (except for the current planet) for a higher price. There is a small chance that a single planet may\n resist destruction and attempt to fight back. The higher number of planets being destroyed, the\n higher the chance of one planet resisting will be. The player must decide whether to fight, or leave\n the planet alone. If the player fights and loses, the player will die and the game will be over.\n If the player fights and wins, then planet destruction will continue normally. The chance of\n the player winning this fight depends on the player's battle fleet level.\n\n* **Upgrade scout fleet**: Buying this item increases the number of planets than can be\n discovered on a single scout expedition. This item can be bought a maximum of 9 times,\n to upgrade the scout fleet through levels 1 to 10.\n\n * *Scout fleet level 1*: between 4 and 8 new planets per scout expedition\n * *Scout fleet level 2*: between 4 and 16 new planets per scout expedition\n * *Scout fleet level 3*: between 4 and 32 new planets per scout expedition\n * *Scout fleet level 4*: between 4 and 64 new planets per scout expedition\n * *Scout fleet level 5*: between 4 and 128 new planets per scout expedition\n * *Scout fleet level 6*: between 4 and 256 new planets per scout expedition\n * *Scout fleet level 7*: between 4 and 512 new planets per scout expedition\n * *Scout fleet level 8*: between 4 and 1024 new planets per scout expedition\n * *Scout fleet level 9*: between 4 and 2048 new planets per scout expedition\n * *Scout fleet level 10*: between 4 and 4096 new planets per scout expedition\n\n* **Buy/upgrade battle fleet**: Buying this item for the first time gives the player a\n battle fleet, which increases the chances of the player winning battles against planets\n that resist destruction, or when being robbed while travelling between planets. Subsequent\n purchases of this item upgrade the battle fleet through levels 1-10.\n\n * *Battle fleet level 0 (no battle fleet)*: 1% chance of winning battles\n * *Battle fleet level 1*: 10% chance of winning battles\n * *Battle fleet level 2*: 15% chance of winning battles\n * *Battle fleet level 3*: 20% chance of winning battles\n * *Battle fleet level 4*: 25% chance of winning battles\n * *Battle fleet level 5*: 35% chance of winning battles\n * *Battle fleet level 6*: 50% chance of winning battles\n * *Battle fleet level 7*: 65% chance of winning battles\n * *Battle fleet level 8*: 80% chance of winning battles\n * *Battle fleet level 9*: 95% chance of winning battles\n * *Battle fleet level 10*: 99% chance of winning battles\n\n* **Increase warehouse limit**: Buying this item will increase by 1 the number of warehouse trips\n that the player can make in a single day.\n\n**\"Buy item\" window**\n#####################\n\n.. image:: images/buy_window.png\n\nThis section describes the functionality of the \"Buy\" window. The \"Buy\" window is displayed\nwhen the player clicks the \"Buy item\" button in the `\"Items on current planet\" section`_.\n\n* **\"Buy\" button**: Purchases the selected quantity of the item. This button will do nothing\n when the selected quantity is 0.\n\n* **\"Cancel\" button**: Cancels the transaction.\n\n* **\"Max\" button**: Automatically sets the quantity to the maximum number of items available,\n or the maximum number of items that the player can afford (whichever is smaller).\n\n**\"Sell items\" window**\n#######################\n\n.. image:: images/sell_window.png\n\nThis section describes the functionality of the \"Sell\" window. The \"Sell\" window is displayed\nwhen the player clicks the \"Sell items\" button in the `\"Items on your ship\" section`_.\n\n* **\"Sell\" button**: Sells the selected quantity of the item. This button will do nothing\n when the selected quantity is 0.\n\n* **\"Cancel\" button**: Cancels the transaction.\n\n* **\"Max\" button**: Automatically sets the quantity to the maximum number of items available\n to sell.\n\n**\"Dump player items\" window**\n##############################\n\n.. image:: images/dump_ship_window.png\n\nThis section describes the functionality of the \"Dump player items\" window. The \"Dump player items\"\nwindow is displayed when the player clicks the \"Dump selected\" button in the `\"Items on your ship\" section`_.\n\n* **\"Dump\" button**: Dumps the selected quantity of the item. This button will do nothing\n when the selected quantity is 0.\n\n* **\"Cancel\" button**: Cancels the item dump.\n\n* **\"Max\" button**: Automatically sets the quantity to the maximum number of items available\n on the players ship.\n\n**\"Move to warehouse\" window**\n##############################\n\n.. image:: images/to_warehouse_window.png\n\nThis section describes the functionality of the \"Move to warehouse\" window. The \"Move to warehouse\"\nwindow is displayed when the player clicks the \"Add to warehouse\" button in the `\"Items on your ship\" section`_.\n\n* **\"Move\" button**: Moves the selected quantity of the item to the warehouse. This button will do nothing\n when the selected quantity is 0.\n\n* **\"Cancel\" button**: Cancels the item move.\n\n* **\"Max\" button**: Automatically sets the quantity to the maximum number of items available\n on the players ship.\n\n**\"Dump warehouse items\" window**\n#################################\n\n.. image:: images/dump_warehouse_window.png\n\nThis section describes the functionality of the \"Dump warehouse items\" window. The \"Dump warehouse items\"\nwindow is displayed when the player clicks the \"Dump selected\" button in the `\"Items in warehouse\" section`_.\n\n* **\"Dump\" button**: Dumps the selected quantity of the item. This button will do nothing\n when the selected quantity is 0.\n\n* **\"Cancel\" button**: Cancels the item dump.\n\n* **\"Max\" button**: Automatically sets the quantity to the maximum number of items available\n in the warehouse.\n\n**\"Retrieve from warehouse\" window**\n####################################\n\n.. image:: images/from_warehouse_window.png\n\nThis section describes the functionality of the \"Retrieve from warehouse\" window. The \"Retrieve from warehouse\"\nwindow is displayed when the player clicks the \"Retrieve items\" button in the `\"Items in warehouse\" section`_.\n\n* **\"Move\" button**: Moves the selected quantity of the item to the player's ship. This button will do nothing\n when the selected quantity is 0.\n\n* **\"Cancel\" button**: Cancels the item move.\n\n* **\"Max\" button**: Automatically sets the quantity to the maximum number of items available\n in the warehouse, or the maximum number of items that can fit on the player's ship (whichever is smaller).\n\n**Item price history window**\n#############################\n\n.. image:: images/price_graph_window.png\n\nThe price graph window shows the changing price of an item on a particular planet over time\n(from day 1 until the current day). The price graph window is displayed when the player selects\nan item in the `\"Planets\" section`_ and presses enter.\n\n**\"High score sharing\" window**\n###############################\n\n.. image:: images/high_score_sharing_window.png\n\nThis section describes the functionality of the \"High score sharing\" window. The \"High score sharing\"\nwindow is displayed when the \"High score sharing\" option is selected from the \"File\" menu in the\nmain game window (e.g. **File->High score sharing**). The \"High score sharing\" window can also be\nopened via the keyboard shortcut Ctrl-R.\n\nThe \"High score sharing\" window allows players to share high scores, by copying/sharing an \"encrypted\"\nstring containing the players high scores. When a player copies another player's string into their\n\"High score sharing\" window, then the scores contained within the string will be added to the player's\nown high scores.\n\n* **To share your high scores with someone else**: Copy the string displayed in the top section of\n the \"High score sharing\" window, and give it to the other player that you wish to share scores with.\n\n* **To add someone elses high scores to your game**: Paste the string provided by another player into\n the bottom section of the \"High score sharing\" window, and click the \"Add high scores\" button at the\n bottom of the \"High score sharing\" window. The other players scores will be added to your high score table.\n\n**\"Prices\" window**\n###################\n\n.. image:: images/material_prices_window.png\n\nThe section describes the functionality of the \"Prices\" window. The \"Prices\" window is displayed\nwhen the \"Material prices\" option is selected from the \"Tools\" menu in the main game window\n(e.g. **Tools->Material Prices**). The \"Prices\" window can also be opened via the keyboard shortcut Ctrl-A.\n\nThe \"Prices\" window shows the usual price for all materials, and can be used as a trading reference.\nThe \"Prices\" window does *not* show the exact item prices for any particular planet. Planets will set their\nown item prices, and the prices in the \"Prices\" window are merely suggestions for them.\n\n**\"Travel log\" window**\n#######################\n\n.. image:: images/travel_log_window.png\n\nThis section describes the functionality of the \"Travel log\" window. The \"Travel log\" window\nis displayed when the \"Show travel log\" option is selected from the \"Tools\" menu (e.g.\n**Tools->Show travel log**). The \"Travel log\" window can also be opened via the keyboard shortcut\nCtrl-S.\n\nThe \"Travel log\" shows all planets that the player has travelled to, in chronological order, along\nwith the day on which they were travelled to.\n\n**\"Transaction log\" window**\n############################\n\n.. image:: images/transaction_log_window.png\n\nThis section describes the functionality of the \"Transaction log\" window. The \"Transaction log\" window\nis displayed when the \"Show transaction log\" option is selected from the \"Tools\" menu (e.g.\n**Tools->Show transaction log**). The \"Transaction log\" window can also be opened via the keyboard shortcut\nCtrl-T.\n\nThe \"Transaction log\" shows all material sales/purchases made by the player, in chronological order, along\nwith the day on which the transaction occurred and the planet involved in the transaction.\n\n**Miscellaneous details**\n#########################\n\nThis section describes miscellaneous functionality that is not necessarily related\nto any particular game window.\n\nScore bonuses\n+++++++++++++\n\nWhen the player reaches 1,000,000,000 money, the total number of days is increased from 30 to 35,\nand the number of store purchases allowed per day is increased from 4 to 5.\n\nWhen the player reaches 100,000,000,000 money, the total number of days is increased from 35 to 40,\nand the number of store purchases allowed per day is increased from 5 to 6.\n\n\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "Dumb space game",
"version": "1.3.1",
"project_urls": {
"Homepage": "http://github.com/eriknyquist/deep_space_trader"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a34379a5e3fb4b472fd8436228abfc6178a280c1bc06c7c32b893eb581b1db76",
"md5": "937430a7b2d7e5cf83cd9f47a919e4f5",
"sha256": "6ff2bc98fcd0388e32451c7be0054d8a5f3839ac8a10a2a40d313083938de2c9"
},
"downloads": -1,
"filename": "deep_space_trader-1.3.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "937430a7b2d7e5cf83cd9f47a919e4f5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 87409,
"upload_time": "2024-04-08T05:14:55",
"upload_time_iso_8601": "2024-04-08T05:14:55.524311Z",
"url": "https://files.pythonhosted.org/packages/a3/43/79a5e3fb4b472fd8436228abfc6178a280c1bc06c7c32b893eb581b1db76/deep_space_trader-1.3.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-08 05:14:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "eriknyquist",
"github_project": "deep_space_trader",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "pyqt5",
"specs": []
},
{
"name": "pyqtgraph",
"specs": []
},
{
"name": "pyqtdarktheme",
"specs": []
}
],
"lcname": "deep-space-trader"
}
JSON
