# Getting Started #### **Welcome to Max2D! ๐ŸŽฎ** **What is Max2D?** Imagine building your own video game, just like playing with building blocks! Max2D is a super cool app that lets you create 2D games **without writing a single line of confusing code**. You can add heroes, monsters, and treasures, make them jump and run, and create your very own gaming world. It's like magic! โœจ #### **1. Let's Get Set Up! ๐Ÿš€** 1. **Download:** Ask a parent to help you download **Max2D** from the Play Store. 2. **Open:** Tap the Max2D icon to start the app. 3. **Learn:** Watch the quick intro screens to see what's possible. 4. **Guest Mode:** You'll start as a **Guest**. You can play around right away!
> **๐ŸŒŸ Pro Tip:**\ > To save your awesome games and show them to friends, tap on **Profile** and create a free Max2D account. It's safe and easy! #### **2. Your Mission Control Center ๐Ÿ•น๏ธ** Look at the bottom of the screen. You'll see **five colorful buttons**. These are your main controls:
* โŒ‚ **Build/Home:** Your headquarters! See your projects, access ready made templates, import projects, turn on dev mode and find tutorials here. * ๐ŸŽฎ **Play:** The arcade! Play fun games made by other users just like you. * **โž• New:** The workshop! Tap this big button to start creating a brand new game. * ๐Ÿงญ **Store:** The treasure chest! Find cool characters, backgrounds, and sounds for your game. * โ–ฆ **Profile:** Your ID card! Change your settings and see your account info. *** #### **3. Start Your First Adventure! โš”๏ธ** **Ready to make a game? Follow these 3 simple steps:** 1. **Tap the Big Plus (+):** It's the button in the middle at the bottom.
2. **Name Your Game:** Give it a cool name (like "Super Space Cat"!). Choose if you want your game to be **Portrait** (tall phone) or **Landscape** (sideways phone). Then tap **Create Project**.
3. **Add Stuff (or Wait):** You can pick images now, or just tap **Skip & Start Empty** to start with a blank canvas.
#### **Boom! You're in the Game Editor. The world is yours to create! ๐ŸŒ**
#### **Inside the Game Lab (The Editor Interface) ๐Ÿงช** This is where the magic happens. The screen has 4 **Key Areas**:
1. **Game Screen:** The big middle part where you see your game. 2. **Top Bar:** Important buttons like Save and Play. 3. **Left Toolbar:** Tools to move and resize things. 4. **Bottom Bar :** This is the brain of your game. Where your objects and their superpowers listed & where you give orders to your game (Coding!). *** #### **1. The Game Screen ๐Ÿ“บ** This is your stage! The **large white rectangle** is what players will see. * **Stay Inside the Lines:** Make sure your hero and enemies are inside the white box so players can see them. * **Zoom In/Out:** Use two fingers like you're pinching or stretching a photo to get a closer look or see the whole level. *** #### **2. The Top Bar (Command Center) ๐Ÿซก**
(Left to Right) 1. ๐ŸŽฌ **Scene:** Create new scenes and select the scene you are working on 2. ๐Ÿ›ˆ **Info:** Tap here and read all the basic information about the game editor. 3. ๐Ÿ•˜ **History:** Tap here to see all changes you made to your project 4. โ†ฉ๏ธ **Undo:** Made a mistake? Tap this to fix it! 5. ๐Ÿ’พ **Save:** **Always tap this** to keep your hard work safe! 6. ๐Ÿž **Debug:** See whatโ€™s wrong in your game and fix it. 7. โ–ถ๏ธ **Play:** Test your game! See if it's fun. 8. **โ‹ฎ Project Menu:** Change how the editor works. *** #### **3. The Left Toolbar (Toolbox) ๐Ÿงฐ**
1. **โ‹ฎโ‹ฎ Drag Tool:** Press here and drag the Left Toolbar to the place where you want 2. โœ‹ **Hand Tool:** Drag the screen around to look at different parts. 3. โœฅ **Move Tool:** Drag objects to where you want them. 4. ๐Ÿ“ **Scale Tool:** Make things bigger (Giant!) or smaller (Tiny!). 5. ๐Ÿ”„ **Rotate Tool:** Spin things around. 6. โ–ฆ **Grid On/Off:** On or off the grid in the game screen *** #### **4. Bottom Bar (Control Center** ๐ŸŽ›๏ธ)
This is where you list all your game objects, save it's abilities and characteristics and tell your game what to do. It have 4 sections. 1. Layers 2. Design 3. Properties 4. Code Let's look into each one in detail: ### Layers
It have mainly three sections: Scene Settings, Scene Objects & Add Object **Scene Settings:** Special Section items at the top * **Scene Camera:** Change camera position( your view), zoom and the background color here! * **Global Variables:** Scorekeepers and memory for your game. * **Sounds:** Music and sound effects manager. * **UI Components:** Manage user interface elements such as Joystick and Banner Ads * **Game Objects and folders:** All your characters and items are listed here. Organize, duplicate, or delete them. * **Scene Appearance**: Set the sceneโ€™s background color and create parallax layers for depth and visual richness. **Scene Objects (Hierarchy) :** It lists everything in your game. * Search bar to filter objects * Draggable, reorderable list of all game objects * Folder grouping (collapse/expand groups of objects) **Add Object:** This is the "Fun Button"! Use it to add cool stuffs like images, emojis and sounds to your game. #### Design This is the home page of your game editor where you see the game screen, Left Toolbar and Top Bar. Go back to arranging your game world! ### Properties( Inspector) The Inspector is where you configure every game object. Select an object in the Layers panel and all its components appear here - position, image, physics, scripts, and more. This is where you bring your objects to life.
Let's see what are the components inside Properties #### Game Object Basics **Game Object**\ This is your main object. You can rename it, control if it is visible, and organize it using tags. **Transform**\ This controls where your object is placed, how big it is, and how it rotates in the game world. #### Add Component Tap **Add Component** to give your object new abilities and make it more powerful. #### Visual Components **Sprite**\ Show an image on your object, this is how your object looks in the game. **Sprite Animation**\ Make your object move by playing images like a flipbook animation. **Text**\ Display words on the screen with your own style and font. **Life Bar**\ Show health or progress, like a playerโ€™s life or loading bar. **Parallax Background**\ Create a cool moving background with layers that scroll at different speeds. #### Physics Components **Rigid Body**\ Give your object gravity and make it move like in real life. **Box Collider**\ Add a rectangular collision shape so objects can bump into each other. **Circle Collider**\ Add a round collision shape for smoother interactions. **Triangle Collider**\ Use triangle shapes, perfect for slopes and ramps. **Polygon Collider**\ Create custom shapes for collisions, from triangles up to complex shapes. **Capsule Collider**\ A rounded shape, great for characters so they donโ€™t get stuck easily. #### Joints **Revolute Joint**\ Connect two objects like a hinge so they can rotate together. **Wheel Joint**\ Perfect for vehicles, adds suspension and smooth wheel movement. #### Logic **Script**\ Add your game logic using visual scripting and control how things behave. #### Utility **Y Sort**\ Automatically arrange objects based on their vertical position, so closer objects appear in front. It also included Scene Camera which is for Change what the player sees, move the camera, zoom in or out, and set the background color. ### Quick Start 1. Add a Sprite object from the Layers panel. 2. Select it - the Inspector opens automatically. 3. Tap + Add Component โ†’ Sprite โ†’ pick an image. 4. Add a Rigidbody to give it gravity. 5. Add a Box Collider so other objects can hit it. ### ### Code **(The Brains ๐Ÿง )**
This is where you tell your game **what to do**. But don't worry, you don't need to type! You use **Blocks** like puzzle pieces. * **Events (Green) (11 Blocks):** When should something happen? (e.g., "When Game Starts") * **Actions (Blue) ( 35 Blocks):** What should happen? (e.g., "Move Right") * **Controls (Orange) (8 Blocks):** Logic (e.g., "If score is 10, then Win!") * **Custom Blocks:** Create your own block for special actions! There are also **Variables** (Data Boxes): 1. **Number:** For scores or health (1, 2, 100). 2. **Text:** For names or messages ("Hello!"). 3. **Boolean:** A switch (True/On or False/Off). 4. **List:** A collection of things. *** #### **Helpful Tips for Young Creators ๐Ÿ’ก** * **Start Small:** Make a simple game first, like a ball bouncing. Then add more! * **Experiment:** Try different buttons to see what they do. You can't break anything! * **Ask for Help:** If you get stuck, look at the **Tutorials** on the Home screen or ask a friend. * **Have Fun:** The most important rule is to have fun creating your world! **Ready? Set. CREATE! ๐ŸŽจ** --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://max2d.gitbook.io/max2ddocumentation/getting-started.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.