Skip to main content

✂️ PackLayer

Overview​

Oraxen supports PackLayer, a Velocity and BungeeCord proxy plugin developed by Oraxen to optimize resource pack distribution on multi-server networks.

PackLayer intercepts resource pack requests at the proxy level and prevents duplicate downloads when players switch between servers using the same pack.

info

This is a proxy plugin for Velocity/BungeeCord, not a backend server plugin.

Installation​

Download PackLayer​

Get the latest PackLayer.jar from GitHub

Install on Proxy​

Place the jar in your proxy's plugins folder (Velocity or BungeeCord)

Restart​

Restart your proxy server

Configuration​

Skip Modes

Determines how PackLayer detects duplicate packs.

ModeDescription
HASH_ONLYDefault. Skip packs with identical SHA-1 hash
URL_ONLYSkip packs from the same URL
HASH_OR_URLSkip if either hash or URL matches
HASH_AND_URLSkip only if both hash and URL match
ALWAYS_SKIPAlways skip pack sends (testing only)
NEVER_SKIPNever skip (effectively disables plugin)
# Skip Mode - determines how PackLayer decides to skip duplicate packs
# Options:
#   HASH_ONLY    - Skip if SHA-1 hash matches (default, recommended)
#   URL_ONLY     - Skip if URL matches
#   HASH_OR_URL  - Skip if either hash OR URL matches
#   HASH_AND_URL - Skip only if both hash AND URL match
#   ALWAYS_SKIP  - Always skip pack sends (testing only)
#   NEVER_SKIP   - Never skip (effectively disables plugin)
skip-mode: HASH_ONLY
Server Filtering

Control which backend servers PackLayer applies to.

server-filter:
  mode: WHITELIST  # DISABLED, WHITELIST, or BLACKLIST
  servers:
    - survival
    - creative
Trusted Domains

Always skip packs from specific domains.

trusted-domains:
  - atlas.oraxen.com      # Oraxen's pack host
  - "*.example.com"       # Wildcard support
Full Configuration
# PackLayer Configuration
 
# Skip Mode - determines how PackLayer decides to skip duplicate packs
# Options:
#   HASH_ONLY    - Skip if SHA-1 hash matches (default, recommended)
#   URL_ONLY     - Skip if URL matches
#   HASH_OR_URL  - Skip if either hash OR URL matches
#   HASH_AND_URL - Skip only if both hash AND URL match
#   ALWAYS_SKIP  - Always skip pack sends (testing only)
#   NEVER_SKIP   - Never skip (effectively disables plugin)
skip-mode: HASH_ONLY
 
# Server Filter - control which backend servers PackLayer applies to
server-filter:
  # Mode: DISABLED (all servers), WHITELIST, or BLACKLIST
  mode: DISABLED
  # List of server names (as defined in Velocity/BungeeCord config)
  servers:
    - lobby
    - hub
 
# Trusted Domains - always skip packs from these domains
# Supports wildcards: *.example.com, cdn.example.com/*
trusted-domains:
  # - atlas.oraxen.com
  # - cdn.example.com
 
# Grace period (ms) after server switch before applying skip logic
# Set to 0 to disable. Useful if backend servers intentionally re-send packs.
server-switch-grace-ms: 0
 
# Enable debug logging
debug: false
 
# Enable statistics tracking (packs skipped, bandwidth saved)
statistics-enabled: true

Commands​

All commands require packlayer.admin permission.

CommandDescription
/packlayer reloadReload configuration
/packlayer statsShow skip statistics
/packlayer clear <player|*>Clear pack cache
/packlayer info <player>Show cached pack info

Usage​

Single Pack Network

All servers use the same Oraxen pack.

  1. Install PackLayer with default settings
  2. Players download the pack once
  3. Server switching becomes instant
skip-mode: HASH_ONLY
Mixed Pack Network

Some servers have different packs.

server-filter:
  mode: WHITELIST
  servers:
    - survival    # These share the same pack
    - creative
    - lobby

Unlisted servers always send their packs.

Using Oraxen's Pack Host

Optimize for atlas.oraxen.com.

trusted-domains:
  - atlas.oraxen.com

Troubleshooting​

warning

Ensure PackLayer is installed on your proxy server, not backend servers.

Pack still re-downloading

  • Enable debug: true to see what's happening
  • Verify all servers use identical packs (same SHA-1 hash)

Players see old pack version

/packlayer clear PlayerName
warning

When using Oraxen's self-host (not Polymart self-hosting) pack hosting option, make sure to use a Skip mode that utilizes hash checking since the pack URL stays the same when self-hosting.

Compatibility​

  • Velocity - 3.0.0+
  • BungeeCord - 1.20+
  • Minecraft - 1.8 - 1.21.x