Player
The Player is a standalone desktop application that serves as your playground. It’s the easiest way to preview your UI and it also provides you with all the tools needed.
Running it
Running it is as simple as double-clicking the provided Player.bat on Windows or Player.sh on Mac. Alternatively, click the Player button in the Launcher.
Capabilities
Here’s a list of what the Player is capable of doing:
- Dragging and dropping HTML files from your file system into the app will load them.
- The Player will propagate mouse and keyboard input to the UI. Gamepad and touch input is propagated only on Windows.
- It’s a great tool for profiling - run the app, hit F12 to open the dev tools and use the Performance panel to measure how fast your UI is.
- It has a number of command-line arguments which you can use to control its behavior (e.g. what the initial page should be, where to read resources from, etc.). Run
--help
on the Player executable for a list of supported arguments.
DualShock
controller, you would have to use a third-party software like DS4Windows which will emulate it as an Xbox controller.Player Configurations
The Player comes with a config file, located at <package_root>/Player/Config.toml
. All command line options can be provided through the config file - you can view some in the provided config file. The most useful arguments to provide through the Config.toml
are fonts to register in advance, which you can do with the following syntax:
[register-font]
path = "path_to_font"
family = ""
sdf = "auto"
style = "auto"
weight = "auto"
To view all of the available values, run Player.exe register-font --help
.
Config.json
file format with a limited amount of settings and options you could configure (namely coui-root
and register-fonts
). This behavior is now deprecated, so it is advised to update your config files to the new format.Keyboard shortcuts
- F1 opens this page in your browser
- F5 will reload the current scene
- F11 toggles between 8 bit and 16 bit render target.
- F12 will launch Prysm’s Dev tools which allow you to inspect, debug and profile your UI.