# Velocitypacker<\/p>\n
\n
\n<\/p>\n
A Velocity plugin that automatically sends resource packs to players and stores their acceptance status in a SQLite database.<\/p>\n
## \u2728 Features<\/p>\n
– \ud83d\udd04 **Automatic Resource Pack Sending** – Pack is sent on every proxy join
\n– \ud83d\udcca **SQLite Database** – Persistent storage of acceptance status
\n– \ud83d\udeab **Smart Blocking** – Players cannot connect to servers until pack is accepted\/declined
\n– \u26a1 **Auto-Connect** – Automatic connection to first server after successful acceptance
\n– \ud83d\udd12 **Session Management** – No re-sending when switching between backend servers
\n– \ud83c\udf9b\ufe0f **YAML Configuration** – Easy customization of all settings
\n– \ud83d\udccb **Detailed Logs** – Comprehensive information about pack status<\/p>\n
## \ud83d\ude80 Installation<\/p>\n
### 1. Download Plugin
\n“`bash
\n# Clone repository
\ngit clone https:\/\/github.com\/TheLion102009\/Velocitypacker.git
\ncd Velocitypacker<\/p>\n
# Build plugin
\n.\/gradlew clean shadowJar
\n“`<\/p>\n
### 2. Install JAR
\nYou can find the compiled JAR in `build\/libs\/Velocitypacker-0.1.jar`.<\/p>\n
Copy this file to the `plugins\/` folder of your Velocity server.<\/p>\n
### 3. Start Server
\nRestart your Velocity server. The configuration file will be created automatically.<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
The `config.yml` is automatically created in the `plugins\/velocitypacker\/` folder:<\/p>\n
“`yaml
\n# Resource pack URL (REQUIRED)
\n# Must be a direct download URL to a .zip file
\nresourcePackUrl: https:\/\/example.com\/resourcepack.zip<\/p>\n
# SHA-1 hash of the resource pack (OPTIONAL)
\n# Format: 40 hexadecimal characters (e.g. a1b2c3d4e5f6…)
\n# Leave empty if you don’t want to use a hash
\nresourcePackSha1: “”<\/p>\n
# Message shown to the player
\n# Supports Minecraft color codes with \u00a7
\nresourcePackPrompt: “\u00a7aPlease accept the resource pack to play!”<\/p>\n
# Kick player if the resource pack is declined
\nkickOnDecline: true<\/p>\n
# Kick player if the download fails
\nkickOnFailedDownload: true<\/p>\n
# Kick message (supports color codes with \u00a7)
\nkickMessage: “\u00a7cYou must accept the resource pack to play!”
\n“`<\/p>\n
### Generate SHA-1 Hash<\/p>\n
**Windows:**
\n“`powershell
\ncertutil -hashfile resourcepack.zip SHA1
\n“`<\/p>\n
**Linux\/Mac:**
\n“`bash
\nsha1sum resourcepack.zip
\n“`<\/p>\n
## \ud83d\udd27 How It Works<\/p>\n
### Player Join Process:
\n1. **Player connects to proxy** \u2192 Resource pack is sent immediately
\n2. **Server connection blocked** \u2192 Player stays in resource pack screen
\n3. **Pack accepted** \u2192 Automatic connection to first available server
\n4. **Pack declined** \u2192 Player is kicked (if configured)<\/p>\n
### Server Switch Process:
\n– **Backend server switch** \u2192 No re-sending (stored in session)
\n– **Proxy rejoin** \u2192 Pack is sent again (new session)<\/p>\n
### Database:
\n– **Location**: `plugins\/velocitypacker\/resourcepack.db`
\n– **Stored data**: UUID, acceptance status, timestamp<\/p>\n
## \ud83d\udccb Logs<\/p>\n
The plugin provides detailed logs:<\/p>\n
“`
\n[INFO] Initializing Velocitypacker…
\n[INFO] Configuration loaded
\n[INFO] Database initialized
\n[INFO] Event listener registered
\n[INFO] Sent resource pack to player Spieler123
\n[INFO] Player Spieler123 successfully downloaded the resource pack
\n[INFO] Connecting Spieler123 to lobby
\n“`<\/p>\n
## \ud83d\udee0\ufe0f Technical Details<\/p>\n
– **Velocity API**: 3.4.0-SNAPSHOT
\n– **Kotlin**: 2.0.20-Beta1
\n– **SQLite**: 3.45.0.0
\n– **SnakeYAML**: 2.2
\n– **Shadow Plugin**: For dependency bundling<\/p>\n
## \ud83c\udfd7\ufe0f Build<\/p>\n
“`bash
\n# Full build with all dependencies
\n.\/gradlew clean shadowJar<\/p>\n
# Compile only (without Shadow)
\n.\/gradlew build
\n“`<\/p>\n
The final JAR is approximately **16 MB** in size and contains all necessary dependencies.<\/p>\n
## \ud83d\udcdd Important Notes<\/p>\n
– **Resource Pack URL**: Must be a direct `.zip` download URL
\n– **No Server Switch Blocks**: Players can freely switch between backend servers
\n– **Session Cleanup**: Data is automatically cleaned up on disconnect
\n– **Database Backup**: SQLite file can be easily copied\/backed up<\/p>\n
## \ud83d\udc1b Troubleshooting<\/p>\n
### Plugin doesn’t load
\n– Make sure Velocity 3.4.0-SNAPSHOT is running
\n– Check if all dependencies are correctly bundled<\/p>\n
### Resource pack is not sent
\n– Check the `resourcePackUrl` in the configuration
\n– Make sure the URL is accessible<\/p>\n
### Players are not forwarded
\n– Check the server logs for errors
\n– Make sure backend servers are available<\/p>\n
## \ud83d\udcdc License<\/p>\n
Created by **thelion**<\/p>\n
## \ud83e\udd1d Support<\/p>\n
For questions or problems:
\n– Create an issue in the GitHub repository
\n– Check the logs for error messages
\n– Make sure all dependencies are correctly installed<\/p>\n
—<\/p>\n
**Good luck with your Velocitypacker plugin! \ud83c\udfae**<\/p>\n","protected":false},"excerpt":{"rendered":"
A easy plugin to send onetime a resourcepack over a proxy for velocity<\/p>\n","protected":false},"featured_media":165604,"template":"","meta":{"_minecraft_slug":"velocitypacker","_minecraft_project_id":"R3rhO91e","_minecraft_author":"TheLion102009","_minecraft_license":"MIT","_minecraft_downloads":76,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"velocitypacker.zip","_minecraft_size_bytes":30983881,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T20:18:06.595258Z","_minecraft_date_created":"2025-10-11T06:06:00.049481Z","_minecraft_date_modified":"2025-10-22T19:30:36.395073Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/velocitypacker","_minecraft_icon_attachment_id":165604,"_minecraft_imported_at":"2026-06-09T17:54:25+00:00","_minecraft_import_hash":"d30ce55ea81d1a9574f51dd8d3b8e31c","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,92,985],"mod_loader":[986],"minecraft_version":[59,36,60,93,94,101,102,62,37,73,74,38,78,79,80,81,82],"class_list":["post-165603","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n