SamB440 / ForcePack

Spigot/Velocity plugin to aid resource pack deployment and enforcement, among other utilities.

ForcePack

Minecraft plugin to force players to use your server resource pack, among other utilities.

Report Bug / Feature request

Table Of Contents

• About the Project
• Features
• Getting Started
  • Prerequisites
  • Setting up
• What to do
• Contributing
• License

About The Project

ForcePack facilitates forcing users to accept your resource pack, with utilities such as live reloading, SHA-1 generation, and per-server support via velocity.

You can find the Spigot resource at: https://www.spigotmc.org/resources/forcepack.45439/

Features

• Support for 1.20.3+ multiple resource packs
• Ability to set resource packs on a per-version basis
• Local webserver resource pack hosting
• Pack unloading for Velocity sub-servers without a resource pack
• Prevents escaping out bypass for clients <= 1.12
• Run commands on pack statuses
• RGB via MiniMessage support
• Prevent failed downloads from bypassing the resource pack
• Geyser support to ignore bedrock players
• Per-client version maximum size verification
• SHA-1 and URL pack verification
• SHA-1 Auto-generation
• Per-server support on Velocity
• Live reloading with resource pack updating
• Easy to use custom force resource pack message for 1.17+ clients

Getting Started

To contribute, follow the steps below. Contributions are very welcome.

Prerequisites

• JDK 17
• Gradle
• Git, if on windows.

Setting up

Clone the repository Via IntelliJ: File > New > Project from Version Control > URL: https://github.com/SamB440/ForcePack.git > Clone

Or, via git bash:

git clone https://github.com/SamB440/ForcePack.git

To build, run the build task from IntelliJ, gradle, or gradlew.

What to do

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are greatly welcomed.

• If you have suggestions for new features or changes, feel free to open an issue to discuss it, or directly create a pull request.
• Make sure to comment your code and add javadoc headers!
• Create an individual PR for each suggestion.

Creating A Pull Request

Please be mindful that we may ask you to make changes to your pull requests.

Also, if possible, please use feature or fix branch prefixes.

License

Distributed under the GNU GPL v3 License. See LICENSE for more information.