> For the complete documentation index, see [llms.txt](https://docs.libiengine.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.libiengine.com/litepaper/getting-started/workshop-tutorial.md). # Workshop Tutorial Tutorial for Sat 17 Oct. Here are a few simple tips to get started with Libi. Take your time and experiment as you go. Libi is easy to learn: In a couple of hours you can build complex worlds, and with more practice you can create detailed 3D experiences. You can save them, set them to public or private, and share them with a link. By the end of this tutorial, you will have a space where you can showcase your artwork and 3D models you have made. ### **Part 1: Familiarisation with Libi, creating your profile, creating a space and basic controls.** ### 1. Launch Libi Go to [**Libi.xyz**](https://libi.xyz) - this is the website for the Libi engine app. Once logged in, you will have your own profile and ability to create your 3D experiences. While Libi works on almost any device with a browser and internet connection, we recommend building from a laptop and with a mouse. ### 2. Sign in. Click on the left menu, or from the homepage "Get Started". Sign in using your email or Google account. Alternatively, if you have an Ethereum or Solana wallet you can connect with your wallet. ### 3. Dashboard & Menu After Signing in, you'll enter your dashboard. As you are new it's still empty. This is where the projects you are working on will be displayed.
Familiarise yourself with the menu on the left. **New Space / My Space** and **Assets** folders are the main items that you should focus on currently. **Account** is where you can set your profile up, adding a bio including changing the profile picture and background images. **Help** You'll find short videos on how to use the engine. ### 4. Make your first project (space). Libi projects are usually built within worlds or "**spaces**" as we call them. A space can be any type of immersive experience from an art gallery, a beautiful intricate garden through to a game. **In the menu, click New Space.** Select **"Futuristic Gallery"**. Wait for it to load. (Usually on a good broadband connection spaces load within a few seconds.) Once it is ready you should see the message "Click to enter". If after 30 seconds it has not loaded, try refreshing. ### 5. The basic controls Now you are in the space, you will see a room. Left click on the screen and drag with mouse until you are looking at the room like the image below. Left click and drag in different directions to look around.

Futuristic Gallery Space.

#### Moving around inside a space Libi is a little different to other editors. You can edit in real-time in the space. Libi allows you to be an editor while moving in the space as a character. (If multiplayer is enabled, other people can also edit the space with you) For this workshop lets continue with the default. **Movement with keyboard and Mouse:** \ \>> **Left click** and drag on the screen to look around the scene. A single left click on the floor / environment will make you "Walk". \>> **Click on the floor** and walk to the Steps. You will see a circle highlight the floor where you want to walk to. \>> Use **W**, **A**, **S**, **D** keys to move forward, back, left and right. Try to walk around the room using those keys while using the mouse to look around. Arrow keys also work. Holding **SHIFT** while moving, makes you run. \>> Press **Space Bar** to Jump, \>> Press **C** to crouch. GREAT! Now\... **Click on the blue sofa.**

Click on the blue sofa. Try Left clicking and Right clicking on the sofa to see the difference.

**Left click on the sofa to grab it**, now drag it on the ground and in the air. You can make it spin, crash and smash! Have fun! Right clicking on models will open a "gizmo". Once a 3D model is selected you can resize and reposition. Try playing around with models to familiarise yourself with the controls.

The green, blue, red tool is a Gizmo. When you right click it will show on object. It is for moving, turning and resizing objects

When you **right click an object and select properties**, you will see a lot more options for that object. Position and Rotation coordinates can move an object more precisely. You can also Scale and **Freeze** an object. The blue circle shows you the freeze option. When an object is Frozen, it means it will stay in position, it won't move around or be effected by Physics. **>> Test what happens when you use Freeze / Unfreeze: Right click on the chairs and tables, Unfreeze and Freeze them and see what happens when you push them into each other.** ### **6. Asset browsing and object drag/drop** Now we will open the All Assets folder. This contains a public folder which has models, textures, sounds and other files that we can use to create our spaces. \>> On Right side, open the Menu and click on **All Assets**
\>> Go to **Models** \>> **DRAG** "modern rock table" to the Space. It is important that you **hold down click to drag** an asset from the folder into the space. If you only click, it will open the properties further. \>> Right click on a model then Use ALT / Option**⌥** (mac OS) and click anywhere in the space to Snap an object to location. So try to move the rock table using the Snapping method. ### 7. Uploading and Framing an Image The space has some blank walls. Lets upload an image and put it on the walls. Find an image online or on your computer. It should be JPG, GIF or PNG. Here is an example image you could use:
\>> Download the image to your computer, then:\ \>> Drag and Drop it onto a wall / surface in the space OR use the Upload button in the left menu.
\>> Select Frame, wait for the image to upload, and then while holding down Alt / Option**⌥** key you can click on any surface and the Image will be placed. ### **Part 2: More advanced building, controls and saving your first space!** #### 1. Click New space, choose "Small Islands"
Tip: Keep saving your spaces, you can give them versioned names. (currently we do not have an undo button!) #### 2. Save your first space!
\>> From the menu, click save. Choose a suitable name for your new space. Congratulations you have made your first Libi space. (Later you can go to Properties, set it to public and share with anyone.) #### **3. Some more controls** "**F**" is Fly mode, to manouvre freely and go through walls. While in fly mode, "Space" makes you float up, and "**C**" makes you fly down. \>> **Press F and fly up and down**. On your keyboard use "Space" to go up, and "C" to go down. \>> Pressing "F" again gives you gravity and you fall back to the ground. \ "Space" is jump and "C" is crouch. Holding down right click will put you into FPS (First Person Shooter) mode, this is where your cursor changes and you can move freely with the mouse, like in a FPS game. #### 4. Building and Manouvring objects
Right clicking on models will open a gizmo. Once a 3D model is selected you can resize and reposition. Try playing around with models to familiarise yourself with the controls. While an object is selected, hitting Alt on windows / Option**⌥** key on mac, and then clicking on a location will make the object snap to the location. Try it out. #### **Duplicating Objects** To dupliate an object: Right click on an object, the gizmo should show on the object. While keeping the alt / option**⌥** key pressed down, move the object using the gizmo. It should create a duplicate. #### **Multiple selections.** Hitting Shift key while selecting objects will select multiples. Combining this with the alt/option**⌥** key and dragging, will create multiple duplicates. #### **Snapping objects together.** With an object selected, Click on another object while holding down alt/option**⌥** key. This will make them snap together. \>> Using above techniques try to use models and "Snap" them together. You can combine many models to create buildings and structures. Use the public library, search the different folders for models such as walls, stairs etc and combine them to make houses or any building. #### 5 Changing the environment Right clicking on the landscape will open a menu on the right. There are various settings for editing the scenery. Likewise for the Sky settings. #### Uploading images Drag and drop an image into the scene. There will be various options, but for having an image to display in the scene select "Frame". We will show you also how to change the appearance of the frame. #### Uploading models You can upload 3D models. GLB, OBJ file formats work best. We have plans for FBX and other formats in future. #### Animations These work too, if they are part of the GLB file. Not sure we have time to talk about physics! We will try to show you during the workshop. (More documentation coming) If we have time we can show more on following: #### Textures #### AI Building ### 6. Activity: Have fun Building Hopefully by the end of the workshop you will have your first 3D space. It is upto you what you decide to build. It could be a gallery or it could be a virtual world made to protest what changes you want to see in the world.

Space access and sharing

Once saved, go to the left side menu. Click Properties. Select Access, change this to public for your space to be viewable on Libi. Share the link with your friends! We will drop some more docs / videos on how to embed etc For now you can join our Discord to get any further help. ### Useful Links [Sketchfab.com](https://sketchfab.com) - You can find free 3D models to use. Download as GLB or OBJ. (Note: not all the models will work, as sometimes they are not game-ready/optimised.) ### Join our community We have a discord where you can meet other creatives and share your creations. We can help with any questions. Our Discord is: Also feel free to message us via socials. We can be found on instagram: @storyofameer and @six.contrast. Project insta: @libi.xyz