mirror of
https://github.com/godotengine/godot-docs.git
synced 2025-12-31 17:49:03 +03:00
c01bcad47e
* "First 2D game" - minor additions, clarification Co-authored-by: tetrapod <145553014+tetrapod00@users.noreply.github.com> --------- Co-authored-by: Max Hilbrunner <mhilbrunner@users.noreply.github.com> Co-authored-by: tetrapod <145553014+tetrapod00@users.noreply.github.com>
68 lines
2.7 KiB
ReStructuredText
68 lines
2.7 KiB
ReStructuredText
.. _doc_your_first_2d_game_project_setup:
|
|
|
|
Setting up the project
|
|
======================
|
|
|
|
In this short first part, we'll set up and organize the project.
|
|
|
|
Launch Godot and create a new project.
|
|
|
|
.. image:: img/new-project-button.webp
|
|
|
|
When creating the new project, you only need to choose a valid *Project Path*. You can leave the other default settings alone.
|
|
|
|
.. tabs::
|
|
.. tab:: GDScript
|
|
|
|
Download `dodge_the_creeps_2d_assets.zip <https://github.com/godotengine/godot-docs-project-starters/releases/download/latest-4.x/dodge_the_creeps_2d_assets.zip>`_.
|
|
The archive contains the images and sounds you'll be using
|
|
to make the game. Extract the archive and move the ``art/``
|
|
and ``fonts/`` directories to your project's directory.
|
|
|
|
.. tab:: C#
|
|
|
|
Download `dodge_the_creeps_2d_assets.zip <https://github.com/godotengine/godot-docs-project-starters/releases/download/latest-4.x/dodge_the_creeps_2d_assets.zip>`_.
|
|
The archive contains the images and sounds you'll be using
|
|
to make the game. Extract the archive and move the ``art/``
|
|
and ``fonts/`` directories to your project's directory.
|
|
|
|
Ensure that you have the required dependencies to use C# in Godot.
|
|
You need the latest stable .NET SDK, and an editor such as VS Code.
|
|
See :ref:`doc_c_sharp_setup`.
|
|
|
|
.. tab:: C++
|
|
|
|
The C++ part of this tutorial wasn't rewritten for the new GDExtension system yet.
|
|
|
|
Your project folder should look like this.
|
|
|
|
.. image:: img/folder-content.webp
|
|
|
|
This game is designed for portrait mode, so we need to adjust the size of the
|
|
game window. Click on *Project -> Project Settings* to open the project settings
|
|
window, in the left column open the *Display -> Window* tab. There, set
|
|
"Viewport Width" to ``480`` and "Viewport Height" to ``720``. You can see the
|
|
"Project" menu on the upper left corner.
|
|
|
|
.. image:: img/setting-project-width-and-height.webp
|
|
|
|
Also, under the **Stretch** options, set **Mode** to ``canvas_items`` and **Aspect** to ``keep``.
|
|
This ensures that the game scales consistently on different sized screens.
|
|
|
|
.. image:: img/setting-stretch-mode.webp
|
|
|
|
Organizing the project
|
|
----------------------
|
|
|
|
In this project, we will make 3 independent scenes: ``Player``, ``Mob``, and
|
|
``HUD``, which we will combine into the game's ``Main`` scene.
|
|
|
|
In a larger project, it might be useful to create folders to hold the various
|
|
scenes and their scripts, but for this relatively small game, you can save your
|
|
scenes and scripts in the project's root folder, identified by ``res://``. You
|
|
can see your project folders in the FileSystem dock in the lower left corner:
|
|
|
|
.. image:: img/filesystem_dock.webp
|
|
|
|
With the project in place, we're ready to design the player scene in the next lesson.
|