Skip to content

hellospacecorgi/spacetraders_java

Repository files navigation

👾 SpaceTraders API Java GUI Application 👾

Note: I KNOW the font color against the white table/console background is a pain to look at, I just couldn't figure out where in the CSS/scene builder setting that I messed up and couldn't make the background the same as what is shown in the menu page :(

Login account for offline version

  • Offline version can allow saving of credentials but does not guarantee successful login.
  • Only allows the account "username" "token" to be logged in (can be selected from list)
  • Manual saving required by clicking "save details" button to add to list.
  • Sign up will generate default password "token"

Run application using Gradle via CLI

gradle run --args=online for online version doing GET/POST to API

or gradle run --args=offline for offline version with dummy response data

Credentials, Tokens

  • Signup will display generated token in token text field
  • Manual saving required by clicking "save details"
  • Allow saving details (any username - token string pair) but does not check for valid pair or not
  • Saved credentials are only stored within the session (till application window closes)

The following is grouping of where to perform required actions once logged in:

Check server status

  • Displays server status (active or not) on bottom console message panel

View Info

  • Load Info to load user loans and ships
  • Displays remaining credits in bottom panel
  • Pay off loan to pay off loan after selecting loanID (Load Info required beforehand)

Loans

  • View Loans to list available loans and details
  • Take Out Loan to obtain loan (require viewing loans and selecting type beforehand)

Purchase Ships

  • View Ships to list available ships and details
  • Purchase Ship require viewing ships and selecting type, purchase location beforehand
  • Purchase Ship Fuel require Load My Ships and then selecting ShipID

Marketplace

  • Response and error messages in bottom left panel, instructions in bottom right
  • View Marketplace require selecting location, response message in bottom left panel.
  • Place Order require viewing marketplace, Load My Ships and selecting ShipID, Good and Quantity

Sell Trade Goods

  • Place Sell Order to sell goods to marketplace (Require Load My Ships for loading Ship ID)
  • Load Cargos to see what goods are available for selling on that ship (after selecting Ship ID)
  • Select ShipID , Good and Quantity before placing Sell Order
  • Response and error messages in bottom left panel, instructions in bottom right

Flight Plan

  • View Nearby Planets to list nearby locations and details (require selecting system)
  • View Nearby Planets, Load My Ships required (load ShipID and destination list) before Create Flight Plan
  • View Flight Plan after selecting PlanID
  • Response and error messages in bottom left panel, instructions in bottom right

About

Java GUI application for the SpaceTraders API

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published