💽 Vinyls

Enrich your Minecraft gameplay with custom musical discs!

🎧 Key Features

🎶 Personalized Records - Add your favorite tracks to the game and create a unique music collection.

⚡ Performance Optimization - The mod is designed to ensure stable server operation even with a large number of users.

💡 Intuitive Management - Simple commands for updating settings and giving discs to players make usage extremely convenient.

⚙ Flexible Configuration - All custom discs are managed through a clear configuration file discs.yml.

🎨 Automatic Resource Pack Generation - The system automatically generates necessary resource packs based on your settings.

🔃 Cross-Version Compatibility - Supports Minecraft versions from 1.16.5 to the latest releases.

🔌 Fabric Support - Works with Fabric starting from versions 1.20+ up to 1.21.1.

💻 Available Commands

/vinyls reload - Reloads the plugin configuration without needing to restart the server.

/vinyls give <disc_name> [player] - Grants the selected music disc to the specified player.

🔒 Permissions

vinyls.admin - Provides full access to all administrative commands of the modification.

📩 Installation Process

1. Download Vinyls - Download the current version of the mod.

2. Installation

   • Place the .jar file in your server's plugins directory
   • Example path: /plugins/Vinyls-x.x.x.jar

3. Activation

   • Restart the server to load the plugin

4. Configuration

   • Edit the discs.yml file at path plugins/Vinyls/discs.yml to add your own discs
   • Configuration example:

     
     # Root node for all custom discs. Each disc entry is located under the "discs" node
     discs:
     # Unique identifier for each disc. Make sure the identifier matches
     # the OGG and PNG files located in the source_files folder.
     # Changing this identifier after distributing items will make previously
     # issued items unusable.
     epic_disc:
     # Display name of the disc in the game. You can use color codes
     # for name styling.
     display_name: "&bMusic Disc"
     # Material type used to represent the disc in-game. "PAPER" is used here,
     # but you can choose any suitable material.
     material: "PAPER"
     # Custom model data value to distinguish this item from others
     # with the same material. Used for applying unique textures via resource pack.
     custom_model_data: 1
     # Lore provides additional context or artistic text for the disc.
     # Each line in the lore array appears as a separate line in the item's description.
     lore:

   • "&7Vinyls - Epic" # First line of description
   • "&8Epic music from Vinyls!" # Second line of description

5. Resource Pack Loading

   • Upload the generated resource pack to a file hosting service
   • Update the server.properties file: Property: resource-pack, Value: Resource pack URL Property: resource-pack-sha1, Value: Resource pack SHA1 hash Property: require-resource-pack, Value: true
   • If you already have an existing resource pack, merge it with the Vinyls resource pack

Video reviews and demonstrations of the mod's capabilities can be found on YouTube.