An open API service indexing awesome lists of open source software.

https://github.com/stevesea/Adventuresmith

Generate tabletop RPG nonsense at the push of a button! (on Android)
https://github.com/stevesea/Adventuresmith

android android-app npc random-generation rpg rpg-dice-roller

Last synced: about 1 year ago
JSON representation

Generate tabletop RPG nonsense at the push of a button! (on Android)

Awesome Lists containing this project

README

          

# Adventuresmith

[![Build Status](https://travis-ci.org/stevesea/Adventuresmith.svg?branch=master)](https://travis-ci.org/stevesea/Adventuresmith)
![Kotlin LoC](https://img.shields.io/badge/Kotlin_LoC-4496-lightgrey.svg)
![YaML LoC](https://img.shields.io/badge/YaML_LoC-78808-lightgrey.svg)

## Overview

Adventuresmith is an Android app for randomly generating elements for tabletop RPGs (names, spells,
items, monsters, characters, alien worlds, etc). Adventuresmith is free, and ad-free (and will remain so).

Adventuresmith software is licensed under the GPL. Depending on the source of the content, the
licensing terms of the content within Adventuresmith varies -- see [this section](#content) for
content attribution and information about the content within the app.

### How to use the app
Random tables are a great tool to provide a framework for improvisation.

During game prep or in-game, if you have a choice of:

> "you meet a person in the city, who are they?"

or

![alt text](https://github.com/stevesea/Adventuresmith/raw/master/docs/images/npc_sample.png "sample NPC")

the second gives you many more hooks to help you create a memorable character to interact with
your players.

Or, if you decide your party encounters a humanoid in the woods...

![alt text](https://github.com/stevesea/Adventuresmith/raw/master/docs/images/asthmatic_half_orc_bandit.png "sample NPC")

... would you have come up with an asthmatic half-orc bandit, laying a trap?

## Downloads

[Google Play](https://play.google.com/store/apps/details?id=org.steavesea.adventuresmith)

[Amazon](http://a.co/9nXGqBY)

## Wiki/FAQ

If you're interested in creating generators, or want to run Adventuresmith on the desktop, there
are instructions on the [wiki](https://github.com/stevesea/Adventuresmith/wiki)

## Info

Bugs? Feature Requests? You can provide feedback [here](https://github.com/stevesea/Adventuresmith/issues)

## Screenshots

![alt text](https://github.com/stevesea/Adventuresmith/raw/master/docs/images/nav_drawer1.png "Sliding nav bar")
![alt text](https://github.com/stevesea/Adventuresmith/raw/master/docs/images/nav_drawer2.png "Sliding nav bar #2")

----------------------------------

# Attribution

## Content
Adventuresmith is a tool to help players and GMs use RPG supplements and systems. Adventuresmith would
not exist without the amazing creativity of many people. All content included within Adventuresmith
has been used with the permission of the individual content creators. Any usage of the content
generated by Adventuresmith not covered by the individual License statements of each generator
is strictly prohibited.

Attribution and licensing statements for all content within Adventuresmith is available [here](./content_attribution.md).

Attribution for each set of generators is also available within the app. When you've selected a set of
generators, click on the info button on the toolbar to be shown the attribution statement for the
generators you're using.

If you enjoy using Adventuresmith, follow the attribution links to the creators' websites, or to their
pages on [DriveThruRPG](http://www.drivethrurpg.com/). Give them reviews and other feedback; buy
their products, and become a patron on Patreon.

### Open Content
Adventuresmith includes Open Content released under the OGL. To see the Open Content
from these OGL sources, follow the links below:
* [Macchiato Monsters](https://github.com/stevesea/Adventuresmith/tree/master/adventuresmith-core/src/main/resources/org/stevesea/adventuresmith/core/macchiato_monsters)
* [Portal Rats](https://github.com/stevesea/Adventuresmith/tree/master/adventuresmith-core/src/main/resources/org/stevesea/adventuresmith/core/portal_rats)
* [Sharp Swords & Sinister Spells](https://github.com/stevesea/Adventuresmith/tree/master/adventuresmith-core/src/main/resources/org/stevesea/adventuresmith/core/ss_and_ss)

### Product Identity

Adventuresmith name, logo, splashscreen, nav-drawer header, icons are product identity.

Names of the individual RPG supplements and systems are product identity, and owned by their respective
publishers or copyright holders.

## Artwork

### Adventuresmith Art
Application launch icon, splash screen logo, and nav-drawer-header logo were created by Brian Todd Christensen.

Creative Commons License

Adventuresmith Art by Brian Todd Christensen is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

Based on a work at https://stevesea.github.io/Adventuresmith/.

Permissions beyond the scope of this license may be available at http://briantchristensen.com/Adventuresmith.

### Icons
* This application uses icons from [https://materialdesignicons.com/](https://materialdesignicons.com/)
* This application uses icons from [http://ionicons.com/](http://ionicons.com/)

## Software

### License
Adventuresmith source code is licensed under [GNU General Public License, version 3 (GPL-3.0)](https://opensource.org/licenses/GPL-3.0).

### 3rd party Software Libraries
* [MaterialDrawer](https://github.com/mikepenz/MaterialDrawer)
* [FastAdapter](https://github.com/mikepenz/fastadapter)
* [AndroidIconics](https://github.com/mikepenz/Android-Iconics)
* [Jackson](https://github.com/FasterXML/jackson)
* [LeakCanary](https://github.com/square/leakcanary)

# dev notes

signing file protected via GCP KMS and SOPS

```shell

# encrypt like:
$ sops -e android.jks > android.jks.enc
$ sops -e advsmith_signing.gradle > advsmith_signing.gradle.enc

# decrypt:
$ sops -d advsmith_signing.gradle.enc > advsmith_signing.gradle
$ sops -d android.jks.enc > android.jks
```