Engine:FNA

From PCGamingWiki, the wiki about fixing PC games
FNA
Engine - FNA - logo.svg
Developers
Website

Games

Game Developer Publisher First release Available on
A Virus Named TOM Misfits Attic 1 August 2012
Apotheon Alientrap Games 3 February 2015
Axiom Verge Thomas Happ Games 14 May 2015
Bastion Supergiant Games Warner Bros. Interactive Entertainment 16 August 2011
Before the Echo Iridium Studios 20 October 2011
Bleed Bootdisk Revolution 28 November 2012
Bleed 2 Bootdisk Revolution 8 February 2017
Blueberry Garden Erik Svedäng 10 June 2009
Capsized Alientrap Games 29 April 2011
Charlie Murder Ska Studios 12 May 2017
Cryptark Alientrap Games
Dust: An Elysian Tail Humble Hearts Microsoft Studios 24 May 2013
Escape Goat Magical Time Bean 14 June 2012
Escape Goat 2 Magical Time Bean Double Fine Productions 24 March 2014
Fez Polytron Corporation Trapdoor 1 May 2013
Fist Puncher Team2Bit Adult Swim Games 21 June 2013
Flinthook Tribute Games 18 April 2017
Fossil Echo Awaceb 8 July 2016
Gateways Smudged Cat Games 22 June 2012
Gnomoria Robotronic Games 23 February 2016
Hacknet Team Fractal Alligator Surprise Attack Games 12 August 2015
Hidden in Plain Sight Adam Spragg 16 July 2014
Melody's Escape Icetesy 20 May 2016
Mercenary Kings Tribute Games 25 March 2014
Murder Miners JForce Games 25 July 2014
Owlboy D-Pad Studio IndieBox 1 November 2016
Poöf Arkedo Studio Neko Entertainment, Plug In Digital 8 November 2013
Quadrilateral Cowboy Blendo Games 25 July 2016
Reus Abbey Games 16 May 2013
Rex Rocket Castle Pixel 5 August 2014
River City Ransom: Underground Conatus Creative 27 February 2017
Rogue Legacy Cellar Door Games 27 June 2013
Salt and Sanctuary Ska Studios 17 May 2016
Shipwreck Brushfire Games 25 February 2014
Skulls of the Shogun 17-BIT 29 July 2013
Solaroids: Prologue DynF/X Digital
Soulcaster Magical Time Bean 10 February 2012
Soulcaster II Magical Time Bean 10 February 2012
SpeedRunners DoubleDutch Games, TinyBuildGames TinyBuildGames 19 April 2016
Super Rad Raygun TRU FUN Entertainment ScrewAttack Games, Rooster Teeth Games 8 November 2016
Terraria Re-Logic 16 May 2011
The Adventures of Shuggy Smudged Cat Games 13 June 2012
The Dishwasher: Vampire Smile Ska Studios 12 May 2017
TowerFall Ascension Matt Makes Games 11 March 2014
Transistor Supergiant Games 20 May 2014
Wizorb Tribute Games 7 November 2011
Wyv and Keep: The Temple of the Lost Idol A Jolly Corpse 14 August 2013

Information[edit]

FNA is an open source reimplementation of the Microsoft XNA Framework, specifically the 4.0 Refresh revision. It started as a branch of MonoGame called "MonoGame-SDL2".

The goal of the project is to recreate a fast, portable, and accurate XNA4 runtime library that prevents the need for code/content changes on the part of the XNA game developer. The currently supported platforms include Windows, Mac OS X and GNU/Linux, with further platform support including those supported by SDL2.

Joysticks[edit]

About XNA Joystick Support[edit]

XNA, being a Microsoft technology, centered its controller input around the Xbox 360 Controller. Because of this, the XNA API is not cleanly compatible with custom controllers, including the Xbox 360 Controller when not being read by XInput. However, a config format was developed to allow binding of joystick input values to a virtual 360 controller, which then gets read by XNA games.

Automatic Configuration: SDL_GameController[edit]

Since FNA uses SDL2 as its base library, we also get the benefit of SDL_GameController, a new subsystem added by Alfred Reynolds at Valve. This takes configurations for known controllers and automatically configures them for the virtual 360 controller, so if your controller is recognized, manual configuration is not necessary. If you run an FNA title through Steam, your controller will automatically be configured using the Big Picture Mode configuration.

About GUIDs[edit]

In addition to expanded configuration support, FNA provides the GetGUIDEXT extension that allows XNA devs to pull in a trimmed/standardized GUID string to determine the controller hardware and react accordingly. TowerFall Ascension uses this for button icon support, for example.

Consider this GUID from the PlayStation 4 controller:

// These are the strings reported by SDL2's SDL_JoystickGetGUIDString:
// https://wiki.libsdl.org/SDL_JoystickGetGUIDString
4c05c405000000000000504944564944 // Windows. Note characters 1-8.
4c05000000000000c405000000000000 // OSX.     Note characters 1-4 and 17-20.
030000004c050000c405000011010000 // Linux.   Note characters 9-12 and 17-20.

4c05c405 // This is the GUID string returned by FNA. Get it?

For XInput controllers on Windows, the GUID string is simply 'xinput'.

DualShock 4 Light Bar Support[edit]

FNA supports the DualShock 4 light bar. The SetLightBarEXT extension allows you to set the color of the light bar by way of adjusting the brightness of the RGB LEDs.

Currently this is only supported on Linux, with kernel 3.15 and higher or SteamOS version 137 and higher.

If a game supports this extension, simply allow write permission to the brightness files for the red/blue/green LEDs via /sys/class/leds/. For example:

cd /sys/class/leds/
chmod 777 0003:054C:05C4.0021:red/brightness
chmod 777 0003:054C:05C4.0021:green/brightness
chmod 777 0003:054C:05C4.0021:blue/brightness

Note that the folder noted above can change per instance, but the constant value is 054C:05C4, the hardware ID for the DualShock 4. Also note that you will need root access to run the chmod operations.

A small test program can be found here.