Compiling AGS: Difference between revisions

← Older edit

Compiling AGS (view source)

Revision as of 09:06, 4 August 2022

224 bytes added , 4 August 2022

→‎Introduction

VisualWikitext

Monsieur'ouxx

132

edits

@@ Line 1: / Line 1: @@
-''Please note that the discussion about this topic is constantly updated on the AGS forums : [http://www.adventuregamestudio.co.uk/forums/index.php?topic=46847.msg636496776#msg636496776 How to compile AGS (forums discussion)]
+''(last update : mid-2021 : that is AGS 3.6.x)''
-''
-''(last update : mid-2021 : that is AGS 3.6.x)''
 Hello! '''Do you know what you're doing?'''
-- '''Yes,''' I've already compiled one of AGS' components in the past (Engine in C++, Editor in c#, etc.). '''=> Skip to "Actual compiling instructions".'''
+- '''Yes,''' I've already compiled one of AGS' components in the past (Engine in C++, Editor in c#, etc.). '''=> Skip to "Getting started for each system".'''
 - '''No,''' I need a bit of context to get me started '''=> Keep reading "Introduction" below.'''
 == <big>'''Introduction'''</big> ==
-If you're a game designer, you should '''never''' have to "build" AGS. All you want is to use ''the '''Editor''''' to make the game (and compile your AGS scripts), then use the '''''Engine''''' to play it. If you have some very specific needs, you might want to program an '''Editor plugin''' or an '''Engine plugin''', but you can just build that plugin on its own, without rebuilding the entire AGS source code (that's precisely why plugins were invented).
+If you're a game designer, you should '''never''' have to "build" AGS. All you want is to use the '''''Editor''''' to make the game (and compile your AGS scripts if you have any), then use the '''''Engine''''' to play it (you won't even notice that you're using the engine, as your game gets compiled into a neat little executable file).
+Even if you have some very specific needs then you might want to program an '''Editor plugin''' or an '''Engine plugin'''. But you can just build that plugin on its own, without rebuilding the entire AGS source code (that's precisely why plugins were invented).
@@ Line 55: / Line 56: @@
 :* Get the source code, as described in the previous section.
-: * Get the '''free''' version of Visual Studio : '''Visual Studio Community 2019'''.
+:*Get the '''free''' version of Visual Studio : '''Visual Studio Community 2019'''.
 * '''<big>AGS.Editor.NoNative.sln</big> -''' That's only the high-level, C# part of the Editor, which does most of the work.
-: * You'll need to get the latest '''Native.dll''' file, '''already compiled.'''
+:* You'll need to get the latest '''Native.dll''' file, '''already compiled.'''
 :- If you have a recent AGS already installed, you can take it from the regular Editor. Otherwise, download it from the AGS page.
 :- If you need a really, really recent Native.dll (nightly build?) then go to [https://www.adventuregamestudio.co.uk/forums/index.php?board=18.0 the forums] (AGS Development --> Editor Development) and download the alpha version you need.
 : - '''Native.dll''' is the only file you need to continue. Put it in any folder of your choice.
-: * Open the .sln file with Visual Studio. Expand the "'''AGSEditor'''" project, then expand "'''References'''". Remove the reference to "Native.dll", then add it again (right-click-->'''Add Reference...''') and use the "'''browse'''" button to point to your '''Native.dll''' file.
+:* Open the .sln file with Visual Studio. Expand the "'''AGSEditor'''" project, then expand "'''References'''". Remove the reference to "Native.dll", then add it again (right-click-->'''Add Reference...''') and use the "'''browse'''" button to point to your '''Native.dll''' file.
-: * Follow extra instructions from the readme : https://github.com/adventuregamestudio/ags/tree/master/Windows#building-ags-editor
+:* Follow extra instructions from the readme : https://github.com/adventuregamestudio/ags/tree/master/Windows#building-ags-editor
 :* If you still have issues, go to [https://www.adventuregamestudio.co.uk/forums/index.php?board=18.0 the forums] (AGS Development --> Editor Development) and see if there is a recent thread devoted to compiling the Editor. Or try any thread about the latest unstable version of AGS.
@@ Line 75: / Line 76: @@
 :* If you still have issues, go to [https://www.adventuregamestudio.co.uk/forums/index.php?board=18.0 the forums] (AGS Development --> Engine Development) and see if there is a recent thread devoted to compiling the Engine. Or try any thread about the latest unstable version of AGS.
 * '''<big>AGS.Engine.sln</big> -''' That's the AGS game engine (the one that actually plays the game).
-: * Follow instructions from the readme : https://github.com/adventuregamestudio/ags/tree/master/Windows#building-ags-engine
+:* Follow instructions from the readme : https://github.com/adventuregamestudio/ags/tree/master/Windows#building-ags-engine
+:* '''ABOUT LIBRARIES:''' The readme provides a link to download the pre-compiled libraries but it's an old link. Ask on the forums to get a more recent libraries package containing SDL_sound.lib, etc.
 :* If you still have issues, go to [https://www.adventuregamestudio.co.uk/forums/index.php?board=18.0 the forums] (AGS Development --> Engine Development) and see if there is a recent thread devoted to compiling the Engine. Or try any thread about the latest unstable version of AGS.
@@ Line 81: / Line 83: @@
 You will find a lot of information in the '''Readme''' file in the git repository: http://github.com/adventuregamestudio/ags
+=== MacOS ===
+See the dedicated thread in the forums
+=== Android ===
+See the dedicated thread in the forums.
 ::
 [[Category:Advanced Tutorials]]