Git Product home page Git Product logo

asoiaf-simulator's Introduction

What Is ASOIAF-Simulator?

ASOIAF-Simulator is a no-cost, web-based, fan-created simulator that leverages Phaser JS to emulate the A Song of Ice and Fire tabletop miniature game (made by CMON), in a vivid 2D environment. Let's be honest, we play tabletop games cause playing with friends in real life is the best and no simulator can capture that fully. But I live remote and getting a game in in real life is an hour drive for me (which isnt always easy to do). So this is designed for those who can't game as often in real life (and to be easy to access). In short, this is designed to be easy to use and to suppliment the ASOIAF miniatures game and support the hobby!

To play, visit:

asoiaf-sim.com

How To Demo Video:

alt text

Simulated Tabletop:

image

Simulated Cards/Dice User Interface:

interface2 min

Features:

  • 2-player ASOIAF simulation
  • Unit Creation/Movement - create ASOIAF Units/Attachments/NCUs with movement controls
  • Unit movement history - Press the r button to have a unit revert to it's last position. or f to go forward in position.
  • Units have short-range, long-range and line of sight arcs built-in.
  • Tactics board - with turn token and player turn throne token.
  • Battlemaps - Currently we have 8 battlemaps that you can select from. (battlemaps are not synced between players so you can set to whatever you want on your side)
  • Objective Cards - objective cards deck built-in
  • Mission Cards - Mission cards deck built-in
  • Tactics Cards/Deck selection.
  • Dice - Builtin dice system for a max of 20x D6 dice. The first dice (in gold border) can be used to represent a D3.
  • Dice - Dice history ( can go back 20 dice states or forward )
  • Tape-Measures - automatic tape measures on units. You can also trigger a manual tape measure by holding down T key.
  • Cards - All Units/Tactics/NCU/Attachment/etc... cards built-in.
  • EN, FR, DE translations for data cards.
  • Color Selection - Army color selection so you can customize your units trays/colors.
  • Save Game State - Save the simulators current game state and copies it to the clipboard.
  • Import Data/Saves from a asoiaf-stats.com list TTS export, CMONs list export from War Council, and ASOIAF-Simulator game state saves.
  • Simulator Log - Important actions are logged and can be viewed under the HELP menu. (this is helpful to keep people honest).
  • Set Names - players can set their name by selecting P1: or P2: (depending if you joined as player 1 or player 2)
  • Tactics/Mission/Objectives cards and Dice rolls all use the JavaScript crypto server-side to ensure things cryptographically secure/random.

Requirements:

  • For Best Results - Use a 1920x1080 (16:9 aspect ratio) screen and full-screen (F11)
  • Web Browser (preferably Chrome since thats the only browser I tested in.)
  • Mouse and Keyboard
  • Internet

Key Bindings:

  • When you have a moveable object selected you can use WASD to move it.
  • Also when selected, you can rotate an object using Q to rotate counter-clockwise and E to rotate clockwise.
  • When moving/rotating objects, you can hold down SHIFT to speed-up the WASD or Q / E rotation.
  • Tape-Measure - Using your mouse, move to the position you want then hold down T and drag the mouse. This will allow you to measure what would be in inches.
  • Delete - Select and object and press Del to delete
  • Reset Object Position - Select a unit and press R to reset it to its last position
  • Redo Object Position - Select a unit and press F to move them forward (i.e. undo the reset)

How to support:

Paying for the server costs out of my own pocket and I hope to have one server in EU and US. So any help is appreciated if you can on patreon.

patreon

Known Issues:

  • Loading/Race conditions. There could be minor race conditions where something loads out of order. First try refreshing the page and see if that helps at all.
  • Cards aren't perfect. Im working on them at https://github.com/chrisjd20/asoiaf_card_generator
  • Translations only apply to EN,FR,DE and only apply to most card images when not specifying english. Otherwise most of the site is only in english.
  • The import feature from TTS needs work. This is because their IDS frot the cmond cards uses historical data from years. Mine is only the most recent. Will have to find some way to fix this.

