Skip to content

agsconfig tries to give similar functionality to the traditional winsetup.exe of Adventure Game Studio, but cross platform

License

Notifications You must be signed in to change notification settings

ericoporto/agsconfig

Repository files navigation

agsconfig

Build Status

agsconfig tries to give similar functionality to the traditional winsetup.exe of Adventure Game Studio, but cross platform

Using with your game

Place agsconfig executable at the same location of your game entry-point (mygame) or binary (mygame.exe). On MacOS, place it at the side of the AGS Engine binary.

Add on the same directory a .config file, and add the following content to it:

[game]
executable = mygame

On MacOS, set the value of the executable to the binary of the AGS Engine and certify the AGS Engine is finding your game on execution. For now, it also requires marking it as executable with chmod +x agsconfig - or the name you set for this utility.

If you are making an Adventure Game Studio with Joystick compatibility, this tool also has gamepad controls supplied by ImGui, which should make possible to configure your AGS game and launch it from your sofa.

Embedded project libraries

This project uses the following libraries that are already supplied in the repository for simplicity

  • SDL2-2.0.10
  • ImGui
  • inipp
  • tiny-process-library
  • optional-lite
  • dirent (Windows compatibility)

Dependencies

This project uses CMake as a build system, at least version 3.13, so you will have to install it. It should just work with the CMake provided by CLion, so should just load it if editing on it. On Visual Studio, you need to install the CMake tools provided by the Visual Studio installer, and later open this directory through open folder, more details supplied on it's official docs.... On MacOS you will need XCode installed.

On Linux, you will need additionally the packages libgl1-mesa-dev and mesa-common-dev (both are available in apt and provide libGL and libdl, needed for linking).

Building on Ubuntu Desktop

To build agsconfig and all the libraries here you may need to install the following dependencies

sudo apt-get -y install libdbus-glib-1-2 libdbus-glib-1-dev libasound2-dev libpulse-dev libsndio-dev libxcursor-dev libxinerama-dev install libxi-dev dbus libdbus-1-dev libudev-dev libibus-1.0-dev

License

AGS Config is made by Érico Vieira Porto and provided with MIT license, see LICENSE.

SDL (Simple DirectMedia Layer) is by Sam Lantinga and provided with it's own license, see COPYING.txt.

Dear ImGui is made by Omar Cornut and provided with MIT license, see LICENSE.txt.

IniPP is made by Matthias C. M. Troffaes and provided with MIT license, see LICENSE.txt.

optional lite is distributed under the Boost Software License, see LICENSE.txt.

tiny-process-library is made by Ole Christian Eidheim and provided with MIT license, see LICENSE.

Dirent Windows interface is made by Toni Ronkko and provided with MIT license, see LICENSE.