Skip to main content
Version: 0.10.0

Getting Started

Welcome to Unique Engine, a modular 3D engine built for GameMaker and inspired by the power and design of Three.js.
This guide will walk you through the first steps to get your 3D scene up and running in minutes.

🔧 Requirements​

  • GameMaker Studio 2 (latest LTS or IDE version recommended)

🧱 Project Structure​

Your 3D scene will usually include:

  • A UeScene object (holds all visible elements)
  • A UePerspectiveCamera (defines the point of view)
  • A UeRenderer (responsible for drawing)
  • Meshes and materials
  • Lights, etc..

📦 Installation​

  1. Clone or download the latest version of the Unique Engine from GitHub:
    https://github.com/manuel-di-iorio/unique-engine

  2. Import the ue.yymps file by dragging it into your GameMaker project.

  3. Create an object and add it to your room.

🚀 Your First Scene​

Add this code in the create event of your object

renderer = new UeRenderer();
scene = new UeScene();
camera = new UePerspectiveCamera({ x: 50, y: -100, z: 50 }).use();

cubeGeometry = new UeBoxGeometry(50, 50, 50, { color: #0066FF });
cubeMesh = new UeMesh(cubeGeometry, new UeMeshStandardMaterial());

ambientLight = new UeAmbientLight(c_gray);
dirLight = new UeDirectionalLight(c_ltgray, 1, { x: 150, y: 80, z: 90 }); 

scene.add(cubeMesh, ambientLight, dirLight);

and this one in the draw Event, in order to render the scene:

renderer.render(scene, camera);

Then run the game and you will see a nice cube!