Troubleshooting:

  • Refresh once first. If still problems then try next step.
  • Clear cache first way:

image

  • Refresh the screen.
  • We have heard reports the NORD VPN/Security products have blocked connections. Try turning off securtiy products or vpns.

Filing Issues:

Please feel free to file any issues you may experiencing here in this github repo. For bugs or issues, it will help if you include screenshots and perhaps any javascript errors that you may experience. On Chrome you can open the developer tools to the javascript console by:

image

  1. Open Google Chrome: Start by opening your Google Chrome browser.

  2. Navigate to the Desired Page: Go to the web page where you want to inspect or debug using the developer tools.

  3. Open Developer Tools: You can open the Chrome Developer Tools in several ways:

    • Press Ctrl + Shift + I (Windows/Linux) or Cmd + Option + I (Mac).
    • Right-click on any page element and select Inspect.
    • Go to the Chrome menu at the top-right (three dots), then select More Tools > Developer Tools.
  4. Access the JavaScript Console:

    • Once the Developer Tools pane is open, click on the Console tab to switch to the JavaScript console.
    • Alternatively, you can press Ctrl + Shift + J (Windows/Linux) or Cmd + Option + J (Mac) to open Developer Tools directly to the Console tab.
  5. Ready to Use: Now you can view console logs, and report any errors that might be displayed there.

TODO LIST:

  • Basic Layout with battle maps and tactics board
  • Buttons to include Army color Selector
  • Player Name Change
  • Card Generator
  • Units
  • NCU's
  • Attachments
  • Game Objects
  • Server-side setup
  • Networking for all non-ui in-game objects
  • Support EN / FR / DE
  • Import Army Lists from Stats / War Council
  • Dice System (uses crypto module server-side for cryptographically secure/random dice rolling)
  • Tactics Cards (uses crypto module server-side for cryptographically secure/random card shuffling)
  • Missions Cards
  • Tactics Selection Filters Out (Mostly) Invalid Commander Choices
  • Objectives Cards
  • Actions Log Stored Server Side (dice rolls, tactics/missions card actions, Army movements/attribute changes) ( this is viewable in help/?)
  • Important actions logged to toasts
  • Game State Save System and Save Reload
  • Mouse/Hand for UI component
  • D3 into dice system ( Just use the one dice in a gold border as the D3 )
  • Need to have finished moves/certain attr changes added to log for tray objects
  • mouse out of background causes stop drag? - fixed this by tracking all mouse up to trigger stop dragging
  • Toggle Turn and player order throne Turn Token
  • straight arrows coming off trays to show movement
  • Toggle All Units Ranges/Graphics
  • Create landing page
  • Help/How To finished (with how to video perhaps?)'
  • Revert AND Redo history for objects. Object Position History will be serverside instead of only client side
  • Object Lock/Unlock system
  • Right-Click Menu on objects
  • UI delete/rotate/lock obj buttons
  • Unit/Tray snapping into place system (magnetic attraction)
  • Add additional terrain (with different themes)
  • Logout to allow another to connect to the same room (right now soon as 2 people join its permanent for taht room)
  • Better logic for initally placement of units/ncus/attachements (and their cards) during creation
  • Add SSL/TLS Certificate for HTTPS
  • More toasts/messages describing whats going on
  • more verbose logging
  • Fix/Improve button animations (lock)
  • Battle Modes Also unset last battle mode stuff
  • In-sim D3 (Improve D3 System) Current is one in gold border
  • cache version checker (tells players they need to clear site cache if outdated
  • French é accent omitted from translation on cards
  • game mode deployment zone display/grid
  • UI expand buttom On right and left when Card/Dice UI opens
  • Tactics Card on bottom of tactics deck
  • Num of cards in tactics deck displays
  • Display special rules on scenery
  • Have objective attach and follow attached unit?
  • More mobile friendly version?

asoiaf-simulator's People

Contributors

chrisjd20 avatar

Watchers

 avatar  avatar

asoiaf-simulator's Issues

builder.asoiaf.fr

Remember to fix the TTS import from our builder (builder.asoiaf.fr) to your simulator.
Thanks to you

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.