# Welcome to Coderblock Studio! We are pleased to welcome you to **Coderblock Studio**: a suite that allows you to create, manage and monitor the results of your virtual experiences. It is a simple and intuitive platform that allows you to build entire **virtual worlds**. Coderblock Studio is accessible **online** (via browser) to anyone who wants to create buildings, scenarios and virtual experiences, **without requiring specific skills in 3D modeling or software development**. ### Spaces **Spaces** are **3D scenes**, **virtual microcosms** for your avatar to explore and interact with. You can simulate existing physical environments or create them from scratch for a variety of uses: meet friends, host private or sponsored events, set up an office for collaboration or client meetings, share Spaces with your community members, or organise training courses. Unlike Lands, which are located within the Open World map, **Spaces** are **small, separate worlds that are not connected to each other**, but can **be shared via a URL**. \ \ If you're a creator (or want to be), **there's a real opportunity to earn from your creations**. Beyond the business uses associated with the scenes, your creations become products that can be sold, providing a potential source of income.

### Builder Tool [**Builder Tool**](/coderblock-studio/builder-tool) is Coderblock Studio's flagship feature: an **online visual editor** where you can build, design and customize your virtual worlds. It allows you to gain skills and become a digital architect without any specific graphics or 3D modeling knowledge. \ \ As mentioned, it's **accessible to anyone** who wants to learn how to create scenes and virtual experiences in just a few steps. It doesn't require any downloads and is available to all Landowners (owners of land in Coderblock) and Coderblock Studio's subscribers.

Our Builder Tool. Ready to create wonderful experiences?

### Coderblock Hub A shared space to **showcase your virtual experiences**, a **marketplace** to **sell your creations**: this and more is **Coderblock Hub**. It's the perfect matchmaking platform between creators and brands. On the one hand, you can sell your scenes for others to buy and use in their environments; on the other hand, Coderblock Hub is the ideal place to increase **brand visibility** and **reach new audiences** by sharing customized virtual experiences.

The public showcase for your virtual experiences.

# Coderblock World **Coderblock** is a **SaaS platform** that allows you to **create and explore virtual worlds** in a simple and intuitive way: you don't need to install anything on your PC or use VR headsets or other external devices. The Coderblock experience is designed to be **user-friendly**: the platform is accessible to everyone, regardless of skill level. Just open your browser, **create your avatar and start exploring and interacting with other users and the content** available. Here's what you can do on Coderblock: * **Create your own alter-ego** **Create your avatar from your own photo** and begin your journey into the virtual world. It will be your digital representation in the metaverse, allowing you to attend events, explore new worlds and engage in games and adventures. You can **interact** with objects or other avatars, and chat or video call with anyone in your virtual environment.

* **Explore virtual worlds** **Move** around 3D environments and **explore new worlds**. Each experience can be unique and tailored to your needs. {% embed url="" %} Moving around the virtual world has never been easier. {% endembed %} * **Attend events wherever you are** No matter where you are. With your virtual alter-ego you'll be able to be part of **events, trade shows or webinars** with just a few clicks.

* **Interact with objects** The **experience** becomes **even more immersive** when you can interact with objects. For example, you can use your avatar to turn on lights, sit on a bench or interact with multimedia content such as billboards, roll-ups, advertisements or simple in-game objects.

# Support At Coderblock we are committed to ensuring a smooth and satisfying experience, providing clear answers and effective solutions for all our users. \ \ Here are a number of resources you can use to find support:


Discover the F.A.Q. Find answers to frequently asked questions.		F.A.Q.
Join us on Discord Ask the community for help or open a ticket with our team.		https://discord.com/invite/coderblock
Contact us by e-mail	Send an email to support@coderblock and wait for a response from our team.	mailto:support@coderblock.com
Fill in the form Send a request to our team using the support form.		https://coderblock.typeform.com/support-it?typeform-source=app.gitbook.com

# Italian Doc Guide To switch to the Italian Documentation, click [HERE](https://docs-it.coderblock.com) # Coderblock Studio **Coderblock Studio**: an intuitive, browser-based platform that lets you **build entire virtual journeys with just a few clicks**. It's a comprehensive suite to manage your virtual experiences 360° and harness the potential of **Artificial Intelligence** to achieve your goals. By choosing one of our subscription plans, you can **experiment, start building, share and monetize** your creations. Use the **Builder Tool** to quickly and easily create virtual spaces, build experiences within them, publish them and share them with users. Increase **visibility** on the Coderblock Hub storefront, **monitor data with Analytics dashboards** and integrate **Artificial Intelligence** solutions to maximize your results. Coderblock Studio is **accessible** to anyone who wants to learn how to build a virtual scene in a few simple steps. The online editor requires no downloads and no special graphics or modeling skills. Its intuitive layout makes it easy to select, move, position, scale and combine objects. # Subscription plans We have a range of subscription plans to **suit all needs**, designed to meet the objectives of both structured businesses and creators focused on monetization.


	Plans for companies		Plans for companies
	Plans for Creators		Plans for Creators

# Plans for companies By purchasing a subscription plan, you can **experiment with your business** in the metaverse **on a budget**. You also get access to the **Coderblock Hub**, an official showcase that you can use as a new acquisition channel for your customers and to increase your brand visibility.

# Plus With the **Plus** plan, you can start **experimenting in the metaverse** with full access to the Builder tool and the ability to use **15 templates** to model your business experiences. This allows you to create **stunning branded experiences and engage your audience** in innovative ways.

# Premium When you purchase the Premium Plan, in addition to all the content and extra features of the Plus Plan, you'll have the ability to harness the power of artificial intelligence in your virtual world. This includes the use of our Digital Humans and other internal Metaverse applications. In addition, the Premium plan includes strategic and project consulting, which is invaluable when your organisation needs guidance and direction on the experiences you need to build to meet your pre-defined business objectives. You'll also get access to dedicated technical support.

# Custom The Custom plan involves the creation of a completely bespoke experience: our team is at your disposal to create worlds tailored to your business needs. Based on your requirements, our team will develop a meticulously planned project that will be implemented internally as a turnkey solution. From a digital twin of a specific corporate headquarters to an entire branded metaverse with custom gamification adventures and integration of advanced AI solutions, each concept is brought to life with a bespoke solution designed just for you.

# Plans for Creators Interested in **exploring the metaverse**, creating **unique experiences** and **monetizing** your **creativity**? Choose the plan that suits you best!

# Free With the **Free** Plan, you'll be able to **access the Builder Tool for free** with a simple registration and **start experimenting with its key features**. You can try building unlimited experiences within a **single 4x4 scene** and unleash your creativity!

# Plus The Plus plan gives you the ability to create unlimited scenes and, most importantly, start monetizing your creativity. Create, share and earn money by selling your scenes on the Coderblock Hub marketplace!

# LAND Would you like to have a **registered location** for your virtual experiences? By [purchasing one or more lands](/coderblock-lands/how-to-get-your-lands) within the Coderblock universe, you can own a **real virtual property** registered on the blockchain. These lands are located on a **shared map** and can be accessed via coordinates or simple exploration, potentially reaching an **infinite number of users**.

# Payment Methods You can subscribe to one of **Coderblock's subscription plans** using your preferred payment method: **use your card** by entering the required details, or conveniently purchase using **PayPal**. Once you have selected the plan that best suits your needs, you will be taken to the payment page where you can complete your purchase. Whether you choose a monthly or annual plan, your subscription **will automatically renew at the specified interval**. You can cancel your subscription at any time from the Coderblock Studio dashboard at no additional cost.

# Builder Tool **Builder Tool** is the online 3D editor within **Coderblock Studio** that brings scenarios, buildings and customised experiences to life in your virtual worlds. It is available to all **Landowners** (owners of land in Coderblock) **and subscribers**, allowing them to act as true digital architects according to their tastes and preferences. {% embed url="" %} Builder Tool: become a digital architect! - Youtube: @Coderblock {% endembed %} Following, is a basic guide to the main features of the Builder Tool.\ \ For more details and insights, see the [Advanced Guide](/coderblock-studio/builder-tool-advanced-guide). # Building with the Builder Tool By using the **Builder Tool**, you can create scenarios that best reflect your desires and goals within your virtual world. No special technical knowledge of 3D modeling is required: the Builder Tool is simple and intuitive for everyone. This tool provides access to an extensive catalogue of 3D objects in a library of over 1,000 predefined models. It also allows you to upload your own 3D models, giving you complete creative freedom. # How to: create a new scene Creating a new scene with the Builder tool is very easy, just follow a few steps: 1. [Login ](https://coderblock.com/login)to Coderblock with your credentials

2. After logging in, you will be on the Dashboard. To create a new scene (or view the ones you have already created), simply click on **My Scenes**. 3. Clicking on ***Scenes*** will open a series of screens that you will have to fill in with the required data.

4. Within the Builder tool, you have the choice of guided creation (from templates) or completely autonomous creation!

5. Clicking ***Next*** will take you to the editor screen. 6. Now you can make all your dreams come true!

Once you have created a new scene, see the Advanced Guide for details on: * [view and movements](/coderblock-studio/builder-tool-advanced-guide/working-environment/view-and-movements) within the scene * the [main tools](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools) of the Builder # How to: manage my scene You can manage a scene both during its creation and afterwards. During creation, you can use the features available in the top right panel:

Here you can: 1. Save the scene 2. Publish the scene (you can undo this if you decide not to publish your scene anymore!) 3. Create Quests 4. Explore the scene with your avatar If you have already saved and/or published your scene, but would like to modify it, simply follow the steps below: 1. Go back to ***My Scenes***. This time click on ***Gallery***.

2. A screen will appear showing all your creations.

3. Click on the three dots in the top right corner above the country to open a drop-down menu.

Here you can: * Make your scene private * Duplicate the scene * Delete the scene
For more details and insights, see the [Advanced Guide](/coderblock-studio/builder-tool-advanced-guide/working-environment/scene-management/finalization-tools). # 3D model library Want to know what is available in the Builder Tool? Take a look at our **inventory**! But remember, the Builder Tool also allows you to upload your own 3D models in .glb format.

For all the details on [library elements](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools/asset-packs), see the Advanced Guide. # Upload your own 3D models Want to customise your scene even more? The Builder Tool allows you to upload your own 3D models. Just follow these steps: 1. Click on the **+** at the top right

2. Drag your 3D model into the box

3. Click **Import Model** 4. Choose a name for your object and select the category

5. Now all you have to do is place your item wherever you want and use it just like any other item in your inventory!

# Objects features For each object you place in your scene, you can modify some of its properties. You can: 1. Move it in all directions 2. Scale it 3. Rotate it in all dimensions 4. Confirm the object 5. Delete the object

All these actions are possible thanks to the panel that opens on the left when the object is placed in the scene. This panel allows you to manage all the actions individually or simultaneously:

Each object has different properties, which you can view in the drop-down menu on the right when you select an object. For more details and insight into object manipulation, see the [Advanced Guide](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools/gizmo-and-assets-manipulation). # NPC and conversations One of the most interesting features of Coderblock World is that you can insert Non-Playable Characters (**NPC**) into your virtual scenes or lands and create conversations that are activated whenever a user interacts with them! These conversations represent a significant step towards a more immersive and dynamic gaming experience: interactive and realistic dialogue - enhanced by artificial intelligence - helps to create a more lively and engaging environment, making the user experience unique.

### How to: place an NPC in the scene You can add either one of our Codys or one of the Digital Humans to your scene as an NPC. Search for **NPC** in the Builder's search bar and choose your favourite!

Once you've selected the NPC, place it wherever you like in your scene. It could greet players at the entrance to a building, be next to a desk or table in a meeting room, or perhaps near where you've placed the start of a quest: any location can be suitable for an NPC in your scene! ### Setting up the conversation flow Once the NPC has been placed, click on it and then click on '**Create Conversation**'.

