GithubHelp home page GithubHelp logo

northburns / virtual-gloomhaven-board Goto Github PK

View Code? Open in Web Editor NEW

This project forked from purplekingdomgames/virtual-gloomhaven-board

0.0 0.0 0.0 55.09 MB

Interactive game board for Gloomhaven

Home Page: https://vgb.purplekingdomgames.com/

License: Creative Commons Attribution 4.0 International

Shell 0.12% Elm 83.36% HTML 0.65% C# 1.78% Batchfile 0.09% SCSS 11.78% JavaScript 1.91% Dockerfile 0.30%

virtual-gloomhaven-board's Introduction

Virtual Gloomhaven Board

The Virtual Gloomhaven Board is designed to help people to play Gloomhaven remotely, without the need for a physical board.

Getting Started

Using the Hosted Solution

The quickest and easiest way to get up and running is by opening vgb.purplekingdomgames.com in a browser!

Using a Local Server

If you'd rather use a local server than the online version (perhaps you're playing ove LAN, or just fancy the technical challenge), then you can do that too! In essence all you need to do is download the correct file and set up port forwarding, but more detailed instructions are below:

Installation

You can find the latest release here. Simply download the binary for your operating system (Windows, Mac, and Linux are all supprted), and then run that program (fWindows users simply double click, Mac and Linux users may need to grant executable privileges and run it from a terminal). This will start the application listening on port 5000 by default. You can test it's working by going to http://localhost:5000 in the browser of your choice (currently Firefox, Chrome and Edge are supported).

Port Forwarding

Once set up it's time to let others play with you! For this you will need to use port forwarding to send all traffic on port 5000 to your IP address. This can be tricky if you haven't done it before as it requires you to change your router settings. Each manufacturer is different so you'll need to look up exact details for the router you have, but the steps are broadly the same:

  • Log into your router
  • Navigate to the Port Forwarding (sometimes called Virtual Server) section in the menu
  • Set up all incoming TCP traffic on port 5000 to forward to your internal IP on port 5000

Connecting Externally

With those setting complete, other people should now be able to use your Virtual Board! Find your exteneral IP address (you can use a site such as this) and then ask your friends to open a browser and navigate to http://<YOUR_IP>:5000 (where <YOUR_IP> is your external IP adddress).

Room Codes

At this stage you will all be connected with randomly generated room codes. The room code is shown in the top left, and needs to be the same for everyone who wants to join your game. Share your room code via a chat app, SMS, email, or carrier pigeon and ask everyone to change to that code. The room code can be changed by using the menu icon in the top left, and selecting Settings. If you're streaming or recording your game then you may want to hide your room code using the same menu.

Adding Players

Player characters can be added, removed, and changed by clicking the menu icon in the top left and selecting Change Players. Clicking on a character icon will select it, bringing that icon into full colour (except for the Triforce icon, which is always grey, but does get a lovely shadow effect). Once you're happy with your selection, click 'OK'.

Customisation

In situations where you're self-hosting or linking through a third paty you may want to lock some of the components, or start players off with a certain configuration. For that you can use query string parameters, of which the following are supported:

  • scenario - An integer between 1 and 96 denoting the starting scenario
  • players - A comma-seperated list of icon names representing players. Valid values are:
    • brute
    • tinkerer
    • scoundrel
    • cragheart
    • mindthief
    • spellweaver
    • phoenix-face
    • lightning-bolt
    • angry-face
    • triforce
    • eclipse
    • cthulhu
    • three-spears
    • saw
    • music-note
    • concentric-circles
    • sun
  • seed - An integer between 0 and 2,147,483,647 used to generate the initial room code
  • lockScenario - If provided should be 1. Stops players changing the scenario
  • lockPlayers - If provided should be 1. Stops players changing the characters in the game
  • lockRoomCode - If provided should be 1. Stops players changing the room code

Useful Additional Software

Playing with a virtual board is fun, but to really get the (remote) party going we recomend the following additional software:

virtual-gloomhaven-board's People

Contributors

hobnob avatar luksan47 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.