openrct2-flexui v0.1.0-prerelease.0

FlexUI for OpenRCT2 plugins

A flexible user interface library for creating windows for OpenRCT2 plugins.

• Simple declarative approach to designing your windows;
• Bind models to your interface components using MVVM-like bindings;
  • Your UI will automatically update when the values in your models change.
• Automatically resize parts of your UI when users resize your window;
• Percentile or weighted sizing of widgets;
  • Put your widgets in columns or rows, sized to 10% or 2/3 of the size of the parent, or something like that.
• Nested widgets, widgets in widgets, or widget-inception;
• New widgets like toggle buttons, dropdown-spinners and dropdown-buttons;
• Easily extendable by implementing your own WidgetCreator-implementations;
• Tree-shakable and minifiable;
  • If you use a tree-shaker then code from the library that you don't use will not be shipped with your plugin.
• Fully unit-tested.

Designed with a focus on ease of use, performance, light-weighted and flexibility.

For examples see the examples folder.

Installing a pre-release

This library is still in development. It may contain bugs or missing features. There may be breaking changes.

If you find a bug or have a feature request, please report it under Issues or find me on Discord in the OpenRCT2 server.

Install the latest pre-release directly from the NPM registry with:

npm install openrct2-flexui

Building the source code

Requirements: Node, NPM.

1. Open command prompt, use cd to change your current directory to the root folder of this project and run npm install.
2. Run npm run build (production build) or npm run build:dev (development build) to build the project.
   • The output folder for the packaged library is (project directory)/dist.

Using a development build

To publish a local version of FlexUI for use in your own plugins; run npm run publish:local to install a local build into your global npm packages directory. Then in the main folder of your new plugin; run npm link openrct2-flexui to temporarily link the local FlexUI build to your new plugin.

Unit tests

The unit tests are written using AVA.js and can be run outside the game. Simply run npm test in the main folder to run all tests.