config.toml

# ForcePack Velocity config.
# ForcePack uses MiniMessage for message formatting.
# You can check the MiniMessage documentation for how to use it: https://docs.adventure.kyori.net/minimessage#format
# ForcePack documentation: https://fortitude.islandearth.net/category/forcepack
# Need help? Join our Discord: https://discord.gg/fh62mxU

# Whether to ignore geyser players. Only enable this if you use geyser.
geyser = false

# Whether to verify that your resource packs have the correct hash.
# May reduce startup time by disabling, but makes problems less obvious.
verify-resource-packs = true

# If we should continuously update the GUI for players <= 1.12. Prevents escaping out bypass.
update-gui = true

# The update speed of the GUI in milliseconds
update-gui-speed = 1000

# Should we forcefully send a resource pack that has an invalid size for the player's client version?
force-invalid-size = false

# If this is true, resource packs will always be sent to the player even if they already seem to have the same resource pack.
force-constant-download = false

# If this is true, a player will not be able to execute any commands until the resource pack is loaded.
disable-commands-until-loaded = false

# A list of commands that can be executed anyway if disable-commands-until-loaded is true.
exclude-commands = [
   "exampleone",
   "exampletwo",
]

# Whether to enable the bypass permission. If you disable this, all OPs will no longer be able to bypass.
# But you should really fix your permissions instead.
bypass-permission = true

# Appends the hash to your URL to fix this bug.
enable-mc-164316-fix = true

# Should we use the 1.17+ force resource pack screen, or the old one?
# You can still define a custom message that will show even if this is false for 1.17+ clients
# Note that with this true, the custom disconnect message will not work because the client forcefully kicks itself
use-new-force-pack-screen = true

# Whether to use the configuration phase.
# When enabled, players on 1.20.2+ receive and load the pack before spawning into the world instead of after joining.
use-configuration-phase = false

# Should we try and prevent hacked clients sending fake resource pack accept packets?
# Still bypassable, but some are stupid and we are able to detect them.
try-to-stop-fake-accept-hacks = true

# How many ticks to delay sending a resource pack by
# Use this if you have a plugin teleporting someone after joining which closes the resource pack screen
delay-pack-sending-by = 0

# Whether to enable debug mode. Prints some extra info.
debug = false

# This configures the web server for force pack.
# See https://fortitude.islandearth.net/forcepack/configuration#self-hosting
# Note that you can leave the IP as localhost unless it is not working, as in most cases the plugin can automatically resolve it.
# Having this enabled allows the use of the "forcepack://" protocol in resource pack URL
# Enabling this DOES NOT mean you are forced to use a localhost resource pack.
# You need to make sure the port is open. Usually you can just add it via pterodactyl panel.
[web-server]
    # Whether to enable the embedded web server. Only enable this if you want to self-host resource packs.
    enabled = false
    # Protocol defines the protocol to use on the resource pack URL sent to players (you still need to use "forcepack://" in the config urls)
    protocol = "http://"
    # The IP address to run the web server on. Leave as localhost unless it is not working.
    server-ip = "localhost"
    # The port to run the web server on. Make sure this port is open!
    port = 8080
    # port-on-url defines whether to use the port in the URL (set to false when this service is behind a web proxy)
    port-on-url = true

[unload-pack]
    # Whether to send an empty resource pack when joining a server without one configured, and the player has one applied
    enable = true
    # The URL of the unload pack
    # It's highly recommended you re-host this pack using the webserver or on a CDN such as mc-packs.net for faster load times.
    # Leaving this as default potentially sends a lot of requests to my personal web server, which isn't ideal!
    url = "https://www.convallyria.com/files/BlankPack.zip"
    # The SHA-1 hash of the unload pack file
    hash = "118AFFFC54CDCD308702F81BA24E03223F15FE5F"
    # Whether to automatically generate the SHA-1 hash.
    # The hash setting will be ignored if this is true, however it will fall back to that if the generation fails.
    generate-hash = false
    # What servers should we exclude from unloading?
    exclude = [
        "exampleserver"
    ]

[global-pack]
    # Whether to enable a global resource pack. If a server does not have a resource pack configured, it shall use this.
    enable = false
    # The URL of the global pack
    url = "https://www.convallyria.com/files/BlankPack.zip"
    # The SHA-1 hash of the global pack file
    hash = "118AFFFC54CDCD308702F81BA24E03223F15FE5F"
    # Whether to automatically generate the SHA-1 hash. This is not recommended for security and reliability.
    # The hash setting will be ignored if this is true, however it will fall back to that if the generation fails.
    generate-hash = false
    # The prompt message for clients on 1.17+.
    resourcepack.prompt = "<yellow>Please accept our resource pack to improve your experience."
    # What servers should we exclude from the global pack?
    exclude = [
        "exampleserver"
    ]

    [global-pack.actions]
        # List of valid actions: https://jd.advntr.dev/api/4.15.0/net/kyori/adventure/resource/ResourcePackStatus.html
        [global-pack.actions.ACCEPTED]
            kick = false
            commands = []
        [global-pack.actions.DECLINED]
            kick = true
            message = "<color:#FF5555>Please accept our resource pack to play on the server!"
            commands = []
        [global-pack.actions.FAILED_DOWNLOAD]
            kick = true
            message = "<color:#FF5555>The resource pack download failed. Please try rejoining."
            commands = []
        [global-pack.actions.FAILED_RELOAD]
            kick = true
            message = "<color:#FF5555>The resource pack reload failed. Please try rejoining."
            commands = []
        [global-pack.actions.SUCCESSFUL]
            kick = false
            commands = []

