Fabric Wiki

User Tools

Site Tools

Trace: • 注册表介绍
tutorial:sounds

Differences

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

Link to this comparison view

Next revision		Previous revision
tutorial:sounds [2019/08/01 20:26] – created fudgetutorial:sounds [2024/06/23 16:23] (current) – slainlight
Line 1: Line 1:
 ====== Playing Sounds ====== ====== Playing Sounds ======
-Ready to replace those zombie sounds with your own cool sounds? You've come to the right place.   +Ready to replace those zombie sounds with your own sounds? You've come to the right place.   
  
 ===== Playing a pre-existing sound ===== ===== Playing a pre-existing sound =====
-Playing a pre-exisiting is fairly simple. Make sure you are on the logical server and call ''world.playSound'' like so:+Playing a pre-exisiting sound is fairly simple. Make sure you are on the logical server and call ''world.playSound'' like so:
 <code java> <code java>
 if (!world.isClient) { if (!world.isClient) {
       world.playSound(       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               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.               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> </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> <code java>
 public class ExampleBlock extends Block { public class ExampleBlock extends Block {
-    ...+    [...] 
 +    
     @Override     @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) {         if (!world.isClient) {
             world.playSound(null, blockPos, SoundEvents.BLOCK_ANVIL_LAND, SoundCategory.BLOCKS, 1f, 1f);             world.playSound(null, blockPos, SoundEvents.BLOCK_ANVIL_LAND, SoundCategory.BLOCKS, 1f, 1f);
Line 37: Line 38:
 To play a sound, you first need a sound file. Minecraft uses the ''.ogg'' file format for those.  To play a sound, you first need a sound file. Minecraft uses the ''.ogg'' file format for those. 
 If your sound file is in a different format (like the one in the provided link), you can use an online converter to convert from your format to ''.ogg''.  If your sound file is in a different format (like the one in the provided link), you can use an online converter to convert from your format to ''.ogg''. 
-Now put your .ogg file in the ''resources/assets/modid/sounds'' folder. In the example case the file will be ''resources/assets/tutorial/sounds/my_sound.ogg''.+Make sure your sound has only one channel, otherwise the attenuation effect (gradual loss of volume with distance) won't be applied to it.   
 +Now put your .ogg file in the ''resources/assets/modid/sounds'' folder. In the example case the file will be ''resources/assets/tutorial/sounds/my_sound.ogg''.  
 ==== Step 2: Add a sounds.json file, or add to it if you already have one ==== ==== Step 2: Add a sounds.json file, or add to it if you already have one ====
 Under ''resources/assets/modid'' add a new file named ''sounds.json'', if you do not have one yet. Under ''resources/assets/modid'' add a new file named ''sounds.json'', if you do not have one yet.
Line 50: Line 52:
 } }
 </code> </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> <code javascript resources/assets/tutorial/sounds.json>
 { {
   "my_sound": {   "my_sound": {
-    "category": "my_sounds", +    "subtitle": "subtitles.tutorial.my_sound",
-    "subtitle": "*punch*",+
     "sounds": [     "sounds": [
       "tutorial:my_sound"       "tutorial:my_sound"
Line 62: Line 63:
 } }
 </code> </code>
 +
 +See the [[https://minecraft.gamepedia.com/Sounds.json|Minecraft Wiki]] for more details about ''sounds.json''.
 ==== Step 3: Create your sound event ==== ==== Step 3: Create your sound event ====
 Simply create a new instance of ''SoundEvent'' with the identifier ''modid:sound_name'', for example: Simply create a new instance of ''SoundEvent'' with the identifier ''modid:sound_name'', for example:
 <code java> <code java>
 public class ExampleMod { public class ExampleMod {
-    ... +    [...] 
-    public static SoundEvent MY_SOUND_EVENT = new SoundEvent(new Identifier("tutorial:my_sound"));+    public static final Identifier MY_SOUND_ID = Identifier.of("tutorial:my_sound"); 
 +    public static SoundEvent MY_SOUND_EVENT = SoundEvent.of(MY_SOUND_ID);
 } }
 </code> </code>
 +If you're using version 1.19.2 or below, please replace ''SoundEvent.of'' with ''new SoundEvent'', and 
 +if you're using versions below 1.21, replace ''Identifier.of'' with ''new Identifier''。 
 ==== Step 4: Register your sound event ==== ==== Step 4: Register your sound event ====
 Register your sound event under the ''SOUND_EVENT'' registry: Register your sound event under the ''SOUND_EVENT'' registry:
Line 75: Line 81:
 @Override @Override
 public void onInitialize(){ public void onInitialize(){
-     ... +     [...] 
-     Registry.register(Registry.SOUND_EVENT, MY_SOUND_EVENT.getId(), MY_SOUND_EVENT);+     Registry.register(Registries.SOUND_EVENT, ExampleMod.MY_SOUND_ID, MY_SOUND_EVENT);
 }  } 
 </code> </code>
 +If you're using version 1.19.2 or below, please replace ''Registries'' with ''Registry''。
 ==== Step 5: Use your sound event ==== ==== 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> <code java>
 public class ExampleBlock extends Block { public class ExampleBlock extends Block {
     @Override     @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) {         if (!world.isClient) {
             world.playSound(             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                     blockPos, // The position of where the sound will come from
                     ExampleMod.MY_SOUND_EVENT, // The sound that will play                     ExampleMod.MY_SOUND_EVENT, // The sound that will play
Line 99: Line 106:
 } }
 </code> </code>
-You should now here a punch sound when you right click your block!+You should now hear a punch sound when you right click your block!
 ==== Troubleshooting ==== ==== Troubleshooting ====
 Don't hear anything? Try: Don't hear anything? Try:
   * Turning up your in-game volume sliders.   * Turning up your in-game volume sliders.
   * Deleting the output directory.    * Deleting the output directory. 
tutorial/sounds.1564691187.txt.gz · Last modified: 2019/08/01 20:26 by fudge