GemIF

by nromdotcom 5 years ago

GNU/Linux • xterm-256color • bash 492 views

I’m working on a very simple interactive fiction engine using Gemini. Think Twine but with way fewer features.

I think Gemini fits this use-case really well both from a technology standpoint and also just an aesthetics standpoint.

As of right now, “game” configuration is via a YAML file that looks a little something like this:

rooms:
- room_id: 2824028c-d71c-49cd-9289-c349a640ed9a
  room_name: Living Room
  room_description: >
    You are in the living room. It is a cozy area with
    a couch, loveseat, and big chair with ottoman. The seats are separated by end tables.
    There is a coffee table in the middle and an entertainment center with TV across from
    the seats.
  exits:
  - exit_description: The kitchen lies to the north.
    destination_id: 9dabb186-6046-4570-a585-2fbaadfab3cc
    exit_id: 85a71759-5c70-4fc4-8178-8ad8a3bef2d6
  - exit_description: To the west is a sliding door that leads to a porch
    destination_id: 478f88b7-88fe-4f2d-8b76-35d5f190c4d1
    exit_id: 478f88b7-88fe-4f2d-8b76-35d5f190c4d1
  - exit_description: To the east is the front door, leading to the yard.
    destination_id: cb178734-dd94-4333-87bd-731f8e8ac1ed
    exit_id: e4e23c7e-3f54-4bb9-a76e-c899034bc327

Where each destination_id is the room_id of another room.

More recordings by nromdotcom

GemIF 0.2.0 0:26

by nromdotcom 5 years ago

GemIF Again 0:29

by nromdotcom 5 years ago

https://asciinema.org/a/376392

Copied!

Append ?t=30 to start the playback at 30s, ?t=3:20 to start the playback at 3m 20s.

See sharing docs for more link customization options.

Embed as image link

Use snippets below to display a preview image linking to this recording.
Ideal for places where scripts are not allowed, such as project README files.

HTML:

<a href="https://asciinema.org/a/376392" target="_blank"><img src="https://asciinema.org/a/376392.svg" /></a>

Copied!

Markdown:

[![asciicast](https://asciinema.org/a/376392.svg)](https://asciinema.org/a/376392)

Copied!

Embed the player

If you're embedding on your own page or on a site which permits script tags, you can use the full player widget:

<script src="https://asciinema.org/a/376392.js" id="asciicast-376392" async="true"></script>

Copied!

Paste the above script tag where you want the player to be displayed on your page.

See embedding docs for more player customization options.

You can download this recording in asciicast v2 format, as a .cast file.

Download

Replay in terminal

You can replay the downloaded recording in your terminal using the asciinema play command:

asciinema play 376392.cast

Copied!

If you don't have asciinema CLI installed then see installation instructions.

Use with stand-alone player on your website

Download asciinema player from the releases page (you only need .js and .css file), then use it like this:

<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" type="text/css" href="/assets/asciinema-player.css" />
</head>
<body>
  <div id="player"></div>
  <script src="/assets/asciinema-player.min.js"></script>
  <script>
    // @license magnet:?xt=urn:btih:8e4f440f4c65981c5bf93c76d35135ba5064d8b7&dn=apache-2.0.txt Apache-2.0
    AsciinemaPlayer.create(
      '/assets/376392.cast',
      document.getElementById('player'),
      { cols: 105, rows: 28 }
    );
    // @license-end
  </script>
</body>
</html>

See asciinema player quick-start guide for full usage instructions.

While this site doesn't provide GIF conversion at the moment, you can still do it yourself with the help of asciinema GIF generator utility - agg.

Once you have it installed, generate a GIF with the following command:

agg https://asciinema.org/a/376392 demo.gif

Copied!

Or, if you already downloaded the recording file:

agg demo.cast demo.gif

Copied!

Check agg --help for all available options. You can change font family and size, select color theme, adjust speed and more.

See agg manual for full usage instructions.