Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update the getting started 3d tutorial for godot 4.x #9698

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

russellsanborn
Copy link
Contributor

@russellsanborn russellsanborn commented Aug 2, 2024

I followed the entire 3d tutorial with godot 4.x and the changes to the docs repo were small. The largest change was needing to replace the outdated links to the old starter project with assets. Since there was no longer a non-complete starter project, I made a PR to godot-docs-project-starters. That would need to be reviewed and merged first before the link to the new starter project zip file would be valid.

New starter/assets project PR:
godotengine/godot-docs-project-starters#9

I followed the entire 3d tutorial with godot 4.x and the changes to the
docs repo were small. The largest change was needing to replace the
outdated links to the old starter project with assets. Since there was
no longer a non-complete starter project, I made a PR to
godot-docs-project-starters. That would need to be reviewed and merged
first before the link to the new starter project zip file would be
valid.

New starter/assets project PR:
godotengine/godot-docs-project-starters#9
@@ -9,15 +9,15 @@ importing the start assets and setting up the game scene.
We've prepared a Godot project with the 3D models and sounds we'll use for this
tutorial, linked in the index page. If you haven't done so yet, you can download
the archive here: `Squash the Creeps assets
<https://github.com/godotengine/godot-3d-dodge-the-creeps/releases/tag/1.1.0>`__.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This would require godotengine/godot-docs-project-starters#9 to be reviewed and merged first, or another location that i should reference to make this doc valid for 4.x


Once you downloaded it, extract the .zip archive on your computer. Open the
Godot Project Manager and click the *Import* button.

.. image:: img/01.game_setup/01.import_button.webp

In the import popup, enter the full path to the freshly created directory
``squash_the_creeps_start/``. You can click the *Browse* button on the right to
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I named this 3d_squash_the_creeps_starter to match one of the patterns in https://github.com/godotengine/godot-docs-project-starters/tree/master/src

@@ -30,7 +30,7 @@ Click *Import & Edit* to open the project in the editor.
The start project contains an icon and two folders: ``art/`` and ``fonts/``.
There, you will find the art assets and music we'll use in the game.

.. image:: img/01.game_setup/04.start_assets.png
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This file was updated, see below, to reference the newer filenames base don the 4.x demo.

@@ -129,7 +129,7 @@ Bind also the :kbd:`A` key, onto the action ``move_left``.
|image12|

Let's now add support for a gamepad's left joystick. Click the "+" button again
but this time, select *Manual Selection -> Joypad Axes*.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Manual Selection is no longer a tab, i uploaded a new getting_started/first_3d_game/img/02.player_input/joystick_axis_input.webp image to match it.

@skyace65 skyace65 added enhancement area:getting started Issues and PRs related to the Getting Started section of the documentation waiting on PR merge PR's that can't be merged until a engine PR is merged first labels Aug 21, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area:getting started Issues and PRs related to the Getting Started section of the documentation enhancement waiting on PR merge PR's that can't be merged until a engine PR is merged first
Projects
None yet
Development

Successfully merging this pull request may close these issues.

The starter project for 3d tutorial is still using Godot 3.x
2 participants