FUCK-CustomDiscs/readme.md

FUCK Custom Discs | v5.0.1 for Paper and forks 1.21.7 / 1.21.8

Custom Discs with removed version and core checking

• Play custom music discs, goat horns and player heads using the Simple Voice Chat API. (The voice chat mod is required on the client and server.)
• Use /customdisc or /cd to view available commands.
• Music files should go into plugins/CustomDiscs/musicdata/
• Music files must be in the .wav, .flac, or .mp3 format.

Downloading Files:

• To download a file use the command /cd download <url> <filename.extension>.
  • The link used to download a file must be a direct link (meaning the file must automatically begin downloading when accessing the link).
  • Files must have the correct extension specified.
  • An UnsupportedAudioFileException will be thrown in the server's console if the file extension is not correct (for example when giving a wav file the mp3 extension).
  • Below is an example of how to use the command and a link to get direct downloads from Google Drive.
    • Example: /cd download "https://example.com/mysong" mysong.mp3
    • To note : Do not forget to use quotes (") for the URL. Without this, you'll get a command error.
• Direct Google Drive links: https://lonedev6.github.io/gddl/

Set the range of a disc:

• To set the active range of a playable disc, just use the command /cd range <range>.
  • The range can be between 1 and the max value set in the config file (default : 256)
• Example: /cd range 100

Permission Nodes (Required to run the commands. Playing discs does not require a permission.):

• customdiscs.create to create a disc
• customdiscs.download to download a file
• customdiscs.range to set the range of the disc
• customdiscs.horncooldown to set the cooldown (in ticks) for custom goat horns

Dependencies:

• This plugin depends on the latest version of ProtocolLib available for your Paper version and SimpleVoiceChatBukkit (latest is recommended - at least version 2.5.31 required).

https://user-images.githubusercontent.com/64107368/178426026-c454ac66-5133-4f3a-9af9-7f674e022423.mp4

Default Config.yml:

# [General CustomDiscs Config]

# The maximum download size in megabytes.
max-download-size: 50

# The master volume of music discs from 0-1. (You can set values like 0.5 for 50% volume).
music-disc-volume: 1

# Debug Mode - To display some more logging information and Stack Trace informations
debugMode: false

# [Music Discs Config]

# Enable custom music discs.
music-disc-enable: true

# Enable "Now playing" message for custom music discs.
music-disc-playing-enable: true

# The distance from which music discs can be heard in blocks.
music-disc-distance: 16

# The max distance from which music discs can be heard in blocks.
music-disc-max-distance: 256

# [Goat Horns Config]

# Enable custom goat horns.
custom-horn-enable: true

# Enable "Now playing" message for custom horns.
custom-horn-playing-enable: true

# The distance from which custom horns can be heard in blocks.
custom-horn-distance: 16

# The max distance from which custom horns can be heard in blocks.
custom-horn-max-distance: 256

# The default cooldown time for horns in ticks from 1 to the max value of horn-max-cooldown (1 second is 20 ticks).
horn-cooldown: 140

# The default max cooldown time for horns in ticks (1 second is 20 ticks).
horn-max-cooldown: 6000

# [Player Heads Config]

# Enable custom player heads.
custom-head-enable: true

# Enable "Now playing" message for player heads.
custom-head-playing-enable: true

# The distance from which music discs can be heard in blocks.
custom-head-distance: 16

# The max distance from which music discs can be heard in blocks.
custom-head-max-distance: 256


# [DO NOT EDIT BELOW THIS LINE - Help configuration]
# Custom Discs Help Page
help:
  - "&8-[&6CustomDiscs v5.0 - Help Page&8]-"
  - "&aAuthor&7: &6Navoei"
  - "&aContributors&7: &6Athar42 / &6alfw"
  - "&fGit&0Hub&7: &9&ohttps://github.com/Navoei/CustomDiscs"
  - "&aDiscord&7: &9&ohttps://discord.gg/YJpqruvZ97"

Default Lang.yml:

prefix: '&8[&6CustomDiscs&8]&r'
invalid-filename: '&cThis is an invalid filename!'
invalid-format: '&cFile must be in wav, flac, or mp3 format!'
file-not-found: '&cFile not found!'
not-holding-correct-item: '&cYou must either hold a disc, goat horn or player head in your main hand.'
create-filename: '&7Your filename is: &a"%filename%".'
create-custom-name: '&7Your custom name is: &a"%custom_name%".'
downloading-file: '&7Downloading file...'
file-too-large: '&cThe file is larger than %max_download_size%MB.'
successful-download: '&aFile successfully downloaded to &7%file_path%&a.'
create-disc: '&aCreate a disc by doing &7/cd create %filename% "Custom Lore"&a.'
download-error: '&cAn error has occurred while downloading.'
now-playing: '&6Now playing: %song_name%'
disc-converted: '&aConverted disc to new format! &fThis is due to changes in newer Minecraft versions which introduced &7ToolTipDisplay&f.'
invalid-range: '&cYou need to chose a range between 1 and %range_value%'
create-custom-range: '&7Your range is set to: &a"%custom_range%".'
not-holding-custom-goathorn: '&cYou must hold a custom goat horn in your main hand.'
invalid-cooldown: '&cYou need to chose a cooldown between 1 and %cooldown_value% (in ticks).'
create-custom-goat-cooldown: '&7Your goat horn cooldown is set to: &a"%custom_goat_cooldown%" ticks.'
custom-music-disabled: '&7Custom music discs are disabled in the configuration.'
custom-head-disabled: '&7Custom player heads are disabled in the configuration.'
custom-horn-disabled: '&7Custom goat horns are disabled in the configuration.'