/odysseus-admin

Admin UI (for use by GMs)

Primary LanguageVueMIT LicenseMIT

odysseus-admin

Admin UI (for use by GM's) for the Odysseus backend.

Tech

  • Node v18.14.0
  • Vue v2.7.14

Local setup

  • NOTE! Make sure you are running Odysseus Backend!
  • Run npm install to install dependencies
  • Run npm run serve for compiles and hot-reloads for development

Admin UI should now be available at http://localhost:8090/

Local setup in VSCode dev container

You can also run the app using VSCode dev containers. Create/update your .env file like in the local setup instructions.

Requirements

Setup

  • NOTE! Make sure you are running Odysseus Backend!
  • Open new window in VSCode
  • File --> Open Folder... --> odysseus-admin
  • VSCode will ask do you want to Reopen in Container --> Click it
    • If you are too slow --> Click the button in left bottom corner (looks like two L:s or disjointed ><) and choose Reopen in Container from the menu.
  • VSCode will then build and start up the dev container, installs npm packages and starts the service.

Problems?

  • Try to rebuild the container: Click the button in left bottom corner (looks like two L:s or disjointed >< with the container name) and choose Rebuild Container from the menu.
  • You might run into this issue on ARM processors, see the issue for potential workarounds.

Jumping the Odysseus (from Admin UI)

  • Make a jump Admin UI Jump drive tab tab
    • Move to calculating --> OK
    • Approve jump --> OK
    • Mark spectral calibration done --> OK
    • Mark jump reactor done --> OK
    • Next state (prep complete) --> OK
    • Initiate jump --> OK --> Wait 60 seconds
    • If you want to break the ship click Change to breaking jump or Change to minor breaking jump --> OK
    • End jump --> OK
  • To continue jumping
    • Bypass engineer fixes --> OK
    • Mark cooldown done --> OK

Breaking Odysseus Manually (for testing purposes)

  • Go to Admin UI Empty Epsilon tab
    • Disable connection and Disable state synchronization (otherwise it will sync back to full health since Empty Epsilon is not running and it defaults to full health)
    • Break things by Update values example
      • Target type: systems
      • Target: impulse
      • Value type: health
      • Value: 0.7
      • Set value

Fixing Odysseus Malfunctions (for testing purposes)

  • Either use HANSCA
  • Or from Admin UI Data stores tab
    • Choose game or box from dropdown
    • Scroll to see which Status is broken
    • Click the one which is broken
    • Change "status": "broken", to "status": "fixed",
    • OK

Other Available Scripts

Compiles and minifies for production

npm run build

Run your tests

npm run test

Lints and fixes files

npm run lint

Customize configuration

See Configuration Reference.