# Defines groups of servers, rather than singular individual ones
[groups]
    [groups.example-group]
        # If exact-match is true, only servers exactly equal to the name will be checked
        # If false, they must only contain the keywords
        exact-match = true
        servers = [
            "example-server",
            "example-server-2"
        ]
        # The ResourcePack URL. This must be a direct URL, ending with .zip. For Dropbox URLs, add ?dl=1 to the end.
        resourcepack.url = "https://www.convallyria.com/files/BlankPack.zip"
        # Whether to automatically generate the SHA-1 hash. This is not recommended for security and reliability.
        # The hash setting will be ignored if this is true, however it will fall back to that if the generation fails.
        resourcepack.generate-hash = false
        # Use a site such as http://onlinemd5.com/ or the hash provided when uploading to https://mc-packs.net/.
        resourcepack.hash = "118AFFFC54CDCD308702F81BA24E03223F15FE5F"
        # The prompt message for clients on 1.17+.
        resourcepack.prompt = "<yellow>Please accept our resource pack to improve your experience."
        [groups.example-group.actions]
            # List of valid actions: https://jd.advntr.dev/api/4.15.0/net/kyori/adventure/resource/ResourcePackStatus.html
            [groups.example-group.actions.ACCEPTED]
                kick = false
                commands = []
            [groups.example-group.actions.DECLINED]
                kick = true
                message = "<color:#FF5555>Please accept our resource pack to play on the server!"
                commands = []
            [groups.example-group.actions.FAILED_DOWNLOAD]
                kick = true
                message = "<color:#FF5555>The resource pack download failed. Please try rejoining."
                commands = []
            [groups.example-group.actions.FAILED_RELOAD]
                kick = true
                message = "<color:#FF5555>The resource pack reload failed. Please try rejoining."
                commands = []
            [groups.example-group.actions.SUCCESSFUL]
                kick = false
                commands = []

[servers]
    # You can specify any server name here that is configured in velocity.
    [servers.example-server]
        # The ResourcePack URL. This must be a direct URL, ending with .zip. For Dropbox URLs, add ?dl=1 to the end.
        # To host a local file on the embedded webserver, change this to the relative path of the force pack folder prefixed by "forcepack://".
        # For example, placing your resource pack as "plugins/ForcePack/pack.zip", the url will just be "forcepack://pack.zip".
        # ONLY PLAYERS ON 1.20.3+ CAN RECEIVE MULTIPLE RESOURCE PACKS. The first URL/Hash pair will be taken for older client versions.
        # URLs list and hashes list MUST BE THE SAME SIZE if generate-hash is disabled.
        resourcepack.urls = ["https://www.convallyria.com/files/BlankPack.zip"]
        # Whether to automatically generate the SHA-1 hash. This is not recommended for security and reliability.
        # The hash setting will be ignored if this is true, however it will fall back to that if the generation fails.
        resourcepack.generate-hash = false
        # See https://fortitude.islandearth.net/forcepack/configuration#getting-the-sha-1-hash-of-a-resource-pack
        resourcepack.hashes = ["118AFFFC54CDCD308702F81BA24E03223F15FE5F"]
        # The prompt message for clients on 1.17+.
        resourcepack.prompt = "<yellow>Please accept our resource pack to improve your experience."
        [servers.example-server.actions]
            # List of valid actions: https://jd.advntr.dev/api/4.15.0/net/kyori/adventure/resource/ResourcePackStatus.html
            [servers.example-server.actions.ACCEPTED]
                kick = false
                commands = []
            [servers.example-server.actions.DECLINED]
                kick = true
                message = "<color:#FF5555>Please accept our resource pack to play on the server!"
                commands = []
            [servers.example-server.actions.FAILED_DOWNLOAD]
                kick = true
                message = "<color:#FF5555>The ResourcePack download failed. Please try rejoining."
                commands = []
            [servers.example-server.actions.FAILED_RELOAD]
                kick = true
                message = "<color:#FF5555>The resource pack reload failed. Please try rejoining."
                commands = []
            [servers.example-server.actions.SUCCESSFUL]
                kick = false
                commands = []
        # Here you can specify a pack format version-specific resource pack.
        # Note that the "all" section above must be kept as a fallback.
        # You can do the same thing in the global resource pack and resource pack groups.
        # See https://minecraft.wiki/w/Pack_format.
        # 222 is an example number.
        #[servers.example-server.version.222]
        #    resourcepack.url = "https://www.convallyria.com/files/BlankPack.zip"
        #    resourcepack.generate-hash = false
        #    resourcepack.hash = "118AFFFC54CDCD308702F81BA24E03223F15FE5F"
        #    resourcepack.prompt = "<yellow>Please accept our resource pack to improve your experience."