|Paradigm||multi-paradigm: structured, imperative, object-oriented, modular, reflective, generic, concurrent|
|Designed by||Mark Sibly|
|Developer||Blitz Research Ltd.|
|First appeared||March 1, 2011|
|Typing discipline||Static, weak, strong (optional), safe, nominative, partly inferred|
|Platform||Cross-platform (see the targets section for a full list of supported platforms)|
|OS||Windows, OS X, Linux|
|License||zlib, proprietary (commercial). (See: Mojo (framework) for details).|
Monkey X is a high-level programming language designed for video game development for many different platforms, including desktop and laptop computers, mobile phones, tablets, and video game consoles. The language itself is an object-oriented dialect of BASIC, which the compiler translates into native source code for several target platforms. The resulting code is then compiled normally. Currently the official target platforms include: Windows (Including the Windows 8 store), OS X, Linux, Xbox 360, Android, iOS, among others.
Monkey X's main implementation (compiler), and a number of official modules are open source. Monkey X's main application/game framework, Mojo, is partially commercial. The compiler and most of the official modules can be found on GitHub. Monkey is also distributed in several compiled binary forms from its official website (registration required, to build the compiler). For details, see: Mojo (framework), and Game targets (technical).
- 1 History
- 2 Mojo (framework)
- 3 Development roadmap
- 4 Official targets
- 5 Unofficial targets
- 6 Notable games made with it
- 7 Game targets (technical)
- 8 Sample code
- 9 See also
- 10 References
- 11 External links
This section needs expansion. You can help by adding to it. (April 2018)
In December 2013, Monkey was re-branded as Monkey X.
The free versions of Monkey X included unrestricted use of the HTML5 and GLFW (desktop) targets; see Mojo (framework). The open source distribution of Monkey's compiler is written in Monkey, and therefore requires a valid binary distribution to be compiled. Before December 2013, Monkey X's compiler (Transcc) could not be compiled and used by those who had not bought full licenses of Monkey X. In late 2014, Blitz Research partnered with Playniax to make a bundle containing the Ignition X framework, as well as a standard "Monkey X Pro" license.
In January 2015, "Monkey X Studio" was added to the official website's "Store" section. This acts as a bundle of third-party software, as well as the existing software from the official commercial distribution. This bundle includes: Jungle IDE and Font Machine (A third-party IDE, and font generation tool, both respectively by LemonBytes). The Ignition X framework. And finally, a full "Monkey X Pro" distribution.
This section needs expansion. You can help by adding to it. (February 2018)
Monkey 2 v1.0.0 was released on 30 June 2016. It expands the capabilities of Monkey X by adding support for generic classes, 'first class' and lamda functions, structs, built-in multi-threading capabilities, and operator overloading.
In June 2017, official support for the original Monkey X was discontinued and the full version and source were made available for free. It has subsequently been forked by the community and re-branded as Cerberus X.
Mojo is the official/commercial application framework for the Monkey X programming language. Mojo has been written for all of Monkey X's official game-based targets, this is done using the native programming languages of each target. Mojo is then wrapped using Monkey X's "external-language" system. Mojo was designed primarily for writing simple 2D games in Monkey X, but like many other APIs, it can also be used for other types of programs. Like Monkey X itself, one of Mojo's goals are to make everything it provides as consistent as possible on all of its supported platforms.
Mojo itself is open source, however, not all implementations are provided openly. Currently the GLFW and HTML5 implementations (Native code) of Mojo are open source. Mojo may be implemented using any language by anyone. The official implementations for the other targets are commercial products, sold by Blitz Research on Monkey X's website.
Along with the application portion of the framework, Mojo provides graphics, sound, and device input functionality on several targets. Mojo's device-input functionality is built to be "virtualizable" through its native implementations. An example of this being the framework's "touch" input functionality, which some targets "virtualize" using traditional mouse input. The same goes for various targets when handling mouse input. Similar examples of this can be found on mobile platforms for keyboard input. Mojo's input functionality also provides several forms of keyboard functionality, accelerometer support, and game controller support. Because of this framework's design philosophies, games made using Mojo tend to look identical when deployed to other platforms, despite sometimes being based on drastically different technologies.
Mojo supports several image and audio formats. Due to the nature of Mojo, some frameworks are only supported on specific platforms. The way resources are used may also change what formats are supported. For example, Mojo provides a specific music framework, separate from its other audio functionality. This framework may support different formats, depending on the target. A brief rundown of supported formats can be found in Monkey X's official documentation.
Mojo has been implemented officially and unofficially for several platforms. Underlying technologies vary between targets, however, several of the targets support OpenGL. Because of this, OpenGL modules are available for these platforms. This functionality is currently dependent on the Mojo framework.
The Mojo framework has also seen several "extensions" (Official platform-specific functionality) in the past. A good example of this being display-management. Some of these platform-specific "extensions" were first provided as a part of target-specific modules (External to Mojo). Future support for target-specific modules' implementations has yet to be commented upon, and may become deprecated. Functionality provided by Mojo can be assumed as the preferred option.
Mojo has become known to Monkey X's community as an effective cross-platform utility; however, some small features can be inconsistent on specific platforms. Such inconsistencies tend to be documented as such, and sometimes "ignored" on compile-time.
Several third party frameworks take advantage of Mojo, examples of this can be found in several of Monkey X's "user modules". Additionally, it is perfectly possible to write an alternative framework built on the same implementation-level as Mojo. Such a framework would be able to share common functionality with Mojo, by using several of the same modules. For details, please see: Game targets (technical).
On May 14, 2015, Mark Sibly, the creator of Monkey, announced the development of Mojo2, a new graphics API intended to supersede the first Mojo module's graphical functionality. The first release of the Mojo2 module came to owners of Pro versions of Monkey X on June 14, 2015. It was released alongside version 84a.
- 'Standard' C++: Used for console applications and tools; Monkey X's compiler-translator is built using this.
- GLFW: A native C++ based target for Windows, OS X, and Linux. This target has gone through several revisions, with support for version 3 of GLFW, and a backward-compatible target for version 2. As of 'version 84a', Windows users may target GLFW3 using ANGLE as an OpenGL backend. This enables hardware acceleration on Windows systems with DirectX driver support.
- Android: A target based on the Java programming language and Android application programming interface (APIs). There are several variants of this target, depending on the version of Monkey. These range from different targeted API versions to separate Android-based targets, like the Ouya target.
- iOS: A target based on the C, C++, and Objective-C programming languages; compiled using Xcode; LLVM.
- PlayStation Vita: A PSS/PSM and C# and Mono based target.
- Adobe Flash
- Microsoft XNA: A C# based target for Windows, Xbox 360, and Windows Phone 7; powered by XNA framework.
- Windows RT: A DirectX based C++/CX target usually used for Windows Store applications and games. This target supports Windows 8, and Windows 8.1 including mobile phone variants.
- Ouya: Initially based on the official Java-based Android target, this target was originally developed by Monkey's community. The initial project was started by Jochen "Maverick69" Heizmann. Today, it's an official target, supporting the same functionality as the standard Android target(s). In addition to this, minor work has been done to accommodate the Ouya console.
This section needs expansion. You can help by adding to it. (April 2018)
Most Monkey X unofficial and community-driven targets are at the official community's User Targets section.
Notable games made with it
- Crypt of the NecroDancer – Developed by Brace Yourself Games.
- New Star Soccer Mobile – Won Sports/Fitness 2013 BAFTA
- 2Dark - From Alone in the Dark developer Frederick Raynal.
Game targets (technical)
All information provided is based on the official source code released by Blitz Research on GitHub, as well as any other contributed source code in the public repository. For a full list of official targets, please see: Official targets.
Game targets are defined as targets which have implementations of the 'BBGame' class. The 'BBGame' class is an externally/natively implemented class described by the official 'brl.gametarget' module (GitHub). This class is used by frameworks such as Mojo as a platform for target-specific application-functionality. Functionality provided by the 'BBGame' class is privately imported, then wrapped in a controlled form by Mojo. The official targets' native 'BBGame' implementations are provided as open source. This does not directly apply to frameworks like Mojo.
Therefore, it is possible to re-implement open source, or even proprietary backends for the Mojo framework, this would still require several components to be implemented, however. This is generally discouraged on official targets, due to the commercial nature of Mojo.
Monkey X does not need game-targets to work, targets such as the standard C++ tool (STDCPP) target do not explicitly require a BBGame implementation. Also, most of the official targets do not require implementation of BBGame, either. They do require implementations for frameworks such as Mojo, however. This also means that Monkey X's official compiler (external dependencies disregarded) could technically be built with most (If not all) of the official targets.
#Rem This example relies on the 'mojo' module, so it will not compile with a non-game target. Mojo comes with all versions of Monkey X, and is implemented for most targets. Classes and functions such as 'Image', 'App', 'LoadImage', and 'DrawImage' are provided by Mojo. NOTES: * Knowing Java or Visual Basic may help in learning Monkey. * Multi-line comments are described with the preprocessor ala "#Rem". * Single-line comments are represented with apostrophes. (Similar to Visual Basic) * Variable-naming standards are generally user-dictated. * Monkey is statically typed, however it does support automatic type resolution. * 'End' may be used to end a scope, however, specific forms of 'End' may also be used for clarity. ("End Method" for example) * Monkey's compiler is generally "multi-pass", so the placement of elements does not matter. This can also lead to different stylistic choices, such as placing fields at the end of classes. * This is a modular language (Some Java parallels can be made), however, Monkey uses files to represent modules, not classes. This example uses a class because it's dictated by Mojo. Monkey is also not strictly object-oriented, however, it does fully support polymorphism, and similar strategies. * This example uses spaces instead of tab-characters for the sake of consistency, such practices are discouraged in realistic applications. #End ' This will enable strict-mode. (This makes the compiler less lenient about code structure) Strict ' Imports: ' Import the standard Mojo module. (Required for this example) Import mojo ' Like several C-like languages, but unlike most BASIC languages, ' Monkey uses the 'Main' function as an entry point. Function Main:Int() ' By simply creating a new 'Game' object, the application will be started. New Game() ' Return the default response to the system. ' Zero: No errors found. This is system specific. ' This point may or may not be reached when the application closes. Return 0 End
' This will act as our main class. Multiple inheritance is ' not supported in Monkey, however, interfaces are. ' The 'Final' specifier works similarly to Java, and is not explicitly needed. Class Game Extends App Final ' Fields: Field player:Player ' Methods: ' These override the 'App' class's methods (Your own methods may also be written in this class): ' Though, technically 'OnCreate' is a method, some consider it a type of constructor, and may label it as such. ' 'OnCreate' is called automatically when an 'App' object is created. Method OnCreate:Int() #Rem Most media should be stored in a folder called "ProjectNameHere.data". The 'LoadImage' command will load an 'Image' object from the path specified. Mojo assumes that what you're loading is in the "ProjectNameHere.data" folder by default. Variables, especially local variables may also use the ":=" operator, in order to use automatic type deduction. #End Local img:Image = LoadImage("player.png") ' Alternative: Local img:= LoadImage("PathHere.png") #Rem Create a new instance of our 'Player' class using the image we loaded. As you can see, 'player' is a field, and because of this, an implicit use of 'Self' can be assumed if there is no name conflict. People familiar with languages similar to C++ would know this pointer/reference as 'this'. Monkey is garbage collected, so there is no need to deallocate this object from the heap later on. #End player = New Player(img, 100, 100) #Rem This will set the update-rate to the rate we specify (X times per-second). This update rate is also implicitly applied to the draw/render rate; however, uses of 'OnRender' are target and system defined, and are therefore decoupled from the main update routine. Setting this to zero will result in a system-defined update-rate. Doing such a thing will hint to Mojo that it should attempt to make this application update and render, as many times as possible. #End SetUpdateRate(60) ' The return values of the 'App' class's commands are currently placeholders. ' Monkey's documentation advises that you return zero by default. ' Returning can technically be optional under certain conditions. (Not always recommended) Return 0 End #Rem The 'OnUpdate' method is called automatically several times per second. The number of times this is called is based on the update-rate. Mojo is generally good about implementing fixed-rate behavior, it will attempt to update the application more than render if profitable. This does not "save you" from the use of delta-timing, or similar techniques, however. #End Method OnUpdate:Int() ' Add '1.0' to the player object's 'x' variable. ' Adding ".0" to the end of a literal can be used to ' explicitly describe it as floating-point ('Float'). player.x += 1.0 ' If the value of 'x' exceeds the number we specify (In case a literal), set it to zero: ' This could also be done using 'Mod', the modulus operator. ' (Represented by '%' in several C-like languages) If (player.x > 100) Then player.x = 0 ' Once again, 'Self' is implicit. Endif ' 'End' could also be used here, instead. ' Everything went according to plan, now return zero. Return 0 End #Rem The 'OnRender' method is usually called as many times as 'OnUpdate', however, this is system and target dependent, the update-rate is used as a hint for this, not a demand. For this reason, having any code that mutates "in-application" data is considered variable and in some ways non-standard. Normally, all graphical/drawing operations must be done in here. However, a non-standard target-dependent way of rendering in 'OnUpdate' can be done using the 'BeginRender' and 'EndRender' commands. (Not recommended) Actions such as loading resources should be done in 'OnCreate' or 'OnUpdate'. #End Method OnRender:Int() ' Clear the screen, then display a color based on the values specified(RGB, floating-point). ' Explicit usage of ".0" is not needed here, as there is no integer overload. ' An alternate overload may be used, which clears the screen using a system/Mojo defined color. Cls(32.0, 64.0, 128.0) ' Call our 'player' object's 'Draw' command. ' In the event that 'player' is 'Null', this will throw an error. player.Draw() ' Everything went according to plan, now return zero. Return 0 End End
' The 'Player' class, as referenced previously (Placement does not matter): Class Player ' Declare all of our fields (Class-local variables): ' These two variables will act as our position on the screen. ' (Alternatively, an 'Array or third-party class could be used) Field x:Float, y:Float ' This will be a reference to an 'Image' object we'll specify. Field image:Image ' Constructor(s): ' Overloading 'New' mainly works the same way as constructors in other languages. ' Returning is generally not recommended for constructors. Method New(img:Image, x:Float=100, y:Float=100) ' Due to the arguments using the same names, 'Self' ' is required to resolve our fields' names: Self.image = img Self.x = x Self.y = y End ' Methods: ' This will be our main render-method for this object: Method Draw:Void() ' Draw the 'image' object to the screen using our 'x' and 'y' fields. DrawImage(image, x, y) ' Returning in a 'Void' function is not required. (Some still recommend it) Return End End
- The official Monkey X forums, where all of the product updates are documented and discussed.
- The GitHub releases page for Monkey.
- Monkey's license for the open-source portion. (official GitHub page)
- A page from the official Monkey X website describing the compiler's "translation" abilities.
- MonkeyMax Source Code Repository from Google Code
- User Made Python Target Source Code Repository from Google Code
- User-made Nintendo DS Target for Monkey
-  Monkey Announcement
- http://www.blitzbasic.com/faq/faq_entry.php?id=29 Blitz Research Ltd
- A forum post describing Monkey X's Re-branding. (Official website)
- The official announcement thread for the "Monkey X Pro + Ignition X" bundle
- The official website for Jungle IDE.
- An official post made by Mark Sibly, announcing the "Monkey X Studio" bundle.
- Mark Sibly: Monkey 2 V1.0.0 now available!, Monkey 2 Blog
- "About Monkey 2". Monkey 2. Retrieved 2018-05-23.
- "Monkey X by Blitz Research". itch.io. Retrieved 2018-05-23.
- "Cerberus X - the continuation of Monkey X". www.syntaxbomb.com. Retrieved 2018-05-23.
- Monkey's official GitHub page (Open source portion)
- Monkey's official documentation's "Supported file formats" page.
- Monkey's forum's "User Targets" section, which has several ports and implementations of Mojo.
- The official documentation for Monkey's 'opengl' module.
- A portion of Monkey's official "display management" functionality. Commit snapshot taken from "Updated mojo." (Jan 13, 2014; GitHub).
- Monkey's GLFW2 target's external display-mode code. Commit snapshot taken from "Updated targets." (Oct 21, 2014; GitHub).
- The official documentation's page on Mojo's audio functionality (Specifically "channel" state detection)
- A forum thread started by Mark Sibly, detailing the now released Mojo2 module.
- GitHub's representation of the "VERSIONS.TXT" file at the time of V84A's commit/release
- After the release of V71, the 'standard' C++ target was given a fully functional garbage collector. - Source: A forum post made by Mark Sibly (Monkey's creator) from www.monkey-x.com
- GitHub's representation of the "VERSIONS.TXT" file when V81A was released
- The somewhat informal release page for Mojo2 and V84A; ANGLE support
- A forum thread started by Jochen himself. from www.monkey-x.com
- Official community User Targets section
- Official BAFTA Sports/Fitness 2013 Category Page from bafta.org
- Mojo wrapping a call to an instance of the 'BBGame' class. Commit snapshot taken from "Updating SetDisplayMode..." (January 6, 2015; GitHub)
- Monkey's official 'brl' module. (GitHub)
- Monkey's official compiler (Module). (GitHub)