Skip to content

Latest commit

 

History

History
100 lines (67 loc) · 4.03 KB

README.md

File metadata and controls

100 lines (67 loc) · 4.03 KB

ipl-overlay-controls

CI

A NodeCG bundle. Provides dashboard panels for Inkling Performance Labs tournaments.

Visit the wiki if you are interested in using ipl-overlay-controls for your own graphics.

Install

  1. Install Node.js - Using the LTS version (14.x as of writing) is recommended.

  2. Install Git

  3. Install nodecg-cli: npm i -g nodecg-cli

  4. Create a directory for NodeCG: mkdir nodecg && cd nodecg

  5. Install NodeCG: nodecg setup

  6. Install ipl-overlay-controls: nodecg install inkfarer/ipl-overlay-controls.

  • To specify a version, append #<tag> after the repository name.

    Example: nodecg install inkfarer/ipl-overlay-controls#1.3.2

    Find a list of the repository's releases here. You can see the tag name next to the commit hash, located on the left-hand side of the page on desktop.

  1. Configure the bundle at <nodecg>/cfg/ipl-overlay-controls.json. It should contain the following info:
{
  "lastfm": {
    "apiKey": "Your last.fm API key",
    "secret": "Your last.fm API secret"
  },
  "smashgg": {
    "apiKey": "Your smash.gg API key"
  },
  "radia": {
    "url": "URL to Radia Production API ",
    "authentication": "Your Authentication Key"
  }
}

The "lastfm", "smashgg", "radia" sections may be omitted, though functionality will be missing if that is done.

  1. In the NodeCG root, start NodeCG: nodecg start

  2. Access the dashboard at http://localhost:9090/ in your browser.

Development

For development, a number of npm scripts are provided:

  • build - Creates a production build of the bundle.
  • clean - Deletes generated build files and npm cache.
  • cleanbuild - Deletes generated files and runs a production build.
  • devbuild - Creates a development build of the bundle.
  • start - Starts NodeCG.
  • watch - Runs a development build when code changes are detected.
  • schema-types - Generates TS type definitions for replicant schemas (Defined in the /schemas directory)
  • lint - Runs ESLint to check for code issues.

This repository uses GitHub actions to automatically verify with ESLint and create builds from the master branch. New releases should be created off the build branch, which contains the built files.

Debugging extensions in JetBrains IDEs

To help debug this bundle in JetBrains IDEs, create a Node.js build configuration with the following options:

  • Working directory: [nodecg]\bundles\ipl-overlay-controls
  • JavaScript file: [nodecg]\index.js

To create a debuggable development build, run npm run watch or npm run devbuild in the project root.

Repositories that depend on ipl-overlay-controls

The following bundles depend on version 3.x.x of ipl-overlay-controls as of 2021-09-05:

The following bundles depend on version 2.x.x of ipl-overlay-controls as of 2021-09-05:

The following bundles depend on version 1.x.x (latest: 1.3.2) of ipl-overlay-controls as of 2021-06-11: