Note I: It is recommended that you use a licensed version of Construct when working with Table Realms. The free version of Construct has a limit on the number of events that can be placed in an event sheet, which will limit the usefulness of Table Realms within the project.
NOTE II: It is recommended that you download the Construct desktop app for To use the Table Realms testing tool more easily, it is recommended that you download the Construct Desktop build. You can find the official download here.
To use the basic functionality of Table Realms to use an Aug in your game, you need to do the following:
Add the Table Realms plugin to your version of Construct (as detailed here)
Create the Aug file using the Table Realms IDE (If you’re not sure, you can check here)
Aug files can be imported into the file structure of your Construct3 project by right-clicking on the “Files” folder in your project sidebar, selecting the “Import Files” option, and either browsing to the location where you saved your aug file, or dagging and dropping it into the project.
Once the Aug file has been imported, you are ready to start integrating Table Realms into your project using Construct’s object system.
After creating the Table Realms object, add a sprite that you will use to display the QR code.
NOTE: This point is only applicable if the game is being built to include a console mode.
Once the sprite has been created and placed, the placeholder needs to load the QR image from a URL. It’s preferable to do that only once the QR code is ready - otherwise the user can be left staring at a placeholder image. Be sure to specify the Aug file to be loaded as well, otherwise it will not work! On your events sheet, it will look something like this:
Object for Event
Condition
Parameters
Object for Action
Action
Parameters
Table Realms
QRCode Data Ready
QR Code Sprite
Load image from
TableRealms.GetQRUrl (Keep current size, cross-origin anonymous)
System
Trigger Once
When you think you’ve gotten everything right, it’s always important to check whether your integration is working. Using the export feature, export your project to TR Testing Tool “Game” folder and open the “run.bat” file. Once the testing tool launches, click the “Console Mode” button, and check if the QR code loads.
Congratulations, Table Realms has successfully been integrated! Continue reading the next chapters to better understand other features of the Table Realms plugin for Construct.