version 1.4, 2019/09/24 04:33:36 |
version 1.40, 2020/08/08 04:29:54 |
|
|
.Os |
.Os |
.Sh NAME |
.Sh NAME |
.Nm fnaify |
.Nm fnaify |
.Nd script to get FNA-based games ready to run on OpenBSD |
.Nd run FNA/XNA games on OpenBSD |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm |
.Nm |
.Op Fl i | y |
.Op Fl i | y |
.Op Fl hv |
.Op Fl hv |
|
.Op Fl c Ar configfile |
.Op Fl d Ar depdir |
.Op Fl d Ar depdir |
.Op Fl m Ar monopath |
.Op Fl m Ar monopath |
.Op Ar gamedir |
.Op Ar gamedir |
|
|
can be run in 3 basic modes regarding the addition of missing libraries: |
can be run in 3 basic modes regarding the addition of missing libraries: |
restrictive, interactive, and permissive. |
restrictive, interactive, and permissive. |
.Pp |
.Pp |
|
All games require additional libraries from ports, like SDL2. Some of |
|
them can be found in fnaify-extralibs package, like libatomstb or |
|
libfmod_SDL. |
|
.Pp |
The arguments are as follows: |
The arguments are as follows: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Fl i | y |
.It Fl i | y |
|
|
is specified, |
is specified, |
.Nm |
.Nm |
runs in restrictive mode, that is no drop-in DLLs will be installed. |
runs in restrictive mode, that is no drop-in DLLs will be installed. |
|
.It Fl c Ar configfile |
|
Optional. Use |
|
.Ar configfile |
|
for the configuration of |
|
.Xr mono 1 . |
|
This sets up dllmap/dllentry settings to use the correct libraries. See |
|
.Xr mono-config 5 |
|
for details. If this option is omitted, |
|
.Nm |
|
looks first for |
|
.Pa ~/.config/fnaify/fnaify.dllmap.config |
|
and then for |
|
.Pa /usr/local/share/fnaify/fnaify.dllmap.config . |
|
If neither one is found, |
|
.Nm |
|
creates |
|
.Pa ~/.config/fnaify/fnaify.dllmap.config |
|
with default settings. |
.It Fl d Ar depdir |
.It Fl d Ar depdir |
Add |
Add |
.Ar depdir |
.Ar depdir |
|
|
.It |
.It |
The Adventures of Shuggy |
The Adventures of Shuggy |
.It |
.It |
|
Akane the Kunoichi |
|
.It |
|
Amazing Princess Sarah |
|
.It |
Apotheon |
Apotheon |
.It |
.It |
|
Apple Jack 1&2 |
|
.It |
|
Atom Zombie Smasher |
|
.It |
|
A Virus Named TOM [!] |
|
.It |
|
Before the Echo [!] |
|
.It |
|
Bird Assassin |
|
.It |
Bleed |
Bleed |
.It |
.It |
Bleed 2 |
Bleed 2 |
|
|
.It |
.It |
Brushwood Buddies |
Brushwood Buddies |
.It |
.It |
|
Camera Obscura |
|
.It |
Capsized |
Capsized |
.It |
.It |
|
Celeste (no audio) |
|
.It |
Chaos Heart |
Chaos Heart |
.It |
.It |
Charlie Murder |
Charlie Murder |
|
|
.It |
.It |
Dad Quest |
Dad Quest |
.It |
.It |
Dead Pixels II |
Dead Pixels [!] |
.It |
.It |
|
Dead Pixels II [!] |
|
.It |
The Dishwasher: Vampire Smile |
The Dishwasher: Vampire Smile |
.It |
.It |
|
Draw a Stickman: EPIC |
|
.It |
Dust: An Elysian Tail |
Dust: An Elysian Tail |
.It |
.It |
|
Eagle Island |
|
.It |
|
Eliza |
|
.It |
Escape Goat |
Escape Goat |
.It |
.It |
Escape Goat 2 |
Escape Goat 2 |
.It |
.It |
|
EXAPUNKS |
|
.It |
|
Explosionade [!] |
|
.It |
FEZ |
FEZ |
.It |
.It |
Fist Puncher |
Fist Puncher |
|
|
.It |
.It |
Flotilla |
Flotilla |
.It |
.It |
|
Game Type [!] |
|
.It |
Gateways |
Gateways |
.It |
.It |
|
Grand Class Melee 2 [!] |
|
.It |
Growing Pains |
Growing Pains |
.It |
.It |
HackNet |
HackNet |
.It |
.It |
Hive |
Hidden in Plain Sight |
.It |
.It |
|
Hive [!] - sometimes doesn't start up |
|
.It |
Hyphen |
Hyphen |
.It |
.It |
Jon Shafer's At the Gates |
Jon Shafer's At the Gates |
.It |
.It |
|
Khet 2.0 |
|
.It |
LaserCat |
LaserCat |
.It |
.It |
|
Little Racers STREET |
|
.It |
Mercenary Kings |
Mercenary Kings |
.It |
.It |
Mount Your Friends |
MidBoss |
.It |
.It |
|
Molek-Syntez |
|
.It |
|
Mount Your Friends [!] |
|
.It |
|
NeuroVoider |
|
.It |
Ninja Warrior |
Ninja Warrior |
.It |
.It |
One Finger Death Punch |
One Finger Death Punch |
.It |
.It |
|
Opus Magnum |
|
.It |
Overdriven Reloaded |
Overdriven Reloaded |
.It |
.It |
Owlboy |
Owlboy |
|
|
.It |
.It |
Penny Arcade's On the Rain-Slick Precipice of Darkness 4 |
Penny Arcade's On the Rain-Slick Precipice of Darkness 4 |
.It |
.It |
|
Phoenix Force |
|
.It |
|
PlanetFriend |
|
.It |
Press X to Not Die |
Press X to Not Die |
.It |
.It |
Rex Rocket |
Rex Rocket |
.It |
.It |
Rogue Legacy |
Rogue Legacy |
.It |
.It |
|
Ruggnar |
|
.It |
Salt and Sanctuary |
Salt and Sanctuary |
.It |
.It |
|
Session Seven |
|
.It |
|
Shenzhen I/O |
|
.It |
Shipwreck |
Shipwreck |
.It |
.It |
|
Signs of Life |
|
.It |
Skulls of the Shogun |
Skulls of the Shogun |
.It |
.It |
Soulcaster 1 & 2 |
Soulcaster 1 & 2 |
.It |
.It |
|
SpaceChem [!] |
|
.It |
SpeedRunners |
SpeedRunners |
.It |
.It |
Stardew Valley |
Stardew Valley |
.It |
.It |
Sumico |
Sumico |
.It |
.It |
Super Amazing Wagon Adventure |
Super Amazing Wagon Adventure [!] |
.It |
.It |
Super Blood Hockey |
Super Blood Hockey |
.It |
.It |
Super Rad Raygun |
Super Rad Raygun |
.It |
.It |
Sword of the Stars: The Pit |
Sword of the Stars: The Pit [!] |
.It |
.It |
|
Terraria |
|
.It |
Timespinner |
Timespinner |
.It |
.It |
TowerFall: Ascension |
TowerFall: Ascension |
.It |
.It |
|
Ultra Hat Dimension |
|
.It |
Unexplored |
Unexplored |
.It |
.It |
Unholy Heights (no audio) |
Unholy Heights (no audio) |
.It |
.It |
The Useful Dead |
The Useful Dead |
.It |
.It |
|
Weapon of Choice [!] |
|
.It |
Wizorb |
Wizorb |
.It |
.It |
Wyv and Keep |
Wyv and Keep |
.El |
.El |
.Sh FILES |
.Sh FILES |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
|
.It Pa /usr/local/share/fnaify/fnaify.dllmap.config |
|
Default configuration file to map DLLs to native libraries. |
.It Pa ~/.config/fnaify/fnaify.dllmap.config |
.It Pa ~/.config/fnaify/fnaify.dllmap.config |
Configuration file to map DLLs to native libraries, based on OpenBSD |
User directory configuration file. Takes precedence if it exists. |
library naming. |
Make sure to keep it up-to-date! |
.El |
.El |
.Sh EXIT STATUS |
.Sh EXIT STATUS |
.Nm |
.Nm |
|
|
.Pp |
.Pp |
.Dl $ fnaify -i path/to/game/directory |
.Dl $ fnaify -i path/to/game/directory |
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr mono 1 |
.Xr mono 1 , |
|
.Xr mono-config 5 |
.Sh HISTORY |
.Sh HISTORY |
The |
The |
.Nm |
.Nm |
utility was originally created in December 2017 by |
utility was originally created in December 2017 by |
.An Thomas Frohwein Aq Mt thfr@openbsd.org |
.An Thomas Frohwein Aq Mt thfr@openbsd.org . |
.Sh RELEASE HISTORY |
.Sh RELEASE HISTORY |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
|
.It 3.0 |
|
Enable modes (\fIsetup\fP, \fIrun\fP). |
|
Support for several Zachtronics games. Add libstubborn use to dllmap. |
|
Symlinking for MonoGame, e.g. NeuroVoider. |
|
.It 2.2 |
|
Fix config for mono 6. Add support for libcestub. |
|
.It 2.1 |
|
Support for additional XNA games. Add MONO_FORCE_COMPAT quirk. |
.It 2.0 |
.It 2.0 |
Add support for XNA games. |
Add support for XNA games. |
Introduce modes |
Introduce interactivity flags |
.Fl i | y |
.Fl i | y |
to facilitate adding in needed assemblies/libraries. |
to facilitate adding in needed assemblies/libraries. |
.It 1.3 |
.It 1.3 |