{"id":13520981,"url":"https://github.com/thexhr/isscrolls","last_synced_at":"2025-04-23T11:30:48.740Z","repository":{"id":46575275,"uuid":"407261008","full_name":"thexhr/isscrolls","owner":"thexhr","description":"Command line based player toolkit for the Ironsworn tabletop RPG","archived":false,"fork":false,"pushed_at":"2024-09-26T15:46:52.000Z","size":712,"stargazers_count":17,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-02T05:32:27.121Z","etag":null,"topics":["braille","bsd","c","hacktoberfest","ironsworn","linux","rpg","rpg-tool","unix","visually-impaired"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thexhr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-09-16T17:45:34.000Z","updated_at":"2024-10-13T05:34:49.000Z","dependencies_parsed_at":"2024-04-01T12:43:22.691Z","dependency_job_id":"3a03953c-67b6-4324-beff-8dc30ba05616","html_url":"https://github.com/thexhr/isscrolls","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thexhr%2Fisscrolls","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thexhr%2Fisscrolls/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thexhr%2Fisscrolls/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thexhr%2Fisscrolls/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thexhr","download_url":"https://codeload.github.com/thexhr/isscrolls/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223922100,"owners_count":17225636,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["braille","bsd","c","hacktoberfest","ironsworn","linux","rpg","rpg-tool","unix","visually-impaired"],"created_at":"2024-08-01T06:00:25.492Z","updated_at":"2025-04-23T11:30:48.732Z","avatar_url":"https://github.com/thexhr.png","language":"C","funding_links":[],"categories":["Tools"],"sub_categories":["Starforged"],"readme":"# isscrolls - Player toolkit for the Ironsworn family tabletop RPG\n\nisscrolls is a toolkit for players of the [Ironsworn](https://www.ironswornrpg.com/) tabletop RPG.  It supports classic Ironsworn, Delve, **Starforged** and its extension **Sundered Isles**.\n\nIt is intended for both solo and co-op play and allows to track your character's progress including vows, roll on adventure and exploration moves, tracks progress for fights, journeys and expeditions and provides results from the static oracle tables from the official rulebook.\n\nAlthough there are several Ironsworn player toolkits available, there was none for the command line.  Since I prefer working in a terminal, I wrote isscrolls.  Think of it as the most Unix-like Ironsworn experience you'll ever see.  Besides that, you can play it over SSH or even in a shared terminal session (with tmux or screen).\n\nVisually impaired players should run isscrolls with the `-b` option to suppress the banner on startup.  By default, very little extra characters or symbols are shown to ease playing with a screen reader or a braille display.  In case you want colors, bold fonts and more symbols start isscrolls with the `-c` option.  This can be seen in the screenshot below.\n\n![isscrolls screenshot](https://xosc.org/misc/is-202209.png)\n\n## Features\n\nThe following game mechanics are implemented.  Some moves are omitted on purpose since it makes little sense to implement them in software, they have to be played by the player.\n\n* Tracking of vows\n* Adventure and Exploration moves\n* Automatic progress tracking for journeys and expeditions\n* Combat moves\n* Automatic progress tracking for fights\n* Quest moves\n* Relationship moves\n* Delve moves\n* Support for various oracle tables such as names, locations, etc\n\n## Installation\n\nisscrolls is written in C and known to work on the operating systems listed in the table below.  To compile it you need the following things:\n\n* A recent C compiler (tested with both clang \u003e= 11 and GCC \u003e= 8)\n* make (tested with both BSD and GNU make)\n* [The GNU Readline library](https://tiswww.case.edu/php/chet/readline/rltop.html)\n* [The JSON-C library](https://github.com/json-c/json-c) \u003e= Version 13\n\n### Dependencies\n\nInstall the dependencies as follows:\n\n| Operating System | Commands and Notes |\n| --- | --- |\n| Arch Linux | Both dependencies should already be installed by default.  Otherwise, `pacman -Syu gcc make json-c readline` will install them |\n| Debian Linux| `apt install libreadline-dev libjson-c-dev` |\n| DragonFly BSD | `pkg install json-c` |\n| Fedora Linux | `dnf install readline-devel json-c-devel` |\n| FreeBSD | `pkg install readline json-c` |\n| macOS | `brew install json-c pkg-config-wrapper` |\n| NetBSD | `pkgin install readline json-c` |\n| OpenBSD | `pkg_add json-c` |\n| Ubuntu Linux| `apt install libreadline-dev libjson-c-dev` |\n| Void Linux| `xbps-install gcc make readline-devel json-c-devel` |\n| Windows | There is no native version, just use WSL |\n\nIf your operating system does not have `pkg-config` installed by default, you have to install it as well.\n\n### Compilation and Installation\n\nBy default, the `Makefile` looks for external includes and libraries in `/usr/local/include` and `/usr/local/lib`.  If your distribution uses special path, you have to modify the Makefile accordingly.\n\nCompile and install with the following commands:\n\n```\n$ make\n# make install\n```\n\n## Usage\n\nisscrolls presents the user with a command prompt and accepts various commands.  A built-in help can be seen by entering __help__ at isscrolls' command prompt.\nAll commands including their usage patterns are described in the [man page](https://xosc.org/isscrolls.html).\n\n**Examples**\n\nCreate a new character:\n\n```\n\u003e create\nEnter a name for your character: Jorrun\nNow distribute the following values to your attributes:\n - Challenging difficulty      : 4,3,3,2,2\n - Perilous difficulty         : 3,2,2,1,1\n - Grim difficulty             : 3,2,1,1,0\nEdge   : 3\nHeart  : 2\nIron   : 2\nWits   : 1\nShadow : 1\nName: Jorrun (Exp: 0/30) Exp spent: 0\n\nEdge: 3 Heart: 2 Iron: 2 Shadow: 1 Wits: 1\n\nMomentum: 2/10 [2] Health: 5/5 Spirit: 5/5 Supply: 5/5\n\nWounded:        0 Unprepared:   0 Encumbered:   0 Shaken:       0\nCorrupted:      0 Tormented:    0 Cursed:       0 Maimed:       0\n\nArmed with a simple weapon\n\nBonds: 0.00\n```\nNow engage in a fight with the new character:\n```\nJorrun \u003e enterthefray wits\nPlease set a rank for your fight\n\n1        - Troublesome foe (3 progress per harm)\n2        - Dangerous foe (2 progress per harm)\n3        - Formidable foe (2 progress per harm)\n4        - Extreme foe (2 ticks per harm)\n5        - Epic foe (1 tick per harm)\n\nEnter a value between 1 and 5: 2\n\u003c1\u003e + 1 = 2 vs \u003c6\u003e\u003c3\u003e -\u003e miss\nPay the price -\u003e Rulebook\n```\nSince the last roll was a _strong hit_ you can see how the progress is advanced according to the foe's rank and how the prompt changes to show that _Jorrun_ now has initiative.\n\n```\nJorrun \u003e Fight 0 \u003e clash edge\n\u003c1\u003e + 3 = 4 vs \u003c2\u003e\u003c1\u003e -\u003e strong hit\nYou inflict harm, regain initiative and can choose one option -\u003e Rulebook\nJorrun \u003e Fight 2 [I] \u003e\n```\n\n## FAQ\n\n**Why does isscrolls so often refers to the official rulebook?** The program should help you in keeping track of your character's progress.  However, it cannot replace the GM in your campaign.  In order to give the player as much freedom as possible, I refrain from doing everything automatically and instead redirect you to the rulebook.\n\n## License\n\nisscrolls was written by Matthias Schmidt and is licensed under the ISC license.  The Ironsworn material was written by [Shawn Tomkin](https://www.ironswornrpg.com) and is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International license. The [Ironsworn Starforged Playkit](https://www.ironswornrpg.com/downloads) was written by Shawn Tomkin in 2022 and is licensed under the Creative Commons Attribution 4.0 International License.  No changes to the content were made.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthexhr%2Fisscrolls","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthexhr%2Fisscrolls","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthexhr%2Fisscrolls/lists"}