Need help with FBNeo?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

finalburnneo
324 Stars 117 Forks Other 10.1K Commits 30 Opened issues

Description

FinalBurn Neo - We are Team FBNeo.

Services available

!
?

Need anything else?

Contributors list

FinalBurn Neo

Official Forum: https://neo-source.com

Discord: https://discord.gg/8EGVd9v

This is the official repository of FinalBurn Neo, an Emulator for Arcade Games & Select Consoles. It is based on the emulators FinalBurn and old versions of MAME

Use of this program and its source code is subject to the license conditions provided in the license.txt file in the src folder.

Work in Progress builds

If the below build status badge is green, you can download the latest builds from this repository. Please note that if the below build status badge is not green then the build will be out of date. As this build is of the last commit occasionally you might run into incomplete code, crashes or other issues that official releases will not have. Also note that the dates might be wrong against the downloads, but if the badge is green the downloads will be of the latest commit.

Build status

Here is the build status of the other versions for which we don't supply a binary directly. A red badge against a platform will indicate that something is wrong with that build. Currenty Raspberry Pi builds are missing from CI, but will one day be added:

SDL2 SDL1.2 macOS VS X64 VS win32

Ports

Raspberry Pi build instructions.

macOS build instructions and releases.

LibRetro port with builds availble via RetroArch for a lot of cool platforms.

For SDL1.2 builds just type

make sdl
(requires SDL1.2 and GCC, make, perl and nasm) instructions

For SDL2 builds just type

make sdl2
(requires SDL2, SDL2_image, gcc, make, perl and nasm) instructions

Reporting Issues

Please raise an issue on the project GitHub or report on the forums at Neosource

What about FB Alpha?

Many of the developers of this project also worked on FB Alpha. Due to a controversy, we no longer do, and recommend that everyone use this emulator instead.

Contributing

We welcome pull requests and other submissions from anyone. We maintain a list of known bugs and features that would be nice to add on the issue tracker, some of which would be a good starting point for new contributors.

One of the focuses of FBNeo is ensuring that the codebase is compilable on older systems. This is for many reasons, not least because older hardware still has a use outside of landfill or being stored in a recycling center, but also it can be a lot of fun porting and running FBNeo to other platforms. Currently, this means we will always aim for C++03 compliance as a minimum. Any pull requests should keep this in mind!

Notes on Contributions

In the root of the source tree there is an .editorconfig that mandates:

  • tabs for indentation
  • tabs use 4 columns

Please see the following function for some ideas on how naming, brackets and braces should be

void FunctionName(UINT8 var1, UINT16 var2)
{
    UINT64 result;
    if (var1 * var2 >= 10) {
        result = var1 * var2;
    } else {
        result = var1;
    }
}

Source tree structure

The source for FBNeo is layed out in a similar way to how things were in the days of the original FinalBurn. It's just that there are now more directories and source files as the emulator has grown significantly.

src/
--/burn         

Porting FBNeo to different systems

In the main source tree, you will see in the intf directory various implementations for different platforms. You should look in here when porting to new platforms. We also encourage new ports, and are happy to have them merged in to the main sourcetree. There is probably a project there for someone to re-implement some of the older ports using the intf standard, should they want to.

For portability we define the following types ``` unsigned char UINT8; signed char INT8; unsigned short UINT16; signed short INT16; unsigned int UINT32; signed int INT32; signed int64 INT64; unsigned int64 UINT64;

It is recommended that you take a look at the other #defines and structs in the header files in Burn and Burner, and don't forget that some of the existing code in the intf directory will come in handy for new ports. 

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.