part_three.rst 28 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698
  1. .. _doc_fps_tutorial_part_three:
  2. Part 3
  3. ======
  4. Part overview
  5. -------------
  6. In this part, we will be limiting the player's weapons by giving them ammo. We will also
  7. be giving the player the ability to reload, and we will be adding sounds when the
  8. weapons fire.
  9. .. image:: img/PartThreeFinished.png
  10. .. note:: You are assumed to have finished :ref:`doc_fps_tutorial_part_two` before moving on to this part of the tutorial.
  11. The finished project from :ref:`doc_fps_tutorial_part_two` will be the starting project for part 3
  12. Let's get started!
  13. Changing levels
  14. ---------------
  15. Now that we have a fully working FPS, let's move to a more FPS-like level.
  16. Open up ``Space_Level.tscn`` (``assets/Space_Level_Objects/Space_Level.tscn``)
  17. and/or ``Ruins_Level.tscn`` (``assets/Ruin_Level_Objects/Ruins_Level.tscn``).
  18. ``Space_Level.tscn`` and ``Ruins_Level.tscn`` are complete custom FPS levels
  19. created for the purpose of this tutorial. Press ``Play Current Scene`` button,
  20. or :kbd:`F6` on keyboard, and give each a try.
  21. .. warning:: ``Space_Level.tscn`` is more graphically demanding of the GPU than ``Ruins_Level.tscn``. If your computer is struggling to render
  22. ``Space_Level.tscn``, try using ``Ruins_Level.tscn`` instead.
  23. .. note::
  24. Due to Godot updates since this tutorial was published, if you are using Godot 3.2 or later, you may need to apply the following changes to the Space Level and Ruins Level scenes:
  25. - Open ``res://assets/Space_Level_Objects/Space_Level.tscn``.
  26. - In the Scene tree dock, select the **Floor_and_Celing** node. In the Inspector dock, if the Mesh Library field under GridMap is ``[empty]``, set it to ``Space_Level_Mesh_Lib.tres`` by dragging the file ``res://assets/Space_Level_Objects/Space_Level_Mesh_Lib.tres`` from the FileSystem dock to that field.
  27. - Do the same for the **Walls** node.
  28. - Open ``res://assets/Ruin_Level_Objects/Ruins_Level.tscn``.
  29. - In the Scene tree dock, select the **Floor** node. In the Inspector dock, if the Mesh Library field under GridMap is ``[empty]``, set it to ``Ruin_Level_Mesh_Lib.tres`` by dragging the file ``res://assets/Ruin_Level_Objects/Ruin_Level_Mesh_Lib.tres`` from the FileSystem dock into that field.
  30. - Do the same for the **Walls** node.
  31. You might have noticed there are several :ref:`RigidBody <class_RigidBody>` nodes placed throughout the level.
  32. We can place ``RigidBody_hit_test.gd`` on them and then they will react to being hit with bullets, so let's do that!
  33. Follow the instructions below for either (or both) of the scenes you want to use
  34. .. tabs::
  35. .. code-tab:: gdscript Space_Level.tscn
  36. Expand "Other_Objects" and then expand "Physics_Objects".
  37. Expand one of the "Barrel_Group" nodes and then select "Barrel_Rigid_Body" and open it using
  38. the "Open in Editor" button.
  39. This will bring you to the "Barrel_Rigid_Body" scene. From there, select the root node and
  40. scroll the inspector down to the bottom.
  41. Select the drop down arrow under the "Node" tab, and then select "Load". Navigate to
  42. "RigidBody_hit_test.gd" and select "Open".
  43. Return back to "Space_Level.tscn".
  44. Expand one of the "Box_Group" nodes and then select "Crate_Rigid_Body" and open it using the
  45. "Open in Editor" button.
  46. This will bring you to the "Crate_Rigid_Body" scene. From there, select the root node and
  47. scroll the inspector down to the bottom.
  48. Select the drop down arrow under the "Node" tab, and then select "Load". Navigate to
  49. "RigidBody_hit_test.gd" and select "Open".
  50. Return to "Space_Level.tscn".
  51. .. code-tab:: gdscript Ruins_Level.tscn
  52. Expand "Misc_Objects" and then expand "Physics_Objects".
  53. Select all the "Stone_Cube" RigidBodies and then in the inspector scroll down to the bottom.
  54. Select the drop down arrow under the "Node" tab, and then select "Load". Navigate to
  55. "RigidBody_hit_test.gd" and select "Open".
  56. Return to "Ruins_Level.tscn".
  57. Now you can fire at all the rigid bodies in either level and they will react to bullets hitting them!
  58. Adding ammo
  59. -----------
  60. Now that the player has working guns, let's give them a limited amount of ammo.
  61. Firstly, we need to define a few variables in each of our weapon scripts.
  62. Open up ``Weapon_Pistol.gd`` and add the following class variables:
  63. ::
  64. var ammo_in_weapon = 10
  65. var spare_ammo = 20
  66. const AMMO_IN_MAG = 10
  67. * ``ammo_in_weapon``: The amount of ammo currently in the pistol
  68. * ``spare_ammo``: The amount of ammo we have left in reserve for the pistol
  69. * ``AMMO_IN_MAG``: The amount of ammo in a fully reloaded weapon/magazine
  70. Now all we need to do is add a single line of code to ``fire_weapon``.
  71. Add the following right under ``Clone.BULLET_DAMAGE = DAMAGE``: ``ammo_in_weapon -= 1``
  72. This will remove one from ``ammo_in_weapon`` every time the player fires. Notice we're not checking to see
  73. if the player has enough ammo or not in ``fire_weapon``. Instead, we're going to check to see if the player has enough ammo in ``Player.gd``.
  74. _______
  75. Now we need to add ammo for both the rifle and the knife.
  76. .. note:: You may be wondering why we are adding ammo for the knife given it does not consume any ammunition.
  77. The reason we want to add ammo to the knife is so we have a consistent interface for all our weapons.
  78. If we did not add ammo variables for the knife, we would have to add checks for the knife. By adding the ammo
  79. variables to the knife, we don't need to worry about whether or not all our weapons have the same variables.
  80. Add the following class variables to ``Weapon_Rifle.gd``:
  81. ::
  82. var ammo_in_weapon = 50
  83. var spare_ammo = 100
  84. const AMMO_IN_MAG = 50
  85. And then add the following to ``fire_weapon``: ``ammo_in_weapon -= 1``. Make sure that ``ammo_in_weapon -= 1`` is outside of the ``if ray.is_colliding()`` check so
  86. the player loses ammo regardless of whether the player hit something or not.
  87. Now all that's left is the knife. Add the following to ``Weapon_Knife.gd``:
  88. ::
  89. var ammo_in_weapon = 1
  90. var spare_ammo = 1
  91. const AMMO_IN_MAG = 1
  92. Because the knife does not consume ammo, that is all we need to add.
  93. _______
  94. Now we need to change one thing in ``Player.gd``, that is to say,
  95. how we're firing the weapons in ``process_input``. Change the code for firing weapons to the following:
  96. ::
  97. # ----------------------------------
  98. # Firing the weapons
  99. if Input.is_action_pressed("fire"):
  100. if changing_weapon == false:
  101. var current_weapon = weapons[current_weapon_name]
  102. if current_weapon != null:
  103. if current_weapon.ammo_in_weapon > 0:
  104. if animation_manager.current_state == current_weapon.IDLE_ANIM_NAME:
  105. animation_manager.set_animation(current_weapon.FIRE_ANIM_NAME)
  106. # ----------------------------------
  107. Now the weapons have a limited amount of ammo, and will stop firing when the player runs out.
  108. _______
  109. Ideally, we'd like to let the player be able to see how much ammo is left. Let's make a new function called ``process_UI``.
  110. First, add ``process_UI(delta)`` to ``_physics_process``.
  111. Now add the following to ``Player.gd``:
  112. ::
  113. func process_UI(delta):
  114. if current_weapon_name == "UNARMED" or current_weapon_name == "KNIFE":
  115. UI_status_label.text = "HEALTH: " + str(health)
  116. else:
  117. var current_weapon = weapons[current_weapon_name]
  118. UI_status_label.text = "HEALTH: " + str(health) + \
  119. "\nAMMO: " + str(current_weapon.ammo_in_weapon) + "/" + str(current_weapon.spare_ammo)
  120. Let's go over what's happening:
  121. Firstly, we check to see if the current weapon is either ``UNARMED`` or ``KNIFE``. If it is, we
  122. change the ``UI_status_label``'s text to only show the player's health since ``UNARMED`` and ``KNIFE`` do not consume ammo.
  123. If the player is using a weapon that consumes ammo, we first get the weapon node.
  124. Then we change ``UI_status_label``'s text to show the player's health, along with how much ammo the player has in the weapon
  125. and how much spare ammo the player has for that weapon.
  126. Now we can see how much ammo the player has through the HUD.
  127. Adding reloading to the weapons
  128. -------------------------------
  129. Now that the player can run out of ammo, we need a way to let the player fill them back up. Let's add reloading next!
  130. For reloading, we need to add a few more variables and a function to every weapon.
  131. Open up ``Weapon_Pistol.gd`` and add the following class variables:
  132. ::
  133. const CAN_RELOAD = true
  134. const CAN_REFILL = true
  135. const RELOADING_ANIM_NAME = "Pistol_reload"
  136. * ``CAN_RELOAD``: A boolean to track whether this weapon has the ability to reload
  137. * ``CAN_REFILL``: A boolean to track whether we can refill this weapon's spare ammo. We will not be using ``CAN_REFILL`` in this part, but we will in the next part!
  138. * ``RELOADING_ANIM_NAME``: The name of the reloading animation for this weapon.
  139. Now we need to add a function for handling reloading. Add the following function to ``Weapon_Pistol.gd``:
  140. ::
  141. func reload_weapon():
  142. var can_reload = false
  143. if player_node.animation_manager.current_state == IDLE_ANIM_NAME:
  144. can_reload = true
  145. if spare_ammo <= 0 or ammo_in_weapon == AMMO_IN_MAG:
  146. can_reload = false
  147. if can_reload == true:
  148. var ammo_needed = AMMO_IN_MAG - ammo_in_weapon
  149. if spare_ammo >= ammo_needed:
  150. spare_ammo -= ammo_needed
  151. ammo_in_weapon = AMMO_IN_MAG
  152. else:
  153. ammo_in_weapon += spare_ammo
  154. spare_ammo = 0
  155. player_node.animation_manager.set_animation(RELOADING_ANIM_NAME)
  156. return true
  157. return false
  158. Let's go over what's happening:
  159. First we define a variable to see whether or not this weapon can reload.
  160. Then we check to see if the player is in this weapon's idle animation state because we only want to be able to reload when the player is not
  161. firing, equipping, or unequipping.
  162. Next we check to see if the player has spare ammo, and if the ammo already in the weapon is equal to a fully reloaded weapon.
  163. This way we can ensure the player cannot reload when the player has no ammo or when the weapon is already full of ammo.
  164. If we can still reload, then we calculate the amount of ammo needed to reload the weapon.
  165. If the player has enough ammo to fill the weapon, we remove the ammo needed from ``spare_ammo`` and then set ``ammo_in_weapon`` to a full weapon/magazine.
  166. If the player does not have enough ammo, we add all the ammo left in ``spare_ammo``, and then set ``spare_ammo`` to ``0``.
  167. Next we play the reloading animation for this weapon, and then return ``true``.
  168. If the player could not reload, we return ``false``.
  169. _______
  170. Now we need to add reloading to the rifle. Open up ``Weapon_Rifle.gd`` and add the following class variables:
  171. ::
  172. const CAN_RELOAD = true
  173. const CAN_REFILL = true
  174. const RELOADING_ANIM_NAME = "Rifle_reload"
  175. These variables are exactly the same as the pistol, just with ``RELOADING_ANIM_NAME`` changed to the rifle's reloading animation.
  176. Now we need to add ``reload_weapon`` to ``Weapon_Rifle.gd``:
  177. ::
  178. func reload_weapon():
  179. var can_reload = false
  180. if player_node.animation_manager.current_state == IDLE_ANIM_NAME:
  181. can_reload = true
  182. if spare_ammo <= 0 or ammo_in_weapon == AMMO_IN_MAG:
  183. can_reload = false
  184. if can_reload == true:
  185. var ammo_needed = AMMO_IN_MAG - ammo_in_weapon
  186. if spare_ammo >= ammo_needed:
  187. spare_ammo -= ammo_needed
  188. ammo_in_weapon = AMMO_IN_MAG
  189. else:
  190. ammo_in_weapon += spare_ammo
  191. spare_ammo = 0
  192. player_node.animation_manager.set_animation(RELOADING_ANIM_NAME)
  193. return true
  194. return false
  195. This code is exactly the same as the one for the pistol.
  196. _______
  197. The last bit we need to do for the weapons is add 'reloading' to the knife. Add the following class variables to ``Weapon_Knife.gd``:
  198. ::
  199. const CAN_RELOAD = false
  200. const CAN_REFILL = false
  201. const RELOADING_ANIM_NAME = ""
  202. Since we both cannot reload or refill a knife, we set both constants to ``false``. We also define ``RELOADING_ANIM_NAME`` as an empty string, since the knife
  203. has no reloading animation.
  204. Now we need to add ``reloading_weapon``:
  205. ::
  206. func reload_weapon():
  207. return false
  208. Since we cannot reload a knife, we always return ``false``.
  209. Adding reloading to the player
  210. ------------------------------
  211. Now we need to add a few things to ``Player.gd``. First we need to define a new class variable:
  212. ::
  213. var reloading_weapon = false
  214. * ``reloading_weapon``: A variable to track whether or not the player is currently trying to reload.
  215. Next we need to add another function call to ``_physics_process``.
  216. Add ``process_reloading(delta)`` to ``_physics_process``. Now ``_physics_process`` should look something like this:
  217. ::
  218. func _physics_process(delta):
  219. process_input(delta)
  220. process_movement(delta)
  221. process_changing_weapons(delta)
  222. process_reloading(delta)
  223. process_UI(delta)
  224. Now we need to add ``process_reloading``. Add the following function to ``Player.gd``:
  225. ::
  226. func process_reloading(delta):
  227. if reloading_weapon == true:
  228. var current_weapon = weapons[current_weapon_name]
  229. if current_weapon != null:
  230. current_weapon.reload_weapon()
  231. reloading_weapon = false
  232. Let's go over what's happening here.
  233. Firstly, we check to make sure the player is trying to reload.
  234. If the player is trying to reload, we then get the current weapon. If the current weapon does not equal ``null``, we call its ``reload_weapon`` function.
  235. .. note:: If the current weapon is equal to ``null``, then the current weapon is ``UNARMED``.
  236. Finally, we set ``reloading_weapon`` to ``false`` because, regardless of whether the player successfully reloaded, we've tried reloading
  237. and no longer need to keep trying.
  238. _______
  239. Before we can let the player reload, we need to change a few things in ``process_input``.
  240. The first thing we need to change is in the code for changing weapons. We need to add an additional check (``if reloading_weapon == false:``) to see if the player is reloading:
  241. ::
  242. if changing_weapon == false:
  243. # New line of code here!
  244. if reloading_weapon == false:
  245. if WEAPON_NUMBER_TO_NAME[weapon_change_number] != current_weapon_name:
  246. changing_weapon_name = WEAPON_NUMBER_TO_NAME[weapon_change_number]
  247. changing_weapon = true
  248. This makes it so the player cannot change weapons if the player is reloading.
  249. Now we need to add the code to trigger a reload when the player pushes the ``reload`` action. Add the following code to ``process_input``:
  250. ::
  251. # ----------------------------------
  252. # Reloading
  253. if reloading_weapon == false:
  254. if changing_weapon == false:
  255. if Input.is_action_just_pressed("reload"):
  256. var current_weapon = weapons[current_weapon_name]
  257. if current_weapon != null:
  258. if current_weapon.CAN_RELOAD == true:
  259. var current_anim_state = animation_manager.current_state
  260. var is_reloading = false
  261. for weapon in weapons:
  262. var weapon_node = weapons[weapon]
  263. if weapon_node != null:
  264. if current_anim_state == weapon_node.RELOADING_ANIM_NAME:
  265. is_reloading = true
  266. if is_reloading == false:
  267. reloading_weapon = true
  268. # ----------------------------------
  269. Let's go over what's happening here.
  270. First we make sure the player is not reloading already, nor is the player trying to change weapons.
  271. Then we check to see if the ``reload`` action has been pressed.
  272. If the player has pressed ``reload``, we then get the current weapon and check to make sure it is not ``null``. Then we check to see whether the
  273. weapon can reload or not using its ``CAN_RELOAD`` constant.
  274. If the weapon can reload, we then get the current animation state, and make a variable for tracking whether the player is already reloading or not.
  275. We then go through every weapon to make sure the player is not already playing that weapon's reloading animation.
  276. If the player is not reloading any weapon, we set ``reloading_weapon`` to ``true``.
  277. _______
  278. One thing I like to add is where the weapon will reload itself if you try to fire it and it's out of ammo.
  279. We also need to add an additional if check (``is_reloading_weapon == false:``) so the player cannot fire the current weapon while
  280. reloading.
  281. Let's change our firing code in ``process_input`` so it reloads when trying to fire an empty weapon:
  282. ::
  283. # ----------------------------------
  284. # Firing the weapons
  285. if Input.is_action_pressed("fire"):
  286. if reloading_weapon == false:
  287. if changing_weapon == false:
  288. var current_weapon = weapons[current_weapon_name]
  289. if current_weapon != null:
  290. if current_weapon.ammo_in_weapon > 0:
  291. if animation_manager.current_state == current_weapon.IDLE_ANIM_NAME:
  292. animation_manager.set_animation(current_weapon.FIRE_ANIM_NAME)
  293. else:
  294. reloading_weapon = true
  295. # ----------------------------------
  296. Now we check to make sure the player is not reloading before we fire the weapon, and when we have ``0`` or less ammo in the current weapon,
  297. we set ``reloading_weapon`` to ``true`` if the player tries to fire.
  298. This will make it so the player will try to reload when attempting to fire an empty weapon.
  299. _______
  300. With that done, the player can now reload! Give it a try! Now you can fire all the spare ammo for each weapon.
  301. Adding sounds
  302. -------------
  303. Finally, let's add some sounds that accompany the player firing, reloading and changing weapons.
  304. .. tip:: There are no game sounds provided in this tutorial (for legal reasons).
  305. https://gamesounds.xyz/ is a collection of **"royalty free or public domain music and sounds suitable for games"**.
  306. I used Gamemaster's Gun Sound Pack, which can be found in the Sonniss.com GDC 2017 Game Audio Bundle.
  307. Open up ``Simple_Audio_Player.tscn``. It is simply a :ref:`Spatial <class_Spatial>` with an :ref:`AudioStreamPlayer <class_AudioStreamPlayer>` as its child.
  308. .. note:: The reason this is called a 'simple' audio player is because we are not taking performance into account
  309. and because the code is designed to provide sound in the simplest way possible.
  310. If you want to use 3D audio, so it sounds like it's coming from a location in 3D space, right click
  311. the :ref:`AudioStreamPlayer <class_AudioStreamPlayer>` and select "Change type".
  312. This will open the node browser. Navigate to :ref:`AudioStreamPlayer3D <class_AudioStreamPlayer3D>` and select "change".
  313. In the source for this tutorial, we will be using :ref:`AudioStreamPlayer <class_AudioStreamPlayer>`, but you can optionally
  314. use :ref:`AudioStreamPlayer3D <class_AudioStreamPlayer3D>` if you desire, and the code provided below will work regardless of which
  315. one you chose.
  316. Create a new script and call it ``Simple_Audio_Player.gd``. Attach it to the :ref:`Spatial <class_Spatial>` in ``Simple_Audio_Player.tscn``
  317. and insert the following code:
  318. ::
  319. extends Spatial
  320. # All of the audio files.
  321. # You will need to provide your own sound files.
  322. var audio_pistol_shot = preload("res://path_to_your_audio_here")
  323. var audio_gun_cock = preload("res://path_to_your_audio_here")
  324. var audio_rifle_shot = preload("res://path_to_your_audio_here")
  325. var audio_node = null
  326. func _ready():
  327. audio_node = $Audio_Stream_Player
  328. audio_node.connect("finished", self, "destroy_self")
  329. audio_node.stop()
  330. func play_sound(sound_name, position=null):
  331. if audio_pistol_shot == null or audio_rifle_shot == null or audio_gun_cock == null:
  332. print ("Audio not set!")
  333. queue_free()
  334. return
  335. if sound_name == "Pistol_shot":
  336. audio_node.stream = audio_pistol_shot
  337. elif sound_name == "Rifle_shot":
  338. audio_node.stream = audio_rifle_shot
  339. elif sound_name == "Gun_cock":
  340. audio_node.stream = audio_gun_cock
  341. else:
  342. print ("UNKNOWN STREAM")
  343. queue_free()
  344. return
  345. # If you are using an AudioStreamPlayer3D, then uncomment these lines to set the position.
  346. #if audio_node is AudioStreamPlayer3D:
  347. # if position != null:
  348. # audio_node.global_transform.origin = position
  349. audio_node.play()
  350. func destroy_self():
  351. audio_node.stop()
  352. queue_free()
  353. .. tip:: By setting ``position`` to ``null`` by default in ``play_sound``, we are making it an optional argument,
  354. meaning ``position`` doesn't necessarily have to be passed in to call ``play_sound``.
  355. Let's go over what's happening here:
  356. _________
  357. In ``_ready``, we get the :ref:`AudioStreamPlayer <class_AudioStreamPlayer>` and connect its ``finished`` signal to the ``destroy_self`` function.
  358. It doesn't matter if it's an :ref:`AudioStreamPlayer <class_AudioStreamPlayer>` or :ref:`AudioStreamPlayer3D <class_AudioStreamPlayer3D>` node,
  359. as they both have the finished signal. To make sure it is not playing any sounds, we call ``stop`` on the :ref:`AudioStreamPlayer <class_AudioStreamPlayer>`.
  360. .. warning:: Make sure your sound files are **not** set to loop! If it is set to loop,
  361. the sounds will continue to play infinitely and the script will not work!
  362. The ``play_sound`` function is what we will be calling from ``Player.gd``. We check if the sound
  363. is one of the three possible sounds, and if it is one of the three sounds we set the audio stream in :ref:`AudioStreamPlayer <class_AudioStreamPlayer>`
  364. to the correct sound.
  365. If it is an unknown sound, we print an error message to the console and free the audio player.
  366. If you are using an :ref:`AudioStreamPlayer3D <class_AudioStreamPlayer3D>`, remove the ``#`` to set the position of
  367. the audio player node so it plays at the correct position.
  368. Finally, we tell the :ref:`AudioStreamPlayer <class_AudioStreamPlayer>` to play.
  369. When the :ref:`AudioStreamPlayer <class_AudioStreamPlayer>` is finished playing the sound, it will call ``destroy_self`` because
  370. we connected the ``finished`` signal in ``_ready``. We stop the :ref:`AudioStreamPlayer <class_AudioStreamPlayer>` and free the audio player
  371. to save on resources.
  372. .. note:: This system is extremely simple and has some major flaws:
  373. One flaw is we have to pass in a string value to play a sound. While it is relatively simple
  374. to remember the names of the three sounds, it can be increasingly complex when you have more sounds.
  375. Ideally, we'd place these sounds in some sort of container with exposed variables so we do not have
  376. to remember the name(s) of each sound effect we want to play.
  377. Another flaw is we cannot play looping sounds effects, nor background music, easily with this system.
  378. Because we cannot play looping sounds, certain effects, like footstep sounds, are harder to accomplish
  379. because we then have to keep track of whether or not there is a sound effect and whether or not we
  380. need to continue playing it.
  381. One of the biggest flaws with this system is we can only play sounds from ``Player.gd``.
  382. Ideally we'd like to be able to play sounds from any script at any time.
  383. _________
  384. With that done, let's open up ``Player.gd`` again.
  385. First we need to load the ``Simple_Audio_Player.tscn``. Place the following code in the class variables section of the script:
  386. ::
  387. var simple_audio_player = preload("res://Simple_Audio_Player.tscn")
  388. Now we need to instance the simple audio player when we need it, and then call its
  389. ``play_sound`` function and pass the name of the sound we want to play. To make the process simpler,
  390. let's create a ``create_sound`` function in ``Player.gd``:
  391. ::
  392. func create_sound(sound_name, position=null):
  393. var audio_clone = simple_audio_player.instance()
  394. var scene_root = get_tree().root.get_children()[0]
  395. scene_root.add_child(audio_clone)
  396. audio_clone.play_sound(sound_name, position)
  397. Let's walk through what this function does:
  398. _________
  399. The first line instances the ``Simple_Audio_Player.tscn`` scene and assigns it to a variable
  400. named ``audio_clone``.
  401. The second line gets the scene root, and this has a large (though safe) assumption.
  402. We first get this node's :ref:`SceneTree <class_SceneTree>`,
  403. and then access the root node, which in this case is the :ref:`Viewport <class_Viewport>` this entire game is running under.
  404. Then we get the first child of the :ref:`Viewport <class_Viewport>`, which in our case happens to be the root node in
  405. ``Test_Area.tscn`` or any of the other provided levels. **We are making a huge assumption that the first child of the root node
  406. is the root scene that the player is under, which may not always be the case**.
  407. If this doesn't make sense to you, don't worry too much about it. The second line of code only does not work
  408. reliably if you have multiple scenes loaded as children of the root node at a time, which will rarely happen for most projects and will not be happening in this tutorial series.
  409. This is only potentially a issue depending on how you handle scene loading.
  410. The third line adds our newly created ``Simple_Audio_Player`` scene to be a child of the scene root. This
  411. works exactly the same as when we are spawning bullets.
  412. Finally, we call the ``play_sound`` function and pass in the arguments passed in to ``create_sound``. This will call
  413. ``Simple_Audio_Player.gd``'s ``play_sound`` function with the passed in arguments.
  414. _________
  415. Now all that is left is playing the sounds when we want to. Let's add sound to the pistol first!
  416. Open up ``Weapon_Pistol.gd``.
  417. Now, we want to make a noise when the player fires the pistol, so add the following to the end of the ``fire_weapon`` function:
  418. ::
  419. player_node.create_sound("Pistol_shot", self.global_transform.origin)
  420. Now when the player fires the pistol, we'll play the ``Pistol_shot`` sound.
  421. To make a sound when the player reloads, we need to add the following right under ``player_node.animation_manager.set_animation(RELOADING_ANIM_NAME)`` in the
  422. ``reload_weapon`` function:
  423. ::
  424. player_node.create_sound("Gun_cock", player_node.camera.global_transform.origin)
  425. Now when the player reloads, we'll play the ``Gun_cock`` sound.
  426. _________
  427. Now let's add sounds to the rifle.
  428. Open up ``Weapon_Rifle.gd``.
  429. To play sounds when the rifle is fired, add the following to the end of the ``fire_weapon`` function:
  430. ::
  431. player_node.create_sound("Rifle_shot", ray.global_transform.origin)
  432. Now when the player fires the rifle, we'll play the ``Rifle_shot`` sound.
  433. To make a sound when the player reloads, we need to add the following right under ``player_node.animation_manager.set_animation(RELOADING_ANIM_NAME)`` in the
  434. ``reload_weapon`` function:
  435. ::
  436. player_node.create_sound("Gun_cock", player_node.camera.global_transform.origin)
  437. Now when the player reloads, we'll play the ``Gun_cock`` sound.
  438. Final notes
  439. -----------
  440. .. image:: img/PartThreeFinished.png
  441. Now you have weapons with limited ammo that play sounds when you fire them!
  442. At this point, we have all the basics of an FPS game working.
  443. There are still a few things that would be nice to add, and we're going to add them in the next three parts!
  444. For example, right now we have no way to add ammo to our spares, so we'll eventually run out. Also, we don't
  445. have anything to shoot at outside of the :ref:`RigidBody <class_RigidBody>` nodes.
  446. In :ref:`doc_fps_tutorial_part_four` we'll add some targets to shoot at, along with some health and ammo pick ups!
  447. We're also going to add joypad support, so we can play with wired Xbox 360 controllers!
  448. .. warning:: If you ever get lost, be sure to read over the code again!
  449. You can download the finished project for this part here: :download:`Godot_FPS_Part_3.zip <files/Godot_FPS_Part_3.zip>`