Skip to content

LinuxOsxInstall.md

Latest commit

 

History

History
56 lines (52 loc) · 3.02 KB

LinuxOsxInstall.md

File metadata and controls

56 lines (52 loc) · 3.02 KB

Arch

There is an AUR package for yafc-ce: factorio-yafc-ce-git Once the package is installed, it can be run with factorio-yafc. Note that dotnet runtime v8 is required.

Debian-based

  • Download the latest Yafc-ce release.
  • Install dotnet core (runtime version: v8)
  • Install SDL2:
    • sudo apt-get install libsdl2-2.0-0
    • sudo apt-get install libsdl2-image-2.0-0
    • sudo apt-get install libsdl2-ttf-2.0-0
    • For reference, have following libraries: SDL2-2.0.so.0, SDL2_ttf-2.0.so.0, SDL2_image-2.0.so.0
  • Make sure you have OpenGL available.
  • Use the Yafc executable to run (you might need to give it executable permissions: chmod +x Yafc).

OSX

  • Install dotnet core (runtime version: v8)
  • For Arm64 Macs, that's it. You can skip to the final step of launching Yafc.
  • For Intel Macs, you can skip to the step of getting SDL libraries with brew.
  • If you want to build Lua from source, here's how you can do that:
  • Download and extract the lua 5.2.1 source code
  • Apply the .patch file to the extracted lua source code.
  • Modify the src/Makefile to include the following two lines. Note that the second line must start with a tab:
liblua.dylib: $(CORE_O) $(LIB_O)
        $(CC) -dynamiclib -o $@ $^ $(LIBS)
  • Run make macosx in the root directory
  • Run make -C src liblua.dylib. This will create src/liblia.a and src/liblua.dylib.
  • Overwrite liblua52.a and liblua52.dylib in Yafc/lib/osx with the two created files:
cp src/liblua.a <yafc repo>/Yafc/lib.osx/liblua52.a
cp src/liblua.dylib <yafc repo>/Yafc/lib.osx/liblua52.dylib
  • To get the SDL libraries, install brew and then install the packages:
brew install SDL2
brew install SDL2_image
brew install SDL2_ttf
  • Copy the following files from $(brew --prefix)/lib, which is usually /opt/homebrew/lib/, to Yafc/lib/osx:
libSDL2.dylib
libSDL2_image.dylib
libSDL2_ttf.dylib
  • Run build.sh to build Yafc. If you get an error grep: invalid option -- P, then you need to either remove the mentions of VERSION from build.sh so grep is not used, or you need to install GNU grep with brew install grep and change grep in build.sh to ggrep.
  • The folder Build/OSX will contain all of the files and should run in place. It will also create an archive OSX.tar.gz for the distro.
  • Make sure you have OpenGL available.
  • To run the app, either use dotnet Yafc.dll in the terminal, or run Yafc as an executable.

Flathub

Note that the version available on Flathub is not the Community Edition. Its repo can be found at https://github.com/petebuffon/yafc.

Other

In general, ensure you have SDL2, OpenGL and dotnet 8 or later. Use the Yafc executable to run.