Monkey2 Build From Source Help

About Monkey 2 Forums Monkey 2 Programming Help Monkey2 Build From Source Help

This topic contains 7 replies, has 3 voices, and was last updated by  cocon 1 month ago.

Viewing 8 posts - 1 through 8 (of 8 total)
  • Author
  • #5169


    This post will contain various information about contributing to Monkey 2, with various subjects such as:

    • downloading from source
    • building it from source
    • download latest changes from git

    Downloading Monkey
    Enter this link to one of the git clients:

    1. Github Desktop
    2. Sourcetree
      (See Nerobot’s notes below for more information)
    3. Alternatively, just download the zip repository from github without any client.

    Building Monkey

    1. Let’s assume you have downloaded the repository somewhere e.g. D:\Programming\monkey2\ .
    2. Now make sure you have connected the g++ compiler to Monkey2, there are various alternative ways to do that, however since you are involved directly with source (git will track any changes you do) is recommended not to mutate the monkey2 files.
    3. Have the g++.exe accessible from the PATH environment variable. If you are on Windows and you want to use MinGW make sure you get the specific recommended toolchain mentioned here.
    4. Now once you are set you can type g++ in command prompt and see compiler output. Head over to monkey2\scripts and run this shell file: rebuildted2go.bat (or .sh for mac or linux) and wait about 25 minutes to let everything built from scratch which includes: transpiler (the compiler 🙂 ), modules, ide, etc…

    Download Latest Changes From git

    1. Github Desktop
      Having selected the branch you are interested in, hit Fetch Origin and wait a few seconds to let it download.
      For more information:
    2. Sourcetree
      Press the pull button from the main toolbar
      (see Nerobot’s notes for more details)


    I use SourceTree for git. I prefer gui instead of command line. 🙂

    May post short ‘howto’ if someone is interested in.



    It will be a good idea, won’t hurt to post it. Can you make a huge image (i.e. 1500×1500) that explains it?


    Generally I use “gihub for windows” but I consider switching to sourcetree, lots of people like this one.




    I also use sourcetree, and I think it would be useful to have!



    There is a short article “How to use SourceTree app for managing git repository”.

    Install & Account

    Install app from here:

    Enter your git account info to get access to github (there is a prompt for first start).

    Clone monkey2

    Start app and press Clone/Add (see st-1.png).

    In clone dialog (see st-2.png):

    • paste monkey2 repository url,
    • select folder to copy into (if folder exists it must be empty),
    • enter name for repo (it’s bookmark for soursetree),
    • and press Clone button.
    • wait loading

    App overview

    See st-3.png

    After loading you will stay on default branch – master.

    To use develop or any other branch, you need to checkout it.

    • Look at Remotes list below master branch.
    • Right-click on remotes::origin::develop and choose “Checkout origin/develop…” and press Ok.
    • Ok, now you stay on develop branch (bold font).

    To change local branch simply double-click on one of them.

    To grab new stuff – just press Pull button on main toolbar.

    Pull and run rebuildall script if needed.

    Any questions? 🙂



    Nice one, thanks.



    There is a cool feature in SourceTree App named “Log selected” – it shows us all changes for selected files.

    For example, I want to inspect latest changes in MainWindow.monkey2 file.

    Look at screenshots.



    I did an update to the original first post to get rid of the directions regarding the raw git command set, since GUI applications are much more useful and the process of working repositories is streamlined. Also the title of the post is renamed to include various tips and tricks generally regarding to building and contributing to monkey2.

    One upcoming post would be to mention ways about compiling monkey2 with MSVC2017, if anyone has tried it can do a post here. 🙂

    Another one is to clone and sync the repository from github-to-github (without involving your client).

Viewing 8 posts - 1 through 8 (of 8 total)

You must be logged in to reply to this topic.