Thanks for dowloading "Custom Music Discs" mod, version 1.7 for Minecraft 1.7.

HOW TO SET UP CUSTOM MUSIC DISCS:

Singleplayer / Client:

First install it as any Forge mod, put the jar file into .minecraft/mods.

Then create a folder named "CMD files" in your .minecraft (you can also create it in .minecraft/mods, it can be useful especially if you want to make a modpack with your musics). For each disc you want to add, put the matching sound file (ogg Vorbis file) in "CMD files". To create an ogg Vorbis file from any sound file, open it with Audacity (free software), go to file -> export as ogg Vorbis.
Every time you add or change a music, you have to launch Minecraft and get to the title screen, to complete the process. Then close and restart your game to play, otherwise the new discs won't work.

Each disc receives an icon from a vanilla disc (it's not random, it depends on the music's name, so it will always be the same icon for the same disc).
If you want a disc to have a custom icon, put the image (png file) in "CMD files". It must have the same name as the sound file. For example, an icon for "sound.ogg" shall be called "sound.png".
After adding an icon, you have to restart your game, just like when you add a new sound.

If you're not adding any new music or icon, you can disable the "update_discs_when_launching_Minecraft" option in the config file. That way, files will not be updated every time you launch the game, and you will get to the title screen a lot faster. Warning: if you add new musics or icons, you HAVE to enable the option, otherwise it won't work properly.

You can also create a text file associated with your disc (called "sound.txt" for "sound.ogg"), to configure crafts, drops and generation in dungeons. Refer to "How to configure a disc file" for more information. If you don't need any of those features for your singleplayer disc, don't create a text file.

To join a multiplayer server with Custom Music Discs:
* you NEED to have an ogg sound file for each disc configured on the server
* you CAN have custom icons for some discs, they will be used on the client side, just like a resource pack
* you DON'T NEED any text files with crafts, drops and dungeons generation configuration. If you have some, they will have no effect while you're on the server.

Server:

First install it as any Forge mod, put the jar file into the "mods" directory of your Forge server (like for Singleplayer, you can also make your "CMD files" folder in the server's mods directory).

Then create a new folder called "CMD files" in the server's main directory.

In this folder, create a text file for each one of the music discs you want to add, and name it the same as the music. You can configure crafts, drops or generation in dungeons in this text file. Refer to "How to configure a disc file" for more information. If you don't want any of those features, you still have to create a text file, otherwise the disc won't be created, so just leave the file empty.
Do not put sound files or icons on the server side, they are resources and they belong on the client side.


HOW TO CONFIGURE A DISC FILE:

You might want your disc to have a craft, to be dropped by a specific creature or found in a specific dungeon.
To do so, go to the "CMD files" you have created (in ".minecraft" for Singleplayer, or in the main directory for a server). If you're configuring a server and you have followed the set up instructions, you should already have an empty text file. If you're on Singleplayer, create a new text file named after the disc, for example "sound.txt" for "sound.ogg".
Open the text file and write as many lines as you want to configure the disc, in any order.

Adding crafts:

To add a craft for your disc, first write a "craft_start" line.
The next 9 lines represent your craft. Lines 1 to 3 represent the 3 items on the first line of the crafting grid, lines 4 to 6 are the second line of the crafting grid, and lines 7 to 9 are the last line (refer to example craft 1).
Write "craft_end" at the end.
You can use items and blocks (all the names are available on http://www.minecraftinfo.com/idlist.htm), and even mod items, if you know their name. For example, "Mocreatures:horsesaddle" refers to the crafted saddle from Mo'Creatures mod.
You don't have to write all 9 lines if your craft is smaller (refer to example craft 2).
If your craft takes only one row, it will work on any row of the crafting grid. Same goes for columns.

You can specify the needed metadata using the colon character (refer to example craft 3).
If no metadata is specified, any metadata will work for the craft.

You can add as many crafts as you want per disc, just remember to always start the recipe with "craft_start" and to end it with "craft_end"!

Adding drops:

To make a monster drop your disc, simply add this line in the text file:
drops:MonsterName:chance
For example, drops:Zombie:20 will make zombies drop your disc with a 20% chance. If you want several monsters to drop your disc, you can write several lines, for example:
drops:Zombie:20
drops:Creeper:60
drops:Skeleton:10
If you use "All" as monster name, all living mobs will drop your disc with the specified chance.
If you can't find a monster's name, look for its "Savegame ID" on http://minecraft.gamepedia.com/Data_values/Entity_IDs.

Adding dungeon generation:

To add dungeon generation for your disc, add this line to the text file:
dungeons:DungeonName:weightedProbability
For example, dungeons:villageBlacksmith:10 adds your disc to the villages chests, with a weighted chance of 10. Average item chance is between 5 and 10.
It's advised not to set too high probabilities, especially if you add a lot of discs, otherwise you will have trouble finding regular items in dungeons.
Here are the names of the dungeons:
* dungeonChest (classic dungeon made of cobblestone, with a monster spawner)
* bonusChest (optional chest that spawns next to you when you create a new world)
* villageBlacksmith
* mineshaftCorridor
* pyramidDesertyChest
* pyramidJungleChest
* strongholdCorridor
* strongholdLibrary
* strongholdCrossing

Here is an example disc file. This disc can be crafted by putting redstone or glowstone on top of a diamond in the crafting table. It has a 10% chance to be dropped when a Blaze dies, and it can be found in jungle temples.

craft_start
redstone


diamond
craft_end

craft_start
glowstone_dust


diamond
craft_end

drops:Blaze:10

dungeons:pyramidJungleChest:10