Velocitypacker

A Velocity plugin that automatically sends resource packs to players and stores their acceptance status in a SQLite database.

✨ Features

🔄 Automatic Resource Pack Sending - Pack is sent on every proxy join
📊 SQLite Database - Persistent storage of acceptance status
🚫 Smart Blocking - Players cannot connect to servers until pack is accepted/declined
⚡ Auto-Connect - Automatic connection to first server after successful acceptance
🔒 Session Management - No re-sending when switching between backend servers
🎛️ YAML Configuration - Easy customization of all settings
📋 Detailed Logs - Comprehensive information about pack status

🚀 Installation

1. Download Plugin

# Clone repository
git clone https://github.com/TheLion102009/Velocitypacker.git
cd Velocitypacker

# Build plugin
./gradlew clean shadowJar

2. Install JAR

You can find the compiled JAR in build/libs/Velocitypacker-0.1.jar.

Copy this file to the plugins/ folder of your Velocity server.

3. Start Server

Restart your Velocity server. The configuration file will be created automatically.

⚙️ Configuration

The config.yml is automatically created in the plugins/velocitypacker/ folder:

# Resource pack URL (REQUIRED)
# Must be a direct download URL to a .zip file
resourcePackUrl: https://example.com/resourcepack.zip

# SHA-1 hash of the resource pack (OPTIONAL)
# Format: 40 hexadecimal characters (e.g. a1b2c3d4e5f6...)
# Leave empty if you don't want to use a hash
resourcePackSha1: ""

# Message shown to the player
# Supports Minecraft color codes with §
resourcePackPrompt: "§aPlease accept the resource pack to play!"

# Kick player if the resource pack is declined
kickOnDecline: true

# Kick player if the download fails
kickOnFailedDownload: true

# Kick message (supports color codes with §)
kickMessage: "§cYou must accept the resource pack to play!"

Generate SHA-1 Hash

Windows:

certutil -hashfile resourcepack.zip SHA1

Linux/Mac:

sha1sum resourcepack.zip

🔧 How It Works

Player Join Process:

Player connects to proxy → Resource pack is sent immediately
Server connection blocked → Player stays in resource pack screen
Pack accepted → Automatic connection to first available server
Pack declined → Player is kicked (if configured)

Server Switch Process:

Backend server switch → No re-sending (stored in session)
Proxy rejoin → Pack is sent again (new session)

Database:

Location: plugins/velocitypacker/resourcepack.db
Stored data: UUID, acceptance status, timestamp

📋 Logs

The plugin provides detailed logs:

[INFO] Initializing Velocitypacker...
[INFO] Configuration loaded
[INFO] Database initialized
[INFO] Event listener registered
[INFO] Sent resource pack to player Spieler123
[INFO] Player Spieler123 successfully downloaded the resource pack
[INFO] Connecting Spieler123 to lobby

🛠️ Technical Details

Velocity API: 3.4.0-SNAPSHOT
Kotlin: 2.0.20-Beta1
SQLite: 3.45.0.0
SnakeYAML: 2.2
Shadow Plugin: For dependency bundling

🏗️ Build

# Full build with all dependencies
./gradlew clean shadowJar

# Compile only (without Shadow)
./gradlew build

The final JAR is approximately 16 MB in size and contains all necessary dependencies.

📝 Important Notes

Resource Pack URL: Must be a direct .zip download URL
No Server Switch Blocks: Players can freely switch between backend servers
Session Cleanup: Data is automatically cleaned up on disconnect
Database Backup: SQLite file can be easily copied/backed up

🐛 Troubleshooting

Plugin doesn't load

Make sure Velocity 3.4.0-SNAPSHOT is running
Check if all dependencies are correctly bundled

Resource pack is not sent

Check the resourcePackUrl in the configuration
Make sure the URL is accessible

Players are not forwarded

Check the server logs for errors
Make sure backend servers are available

📜 License

Created by thelion

🤝 Support

For questions or problems:

Create an issue in the GitHub repository
Check the logs for error messages
Make sure all dependencies are correctly installed

Good luck with your Velocitypacker plugin! 🎮

VelocityPacker