The backend and API code for the Unscripted mini-game.
Project description
Fira
Fira is the main backend and API code for the minigame in Unscripted, a visual novel about software development. Fira provides many facets of the minigame, including a public API that players can use to code solutions to the minigame puzzles, a configuration and data generator from level files, and a virtual machine that runs low-level code that the minigame processes. Fira is named after Fira Sans, one of the game's characters.
Requirements
- Python 2.7+
- Poetry package manager
Getting started
Fira comes pre-packaged in Unscripted but can be installed outside of the game to work better with IDEs and other Python tools such as Poetry.
Dependencies
Fira is both a Python 2 and Python 3 package and relies on the TOML Python package. These dependencies will be installed with the package, either from source or from PyPI.
Quick Start: Install on PyPI
Fira is available on PyPI and can be installed as such:
pip install uvn-fira
Install from source
To install Fira from the source code, first clone the repository from GitHub via git clone
. You'll also need to install Poetry. In the root of the source, run the following commands:
poetry install
poetry build
The resulting wheel files will be available in the dist
directory.
Usage
For players installing this package to solve minigame puzzles, using the Fira package to access the API is relatively straightforward:
from uvn_fira.api import get_level_information, CSPlayer, CSWorld
gp, gw = get_level_information(0,
fn_path=renpy.config.savedir + "/minigame",
exists=renpy.loadable,
load=renpy.exports.file) # type: (CSPlayer, CSWorld)
Documentation on the API is located inside of Unscripted by going to Help › Minigame or Settings › Minigame.
The documentation for the entire package is located at https://fira.marquiskurt.net, which is useful for developers that wish to make custom toolkits that connect to the minigame's virtual machine or for modders that wish to make custom minigame levels.
Reporting bugs
Bugs and feature requests for Fira can be submitted on YouTrack. Submit a report ›
License
The Fira package is licensed under the Mozilla Public License v2.0.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for uvn_fira-1.2.10-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 13abaf7349157459afb0aab32c05800f3220a829284809c95fca5a32f79b4041 |
|
MD5 | b6c1d89217a2e9369bf13dbd322c40af |
|
BLAKE2b-256 | c4355d06342cd31c8d7cbf2cec6592ee551825680d35fd0c090de0ece313b871 |