Bishop (formerly "Bishop's Map") is a Javascript-based interactive fiction engine designed for allowing text adventure games to be played in a browser. The engine itself is entirely client-based, which means the work is performed entirely by the player's web browser and server-based code isn't necessary for successful operation.
Bishop is not production-ready. It is still very much a work in progress, and even a cursory peek at the project's Issues page will show you how far we still have to go. Check out the changelog for info on how things are going and what works where, but there are still gaps in the engine's capabilities.
In addition, you should expect multiple breaking changes between now and the 1.0 release. The changelog should make ample notes of what is changing and what upgrade dangers might arise, but the project's versioning won't be semantically meaningful until after 1.0.
Authors define the entirety of their game logic in a file called gamedata.js. For documentation on syntax and game logic, check out the Bishop wiki. Once the game has been designed, all a player needs to do is open an HTML file that links together the Bishop code with the game data.
When building the gameplay page, the included "index.html.sample" should be helpful in determining basic requirements, but they are here as well:
debugMode = true for that), but it keeps you from needing to remember to include it whenever you want to run a check.<h1 id="gameName"></h1> at the top of the page would become id="gameName">Your Custom Game Woo!</h1> when your game is loaded. (The title of the game is set in the game's metadata.)<p> tags for displaying game information:
<form> element. It doesn't have any id requirement, but you should include action="#" and wrap it around several specific elements:
<form> tags. It's recommended they be put inside an HTML form so that typing in the box and pressing "Enter" will trigger the "submit" button, rather than forcing the player to click the button in between every command.<button> tag with an id of "listening" and contents of whatever you'd like will be used to turn the speech-to-text feature on and off, so players can control when the game is listening to their microphone.<button> tag with an id of "talking," to allow the player to tell the text-to-speech feature to stop reading things out loud. It should be labeled something like "Stop talking."Because there is no server-side code, a site using only Bishop (plus any other client-side libraries) only needs to be put somewhere from which players can retrieve the files.
To run your game as a conventional website, you could easily use a traditional web server running something like Apache or Nginx, or simply put the files in a file-hosting service like Amazon S3. Github Pages is another option that should be totally free.
Distributing the files to players in other ways will give them the same access they would get if they were playing your game from your website. You can e-mail the files to players if you want, or send them a link to Dropbox or Google Drive. Transferring the files to a player's computer will work any way you want to move them, and as long as the player doesn't mess with the relative location of the files, it should work fine -- the files need to stay in the directories in which you sent them, but the player can put those files anywhere on their computer. Bishop games require no outside dependencies -- just the Javascript files and whatever your index.html file includes.
Once a player has the files, all they need to do is open the "index.html" file in a browser and start playing. Most operating systems will open *.html files with the default browser, but players can also open files by opening the browser and selecting something like "Open..." from the "File" menu.
Though this method is more complicated, it has the added bonus of making your game available offline, so players don't need an internet connection to play. The only exception to this is any functionality you add that relies on third-party libraries that you do not include in the game directory: Google fonts, for example, or jQuery. The talking/listening features also require an internet connection.
Bishop comes pre-packaged with all the necessary files to allow the "index.html" file to be loaded as a Chrome application, allowing the game to appear in a player's "Apps" page in Chrome, or be loaded as a standalone app outside of a browser. All of the required files mentioned in the full instructions from Google are included in the "extras" directory, but should be moved into the base directory (with bishops_map.js and index.html) if you're planning on using them. This is the short version of the config, for once the files are in place: