diff --git a/getting_started/step_by_step/files/dodge_assets.zip b/getting_started/first_2d_game/files/dodge_assets.zip similarity index 100% rename from getting_started/step_by_step/files/dodge_assets.zip rename to getting_started/first_2d_game/files/dodge_assets.zip diff --git a/getting_started/step_by_step/img/add_node.png b/getting_started/first_2d_game/img/add_node.png similarity index 100% rename from getting_started/step_by_step/img/add_node.png rename to getting_started/first_2d_game/img/add_node.png diff --git a/getting_started/step_by_step/img/add_script_button.png b/getting_started/first_2d_game/img/add_script_button.png similarity index 100% rename from getting_started/step_by_step/img/add_script_button.png rename to getting_started/first_2d_game/img/add_script_button.png diff --git a/getting_started/step_by_step/img/attach_node_window.png b/getting_started/first_2d_game/img/attach_node_window.png similarity index 100% rename from getting_started/step_by_step/img/attach_node_window.png rename to getting_started/first_2d_game/img/attach_node_window.png diff --git a/getting_started/step_by_step/img/completed_main_scene.png b/getting_started/first_2d_game/img/completed_main_scene.png similarity index 100% rename from getting_started/step_by_step/img/completed_main_scene.png rename to getting_started/first_2d_game/img/completed_main_scene.png diff --git a/getting_started/step_by_step/img/custom_font1.png b/getting_started/first_2d_game/img/custom_font1.png similarity index 100% rename from getting_started/step_by_step/img/custom_font1.png rename to getting_started/first_2d_game/img/custom_font1.png diff --git a/getting_started/step_by_step/img/custom_font2.png b/getting_started/first_2d_game/img/custom_font2.png similarity index 100% rename from getting_started/step_by_step/img/custom_font2.png rename to getting_started/first_2d_game/img/custom_font2.png diff --git a/getting_started/step_by_step/img/dodge_preview.gif b/getting_started/first_2d_game/img/dodge_preview.gif similarity index 100% rename from getting_started/step_by_step/img/dodge_preview.gif rename to getting_started/first_2d_game/img/dodge_preview.gif diff --git a/getting_started/step_by_step/img/draw_path2d.gif b/getting_started/first_2d_game/img/draw_path2d.gif similarity index 100% rename from getting_started/step_by_step/img/draw_path2d.gif rename to getting_started/first_2d_game/img/draw_path2d.gif diff --git a/getting_started/step_by_step/img/export_variable.png b/getting_started/first_2d_game/img/export_variable.png similarity index 100% rename from getting_started/step_by_step/img/export_variable.png rename to getting_started/first_2d_game/img/export_variable.png diff --git a/getting_started/step_by_step/img/filesystem_dock.png b/getting_started/first_2d_game/img/filesystem_dock.png similarity index 100% rename from getting_started/step_by_step/img/filesystem_dock.png rename to getting_started/first_2d_game/img/filesystem_dock.png diff --git a/getting_started/step_by_step/img/grid_snap_button.png b/getting_started/first_2d_game/img/grid_snap_button.png similarity index 100% rename from getting_started/step_by_step/img/grid_snap_button.png rename to getting_started/first_2d_game/img/grid_snap_button.png diff --git a/getting_started/step_by_step/img/group_tab.png b/getting_started/first_2d_game/img/group_tab.png similarity index 100% rename from getting_started/step_by_step/img/group_tab.png rename to getting_started/first_2d_game/img/group_tab.png diff --git a/getting_started/step_by_step/img/instance_scene.png b/getting_started/first_2d_game/img/instance_scene.png similarity index 100% rename from getting_started/step_by_step/img/instance_scene.png rename to getting_started/first_2d_game/img/instance_scene.png diff --git a/getting_started/step_by_step/img/lock_children.png b/getting_started/first_2d_game/img/lock_children.png similarity index 100% rename from getting_started/step_by_step/img/lock_children.png rename to getting_started/first_2d_game/img/lock_children.png diff --git a/getting_started/step_by_step/img/main_scene_nodes.png b/getting_started/first_2d_game/img/main_scene_nodes.png similarity index 100% rename from getting_started/step_by_step/img/main_scene_nodes.png rename to getting_started/first_2d_game/img/main_scene_nodes.png diff --git a/getting_started/step_by_step/img/mob_animations.gif b/getting_started/first_2d_game/img/mob_animations.gif similarity index 100% rename from getting_started/step_by_step/img/mob_animations.gif rename to getting_started/first_2d_game/img/mob_animations.gif diff --git a/getting_started/step_by_step/img/path2d_buttons.png b/getting_started/first_2d_game/img/path2d_buttons.png similarity index 100% rename from getting_started/step_by_step/img/path2d_buttons.png rename to getting_started/first_2d_game/img/path2d_buttons.png diff --git a/getting_started/step_by_step/img/player_coll_shape.png b/getting_started/first_2d_game/img/player_coll_shape.png similarity index 100% rename from getting_started/step_by_step/img/player_coll_shape.png rename to getting_started/first_2d_game/img/player_coll_shape.png diff --git a/getting_started/step_by_step/img/player_scale.png b/getting_started/first_2d_game/img/player_scale.png similarity index 100% rename from getting_started/step_by_step/img/player_scale.png rename to getting_started/first_2d_game/img/player_scale.png diff --git a/getting_started/step_by_step/img/player_scene_nodes.png b/getting_started/first_2d_game/img/player_scene_nodes.png similarity index 100% rename from getting_started/step_by_step/img/player_scene_nodes.png rename to getting_started/first_2d_game/img/player_scene_nodes.png diff --git a/getting_started/step_by_step/img/player_signal_connection.png b/getting_started/first_2d_game/img/player_signal_connection.png similarity index 100% rename from getting_started/step_by_step/img/player_signal_connection.png rename to getting_started/first_2d_game/img/player_signal_connection.png diff --git a/getting_started/step_by_step/img/player_signals.png b/getting_started/first_2d_game/img/player_signals.png similarity index 100% rename from getting_started/step_by_step/img/player_signals.png rename to getting_started/first_2d_game/img/player_signals.png diff --git a/getting_started/step_by_step/img/set_collision_mask.png b/getting_started/first_2d_game/img/set_collision_mask.png similarity index 100% rename from getting_started/step_by_step/img/set_collision_mask.png rename to getting_started/first_2d_game/img/set_collision_mask.png diff --git a/getting_started/step_by_step/img/spriteframes_panel.png b/getting_started/first_2d_game/img/spriteframes_panel.png similarity index 100% rename from getting_started/step_by_step/img/spriteframes_panel.png rename to getting_started/first_2d_game/img/spriteframes_panel.png diff --git a/getting_started/step_by_step/img/spriteframes_panel2.png b/getting_started/first_2d_game/img/spriteframes_panel2.png similarity index 100% rename from getting_started/step_by_step/img/spriteframes_panel2.png rename to getting_started/first_2d_game/img/spriteframes_panel2.png diff --git a/getting_started/step_by_step/img/start_button_shortcut.png b/getting_started/first_2d_game/img/start_button_shortcut.png similarity index 100% rename from getting_started/step_by_step/img/start_button_shortcut.png rename to getting_started/first_2d_game/img/start_button_shortcut.png diff --git a/getting_started/step_by_step/img/ui_anchor.png b/getting_started/first_2d_game/img/ui_anchor.png similarity index 100% rename from getting_started/step_by_step/img/ui_anchor.png rename to getting_started/first_2d_game/img/ui_anchor.png diff --git a/getting_started/first_2d_game/index.rst b/getting_started/first_2d_game/index.rst new file mode 100644 index 000000000..08c361c6d --- /dev/null +++ b/getting_started/first_2d_game/index.rst @@ -0,0 +1,64 @@ +Your first 2D game +================== + +In this step-by-step tutorial series, you will create your first complete 2D +game with Godot. By the end of the series, you will have a simple yet complete +game of your own, like the image below. + +|image0| + +You will learn how the Godot editor works, how to structure a project, and build +a 2D game. + +.. note:: This project is an introduction to the Godot engine. It assumes that + you have some programming experience already. If you're new to + programming entirely, you should start here: :ref:`doc_scripting`. + +The game is called "Dodge the Creeps!". Your character must move and avoid the +enemies for as long as possible. Here is a preview of the final result: + +You will learn to: + +- Create a complete 2D game with the Godot editor. +- Structure a simple game project. +- Move the player character and change its sprite. +- Spawn random enemies. +- Count the score. + +And more. + +You'll find another series where you'll create a similar game but in 3D. We +recommend you to start with this one, though. + +**Why start with 2D?** + +3D games are much more complex than 2D ones. It would be best if you stuck to 2D +until you understood the game development process and how to use Godot well. + +Prerequisites +------------- + +This step-by-step tutorial is intended for beginners who followed the complete +:ref:`Getting Started `. + +If you're an experienced programmer, you can find the complete demo's source +code here: `Godot demo projects +`__. + +We prepared some game assets you'll need to download so we can jump straight to +the code. + +You can download them by clicking the link below. + +:download:`dodge_assets.zip `. + +Contents +-------- + +.. toctree:: + :maxdepth: 1 + :name: toc-learn-introduction + + your_first_game.rst + +.. |image0| image:: img/dodge_preview.gif diff --git a/getting_started/step_by_step/your_first_game.rst b/getting_started/first_2d_game/your_first_game.rst similarity index 98% rename from getting_started/step_by_step/your_first_game.rst rename to getting_started/first_2d_game/your_first_game.rst index 0899a4b71..f254b20a5 100644 --- a/getting_started/step_by_step/your_first_game.rst +++ b/getting_started/first_2d_game/your_first_game.rst @@ -3,27 +3,6 @@ Your first game =============== -Overview --------- - -This tutorial will guide you through making your first Godot -project. You will learn how the Godot editor works, how to structure -a project, and how to build a 2D game. - -.. note:: This project is an introduction to the Godot engine. It - assumes that you have some programming experience already. If - you're new to programming entirely, you should start here: - :ref:`doc_scripting`. - -The game is called "Dodge the Creeps!". Your character must move and -avoid the enemies for as long as possible. Here is a preview of the -final result: - -.. image:: img/dodge_preview.gif - -**Why 2D?** 3D games are much more complex than 2D ones. You should stick to 2D -until you have a good understanding of the game development process and how to -use Godot. Project setup ------------- diff --git a/index.rst b/index.rst index 4e1e9c5b7..09a3e23ec 100644 --- a/index.rst +++ b/index.rst @@ -77,6 +77,7 @@ The main documentation for the site is organized into the following sections: getting_started/introduction/index getting_started/step_by_step/index + getting_started/first_2d_game/index getting_started/first_3d_game/index