The Gamepedia and Fandom account systems have now been merged. If your username is incorrect, you have accounts on both platforms that weren't merged, or you have trouble signing in, please submit a support ticket.

Tutorials/Sound directory

From Minecraft Wiki
Jump to: navigation, search

This tutorial will help you locate the sound directory, where the sounds for Java Edition are stored.

Sound directory (after 1.7.2)[edit]

The sound file for versions after 1.7.2 is located in the indexes directory:

1.8 macOS: ~/Library/Application Support/minecraft/assets/indexes/1.8.json

1.11 macOS: ~/Library/Application Support/minecraft/assets/indexes/1.11.json

The sound files in version 1.7.2 (specifically 13w42a) and above are scattered and hashed into different folders, which are located in:

  • Windows: %AppData%\.minecraft\assets\objects
  • macOS: ~/Library/Application Support/minecraft/assets/objects
  • Linux: ~/.minecraft/assets/objects

Locating specific sound files[edit]

Find the folder indexes, which is found under the same assets folder as objects, where the sound files are indexed and logged in the sounds.json file. Select the version you want and open the sounds.json file with a program that supports it, such as Notepad. Programs such as Notepad++ are recommended to help make the file more readable. Once opened, you may find something that looks like this:

"sounds/music/menu/menu1.ogg": {
    "hash": "c157c56846f0e50620f808fecd9d069423dd6c41",
    "size": 1744657
},

From this, we can determine that menu1.ogg is hashed (or labeled) as c157c56846f0e50620f808fecd9d069423dd6c41. Perform a search in the directory objects under assets and you should find a file with the same exact string; this is the file "menu1.ogg", one of the pieces of music that plays on the menu screen. The first two letters of the file name ("c1") will match the folder that the file is in as well; knowing this can help locate specific files faster.

After locating the file, you can test it to make sure it is the right one by playing it with a media player that is able to play .ogg sound files. If the media player you have cannot play the file, try renaming it with ".ogg" at the end. If this fails too, then it either means the media player you use does not have proper .ogg extension to play the sound, or the file you found is not a sound file.

Note: If you accidentally edit or remove the file from the original directory, the launcher will automatically re-download it again the next time you launch the game. (You must be connected to the Internet when you launch the game. If not, then the sound directory will not be reset and could potentially lead to errors.)

Extracting Minecraft Sounds using Python[edit]

 1 import json, os, platform, shutil, sys
 2 
 3 ''' 
 4     Copies audio files from indescript hashed folders to named sorted folders.
 5     You may need to change output path.
 6 '''
 7 
 8 # This section should work on any system as well
 9 print("Your OS is " + platform.system())
10 if platform.system() == "Windows":
11     MC_ASSETS = os.path.expandvars(r"%APPDATA%/.minecraft/assets")
12 else:
13     MC_ASSETS = os.path.expanduser(r"~/.minecraft/assets")
14 
15 # Find the latest installed version of minecraft (choose the last element in assets/indexes)
16 MC_VERSION = os.listdir(MC_ASSETS+"/indexes/")[-1]
17 print("Your latest installed version of minecraft is " + MC_VERSION[:-5] + "\n")
18 
19 # Change this if you want to put the sound files somewhere else
20 OUTPUT_PATH = os.path.normpath(os.path.expandvars(os.path.expanduser(f"~/Desktop/MC_Sounds/")))
21 
22 # These are unlikely to change
23 MC_OBJECT_INDEX = f"{MC_ASSETS}/indexes/{MC_VERSION}"
24 MC_OBJECTS_PATH = f"{MC_ASSETS}/objects"
25 MC_SOUNDS = r"minecraft/sounds/"
26 
27 
28 with open(MC_OBJECT_INDEX, "r") as read_file:
29     # Parse the JSON file into a dictionary
30     data = json.load(read_file)
31 
32     # Find each line with MC_SOUNDS prefix, remove the prefix and keep the rest of the path and the hash
33     sounds = {k[len(MC_SOUNDS):] : v["hash"] for (k, v) in data["objects"].items() if k.startswith(MC_SOUNDS)}
34 
35     print("File extraction :")
36 
37     for fpath, fhash in sounds.items():
38         # Ensure the paths are good to go for Windows with properly escaped backslashes in the string
39         src_fpath = os.path.normpath(f"{MC_OBJECTS_PATH}/{fhash[:2]}/{fhash}")
40         dest_fpath = os.path.normpath(f"{OUTPUT_PATH}/sounds/{fpath}")
41 
42         # Print current extracted file
43         print(fpath)
44 
45         # Make any directories needed to put the output file into as Python expects
46         os.makedirs(os.path.dirname(dest_fpath), exist_ok=True)
47 
48         # Copy the file
49         shutil.copyfile(src_fpath, dest_fpath)

