Differences

This shows you the differences between two versions of the page.

--- tutorial:sounds [2019/08/19 19:57] – [Step 2: Add a sounds.json file, or add to it if you already have one] Add reference to minecraft wiki jamieswhiteshirt
+++ tutorial:sounds [2020/05/16 19:35] – activate -> onUse yanis48
@@ Line 7: / Line 7: @@
 if (!world.isClient) {
       world.playSound(
-              null, // Player (purpose unknown, edit if you know)
+              null, // Player - if non-null, will play sound for every nearby player *except* the specified player
               blockPos, // The position of where the sound will come from
               SoundEvents.BLOCK_ANVIL_LAND, // The sound that will play, in this case, the sound the anvil plays when it lands.
@@ Line 17: / Line 17: @@
 </code>
-You can do this when the block is right clicked for example, by overriding ''activate'':
+You can do this when the block is right clicked for example, by overriding ''onUse'':
 <code java>
 public class ExampleBlock extends Block {
@@ Line 23: / Line 23: @@
     @Override
-    public boolean activate(BlockState blockState, World world, BlockPos blockPos, PlayerEntity placedBy, Hand hand, BlockHitResult blockHitResult) {
+    public ActionResult onUse(BlockState blockState, World world, BlockPos blockPos, PlayerEntity placedBy, Hand hand, BlockHitResult blockHitResult) {
         if (!world.isClient) {
             world.playSound(null, blockPos, SoundEvents.BLOCK_ANVIL_LAND, SoundCategory.BLOCKS, 1f, 1f);
@@ Line 51: / Line 51: @@
 }
 </code>
-You can also add a category and subtitle to your sound:
+You can also add a subtitle to your sound. The subtitle is a translation key, which should go in your language file.
 <code javascript resources/assets/tutorial/sounds.json>
 {
   "my_sound": {
-    "category": "my_sounds",
+    "subtitle": "subtitles.tutorial.my_sound",
-    "subtitle": "*punch*",
     "sounds": [
       "tutorial:my_sound"
@@ Line 84: / Line 83: @@
 </code>
 ==== Step 5: Use your sound event ====
-Use the sound event just like we explained at the start (''activate'' is just an example, use it anywhere you have access to ''World'' instance):
+Use the sound event just like we explained at the start (''onUse'' is just an example, use it anywhere you have access to ''World'' instance):
 <code java>
 public class ExampleBlock extends Block {
     @Override
-    public boolean activate(BlockState blockState, World world, BlockPos blockPos, PlayerEntity placedBy, Hand hand, BlockHitResult blockHitResult) {
+    public ActionResult onUse(BlockState blockState, World world, BlockPos blockPos, PlayerEntity placedBy, Hand hand, BlockHitResult blockHitResult) {
         if (!world.isClient) {
             world.playSound(
-                    null, // Player (purpose unknown, edit if you know)
+                    null, // Player - if non-null, will play sound for every nearby player *except* the specified player
                     blockPos, // The position of where the sound will come from
                     ExampleMod.MY_SOUND_EVENT, // The sound that will play