Conversation flows are managed by **Narrative Events**. Each Narrative Event represents a 'node' in the conversation flow, and the user's choices determine the order of the nodes and therefore the conversation with the NPC that is displayed. \ \ Within each Narrative you can add one or more 'Items', which can be thought of as 'sub-nodes'. There are two types of item to choose from: * **ItemText**: This is an 'informative', 'conversational' item. It's a simple text that you can decide to insert into the conversation, it doesn't involve a choice, but allows the flow of conversation to continue until the end of that particular Narrative Event, or until an ItemChoice is encountered. If there is no ItemChoice and the Narrative Event ends (i.e. there are no more ItemTexts), the conversation with the NPC will end. * **ItemChoice**: Allows the user to make a choice via 'Answers' that will redirect the conversation flow to another Narrative Event. Click '**Add Answer**' to add the choices that the user can make (with the text that will appear on the choice buttons) and the corresponding Narratives where the conversation flow will land based on the choice.

For both types of item, you can use the '*Dialogue Text*' to enter what the NPC will say when the conversation reaches that particular item. To add an item to the narrative event, simply click '*Add ItemText*' or '*Add ItemChoice*' and it will be placed after the last previously created item (or as the first if you haven't added any items yet).

For each item, you can also define **Conditions** and **Effects**, which allow you to better manage the conversation by specifying the conditions under which this 'sub-node' will be displayed to the user during the conversation, or the effects that it will trigger. The main purpose of these two settings is to manage quests, as explained [HERE](/coderblock-studio/builder-tool/npc-and-conversations#gestione-delle-quest-tramite-conversazione-con-npc).

Once the conversation is created, you can change it at any time by clicking on the NPC and then clicking on '**Update Conversation**'. Remember to click '**Save**' on each item within a Narrative Event when you make changes, as well as the 'Save' button at the top of the entire conversation.

Finally, click the green '**Save Scene**' button in the top right corner to save your changes. ### Quest management - *Condition and Effect* Our NPCs are not just friendly characters who provide information and companionship, they can also play a crucial role in your virtual environment. **The activation and management of** [**Quest**](/coderblock-studio/builder-tool/quests-what-they-are-and-how-to-create-them) **is entirely up to the NPCs** and their conversations! The part of the conversation flow related to quest management deserves a separate discussion. We are talking about the Condition and Effect sections, which can be found in detail [HERE](/coderblock-studio/builder-tool/quests-what-they-are-and-how-to-create-them#attivazione-e-gestione-quest-tramite-npc) # Quests: what they are and how to create them **Quests** are missions or tasks that users can complete within interactive virtual worlds. This concept is very common in video games and is also found in your virtual world. In order for a user to participate in a Quest, it must be **activated by talking to an NPC**. To implement a Quest in your scene, you'll need to follow three main steps: * Create the **Quest** * Add an **NPC** to the scene * Set up the **activation of the quest** within the NPC's conversation. The user can then choose to participate in the quest by talking to the NPC. Here's a simple example: \- The user interacts with the NPC by pressing E and initiating the conversation. \ \- NPC: "Welcome! Would you like to join the quest?" \ \- At this point, the user can choose to click the "Yes!" button or "No, thank you!" (or any other form you decide to use in the conversation). \ \- If the user clicks "Yes!" and the conversation with the NPC is correctly set to start the quest under those conditions, the quest will start! \ \ **NOTE**: *Quests will soon be available on lands as well as spaces!* ### Create a Quest To create a quest, simply click on the green '**Quests**' button at the top of the screen, and then click on the '***Create New Quest'*** button that will appear in the centre of the screen. At this point, you can give your quest a name and description, and select its type based on the type of quest you want to create, as we'll see shortly.

Once you have filled in the Title, Description and Quest Type fields, you will find yourself at this stage (in the example, a CollectItems quest type):

From here, you can choose to edit the information you just entered (such as the title and description) by clicking on '**Edit Info**', delete the quest by clicking on '**Delete**', or continue to define its details by clicking on '**Edit Quest**'. **Important**: Remember to set the quest to 'Active' if you want it to be operational! Currently available quest types include '**Treasure Hunt**' and '**Follow the Path**' quests, with and without **timers** (new quest types will be available soon, follow us on social channels to stay updated)! In both cases, the concept is the same: once the quest starts, the participating user must approach and get close to the objects you have chosen to include in the quest in order to **collect** them. The quest is completed when all the items have been collected (or within a certain time if you have set a timer). #### Treasure Hunt To set up a treasure hunt, choose '**CollectItems**' as the quest type. In this quest, all the items you select will appear simultaneously at the start of the quest, placed in the locations you select in the scene. You can collect them in any order you like - the only requirement to complete the quest is to collect **them all**! Once you have created the 'base', click on '***Edit Quest***' to decide which items you want to use in your quest and how you want to arrange them. Choose whether you want to use items such as 'Tiles', 'Nature', 'Furniture' or 'Decorations', then click 'Next' and select the single items you want to use.

In the example below, we have chosen a 'Circle Flower Bed' of type 'Nature', and we are going to place it in the scene.

Choose how many items you want and place them wherever you prefer within your scene (you can also use different types of items). Once you have positioned all the items that you want users to collect during the quest, click on **Next**. At this point, you can set up an interaction with each of the objects you have placed. This means that when a user touches or passes over an object, you can show them an iframe with the content of a web page, just like with other objects placed in the scene outside of the quest, as explained [HERE](/coderblock-studio/virtual-environment-management/website-integration). Now, click on **Next** and proceed to set up the '**Variables**', which are crucial for the proper functioning of the Quest. Click on '**Add Variable**' to set additional details in your quest, such as the presence or absence of a timer.

Note: The description must not contain any spaces. The first drop down menu allows you to choose between '**Counter**' and '**Countdown**'. **Counter** simply indicates that the quest will end when all items have been collected, and during the quest users will see a counter showing how many items remain to be gathered. You can also choose to have the items appear all at once (as in a treasure hunt) or one at a time (as in a 'follow the path' quest). \ (In the case of a treasure hunt, it is not necessary to set a Counter variable: you can choose not to set any variables and the items will appear all at once). Instead, you can add a **Countdown** variable to require users to collect all the items within a specified time to complete the quest. \ \ Click **Ok** and then **Next** at this point. \ Click **Next** again on the next screen, 'Quest actor placement', and then click **Done** on the final screen, 'Quest actor conversation', as the activation of the quest in this case will be managed by an NPC external to the quest and its conversation, as explained in the next paragraph. Congratulations, you have created your first quest! Now all you have to do is set it up to be activated by an NPC, but we'll see about that in a moment 😉. #### Follow the Path If you want to implement a '**follow the path**' type of quest, choose **FollowPath** as the quest type. In this type of quest, the items you select will appear in the scene one at a time, in the order and location you specify. In this case, it is necessary to collect the item that appears in order for the next one to appear (unlike a treasure hunt), so that the user follows the path you have outlined. Due to the nature of this quest, which is typically used to guide the user along a specific path, it is advisable to place the items not too far apart so that the user can easily see the next one. The process of creating this type of quest is very similar to that of a treasure hunt. After creating the 'base' quest, you will also need to click '**Edit Quest**' to select and position the items you want the players to collect during the quest. The only real difference is in the '**Variable**': in this case you will need to add a **Counter** variable and set it to '**Show one item at a time**'. As before, add a **Countdown** if you want your users to collect the items - one at a time in this case - within the time available. ### Placing an NPC in the scene Once the quest has been created, **you will need to activate it by having a conversation with an NPC** that you will need to place in the scene and whose role will be to manage the quest. Follow the instructions [HERE](/coderblock-studio/builder-tool/npc-and-conversations) to add at least one NPC to your scene to use quests: the conversation doesn't necessarily have to be about activating the quest, the topics can vary. What is important is that there is a flow that leads to the activation of the quest itself, if the user chooses to participate in the quest. **Note**: The NPC can initiate the quest, but can also end it. They can also give hints on where to find items if the user is unable to find them. During a quest, if the user resumes the conversation with the NPC by interacting with them, the NPC will respond differently than they did before the quest began. They may also respond differently once the quest has been completed. You determine all aspects of quest management - before, during and after - by setting up the NPC conversation as you wish, including parameters such as **Conditions and Effects**, as explained in the next section. ### Managing Quests through NPC: Condition and Effect Once you've placed the NPC in the scene and set up its conversation flow as explained [HERE](/coderblock-studio/builder-tool/npc-and-conversations), it's time to insert ***Conditions and Effects*** into the conversation elements as you see fit, allowing you to manage quests (and more!). A ***Condition*** allows you to enable or disable a particular ItemText or ItemChoice within a narrative. Each time the conversation flow reaches an Item in a Narrative, it checks the Condition associated with that Item. If the condition is not met (for example, the 'Gather Crystals' quest has ended while it's still running or hasn't started yet), then that item will not be displayed to the user, and the conversation flow will continue without displaying it. Conversely, if the condition is met or not defined, the item will be considered, shown to the user, and any set effects will be activated. Currently, you can set a condition to check whether a quest is *active*, *started*, *in progress* or *completed*. An ***Effect***, on the other hand, allows you to set functionality that is activated when the conversation flow reaches a certain point in a narrative (assuming the condition is met or not defined). You can decide to *start*, *stop* or mark a quest as *completed* (successfully or not).

The flexibility of Condition and Effect allows you to manage different situations within the same quest through a single NPC. For example, you can set up the conversation flow so that the first time a user speaks to an NPC (when the quest hasn't started yet), the NPC asks if the user wants to join the quest. If the user speaks to the NPC again during the quest, the conversation will be different, with the NPC perhaps offering hints on the location of items to be found. Similarly, if the user speaks to the NPC after completing the quest, you can set up a different conversation in which the NPC congratulates the user on completing the quest. It is therefore vital that you learn how to use Condition and Effect to get the most out of your quests. In the **first example** of our simple conversation with the NPC and the 'Collect Items' quest, the start of the quest is set in Narrative Event 2 (its first and only item), which is reached when the user answers '*Yes*' to the question '*Do you want to participate in the quest?'*

In this case, no conditions have been set, so the only requirement to start the quest is for the user to answer 'Yes', which will allow the conversation flow to reach the Narrative that handles the 'Start Quest' function, thus starting the quest!

**NOTE**: Whenever you make changes to the conversation flow, remember to click 'Save' on both the individual item you've edited and the conversation as a whole, as well as 'Save Scene' at the top right! # OpenAI - COMING SOON Soon it will be possible to harness the power of AI directly into Coderblock's virtual experiences with the integration of some OpenAI functionality! Stay tuned 🔜 # Rights on my creations As with all platforms where virtual scenes can be created, replicating a scene involves rebuilding it piece by piece from assets available in the Builder library. Custom objects imported from external sources are copyrighted by the person who originally uploaded them. # Virtual environment management Do you want to be able to create, manage and interact with virtual environments on your own? Once you've created your 3D world, it's time to use it to organise events and initiatives! Discover the key features you can use to get the most out of virtual environments.


	Live Streaming		Live streaming in my environments
	Users in my scene (CCU)		Users in my scene (CCU)
	Users interactions		Users interactions
	Website integration		Website integration
	Video call integration		Video call integration

# Live streaming in my environments **Live streaming** is a feature that allows you to broadcast live video within a virtual scene. You can use this feature through a **Video** element or a **Stage** element, as these elements have an integrated screen.

Once you have placed the screen or stage in the scene, you need to change the options as follows: * **ResourceType**: Live Streaming (M3U8 HLS). * **ResourceUri**: an m3u8 link obtained from the streaming engine, i.e. the third party platform used for streaming. * **HasExternalURL**: disabled.

Two other useful options: * **Has Video control**: if enabled, it allows you to modify some video controls (play, pause, volume, etc.) and to view the live stream on mobile devices. * **Range of interaction**: defines the area in front of the screen that, when crossed by the user, triggers playback. Note: when a user walks through the interaction area in front of the screen, they are watching the live stream playback. However, they can choose to restart the playback from the beginning using the controls that appear on the screen. # Users in my scene (CCU) You can share your scene with an unlimited number of users using the link that is generated in Coderblock Studio. This will be the official entry point to the scene and there are no limits on sharing. However, during your events, you can host a maximum number of users **simultaneously** within the scene. This value is called **CCU** (Concurrent Users) and depends on the [subscription plan](/coderblock-studio/subscription-plans) you have chosen: with the Plus plan you can host up to 75 users, while with the Premium plan you can host up to 100 users! If you think your events will host more than 100 users, try our [Custom](/coderblock-studio/subscription-plans/plans-for-companies/custom) plan, buy a [Land](/coderblock-studio/subscription-plans/plans-for-creators/land) or contact us for a personalized package.
# Users interactions When they're in the scene that you've created, your users can interact with each other through a **shared** **general chat**, a **private chat**, an **individual audio call**, and a **video/audio** **call shared** with all the other users sitting at the same table or bench! \ \ In fact, in scenes that represent offices for meetings, networking activities, or just gathering places for friends, you could include tables that allow for integrated video calls.

But the interaction possibilities don't end with chat/calls: imagine attending a concert with users from all over the world and starting to dance to the music, waving to greet a new user, raising your hand to speak during an event, or applauding to show appreciation in front of a digital art exhibition. Expressing your **emotions** to those around you, even if they are physically thousands of miles away, has immense potential! By enabling a level of engagement and communication that replicates the dynamics of the real world, users can become more fully integrated into the virtual world they inhabit and fully appreciate the experience. Want to know more about how your avatar can interact with others? Check out the dedicated [section](/coderblock-world/user-experiences/interactions).
# Website integration One of the most useful features if you want to present and promote your business within your virtual scene is to use 'informative' elements directly from the Builder that users can interact with. You can use three types of elements for this purpose: * **Details**: you can find them in the '*Features*' -> '*Contents*' section. Once placed, it appears as a small circle on the floor and users can interact with it using the E key, similar to other interactive elements.

When the user approaches this element and clicks the E key, an iframe is displayed with an image, a description and two buttons leading to different URLs, plus a third link placed in the iframe footer.

**Roll up, banner and walls**: these are graphic elements that display an image and also link to a URL when the user interacts with them by pressing the E key.

*Note: Not all walls offer this functionality, only the interactive ones. Remember that interactive objects of any type are visually identified in the Builder by a light blue background and a ⚡️ icon.* * **Stands**: There are several sizes available, all of which are capable of displaying graphics in different spaces according to the dimensions of the stand. They also integrate the functions of the Details element. When you interact with the E button on the stand, the iframe described above appears, offering the same customization options.

These interactions not only enrich the user experience, but also provide creative opportunities to promote your business and engage visitors as they explore virtual worlds! # Video call integration If you've decided to allow users in your virtual scene to interact with each other via **video call**, perhaps creating an experience that resembles an office for meetings or just a meeting place for friends, you can do this by placing an interactive 'table' element in the scene, as well as benches or chairs. Not all tables allow this functionality, so remember that you can identify interactive objects (tables and others) by their sky blue background and ⚡️ icon.

In fact, in the image above, the interactive tables are the ones that allow integrated video calls between users sitting at them! Once you've positioned the table, bench or chair in your scene, here are the options to set: * If you want to use an **integrated video call** in the environment, enable the 'Use video call' option and also the 'Embed call' option. This way, when you sit at a table or bench, a window will open in the bottom right corner with a set of controls for managing the video call with other users sitting with you.

If you do not select 'Embed call', the video call will open in a separate window. * If you want to use a link to an **external video call**, such as Google Meet or Zoom, select '*Has external URL'* and enter the call link in '*URL*'. In this case, do not select either of the built-in video call options. This option can be useful if you are using chairs and want to allow all users who are spread around the room on different chairs to join the same call. Or if you want users sitting at any table to join the same call, rather than having a different call for each table.

In both cases, once the user has joined the video call by sitting down and pressing E, they can stand up (again, by pressing E) and continue exploring the environment without disconnecting from the video call. The business opportunities associated with using the video call feature are numerous: you can manage meetings, presentations and discussions with clients or collaborators simultaneously and without geographical limitations! # Builder Tool - Advanced guide Here is a detailed technical guide to building your virtual environments and getting the most out of the Builder! # Working environment The Builder is made up of two main elements: the first is the **visualization space**, where we set up our scene and manipulate its appearance, which occupies a large part of our working environment; the second is what in technical jargon corresponds to the **HUD** (Head-Up Display), i.e. the overlay tools we have at our disposal to go through the various stages of working on our environment. The builder, integrated into the web management system, is structured as follows: * on the left side, the menu items for managing your account remain prominent for quick access to platform features; * on the right side are the main controls for [scene management](/coderblock-studio/builder-tool-advanced-guide/working-environment/scene-management) and [finalization](/coderblock-studio/builder-tool-advanced-guide/working-environment/scene-management/finalization-tools) ([quest](/coderblock-studio/builder-tool/quests-what-they-are-and-how-to-create-them), [saving and testing](/coderblock-studio/builder-tool-advanced-guide/working-environment/scene-management/finalization-tools#publish)), as well as the [Asset library](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools/asset-packs) for building the environment; * the central part contains the working environment, [controls for managing the elements in the scene](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools), and a monitoring panel, the [poly-count](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools/scene-monitoring).

# Scene management ### Basic informations First, it's important to establish the nature of our scene: it will be appropriate to assign it a name, a description and some parameters that will allow us to best index it within the Coderblock ecosystem. Click on the edit icon

found at the top of the right panel.

Then enter a **name** for your environment and a **description** (these values will be displayed on the welcome screen during login), then select a **market category** and **tags** for the template that can best represent the environment you are building.

Confirm by clicking on the *Update* button. You will notice that the side panel from which you will manage the scene has been enriched with the name you have assigned to it. Of course, it will be possible to edit this information, allowing you to make the environment versatile and editable according to your needs.

# Finalization Tools Among the management tools, those that we will call "finalization" tools are crucial for defining the experience within your space and its fruition from the outside. At the top, next to the editing panel, a drop-down menu

will give you access to some of the functions described below: * [Save scene](#save-scene) * [Publish](#publish) * [Quests](#quests) * [Jump to your virtual world](#jump-to-your-virtual-world)

The buttons are self-explanatory, of course, but let's go through them: #### Save scene Although it may seem that saving our work on the builder is only associated with this button, this is not the case. In fact, as you build your environment, every single move you make is automatically saved, so if you left the Builder without clicking *Save Scene* and came back later, you would find the work exactly as you left it. However, you may not want to show the intermediate stages of processing when the environment is incomplete, especially if the work you are doing is particularly complex and may extend over time.\ \ So what is this button for, if the work is automatically saved? It is used to confirm that the work in progress is finished or has otherwise reached a level that you want to present to our audience. The status is then stored in the server cache and made available to the end user. As a matter of good practice, it is not necessary to save the scene every time you make a small change, unless you need to make the change available immediately. **Best practices**: * do not save the scene every time you make a small change, except for changes that need to be made available quickly. * once you have clicked the "Save Scene" button and waited for the save time (which varies depending on the complexity of the scene), click the "[Jump to your virtual world](#jump-to-your-virtual-world)" button to verify that the changes are displayed correctly and to speed up future uploads. #### Publish **Publish** allows you to publish the saved scene. However, we must distinguish between two different cases of publishing, depending on the type of scene you are managing, considering the possibility of operating as a user of Coderblock Studio for SaaS and as a Landowner. Operating in **SaaS**, the Publish button will bring the scene within [Coderblock Hub](https://coderblock.com/hub/home), with visibility and searchable. As a **landowner**, however, the scene will not be listed at the moment, but will be visible in the Open World. It is important to remember that you can build as many scenes as you like on the lands you own, but only the published one will actually be visible. This feature allows you to build many different scenes, or make small temporary changes to a duplicate scene, and choose from time to time which variant to publish. #### Quests The *Quests* button opens, in the footer, the tool for creating experiences in our environment, the "quests", and it is considered a finalization tool, since it is usually used at the end of the environment processing, when the setup is almost finished and you can devote yourselves to custom content (graphics and dialog). A [separate section](/coderblock-studio/builder-tool/quests-what-they-are-and-how-to-create-them) will cover how to create and activate quests.

**Best practice**: for proper design, quest creation should precede dialogues writing. #### Jump to your virtual world When your scene is ready, or sufficiently set up to be tested, the "Jump to your virtual world" button will take you to the environment you have just created. A new tab will open in your current browser. The URL displayed has a fixed structure (**game.coderblock.com/#id=** followed by an identification code), will be unique and will never change despite any changes you make over time. You can then share it with your end users to allow them to visit your space and access the experience you have created. **Best practice**: the URL consists of three parts: the root **game.coderblock.com/#id=**, an alphanumeric code, and spatial parameters traceable to our positional coordinates. The last part is preceded by an **&** and only appears when we start moving through space with our avatar, and changes dynamically. Therefore, when sharing an access link with your users, it would be good to provide the URL that you see once you enter the environment, or if you are already moving, remember to capture only the part that precedes the **&**.

# View and movements First, it's important to learn how to move around the scene you are building in order to better manage perspective and evaluate space and placement. You can use the mouse (or trackpad) and keyboard simultaneously for optimal editing. The keyboard alone does not allow an unlimited number of movements, whereas the mouse does. The difference, however, is that the mouse by its very nature has spatial limitations related to the size of its support surface in relation to the amplitude of the movement you perform, while the keyboard can allow continuous movements of unlimited amplitude (just holding down a key is enough to extend a command). At the end of this section, we will outline some best practices for using them together to achieve smooth movements and precise positioning. If we consider an absolute condition for the positioning of objects, with spatial coordinates that converge to the 0 point in the upper left corner of our scene (or of the global map in the open world), the movement in space assumes a relative condition, referring to the orientation of our point of view (**POV**) for each and every instant in which the movement itself takes place, thus considering a horizontal axis for **x**, a vertical one for **y**, and one perpendicular to us for **z**, always concordant to our POV. This imaginary, fixed Cartesian system, of which **z** traces an invisible line between us and the object we are observing, does not correspond to the references relating to the movement of the objects themselves, except in a specific mode of [translation on the orthogonal plane](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools/gizmo-and-assets-manipulation/position/movement-on-the-orthogonal-plane). Later, when we deal with manipulating and editing objects in the scene, we will assign **red**, **green**, and **blue** reference colors to these axes. The POV cannot rotate around itself, but always relative to a **focus** that affects it, as if walking along a circumference or on the surface of a sphere, always looking at the center. Rotation of the POV on axes is only possible for **panning** (y-axis) and **tilting** (x-axis). {% hint style="info" %} Imagining the camera at a fixed point, the main movements are derived directly from film jargon and practice. In this specific context, we count three, one for each axis of rotation: **tilting (x)**, **panning (y)** and **rolling (z)**. \ However, since there are no directorial/cinematic needs, but only practical and architectural ones, the rolling movement is excluded from the possibilities. This may seem like a limitation, but it is actually an advantage because it allows for faster execution in the construction phases. The absence of rolling will be most noticeable when describing the [orthogonal plane positioning](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools/gizmo-and-assets-manipulation/position/movement-on-the-orthogonal-plane) tool. **To make it easier to distinguish between the axes of the workspace and those of the POV, we will refer to the former by the letters ****x****, ****y****, ****z****, according to the spatial coordinate system, and to the latter by the terms ****tilting****, ****panning**** and ****rolling****.** {% endhint %} ### Focus When you enter a scene, whether it is new or loading a previous work, the focus is placed on a predefined point in space. Your movements in the environment and the manipulation of objects will affect the focus. Its centering can be restored by clicking on the [**Focus Camera**](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools/control-panel#focus-camera) button to reinitialize it, or by pressing the **F key** after selecting an object to reset the focus on that object. The latter operation is very useful when you are working in large environments, where moving your POV can cause rotations over very large radii for the selected object. ### Using the mouse/trackpad The combined use of the three buttons (two side buttons and the center wheel) with the mouse movement allows a comprehensive use of the space, with no limits in the selection and movement of objects and PDV. If you wanted, you could use only this device for integral processing, without ever using the keyboard (except for customizations). * The **left button** of the mouse retains its primary function of **selecting, dragging,** and **dropping**, and is therefore associated with **placing** and **manipulating** **objects** from the [Asset Pack](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools/asset-packs) or already in the scene. Left-clicking on a point in the scene where there are no objects will therefore produce no results. * The **right button** of the mouse allows you to **rotate around the** **panning axis (y)**, which is vertical to our focus, and **around the** **tilting axis (x)**, which is horizontal. The distance of our POV from the focus determines the rotation radius of the POV itself. * The **middle button** of the mouse, corresponding to the cogwheel, is the one that suffers most from the mechanical limitations of the work surface, but it allows total control of the **linear movements**. Clicking on the cogwheel produces a **shifting**, where the horizontal movement of the mouse allows **lateral movement along the** **tilting axis (x)** and the vertical movement, on the other hand, results in **elevation along the** **panning axis (y)**. Finally, rotating the wheel allows you to **zoom** forward and backward, so **in depth along the** **rolling axis (z)**. **Please note**: the use of a **trackpad** is not explored in depth because the gestures that correspond to mouse movements are specific to the hardware in use and may vary. ### Using the Keyboard As anticipated, the keyboard allows a limited number of movements, and they are only related to the **zoom** and **shifting** functions, i.e. those associated with the middle mouse button. The advantage of using the keyboard, however, is related to the **persistence of the command**, which allows large movements with extreme fluidity. In fact, if the mouse has the mechanical limitation of its usable surface, and the movement in space is related to the movement of the mouse, the movement performed by the keyboard is related to the duration of the key presses. The keys associated with such moves are the first 6 on the left side of the keyboard, distributed as follows: * **A****/****D**, respectively the left or right lateral shift, corresponds to the movement on the **tilting axis (x)**; * **Q****/****E**, allow movement in the vertical plane, lowering and raising the POV along the **panning axis (y)**; * **W****/****S**, to move forward and backward along the **rolling axis (z)**.

Constant button presses move the POV along the axes, but what if we want to move in one plane? It's easy: just give the commands for the directions involved at the same time. The same goes for moving in three-dimensional space: press three buttons, one for each axis.\ Ex: I want to move along on the horizontal plane while moving forward and to the right at the same time, so I will press W and D, dosing them to get to the desired point. Note: as mentioned at the beginning of the chapter, the translation axes are relative. Therefore, if we were looking at our environment from above, and had therefore applied a downward tilt to frame the scene (as in the image above), a forward movement along the **rolling (z) axis** (**W** key pressed) will not be parallel to the horizontal plane of the scene itself, but diagonal to it, and insisting on the movement will intercept it. **Best practice**: motion management is best done with a combination of keyboard and mouse, where we leave 100% of the linear movement, zooming and panning to the keyboard, and use the mouse for tilting and panning, using only the right button and not the middle button. # Design Tools We have already mentioned the main components of the HUD, so let us get more specific by describing its main tools. First of all, let us distinguish between two terms that we will come across repeatedly in relation to the tools of the Builder that allow us to make changes to the scene: we will talk about **editing** and **customization** tools, and they will refer primarily to the manipulation of objects. These terms may seem synonymous, but we will actually refer to them as such: * **Editing**: all operations related to the integration and spatial transformation of the object; * **Customization**: secondary operations that do not involve spatial configuration, but add interactions, special features, redirection, information, or custom graphics to the enabling objects. The display area shows two groups of fixed elements: * [a control panel](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools/control-panel) * [a monitoring panel](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools/scene-monitoring) * [the library of objects (asset packs)](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools/asset-packs) Other tools, however, will appear depending on the operation we are performing: * an editing panel * [a quest design panel](/coderblock-studio/builder-tool/quests-what-they-are-and-how-to-create-them) * [a pop-up for dialogue management](/coderblock-studio/builder-tool/npc-and-conversations) # Control panel The Control Panel, which occupies the upper left part of the workspace, collects the display settings and commands for confirming the edit or deleting the object.

We have already discussed the [management of movement](/coderblock-studio/builder-tool-advanced-guide/working-environment/view-and-movements) in space in the design phase, and we have highlighted the concept of POV, which corresponds to a camera that frames the workspace from vantage points that we choose. This type of construction allows us to have an overview, but it does not give us the certainty that we have designed the spaces optimally, at least from the point of view of walkability. So, in order to validate the scene structure without necessarily publishing the environment to test it, the control panel helps us with the first two buttons from the left. These two buttons actually transform the working mode, locking the POV by assigning real motion functions to the keyboard and mouse. #### First person The first button

activates the first-person viewport, simulating the presence of an avatar. As long as the mouse is inside the viewport, the pointer disappears: this way, mouse movements, in combination with the keyboard, orient the view and thus any non-straight movements. In this mode, the controls differ from the game mode in that the keyboard is essential to enable movement, while the mouse provides a spherical view (x and y axes) and the click provides interaction feedback (if any). The corresponding keys to apply motion are W-A-S-D, where * W: forward * S: backward * A: left sideways shift * D: right sideways shift * SHIFT: run * SPACE: jump To exit this mode, press the **ESC** key on the keyboard to release the mouse.

Pressing ESC again will lock the mouse again

, while clicking on the first person key

will return you to construction mode. #### Third person The next button

brings an avatar into the scene by imposing a third-person view.

As in the first-person view, movements are entrusted to the keyboard with the same configuration, while the mouse orients the view and thus the direction of movement. This mode is very useful when a **human reference** is needed to estimate **proportions** with the dimensions of objects in the scene. For example, commonly used elements such as buildings and doors can be resized if necessary, but incorrect proportions could prevent proper enjoyment or create unwanted visual effects. A third-person motion test can help us properly evaluate any staging choices. #### Focus Camera This topic has already been covered [here](/coderblock-studio/builder-tool-advanced-guide/working-environment/view-and-movements#focus), but let's take a closer look:\ the third element in the control panel is the "focus camera" button

, and it is actually a function that is useful in the default viewing mode, i.e. free camera.\ As already mentioned, the focus repositions itself as the camera is moved, according to the positioning and manipulation of objects in the scene. It natively corresponds to a specific view of the object in use, or of the initial coordinates of the space. What determines which view we get is the existence of an active selection: * If **no object** is **selected**, the Focus Camera button returns to the scene initialization coordinates; * if **an object** is **selected**, the Focus Camera button will reset the focus on it, bringing the POV to a predefined distance from the object's [**pivot**](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools/gizmo-and-assets-manipulation#pivot); only in this case, we can use the same function through a keyboard shortcut by pressing the **F** key. The focus camera is one of the least used features in the early stages of editing a scene, as the mostly empty environment allows for easy selection and editing. However, this simplicity creates a habit. In fact, management becomes complicated when there is a building to set up, and moving within it can become complex because the focus corresponds to a kind of pivot. It should be remembered that linear movement (**W** and **S** keys, on the **z** axis), unlike lateral movement, does not move the focus, but only the distance from it, and by rotating the view, architectural elements such as walls or other staging elements could be inserted between our point of view and the object to be edited. **Best practice**: it might be necessary to move an object from a clearly visible position to another semi-hidden position or out of our field of view (more on this topic later). In some cases, an inaccurate movement might cause us to miss the object. In either case, before confirming its position, it would be a good idea to use the focus camera button (or the F key) to bring the object back into visual focus. #### Legend The only function of this element

is to summarize the most important commands of the Builder, already mentioned here, regarding the movement and editing of objects and the movement in space. #### Erase/Confirm Normally disabled, these buttons become active only when an object is selected. The first

, has the sole function of deleting the selected item from the scene, and is irreversible. Its shortcut is the **CANC** key on a PC or **Fn+Backspace** on a Mac. The second

, confirms the position and is conditional on the validity of the position itself. In fact, as we will see later, we can only confirm the position for elements that are not larger than the scene itself, inscribed in it, or otherwise not outside its boundaries. Its shortcut is the **ENTER** key. **Best practice**: when you are working on a layout that includes buildings and furniture, you may accidentally select a building and delete it, or move it and confirm the new location. To avoid this, when structuring complex spaces, it is a good practice to mark the position, rotation, and scale coordinates of the buildings on a note, exactly as they are described by the tools themselves, so that you can effectively relocate changed objects to the same positions. # Gizmo and assets manipulation When we pick up an object from the [asset pack](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools/asset-packs), or when we select an object that already exists in the scene, the most important tool is undoubtedly the **gizmo**. The Gizmo is a virtual object that overlays the selected element to allow editing, and it is present in the Builder in four forms: one for each type of spatial transformation, and a universal one that includes them all. The transformations concern position, rotation and scale, and their activation results in a different gizmo configuration, so that the transformation used can be recognized at a glance. When we select an object for the first time, the gizmo related to positioning appears by default, but after the first editing it will inherit the last tool used, in order to speed up any recurring operations. #### Pivot The gizmo does not occupy a random point on the object, but a specific position corresponding to the **pivot**. The pivot relative to the 3D model is intrinsic, i.e. it is arbitrarily defined when creating/exporting the object itself and cannot be changed in the Builder. It corresponds to a point that we might call a relative origin, i.e. the intersection of the axes, and it provides the Builder with instructions on how to position the object relative to the point where we clicked to release it.\ This means that for a simple 3D model such as a cube, if it has a fulcrum placed at its base, placing it at a point in our space will cause the cube to rest on the selected face. On the other hand, if the fulcrum were at its center of gravity, selecting the surface on which to place it will give us the effect of an object intersecting with the surface itself, leaving half of the cube exposed. Considering the exact placement of the pivot will be important if we decide to create and upload [custom objects](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools/asset-packs/uploading-custom-objects) (e.g., a pivot away from the base of the model can be useful for creating floating objects). #### Grid and Snap When an object is selected, a grid is highlighted, which is useful as a spatial reference. The unit of measurement when discussing coordinates and dimensions is the meter, and each plot measures **16x16m**. The grid superimposed on a plot divides the space into sixteenths, so that each small block measures 1x1m. In order to speed up the design process, a snap, i.e. an anchor to a specific measure, has been set, which binds movement and scaling operations to fixed values. This measure allows increments and decrements of **1/4 units**. The meaning of this value will be explained in the next sections of the manual.

#### Shortcut If you need to move the POV while editing an object, you can use the keyboard commands [as described before](/coderblock-studio/builder-tool-advanced-guide/working-environment/view-and-movements#using-the-keyboard). However, you may notice that the gizmo changes shape during these movements. This is because some tool selection shortcuts share the same keys as the POV movement. These shortcuts, which we will discuss together, are as follows: * W: positioning tool * E: rotation tool * R: scaling tool * T: universal tool It should be noted that accidentally activating these tools during a POV movement will not interfere with the editing of the object, unless you intervene with the mouse on the selected object. #### Playground In the following sections, we will explore the different gizmos in detail by spatially manipulating a cube taken directly from the Asset Pack A reference configuration will be used. The yellow cube will be the object of manipulation in all four modes. The remaining four coloured cubes will remain fixed in the scene as a spatial reference. The focus will always be on the yellow cube, positioned with coordinates x: 24; y: 0; z: -24.

The attached videos provide an overview of the tools that we will explore in more detail in the following sections: {% file src="/files/1dsWGa3v1UzKhmN8tDS4" %} {% file src="/files/5KZ2R10sIIsdDtAq0o7T" %} # Position The first spatial editing tool is the Position tool. To begin, you will need to select an object from the asset pack or one that already exists in the scene. Normally the Position tool will be the active tool by default, but if it is not, click on the first button that appears on the left to activate it

, or use the **W** key on your keyboard. **The gizmo will show six components: three axes and three intersecting planes.** The three axes are absolute, so if you move the POV they will move with it accordingly, always showing the true orientations and easily recognizable by the colors: * **Red**: x axis; * **Green**: y axis; * **Blue**: z axis; The same colors in the gizmo also apply to the squares representing the **planes perpendicular to the axes.** If you move the mouse pointer over one of them, the selected axis will change color to **yellow**. You can then simply left-click and drag in any direction or axis to move the object.

Movement along the **x** and **z** axes is affected by the **snap** on the grid, a kind of magnetic attraction that forces positioning to fixed values. The grid shows 1m intervals, but remember that the increment (or decrement) is 1/4 unit at a time, so each advance is 25cm. Movement along the **y**-axis, on the other hand, has no snap constraints, but is continuous, so it will always provide intermediate positions. When an object is selected, a block of information appears at the top of the workspace giving its spatial description in relation to the selected tool. In this case, the position returns the coordinates on the three axes as values. These coordinates are dynamically updated as we move the element, allowing us to monitor its current position. The same block carries a form. This is a second editing mode based on direct input of values. Knowing the exact distance and direction of movement, it is then possible to enter the target coordinates directly. To take advantage of this system, simply enter the coordinates in the appropriate fields and validate them using the green adjacency button. Unit or floating point values are allowed to three decimal places (note: precision to the cm, i.e. two decimal places are more than sufficient to search for adjacencies without interpenetrations). Values, if decimal, must be written in the fields using the **comma** character. It is not necessary to fill in all the fields, only those of interest. Fields left blank retain their value.

{% hint style="info" %} A typical use of this input mode is the repositioning of many duplicated elements by copy/paste, such as the distribution of objects that are repeated several times at regular intervals, or the need to reproduce the same layouts on different floors of a building. Once an object has been duplicated, it is sufficient to modify its **y**-value. {% endhint %} {% hint style="warning" %} Note: The values shown are rounded down to one decimal place. The following images illustrate a shifting of the object by 0.5m on **x**. This is done by hand, so there are two steps of 0.25m. The first will therefore approximate a value of 0.2, while the next will show the round figure of 0.5. {% endhint %}

{% hint style="warning" %} It should be noted that the actual displacement still occurs for the exact 1/4 unit increment, i.e. 0.25m. To demonstrate this, the same displacements can be replicated using the input form. {% endhint %} #### Example of a linear displacement movement In the example below, the yellow cube is positioned at coordinates \[**x: 24** **y: 0** **z: -24**]. We want to move it 1m to the right along the x axis and 1m up along the z axis. The y remains unchanged, so the cube remains on its own plane. Select the cube. The corresponding detail appears at the top. We then fill in the form by entering the correct values for the new **x** and **z** coordinates, i.e.: **25** and **-23**.

By validating the values with the green form button, the cube will move to the new position.

Confirm the operation by clicking on the Confirm button in the [**control panel.**](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools/control-panel#erase-confirm) The cube is now in its new position.

#### Movement along the intersection plane The squares shown at the intersection of the gizmo axes represent the imaginary plane relative to the two axes involved. Each square shows the color of the excluded axis, i.e. the coordinate that remains fixed. If we wanted to reproduce the previous example by moving the cube manually, we could intervene one axis at a time, dragging it to the correct coordinate until we reached the final position. But not involving the **y**-axis whose value remains fixed at **y: 0**, we could move the cube by acting directly on the green square. As with the axes, when the mouse pointer is over the **green square**, it turns yellow. By clicking on it, we will be able to drag it along the horizontal plane directly to the right position with a single mouse movement. Again, the movement is anchored to the grid, with the snap set to 1/4 units on an axis and the corresponding plane.

The same rule applies to planes that intersect the y-axis and therefore move in vertical planes, which is useful when we need to place decorations on walls, for example. The **red square** will therefore move the object in a vertical plane of a **fixed x**, and the **blue square** will do the same in the vertical plane of **z**. {% hint style="warning" %} The snap has priority over the float (fluid movement not locked to the grid). This means that for the movement along the two vertical planes, despite the fact that y is involved, which allows a smooth increment, the second axis will dominate by imposing the snap. We will therefore also have movement on the vertical plane always in 1/4 unit increments. {% endhint %} # Movement on the orthogonal plane This mode of position editing is particularly complex and rarely used, but it offers even greater control over movement. While the traditional mode uses the axes and therefore the real planes relative to the workspace as a reference, here we use mutable references, the inclusion of which leads to results that are not entirely predictable, since the primary reference is our POV. We spoke earlier of a Cartesian system in relation to the management of the POV. We can therefore say that, in this system, the three axes **x, y** and **z (locked)** correspond to the axes of **tilting**, **panning** and **rolling (locked)** already mentioned. This mode is activated by selecting the position instrument and pressing the **SHIFT** button and holding it down during operations As you can see from the images, only two axes are shown, describing a plane on the object that is orthogonal to our POV. In fact, movement is allowed along the **tilting** and **panning** axes and on the plane they describe. In fact, we have to imagine that the **rolling axis** is a straight line, perpendicular and anchored to us, and that this new Cartesian system always remains fixed relative to our POV and therefore variable with respect to space. In whatever direction we point the POV, these two axes and the square at their intersection remain fixed. And here is the complexity: the coordinates displayed in the control mirror always represent the real spatial coordinates of the object, but when we act on the arrow representing the **tilting axis (the orthogonal x-axis according to the POV)**, the object will move in a direction that is concordant with the axis and our POV, but **relative to space it will move instead on the real x and z**. Since rotation cannot be applied to the rolling axis, the movement applied to the tilting axis (a horizontal directional axis) will always be parallel to the real horizontal plane. {% hint style="info" %} **Note: in this mode the snap is active, but it moves per unit. Each step will therefore measure 1m.** {% endhint %} An example will better explain the concept: Let us empirically set up a POV by placing the space in a perspective as balanced as possible, with a rotation corresponding to about 45° on all axes. We will realize the success of this operation by observing the three intersecting planes of the axes: the union of the three squares, prospectively three rhombuses, will draw a regular hexagon. In this particular case, however, the greater precision sought is not so much in the angle with respect to the y axis, but in the balance between the real **x** and **z** axes.

By setting with the SHIFT key to orthogonal mode, the **tilting axis** is in a position that suggests an equal shifting in the real plane relative to the **x** and **z** coordinates, that is, a shifting of the object on a diagonal between the two axes.

We therefore apply a translation of the object on this relative axis by moving to the right. It has already been mentioned that the shifting is by unity, that is 1m from the starting point. We have therefore ideally moved the object 1m along the hypotenuse of a triangle described by an increment of **x** and an equal increment of **z**.

The Pythagorean theorem and a quick calculation will then tell us that the displacement on the real axes was incremental by a value of 0.7. The start coordinates \[**x: 24** **y: 0** **z: -24**] and the end coordinates \[**x: 24.7** **y: 0** **z: -23.3**] confirm the correctness of these calculations.

If this is true, what is expected from an action on the **panning axis (the y of the POV)**? Again, the answer can be complex, because if a *rotation on the panning* axis can affect the angular direction involving the real **x** and **z** through a translation on the tilting axis, a *rotation on the tilting* axis will also change the angle of incidence on the real plane: a translation on the panning axis (a vertical directional axis) will then affect all directions, affecting **x** and **z** of the object according to the direction indicated by the arrow, and **y** according to the tilting angle. The following is a practical example of a combined translation on the **tilting** and **panning** axes of a fixed POV.

The translation just illustrated was carried out quickly by moving the small square at the intersection of the axes: moving it to the right and upwards resulted in an incremental translation involving **x**, **y** and **z**. In fact, it can be seen that although the step is unity, the **y** reports a final value of 0.8, determined by the particular angle of the **tilting** axis. {% hint style="info" %} **But does the ****panning axis**** really force vertical translation?** Short answer: no. To say that rolling is not enabled is to say that it is fixed at a rotation angle of 0°. But tilting is possible over an angle of 360°. This means that a POV that is perfectly orthogonal to the plane, i.e. with a rotation on tilting for an angle of 90°, will cause the panning axis to be parallel to the plane itself. In this state, the tilting axis and the panning axis will both affect **x** and **z** depending on the direction. The translated object then retains its **y** value. In the following example, the movement of the yellow cube resting on the plane keeps the **y: 0** value constant. {% endhint %}

# Rotation The rotation tool can be accessed by selecting the object from the second pop-up button

or by pressing the **E** key on the keyboard. In this case, the arrows in the gizmo will be replaced by **three spherical circles highlighted in the colors corresponding to their rotation axes**.

From the image above, it is easy to see that the new gizmo is in a specific position, the one related to the pivot, in this case placed on the base of the cube we are using for this demonstration. What was previously a **y** axis of vertical movement now becomes a rotation axis, so the translation of each point of the object is no longer linear, but angular on the corresponding plane perpendicular to the axis itself. It is activated by selecting the circumference of our interest and moving the mouse by the amount of momentum required to achieve the desired rotation. As with the Position tool, mouse interaction will highlight the reference in yellow, and clicking will initiate the action. Again, the information block in the middle will show real-time references relative to the editing operations. In this case, the unit of measurement is the **decimal sexagesimal degree**, i.e. 360 degrees on the full rotation and a decimal fraction of a degree, so we will see non-unit values indicated by a comma. Similarly, we will be able to manually enter the values we are looking for with the form below, which is very useful when we need to accurately replicate the rotation of multiple objects. It is possible to enter positive or negative values. Positive values produce a clockwise rotation with respect to the normal of the rotation plane, negative values produce a counterclockwise rotation. {% hint style="info" %} Note: entering negative values will always display the positive counterpart in the information block. \ For example, if you manually enter a value of -15 with respect to an axis, it will be displayed as 345 after confirmation. {% endhint %} In the following example, the cube is rotated 45° on the **y** axis.

The pivot is placed at the center of the vertical axis of the cube, but at the base of the cube. The resulting rotation does not significantly change its position or size of the element in the space. However, we cannot expect the selected element to remain in the same position as it rotates, because the angular movement is determined by the radius, and thus the distance between the object and its pivot. This means that a pivot placed exactly in the center will cause the object to rotate about itself, but a pivot that is unbalanced or outside the object will cause nonlinear motion along a circumferential arc. Let us return the cube to its original position and see what happens when we apply a rotation on the **z**-axis instead. We will test two values, rotating it 45° and 90°.

If the pivot point is located at the bottom, i.e. off-center with respect to its height, a rotation along the **z**-axis produces a rotation with a fulcrum on the pivot itself, which causes the object to lie sideways and also to change its position in space. {% hint style="warning" %} The change in position is only perceptual. The object has not actually been moved, because its coordinates always refer to the position of the pivot. By asking the builder about the position of the yellow cube, its value actually remains unchanged.\ ![](https://1025404586-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvALqBsUIqL1aZ2BmaieV%2Fuploads%2F2K35AiCCXwMklJhqJsce%2Fimage.png?alt=media\&token=e009410e-a805-406f-ba3c-0bde60f3485f) {% endhint %} {% hint style="info" %} The movement along the circumference is smooth, with no snap constraints, because the input form can always be used to set specific values. However, there is a mode that allows rotation in predefined steps of 15°, a geometrically very common value because of its regular multiples (related to angle measurements). To activate the **15° snap**, simply hold down the **SHIFT** key while rotating with the mouse. {% endhint %} # Scaling The scaling tool allows you to scale objects according to the principles of enlargement or reduction. Selezionando l'oggetto, è possibile attivare questo strumento attraverso il terzo pulsante dall'alto

o tramite il tasto **R** della tastiera.By selecting the object, you can activate this tool by pressing the third button from the top or the R key on the keyboard.

You will immediately notice the disappearance of the gizmo, which will give way to a **small cube placed at the pivot**. Like the other instruments, its position will be critical in determining the source of accretion or reduction. In other words, if the pivot is at the center of gravity of the object, it will either grow or shrink around it, but if it is outside, or unbalanced, so will the relative scaled distances. The object of our demonstration, the yellow cube, has the pivot placed at the center of the face that serves as the base. This particular configuration comes in handy; in fact, as we place the cube on our work surface, it will grow or shrink while always keeping the base adjacent to the surface, giving us the ability to measure even visually the outcome of the scaling we are going to apply. Once the tool is activated, all you have to do is move the mouse over the small cube that acts as a gizmo. As you can see, it is neutral gray and does not have the colors previously assigned to the axes, since this scaling will involve the three dimensions together. By interacting with it with the mouse pointer, it will turn yellow. By clicking and dragging, we will be able to scale the object at will. The information panel at the top dynamically reports the scaling as usual, while the small input form, this time only one, allows us to enter custom values. {% hint style="info" %} **The mathematics of Scaling** Scaling an object means being able to increase or decrease its size by multiplying the individual dimensions of the object. **The number associated with scaling is a coefficient**, which is a dimensionless value, a multiplier, with no unit of measurement. **The default initial coefficient is 1.** This reference, the coefficient that we use to perform the dimensioning edit, does not involve volumetric values, but linear ones, i.e. if we set a scaling coefficient to 2, it would mean that we would not be doubling the object itself (and thus its volume), but the individual dimensions that make it up, by the values of **x**, **y** and **z**. **The increment or decrement we measure is also in steps of 1/4 relative to the initial coefficient**, and will remain so each time we continue scaling without leaving the mouse click. In the case of an incremental motion, we will not encounter any limitations in scaling with the mouse, so it will be possible to easily go from coefficient 1 to larger values, proceeding by steps in a single movement. In the case of a reducing motion, however, we will encounter a first mathematical limitation: **the coefficient cannot be 0**.\ Assuming a reduction starting from the default coefficient, we will in fact encounter this progression: **1 ->** **0,75**** -> ****0,5**** -> ****0,25**** -> ****0** Therefore, **the limit of decremental steps is set to three at a time**. The fourth step will then bring the coefficient back to the unit value. To obtain further reductions, it will be necessary to leave the click at an intermediate coefficient of the three allowed steps (also depending on our reduction goals) and click again to further reduce. So, working in increments and knowing that they correspond to 1/4, if we wanted to double the size of the object (scale: 2), starting from the default state (scale: 1), we would have to click on the cubic gizmo and drag the mouse to the desired value. If the increment is 1/4, it will take 4 increments, or 4 steps, to reach our goal. \ We will then see the value of the coefficient progress in this way: \ **1 ->** (step 1) **1,25** -> (step 2) **1,5** -> (step 3) **1,75** -> (step 4) **2** #### Formula to determine the final coefficient The following formula, where "**ci**" is the initial coefficient and "**s**" is the number of steps, will give us the final value of the scaling coefficient "**cf**": $$cF= cI ( 1 ± s/4)$$ In applying the formula, we will use addition to increase the scaling and subtraction to decrease it. {% endhint %} After what has been said, let us see the doubling of our reference cube. We will do this by selecting it and entering the value directly in the input form.

As already mentioned, the resulting cube will not be twice as large as the original (volumetrically it is 8 times as large), but its linear dimensions will be. In fact, we can easily verify through the grid that the initial dimension of each side is 2m, while in its final form it is 4m, twice as large. If we want to do the opposite, that is, to halve the size of the cube, we will set a coefficient of 0.5, directly in the input.

Again, the size of the cube at the volumetric level does not correspond to half (it is actually 1/4 of the original volume), but its dimensions are correctly as expected: those of a cube of 1m on each side. #### Limits If we did not take into account the size of the space in which we were operating, we would have a virtually infinitely large space, but not an infinitely small one. In both cases, it will be the initial size of an object that will determine the yield of a very large enlargement or extreme reduction. If we want to enlarge an object, it will be necessary to evaluate the effectiveness of a magnification according to one's aesthetic canons and in the overall view. The scalability of a three-dimensional object is in fact unlimited, given its **vector** geometric nature, but the possible presence of a decorative texture inside it, whether integrated in the object itself or the result of a customization (if any), will highlight the **raster** artifacts resulting from possible compressions and interpolations of the JPG or PNG images used. Considering instead the assumption of a reduction, **the scale is limited to a final coefficient of 0,01**. This is where the initial size, i.e. its default size when the object is inserted into the environment, really matters. A cube with a native size of one meter on each side can be scaled down to one centimeter, while a 40m long building can be scaled down to a maximum of 40 cm. {% hint style="warning" %} **Resetting the initial coefficient.** Why is it important not to leave the mouse click? Because even if we have not confirmed the scaling with the button in the control panel

, by changing its value we have set a new initial coefficient. If we then click the gizmo again, the 1/4 increase or decrease will not refer to the default value, but to the newly set value. Continuing with the previous example, let us assume that we have increased the coefficient to 1.75, and that we have intentionally or unintentionally released the mouse click.\ The new initial value will be 1,75. Obviously, if we wanted to double it, we should be able to get a coefficient of 3,5.\ *Applying the formula mentioned above*, here is what we would get if we proceeded in this direction: 1,75 -> 2,19 -> 2,62 -> 3,06 -> 3,5 The new progression does not pick up where it left off, but starts over, resetting the initial coefficient. {% endhint %} {% hint style="warning" %} **There is a trick to enlarge objects by increasing the coefficient by one unit at a time, without going through the 1/4 steps.** To achieve this effect, which is not essential but sometimes useful, simply reduce the object till the 4th step, which will bring the coefficient back to 1, and then extend the movement without releasing the mouse click. We will get the following sequence: **1 -> ****0,75**** -> ****0,5**** -> ****0,25**** -> 1 -> ****2**** -> ****3**** -> ****4**** -> ****5**** -> ****etc.** {% endhint %} # Universal tool The last edit tool is a universal tool that combines the previous three into a single multifunctional gizmo. After selecting the object, it can be activated with the fourth button on the toolbar

or with the **T** key on the keyboard. It is the most versatile of them all and is the one that is generally used to finalize certain details, such as making micro-adjustments to position, rotation and scale.

This potential stems from the fact that the tools proposed within it are 100% fluid, without any *snap* constraints, allowing complex constructions that can be both totally empirical, without any mathematical relief regarding positions, rotations and scales, and totally regular, following strict geometries and millesimal adjustments. How these two souls coexist is determined by the individual design intentions, since the tool does not carry an information panel or the possibility of entering specific values. {% hint style="danger" %} This versatility is a strength, but it should lead the user to handle the tool with care, since we do not have real time numerical control, but only optical/perceptual. As a result, we have to confirm the object if we want to recognize its values in order to reproduce or correct its position by individually selecting the position, rotation and scaling tools. {% endhint %} Its extreme freedom of use thus makes it an absolute tool when used alone, but its greatest expression occurs when, in the case of a geometrically reasoned design, the finishing touches are applied to a portion of the layout. We will better understand the value of this statement in the next section of [copy/paste](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools/gizmo-and-assets-manipulation/copy-paste). As with individual tools, to activate the action, the mouse pointer must intercept the desired element of the gizmo by changing its color to yellow; it is then possible to click and drag to complete the action. Let's look at an example of editing through our reference system. The selected yellow cube will undergo some transformations, the end result will be that it will be rotated on all axes and translated upwards.

#### Shifting in the orthogonal plane Again, there is an option to activate a translation mode in the orthogonal plane relative to the universal tool. It is activated by pressing the **SHIFT** key and interacting with the **x**, **y** and **z** translation axes. Obviously, it follows the same rules as the [analogous tool](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools/gizmo-and-assets-manipulation/position/movement-on-the-orthogonal-plane) in standard mode, but it inherits the fluidity of the transformation of its parent in the movements on the axes and in the plane.

# Copy/Paste There is a copy/paste function linked to objects in the scene that allows us to integrate a large number of the same elements without having to take them out of the [asset pack](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools/asset-packs) each time, preserving the editing values of the copied object. Obviously, the preservation of edits involves an overlap of the pasted object with its original, but it will be in an unconfirmed state, i.e. with an active tool that can then allow any rotation, movement or scaling according to our needs. A typical example is that of an audience of chairs facing a stage, i.e. a positioning with possible rotation repeated **n** times in different points of the space, usually spaced with some regularity. This tool has no counterpart on the HUD, only keyboard shortcuts, and since we are dealing with copy/paste there, the shortcuts are, as usual, **ctrl+C** and **ctrl+V** (**cmd+C**/**cmd+V** on Mac systems). All you have to do is select the object you want, copy it, paste it and position it where you want. {% hint style="danger" %} Copy/Paste commands are contextual. This means they must be performed in the correct location according to the reference. To copy an object, you must select it and not move the mouse focus elsewhere, such as to a different tab or application, where a "paste" command might produce different results. In fact, if the mouse were somewhere else in the browser and the URL bar were selected, the "paste" command would give no result or might paste additional text strings previously entered into memory. {% endhint %} To give a demonstration of the copy/paste tool, we will use a variation of the playground by eliminating some of the objects in the environment, leaving only the yellow cube as a spatial reference in the center of the scene. We select them one by one and delete them with the Erase button

Instead of the removed cubes, the result we want to achieve is in the following example: we will place a single red cube and assign a rotation to it. We will then distribute the others by copying the first one.

Select a red cube from the asset pack and place it in the desired location.

Keeping the selection active on the cube, we adjust the position if necessary, then select the rotate tool and set it to 45° on the **y** axis. This is the result:

It is not really necessary to confirm the object once it is correctly positioned: if we are sure of the settings, it will be enough to copy it (ctrl+C/cmd+C) when it is selected, taking care to keep the mouse selection in the workspace and not on the outer parts of the HUD (asset pack or any customization panels).

Pasting the newly copied object (Ctrl+V/cmd+V) will place it in perfect overlap.

We can see that not only the selected object itself is clearly preserved, but also its position, rotation and the last selected tool. So we move the object to the desired coordinates. We can do this by acting on the axes or by direct input.

Before confirming, we can now consider two options: * repeat the copy/paste operation again, replicating the new object in the active selection * repeat only the paste operation, which will then refer to the previously copied object. In this case, we will proceed with the first hypothesis, keeping the active selection on the new object, and repeat the command pair.

The object of the active selection is then copied and pasted to itself. We then move it to the desired position and confirm the operation.

Of the previous hypotheses, we now take advantage of the second one: one object is already in the copy buffer, the middle one, so without selecting anything, we simply replicate the paste command.

The new cube will, as expected, take the same position as the previously copied object and we will move it to the desired position. {% hint style="info" %} This solution, especially when we are dealing with a progression in a series of objects (such as a row of chairs), may not be the ideal choice, since it would force us to make sequential movements that are from time to time greater than the initial position. On the other hand, it comes in handy when we want to paste and move elements around a starting one, since having a definite central reference also facilitates the calculation of shiftings and the amount of motion we have to apply. {% endhint %}

# Asset packs We have demonstrated [how the tools work](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools/gizmo-and-assets-manipulation) using a very simple reference system. But if the environments we build are to be primarily representative of reality, then the objects that form the builder's raw material must themselves be representative of the real world, regardless of any styles that will determine their aesthetic impact. For immediate enjoyment, all objects have been grouped into high-level categories. Thus, we will find in a single category "Nature" all the natural elements, whether plants, trees, flowers, animals or rocks, just as the category "Furniture" will make available any type of furniture, regardless of its function.

In describing the Asset Pack, we will not dwell on the analysis of each classification, but if we look at this column, which corresponds to the initial state of the Asset Pack, we will notice that, in addition to the basic categorized objects, a series of elements have been integrated that we will manage at the same level as the others with the tools provided by the Builder, but that suggest an additional method of categorization that is strictly functional. This will be the categorization on which we will base our analysis, let us look at it in detail: * [**Ground**](#ground) -> these are not objects, but scene modifiers. They change the basic nature of the environment. * [**Static and interacting elements**](#elementi-statici-e-interagibili) -> grouped in the categories **Tiles, Nature, Furniture, Structures, Buildings, Decorations** are the real objects that will make up the architecture of our environment. * [**Contents**](#contents) -> intangible functional elements that enable the activation of a specific service at a specific time. * [**NPCs**](#npcs) -> Non-Player Character (or Non-Playable Character) are meta-human elements that can be programmed to support conversational events. * [**Custom asset pack**](#custom-asset-pack) -> collection of custom objects that the user integrates into the Builder using the button

in the upper right corner #### Ground At first, the scene presents a regular grass surface. But this is not the only aspect we can give to our environment. In fact, we can change its aesthetics by changing the nature of the individual lands that make it up into other natural or urban variations, such as a sandy or paved or even aquatic ground. To do this, simply click on the selected item and drag it to the desired location.

Whenever the placement is considered valid, the selector switch turns green.

All modifiers behave the same way except water. This allows you to build underwater structures to create special experiences, or above ground structures on platforms, and of course you can walk on them in the game phase by swimming and diving. #### Static and interactive elements Most of the objects we find within the categories have a primarily architectural function. In fact, they are the components that, when put together, contribute to the creation of a layout that includes both exterior and interior spaces, thus guiding the visitor-user along a path of exploration designed according to our purposes. **Static elements** are recognizable by the white background in the thumbnail, and their function is purely aesthetic and environmental, as their presence will return a material impact to the experience. In fact, all objects are material and, depending on their size, obstacles. **Interactive elements** can be recognized by the presence of a *light blue background* in the thumbnails and a small *lightning* icon. Once placed in the environment and in active selection, they will propose in the HUD a series of adjustments according to the selected object. These interactions could be aesthetic (lights), functional (doors), informational, etc. We will analyze the different types of interactive elements later. Clicking on the button for each category will bring up the items belonging to that category. In the following example, we have clicked on the "Structures" button. The presence of static and interactive elements is immediately apparent.

All you need to do is click on an object to select it, and drag it into the environment. The selector will show two components: an arrow and a circle. The **arrow** indicates where the object will be placed. The **circle** will indicate the support surface. In fact, we need to consider that we might want to place an object not only on the ground of the scene, but also on another surface, such as an elevated platform, the floor of a building, a desk, and so on. When both indicators, the arrow and the circle, turn green, you can click again to place the selected object.

In the example below, a fountain has been selected and placed on a point. The object selection remains active so that we can edit its position, rotation and scale if necessary.

Once the position is confirmed, the object is stabilized and automatically saved in the environment. #### Contents These objects are immaterial. There is evidence of their presence or function in the environment, but they cannot be considered architectural elements, only functional ones. Because they have special functions, which we will explain later, they are represented with a blue background thumbnail and can be manipulated in space like any other object.

#### NPCs NPCs are avatars that can be placed anywhere in the environment to provide the user with a complete and interactive experience despite the possible absence of other players in the game environment.

Like inanimate objects, they can be manipulated in space, and their interactive component is **dialog**. With proper planning, this capability can extend the experience by guiding the user to obtain information or activate any **quest**. #### Custom asset pack The Builder can be considered as a platform that allows the manipulation of 3D objects designed according to some specific canons and taken from a library (asset pack). The library is in fact a container, and the objects within it have been tested and validated to work best in the environment. Nevertheless, the integration and classification of objects from external sources or from an independent design is allowed, as long as they meet certain criteria. We will discuss these criteria [later](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools/asset-packs/uploading-custom-objects). # Interactive elements Interactive objects have a purely aesthetic function as long as their internal components are not activated/customized. The possibilities are many and, as mentioned above, such components can act as environmental modifiers, external redirects, or activators. Most interactive elements allow customization of the interaction reference (**when click text**), as linguistic or contextual customization. When we integrate and select an interacting object in the scene, it will show a specific view for customization in the right column of the builder.

We can identify primitive components that we will activate by entering text, URLs, or by manipulating switches and sliders. These components, combined within a specific object, determine the peculiarities. The following diagrams provide an overview of all the interacting categories and their functions in relation to the associated primitives. {% embed url="" %} {% embed url="" %} Once the interactive object has been customized, simply confirm it like any other object to keep the changes. Some objects can be customized by adding [graphical components](/coderblock-studio/builder-tool-advanced-guide/working-environment/design-tools/asset-packs/graphic-components). Instructions for creating such components and related actions are discussed in the next section. # Graphic components Some objects can be graphically customized. The different nature and shape of these objects requires a precise creation of the graphic or photographic elements we want to integrate, since certain design specifications must be met in order to avoid possible deformations. There are just three basic rules: * All graphic components must be inscribed in a **square format**. * The dimensions of the square must always be to the **power of 2**. The recommended formats in pixels are **512x512** and **1024x1024**. * The file should be in **JPG** format (recommended), or **PNG** (if you want it to be transparent). {% embed url="" %} {% hint style="info" %} Regardless of the software used for production (Photoshop, Illustrator, Gimp, Canva, etc.), it is recommended to create the graphic based on the dimensions shown in the diagram, and later stretch the canvas to the square format, adding vertical or horizontal space depending on the object created, without stretching the final image. {% endhint %} {% hint style="info" %} Objects such as "Logo Plane" or "Sticker" do not have a solid component as a frame and are primarily created to maintain transparency where needed. The use of PNG files is recommended in such cases. {% endhint %} # Uploading custom objects The Builder gives you the ability to add custom objects to our scene. If you have **low-poly 3D objects** created by yourself or a third party, you can integrate them into our scene. The only format accepted is **GLB**, and proper weight must be given at the design stage to any textures it will carry. In fact, more than the complexity of the object (which is important for the purposes of the number of objects allowed in the room), textures will affect loading times. For example, considering the need to integrate very small objects, it will be appropriate to lighten the textures very much if they propose a level of detail that can be considered unnecessary. To add custom assets, simply click the small **+** icon in the top right corner of the Asset Pack

and upload the file. Give it a name and category and it will be easy to find using the search form

or in the **Custom Asset Pack** category at the bottom.

{% hint style="warning" %} Custom objects do not have their own thumbnails, but have a unique icon to identify them

. If it is necessary to repeat the upload several times to make corrections, it is good practice to include a version number in the filename (e.g. \_v01, \_v02, \_v03, etc.). {% endhint %} # Scene monitoring As with any construction process, an abundance of raw materials must be provided. The Asset Pack might suggest that this is unlimited, since there is no number for individual objects to indicate a reserve. But a limit must be set, of course, by the ability of an environment to be used on multiple devices. In the lower left corner of the HUD is a small button with an image of a cube

. When you click on it, a small information box opens with some numerical details about the number of objects in the scene, the number of materials, vertices and triangles.

Depending on the complexity of the inserted objects, the **Poly-Counts** panel will report the exact number of triangles in the scene. Each scene has a number of triangles available depending on the number of lands it contains. Each land can hold **45000 triangles**, and the total is cumulative for the scene itself. If the number of triangles entered exceeds the allowed limit, an "*Out of poly-count*" warning will inform you of the need to delete something. {% hint style="warning" %} The Asset Pack is optimized to allow for extensive integration of objects into the scene. It is very difficult to saturate this value, but not impossible! It is good to check this report from time to time, watch out for custom objects! {% endhint %} # BUSINESS Coderblock Studio is the all-in-one platform for exploring the metaverse in an easy and intuitive way. Get ready to revolutionise your business with artificial intelligence and virtual experiences! # Start **Coderblock Studio** is the **all-in-one platform** that can **revolutionize your business** by creating virtual experiences with just a few clicks and without the need for significant resources. Experiment with and harness the potential of virtual environments, create immersive experiences and discover the power of **Generative AI applied to virtual experiences** to improve internal processes and gain a competitive edge. {% embed url="" %}


	I piani nel dettaglio		Plans in detail
	Scene virtuali, Lands e digital twin		Spaces, Lands e Digital twin
	Ingresso in Coderblock Studio		Getting started with Coderblock
	Gestione scene virtuali		Virtual scene management

# Plans in detail Two different subscription plans and a bespoke package offer every company the opportunity to explore the virtual world at a flat annual cost. Here are the plan details: For more details on the subscription plans available, please visit the [following page](https://www.coderblock.com/pricing/).


	Plus		Plus
	Premium		Premium
	Tailor-made		Custom

# Plus The Plus plan allows you to **start exploring the potential of virtual environments** with a basic package. With full access to the Builder, you can create your own branded experiences from scratch or using one of the 15 additional templates included in the plan. In addition, the Plus plan includes **access to Coderblock Hub**, Coderblock's showcase designed to give visibility to your virtual worlds.

# Premium The Premium plan includes **all the features of the basic package**, with a larger number of catalog templates to use for building customized experiences. Additionally, it provides your business with **tailored strategic consulting** for potential projects in the metaverse. Our team, with years of accumulated expertise, will guide you towards the most suitable design for your business needs, offering you dedicated support. Among the additional benefits of the Premium plan is the **integration of AI tools and Digital Humans** into your virtual scenes, taking your experiences to the next level.

# Custom The **Custom** plan is a truly **tailored solution**, designed in collaboration with our team to meet your brand's specific needs. You will receive **strategic and project consulting**, as well as Enterprise-level technical support. Your virtual project will be crafted with meticulous attention to detail, such as a bespoke digital twin, with 3D modeling of custom scenarios and personalized quests. This plan also offers a higher number of simultaneous users connected to your scene, as well as the integration of advanced Artificial Intelligence features.

# Spaces, Lands e Digital twin Discover the differences between Spaces, Lands and Digital Twin!


	Scenes		Spaces
	Land		Land
	Digital Twin		Digital Twin

# Spaces **Spaces** are **3D environments** featuring scenarios, buildings, NPCs, quests, and customized experiences. Unlike lands, these scenes are not located within a shared map but are **separate worlds that can be shared and accessed directly via URL**. They are ideal for hosting events, activities, and initiatives tailored to a specific target audience or for creating exclusive environments accessible to a limited group of users.

# Land **Lands** are **virtual plots registered on the blockchain**, with **ownership rights guaranteed by smart contracts**. These parcels are located at specific coordinates within a virtual map called the Open World. This environment is accessible and explorable by all users of the platform: owning land in this shared space offers various opportunities in terms of visibility and awareness.

This environment is **accessible and explorable** **by all users of the platform**: owning land in this **shared space** therefore offers several **opportunities in terms of visibility and awareness**. Each virtual plot **can be visited by a potentially unlimited number of people** who can experience the activities and events planned. Furthermore, as digital property, plots have an intrinsic value that can increase over time, making them tradable assets that can be rented or sold to other users. {% embed url="" %} # Digital Twin **Digital twins** are **virtual representations of real environments, structures and initiatives**: a **true digital copy in the virtual world**. From headquarters to event pavilions, from hospital facilities to cinemas, every business reality can have its digital twin, a virtual replica of an existing physical entity used to simulate, analyse and optimise various business operations. This advanced technology allows the creation of a detailed digital model capable of optimizing processes, anticipating problems and innovating with greater agility to remain competitive in an increasingly dynamic market, providing real-time insights into performance and operating conditions. **It provides a truly immersive physical-digital experience** that enables activities such as simulation and testing, research and development, process optimization and efficiency improvement.

Digital Twin - **Flagship Station di Q8 a Paderno Dugnano** (MI).

# Getting started with Coderblock Once you have subscribed to the plan that best suits your needs, you can begin **experimenting** by logging into the platform. To access Coderblock Studio, you need to log in [here](https://coderblock.com/login) with your credentials (or create an account if you haven't registered on Coderblock yet). # Login/Sign up * [Login](https://coderblock.com/login) by entering your account details. (Forgot your password? Reset it [here](https://coderblock.com/password/reset).) * [Sign up](https://coderblock.com/it/signup): If you don't have an account yet, simply follow the instructions and fill in all the required fields to register on the platform. * Once you are logged in, you can start customizing your avatar directly from Coderblock Studio:

Want to know how? Read [here](/coderblock-world/user-experiences/photorealistic-avatar-coderblock-studio-x-ready-player-me). # Virtual scene management **Coderblock Studio** allows you to **manage your 360-degree virtual scenes** through a simple and intuitive web interface. Whether you want to **increase brand awareness, boost lead generation, organize events or offer your customers a more immersive shopping experience**, your spaces in the metaverse provide a new touchpoint with your audience. Based on your **business goals**, you can direct your team to create experiences with different styles and purposes, starting from scratch or using available catalogue templates. Alternatively, you can choose from a range of scenes created by our virtual creators and select those that best meet your objectives. You can also create personalised adventures in the form of quests, engage your users with non-player characters (NPCs), broadcast live events on large screens, and (soon) add new team members to manage the environment and moderate experiences, ensuring a safe environment by excluding inappropriate users. Find out more [here](/coderblock-studio/virtual-environment-management). # Create Creating a virtual experience for your business in Coderblock Studio allows you to **explore** the metaverse at an **affordable cost**. Using the Builder tool, you can create and share 3D experiences and entire worlds in just a few steps, without any technical expertise, to support your business objectives: from increasing brand awareness and lead generation to boosting direct sales. All of this is enhanced by the application of **Artificial Intelligence** tools to metaverse functionalities, marking another step towards business innovation.


	Builder Tool		Builder Tool
	Virtual experiences		Virtual experiences
	Case studies		Workspaces inside the virtual world and case studies

# Builder Tool The **Builder Tool** is the heart of Coderblock Studio: an online builder tool designed to be easy and intuitive to use for users at different levels of digitization. {% embed url="" %} Within the tool, **you can start from a blank scene or use the extensive selection of 3D models in the library** (over 1,000 virtual objects). Alternatively, you can start with a pre-built template that we've provided to further streamline the creation process. However, the **customization** options are extensive. You can make your branded virtual experiences even more unique and exclusive by uploading external 3D models in .glb format.

Consult the dedicated [guide](/coderblock-studio/builder-tool) to get direct help on all the features available in the Builder and get the most out of your Coderblock Studio experience. **Prefer a turnkey virtual experience**? Explore the **Custom Plan** and request a consultation with our team to tailor the project to your goals. # Virtual experiences The **virtual experiences** in the metaverse can be potentially endless, each to be designed according to the type of business and the goals to be achieved. Here are a few examples. You can also view them all [here](https://www.coderblock.com/en/virtual-experiences/). # Offices A new way of **collaborating and networking** in the metaverse. Your virtual headquarters becomes a meeting place for team building, connecting geographically dispersed offices and meeting new customers and talent from all walks of life.

# Events Create new **networking and lead generation** opportunities in the metaverse through **virtual events and tradeshows**: it's possible to engage a broader audience, overcome geographical and logistical limitations, and create a more immersive experience for event attendees.

# HR and Recruitment The Metaverse is an innovative space where you can **streamline your company's HR processes**: from profiling candidates and recruiting new talent, to onboarding new employees and organizing team-building activities to increase employee engagement.

# Training **Train in a new way**: create an immersive world tailored to your online courses and offer your students and trainees gamification experiences designed to make learning more engaging.

# E-commerce Increase your online sales: by creating your **virtual store**, you can offer a less impersonal and increasingly immersive shopping experience to users of your e-commerce platform. Virtual shops, product showcases, virtual shopping assistants, and live customer care are **just a few of the services** you will have access to, guiding your users through a **revolutionary shopping experience journey**.

# Workspaces inside the virtual world and case studies Over the years, several companies have chosen Coderblock to increase their business opportunities. Below are some case studies from different industries that illustrate the potential of the Metaverse (discover them all [here](https://www.coderblock.com/en/clients/)). # Flagship Station by Q8 A forward-looking digital twin. **Q8** is one of the leading players in the fuel distribution scene in Italy. The project created is a **digital twin that captures the essence and modernity of Q8's flagship station in Paderno Dugnano** (MI). In its virtual version, the project tells a compelling story: the harmonious meeting of innovation and functionality, where every detail is designed to improve the user's life. It invites you to explore a world where fueling becomes an interactive and immersive journey, reflecting Q8's vision of a greener and more technologically integrated future. This state-of-the-art service center is designed to meet every mobility need, seamlessly combining advanced technology, cutting-edge design and sustainability principles.

# LE VILLAGE by Crédit Agricole Triveneto A digital twin for startups and corporates. A perfect example of a **digital twin**: **a 3D hub that faithfully reproduces the environments of the Padua office**. This space offers co-working areas for startups, meeting rooms and branded spaces for companies, with the aim of improving networking opportunities and increasing audience engagement. \ An immersive experience that allowed users to customize their avatar, explore the citadel, use the chat to communicate, interact with corners dedicated to the startups, and go to the main space, La Place, where they could watch events and live streams on the big screen.

# SAVE THE CHILDREN - #bambinisottoattacco A virtual awareness campaign inside the metaverse. For Save the Children, we launched **a virtual space dedicated to the #childrenunderattack campaign**, an initiative aimed at raising awareness of the enormous difficulties millions of children face as a result of war. A virtual journey linked to gamification activities within the virtual environment, an exhibition of NFT artwork donated by artists was planned and linked to Web3 marketplaces. Proceeds from sales were donated to charity to support children affected by the war in Ukraine. By entering the virtual world, Save the Children Italy was able to **expand its financial support and integrate innovative communication channels to spread its messages to a wider and more diverse audience**. The Metaverse also became a **space for activism**, where every visitor could sign a petition to the Italian government to prosecute war crimes against children.

# SACE JOB FAIR by Sace Group Career day in the metaverse. A perfect example of the **Career Day** in the Metaverse, dedicated to exploring opportunities in HR through virtual innovation, organized by SACE. The event offered students, graduates and young professionals the opportunity to **discover career opportunities in the SACE Group** and be part of the ongoing transformation. The initiative offered a virtual exhibition environment and a gaming phase to actively engage participants, allowing them to understand SACE's mission through a unique online experience. Cognitive talks, networking sessions, gamification elements and thematic quiz challenges about SACE: the event harnessed the potential of the metaverse to overcome geographical limitations and offer full immersion in the virtual world.

# Sharing **Coderblock Studio** gives you the opportunity to **share your creations** and showcase your best scenes to the rest of the community. Coderblock Studio gives you the ability to organise as many events as you like, expanding the reach of your experiences. You can choose to share your scenes with your target audience by simply sending them a URL, or post them on **Coderblock Hub**, the public showcase that increases the visibility of your scenes and your brand.


	Pubblicare una scena		How to: publish a scene
	Condividere una scena		How to: sharing a scene - COMING SOON
	Pagina profilo Creator - COMING SOON		Creator profile page - COMING SOON
	Coderblock Hub		Coderblock Hub - COMING SOON

# How to: publish a scene Once you have created your virtual experience, you can publish it to make it visible and accessible to other users. Once you have finished configuring your scene, you can publish it by simply clicking ***Publish*** in the top right hand menu within the Builder. Once published, click ***Jump to your virtual world*** to visit it yourself, and share the URL at the top with your contacts to invite others to explore!

# How to: sharing a scene - COMING SOON Coderblock Hub is the showcase where you can share your virtual experiences or buy your favourites from our community of creators. Sharing a scene on Coderblock Hub is easy: * Use the ***Experiences*** section to showcase your experience and increase its visibility. Coderblock users can visit and interact with the content inside. * Use the ***Marketplace*** section (link to documentation) to buy your favourite scenes created by our virtual Creators. # Creator profile page - COMING SOON Soon you will have access to a **dedicated page profile** page where you can tell the story of your brand and showcase your brand experiences. It will be a real showcase to gather all the virtual initiatives related to your company and attract more users. # Coderblock Hub - COMING SOON **Coderblock Hub** is a public space where you can showcase your creations. Not only will you be able to showcase your virtual scenes to the world, but you'll also have the opportunity to increase **awareness** and **lead generation**.

# Marketplace **Coderblock Hub - Marketplace** is where you can buy any creation you want. Coderblock Hub is the ideal showcase for our virtual creators to showcase and sell their best virtual experiences. # Experiences **Coderblock Hub - Experiences** allows you to share your scenes. This means you can use them in countless ways: create quests, use scenes for events, or recreate your virtual office. Each virtual experience is designed to be shared, providing a space for communication, connection and interaction with other users. Your scene is easily accessible: you can share it via a URL. # Business opportunities Key objectives for doing business with Coderblock Studio include increasing brand awareness, enhancing reputation and fostering customer loyalty through custom virtual experiences, events and webinars. The platform facilitates lead generation through immersive events and live streaming webinars, increasing interaction and engagement. It also provides the opportunity to create a unique and personalised shopping experience to differentiate from the competition and increase sales. By creating engaging and realistic virtual environments for recruiting and networking, it optimises business processes and increases business opportunities. # Goals When creating your own virtual experiences, what are the main goals you want to achieve? # Awareness Increasing **brand awareness**, improving **reputation and fostering customer loyalty**: our personalised solutions are designed to be highly efficient and measurable, ensuring that every resource deployed contributes significantly to your business success. Coderblock Studio gives you all the tools you need to create awareness-focused experiences: events, webinars, meetings and branded quests. We also offer the ability to create customised 3D scenes, allowing you to create unique and highly engaging virtual environments.

# Lead generation Hosting events, creating live streaming webinars and increasing user engagement through gamification: **generating leads in the metaverse** has never been easier. With Coderblock Studio, you can deliver immersive experiences that foster a deeper and more meaningful connection with your brand. Manage experiences and events easily and effectively with high levels of participation and interaction.

# Sales In an ever-evolving digital landscape, delivering a unique and personalized shopping experience is critical to differentiating your business and building customer loyalty. Our innovative approach to **e-commerce** combines advanced technology and customization to create a virtual store that not only attracts customers, but also engages them in a memorable way. By increasing conversion rates and customer satisfaction, our approach leads to sustainable and significant revenue growth.

# Networking Building a strong and diverse network is essential to creating **new business opportunities** and **achieving your goals**. Create new initiatives to connect with people who share similar interests, interact with industry leaders and stay on top of the latest trends - all in the virtual world.

# Workflows optimization The recruitment process determines the quality and effectiveness of the work team. By creating **Virtual Recruitment Experiences**, you can use immersive environments, realistic scenarios and gamification activities to deliver innovative recruitment activities to your candidates. In Coderblock, you can create an immersive environment where candidates find themselves in realistic scenarios that replicate the day-to-day challenges they may face in their role. This allows them to demonstrate their skills, technical competencies, problem solving abilities and adaptability, providing a comprehensive view of their potential. By identifying the strengths and weaknesses of each candidate, you can build a solid and competent team capable of meeting the challenges of the marketplace.

# Analytics Dashboard - COMING SOON The **Analytics Dashboard**, available to every user, is the perfect place to monitor and analyse results to improve your company's user experience. Inside you will find Key Performance Indicators (KPIs) that are critical to analyzing user actions within your scene.

# CREATORS Join **Coderblock Studio** and become a **virtual creator**: in just a few steps you can build unique 3D experiences and worlds, share them with the community, and unleash your creativity while earning rewards!

# Start Become a **virtual Creator**: In just a few steps, you can build unique worlds, share them with your community and earn rewards for unleashing your creativity. No technical skills required, **just your imagination**!


	Plans in detail
	Scene virtuali and Lands
	Login/Sign up in Coderblock Studio
	Virtual scene management

# Plans in detail We have a plan for **every need and opportunity**. In Coderblock Studio, as a Creator, you can choose which of these three subscriptions you would like to subscribe to.


	Free
	Premium
	Plus

# Free You will have access to a **free virtual scene** where you can **start experimenting** by building scenarios and experiences. Just register with Coderblock and log in to Coderblock Studio to **discover all the possibilities of the Builder Tool**!

# Plus An advanced plan that lets you **create unlimited scenes, share them** with your contacts and users, and **monetize** them! With the Plus plan, you'll have full access to **all the features of Coderblock Studio**, publish your scenes, organize events and sell your creations on the Coderblock Hub marketplace! If you opt for the **annual plan**, you'll also benefit from a significant discount (**40% off!**) and have access to **15 catalogue templates** to use as models for building your experiences!

# Land Unlike previous plans, the **Land plan does not involve a subscription**, but rather a one-time purchase of one or more lands within Coderblock's open world. **Owning a land means acquiring ownership on the Blockchain**, as lands are NFTs registered via smart contracts. Your lands are located within a **shared world**, so rather than being separate microcosms, they can be accessed and visited by a potentially unlimited number of users exploring the Coderblock universe. You'll also be able to **create** unique environments and experiences on your lands using the Builder tool. In addition to the benefits associated with the visibility of your experiences, a virtual land, as real estate, represents value that can be traded through sale or lease.

# Spaces and lands Although the possibilities for creation and customisation are almost identical, there are, as expected, some differences between virtual scenes and land. **Spaces are separate microcosms, not connected to each other** or to surrounding virtual worlds. They **can be shared** via a direct URL and are ideal for creating experiences and events tailored to a specific audience.

**Lands**, on the other hand, **are true virtual parcels of land on the blockchain**, with **ownership rights held through smart contracts**. Plots are located using coordinates within an open virtual map: the **Open World**. This world is accessible and explorable by any user on the platform: owning land within a shared space thus offers various opportunities in terms of visibility and awareness, as one's virtual terrain and the experiences it contains can be visited and enjoyed by a potentially infinite number of users. In addition, as property, land has a real value that can be increased, allowing it to be traded as a commodity for rent or sale to third parties.

# Acess to Coderblock Studio Once you have subscribed to your subscription plan, accessing **Coderblock Studio** is straightforward. You need to log in [here](https://coderblock.com/login) with your credentials (or create an account if you haven't registered on Coderblock yet). --- [Next Page](/llms-full.txt/1)