Extracting Minecraft Music On Windows (via Windows Subsystem for Linux)[edit]

  1. Create a new file (for example from the terminal): vi minecraft-music-extractor.sh
  2. Paste the following into the file: (when you run the file, it'll ask you what your Windows username is and Minecraft version, the rest is automatic, and outputs to the desktop)
  3. Update the variables (e.g. MINECRAFT_ASSETS_DIR) with your correct directory paths
  4. If you want all sounds, replace "grep sounds" with "grep music", part of which is shown as commented code.
  5. Run the script from terminal with "bash minecraft-music-extractor.sh".
 1 #!/bin/bash
 2 #
 3 # Description: Minecraft Music Extractor
 4 
 5 echo -e "Enter your Windows username:"
 6 read winusername
 7 echo
 8 
 9 USER_DIR="/mnt/c/Users/$winusername"
10 
11 # Windows Profile doesn't exist = Can't run
12 if [ ! $(ls /mnt/c/Users/ | grep $winusername) ]; then
13 	echo -e "Unable to run, you entered an invalid user."
14 	echo -e "Make sure you entered everything correctly, spelled right with caps and lower case.\n"
15 	read -p "Press [Enter] key to continue..." && exit
16 fi
17 
18 MINECRAFT_ASSETS_DIR="$USER_DIR/AppData/Roaming/.minecraft/assets"
19 OUTPUT_DIR="$USER_DIR/Desktop"
20 
21 echo -e "Enter the Minecraft version you want to extract from:"
22 read version
23 echo
24 
25 JSON_FILE=$(echo $MINECRAFT_ASSETS_DIR/indexes/$version.json | grep "/")
26 
27 # Version doesn't exist = Can't run
28 if [ ! -f $JSON_FILE ]; then
29 	echo -e "Unable to extract because that version isn't downloaded or doesn't exist."
30 	echo -e "Make sure to open the launcher and download the version you need to create a pack for.\n"
31 	read -p "Press [Enter] key to continue..." && exit
32 fi
33 
34 # for ENTRY in `cat "$JSON_FILE" | python -c 'import sys,json; from pprint import pprint; data = json.load(sys.stdin); pprint(data);' | grep music | awk -F\' '{print $2 "," $6}'`
35 # cat "$JSON_FILE" | python -c 'import sys,json; from pprint import pprint; data = json.load(sys.stdin); pprint(data);'
36 # cat "$JSON_FILE" | python -c 'import sys,json; from pprint import pprint; data = json.load(sys.stdin); pprint(data);' | grep music
37 
38 for ENTRY in `cat "$JSON_FILE" | python -c 'import sys,json; from pprint import pprint; data = json.load(sys.stdin); pprint(data);' | grep sounds | awk -F\' '{print $2 "," $6}'`
39 do
40 	echo "Processing $ENTRY..."
41 	echo $ENTRY | cut -d, -f1
42 	FILENAME=`echo $ENTRY | cut -d, -f1`
43 	FILEHASH=`echo $ENTRY | cut -d, -f2`
44 
45 	#Locate the file in the assets directory structure
46 	FULLPATH_HASHFILE=`find "$MINECRAFT_ASSETS_DIR" -name $FILEHASH`
47 
48 	#Copy the file
49 
50 	mkdir -p  $OUTPUT_DIR/`echo $FILENAME | sed -E 's/\/[a-z0-9_]+\..+//'`
51 	cp "$FULLPATH_HASHFILE" "$OUTPUT_DIR/$FILENAME"
52 
53 done

Extracting Minecraft Music On Linux[edit]

  1. Create a new file (for example from the terminal): vi minecraft-music-extractor.sh
  2. Paste the following into the file: (when you run the file, it'll ask you what Minecraft version, the rest is automatic, and outputs to the desktop)
 1 #!/bin/bash
 2 #
 3 # Description: Minecraft Music Extractor
 4 
 5 USER_DIR=$(echo ~ | grep "/")
 6 MINECRAFT_ASSETS_DIR="$USER_DIR/.minecraft/assets"
 7 OUTPUT_DIR="$USER_DIR/Desktop"
 8 
 9 echo -e "Enter the Minecraft version you want to extract from:"
10 read version
11 echo
12 
13 JSON_FILE="$MINECRAFT_ASSETS_DIR/indexes/$version.json"
14 
15 # Version doesn't exist = Can't run
16 if [ ! -f $JSON_FILE ]; then
17 	echo -e "Unable to extract because that version isn't downloaded or doesn't exist."
18 	echo -e "Make sure to open the launcher and download the version you need to create a pack for.\n"
19 	read -p "Press [Enter] key to continue..." && exit
20 fi
21 
22 #for ENTRY in `cat "$JSON_FILE" | python -c 'import sys,json; from pprint import pprint; data = json.load(sys.stdin); pprint(data);' | grep music | awk -F\' '{print $2 "," $6}'`
23 #cat "$JSON_FILE" | python -c 'import sys,json; from pprint import pprint; data = json.load(sys.stdin); pprint(data);'
24 #cat "$JSON_FILE" | python -c 'import sys,json; from pprint import pprint; data = json.load(sys.stdin); pprint(data);' | grep music
25 
26 
27 for ENTRY in `cat "$JSON_FILE" | python -c 'import sys,json; from pprint import pprint; data = json.load(sys.stdin); pprint(data);' | grep sounds | awk -F\' '{print $2 "," $6}'`
28 do
29 	echo "Processing $ENTRY..."
30 	echo $ENTRY | cut -d, -f1
31 	FILENAME=`echo $ENTRY | cut -d, -f1`
32 	FILEHASH=`echo $ENTRY | cut -d, -f2`
33 
34 	#Locate the file in the assets directory structure
35 	FULLPATH_HASHFILE=`find "$MINECRAFT_ASSETS_DIR" -name $FILEHASH`
36 
37 	#Copy the file
38 
39 	mkdir -p  $OUTPUT_DIR/`echo $FILENAME | sed -E 's/\/[a-z0-9_]+\..+//'`
40 	cp "$FULLPATH_HASHFILE" "$OUTPUT_DIR/$FILENAME"
41 
42 done
  1. If you want all sounds, replace "grep music" with "grep sounds".
  2. You may need to run `chmod u+x minecraft-music-extractor.sh` if the script isn't executing.
  3. Run the script from terminal with "./minecraft-music-extractor.sh".

Extracting Minecraft Music On Mac[edit]

  1. Create a new file (for example from the terminal): vi minecraft-music-extractor.sh
  2. Paste the following into the file:
 1 #!/bin/sh
 2 #
 3 # Description: Minecraft Music Extractor
 4 
 5 MINECRAFT_ASSETS_DIR="/Users/YOURUSERNAMEHERE/Library/Application Support/minecraft/assets"
 6 OUTPUT_DIR="/Users/YOURUSERNAMEHERE/Desktop"
 7 JSON_FILE="/Users/YOURUSERNAMEHERE/Library/Application Support/minecraft/assets/indexes/YOURJSON.json"
 8 
 9 #for ENTRY in `cat "$JSON_FILE" | python -c 'import sys,json; from pprint import pprint; data = json.load(sys.stdin); pprint(data);' | grep music | awk -F\' '{print $2 "," $6}'`
10 #cat "$JSON_FILE" | python -c 'import sys,json; from pprint import pprint; data = json.load(sys.stdin); pprint(data);'
11 #cat "$JSON_FILE" | python -c 'import sys,json; from pprint import pprint; data = json.load(sys.stdin); pprint(data);' | grep music
12 
13 
14 for ENTRY in `cat "$JSON_FILE" | python -c 'import sys,json; from pprint import pprint; data = json.load(sys.stdin); pprint(data);' | grep sounds | awk -F\' '{print $2 "," $6}'`
15 do
16   echo "Processing $ENTRY..."
17   echo $ENTRY | cut -d, -f1 
18   FILENAME=`echo $ENTRY | cut -d, -f1`
19   FILEHASH=`echo $ENTRY | cut -d, -f2`
20 
21   #Locate the file in the assets directory structure
22   FULLPATH_HASHFILE=`find "$MINECRAFT_ASSETS_DIR" -name $FILEHASH`
23 
24   #Copy the file
25 
26   mkdir -p  $OUTPUT_DIR/`echo $FILENAME | sed -E 's/\/[a-z0-9_]+\..+//'`
27   cp "$FULLPATH_HASHFILE" "$OUTPUT_DIR/$FILENAME"
28 
29 done
  1. Update the variables (e.g. MINECRAFT_ASSETS_DIR) with your correct directory paths
  2. If you want all sounds, replace "grep music" with "grep sounds".
  3. Run the script from terminal with "bash minecraft-music-extractor.sh".

Old sound directory (pre-1.7)[edit]

If you play the game before 1.7.2, the sound directory is located as follows:

  • Windows: %AppData%\.minecraft\assets or %AppData%\.minecraft\assets\virtual\legacy
  • macOS: ~/Library/Application Support/minecraft/assets
  • Linux: ~/.minecraft/assets

If you have played both the old and new versions, then both the old and new directories will exist in the game files. The old directory is only used for pre-1.7 versions.

Legacy sub-folders[edit]

In .minecraft\assets\virtual\legacy\sounds, there are 13 sub folders:

  • ambient: Ambiance and rain/thunder
  • damage: Sounds of the player taking damage
  • dig: Breaking blocks
  • fire: Fire sounds
  • firework: Fireworks sound effects
  • liquids: Sounds made by liquids such as water and lava
  • minecart: Sounds created by moving minecarts
  • mob: Mob sounds
  • music: Background music by C418
  • random: Various sound effects from eating to explosions
  • records: Music on the record discs found
  • step: Footsteps
  • tile: Pistons

Warning[edit]

If you edit, add, or remove sounds directly in the sound directory, executing the launcher and then launching Minecraft while connected to the Internet will automatically re-download and revert any changes you've made to the sound directory, deleting your work. This applies for both the new and old sound directories. Disconnecting from the Internet before launching the game will not revert the files, but this is not recommended. The best method to safely store custom sounds is to create your own resource pack.

Video tutorials[edit]

Minecraft Tutorial: Locate the Minecraft Sound Directory and Convert Audio Files (Old sound directory only)

See also[edit]