{"id":120558,"date":"2026-06-07T05:13:52","date_gmt":"2026-06-07T02:13:52","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/permpacks\/"},"modified":"2026-06-07T05:13:52","modified_gmt":"2026-06-07T02:13:52","slug":"permpacks","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/permpacks\/","title":{"rendered":"PermPacks"},"content":{"rendered":"

\"PermPacks<\/p>\n

PermPacks<\/b><\/h1>\n

\n English<\/span> |
\n \u4e2d\u6587\n<\/p>\n

A Paper plugin that distributes a layered resource-pack stack to players based on permissions. It supports both remote URLs and local files, ships with self-host and Amazon S3 upload backends, and can optionally block external packs for consistency.<\/p>\n

## Highlights<\/p>\n

– Permission-driven pack stack: filter packs from `packs.yml` by player permissions, load in ascending priority; later packs override earlier ones.
\n– Unified delivery for multiple sources: `url` and `file` items are unified into a single client request.
\n– Pluggable upload services: built-in `self_host` (embedded HTTP server) and `amazon_s3`; SHA-1 is auto-computed and reused to avoid duplicate uploads.
\n– External pack blocking: with ProtocolLib installed, block any resource pack not marked by this plugin.
\n– Hot reload and diagnostics: reload configs and redistribute online players; inspect pack details and player stack state.<\/p>\n

## Requirements<\/p>\n

– Paper 1.21+, Java 21
\n– Optional: ProtocolLib (recommended for external-pack blocking)<\/p>\n

## Installation<\/p>\n

1) Drop `PermPacks--all.jar` into `plugins\/`
\n2) Start the server to generate `config.yml` and `packs.yml`
\n3) Edit configs as needed, then run `\/permpacks reload packs` to apply<\/p>\n

Note: the plugin creates cache\/repository directories (e.g., `.filerepo\/`). They are safe to delete; they will be re-created automatically.<\/p>\n

## Configuration (`config.yml`)<\/p>\n

“`yaml
\nblock_other_packs: false<\/p>\n

file_upload:
\n enabled: false
\n cleanup: false
\n service: self_host # amazon_s3, self_host
\n self_host:
\n host: 127.0.0.1
\n port: 7077
\n amazon_s3:
\n endpoint: s3.amazonaws.com
\n region: cn-north-1
\n bucket: your-bucket-name
\n directory: uploads
\n access_key_id: “”
\n secret_access_key: “”
\n path_style_access: false
\n chunked_encoding: true
\n“`<\/p>\n

– `block_other_packs`: if enabled, block any resource pack not marked by this plugin (requires ProtocolLib).
\n– `file_upload.enabled`: enable usage of `file` items in `packs.yml`; when disabled, `file` items are ignored.
\n– `file_upload.service`: choose `self_host` (embedded HTTP) or `amazon_s3`.
\n– `file_upload.cleanup`: on startup, remove unreferenced objects from the repository\/bucket; keep only those referenced by current config.
\n– `self_host.*`: listen address and port for the embedded HTTP server.
\n– `amazon_s3.*`: S3 client and bucket settings; supports path-style addressing and chunked encoding.<\/p>\n

## Packs (`packs.yml`)<\/p>\n

Priority rules: default is 0; negatives allowed. Packs are loaded in ascending priority; items with equal priority are loaded in file order, with later items overriding earlier ones.<\/p>\n

“`yaml
\nexample:
\n permission: permpacks.pack.example
\n priority: 10
\n items:
\n – url: https:\/\/example.com\/high.zip
\n hash: d41d8cd98f00b204e9800998ecf8427e
\n – file: plugins\/OtherPlugin\/assets.zip
\n hash: 900150983cd24fb0d6963f7d28e17f72
\n“`<\/p>\n

– `permission`: players owning this permission receive the pack (and its items).
\n– `priority`: lower loads earlier; later packs override earlier ones.
\n– `items.url`: direct download URL; providing official SHA-1 is recommended.
\n– `items.file`: local file path; requires upload service. The plugin validates, computes SHA-1, and uploads to self-host or S3 to generate an accessible URL.<\/p>\n

Apply changes with: `\/permpacks reload packs`.<\/p>\n

## Commands & Permissions<\/p>\n

– `\/permpacks reload configs` (`permpacks.admin`): reload `config.yml` and `packs.yml`.
\n– `\/permpacks reload packs` (`permpacks.admin`): re-cache and redistribute based on current config.
\n– `\/permpacks info ` (`permpacks.admin`): show permission and item details (URL\/File and hashes) for a pack.
\n– `\/permpacks check ` (`permpacks.admin`): compare player permissions with actually distributed packs; shows \u2714\/\u2718.<\/p>\n

Aliases: `\/ppacks`, `\/pp`<\/p>\n

## How It Works (Internals)<\/p>\n

– Startup: `PermPacks` initializes `Options`, `BinaryCache`, and upload services (`SelfHostService`\/`S3Service`), then reads and caches packs.
\n– Distribution: `Packer.distribute(player)` filters `Pack`s by permissions, builds a single request, and sends all items; each item is marked in `PackPacketTracker`.
\n– Blocking: when `block_other_packs` is enabled, `PackBlocker` (via ProtocolLib) blocks any outgoing resource pack not previously marked.
\n– Cleanup: with `file_upload.cleanup` enabled, unreferenced files\/objects are cleaned up on self-host\/S3 during startup.<\/p>\n

## Build From Source<\/p>\n

“`bash
\n.\/gradlew build
\n“`<\/p>\n

– Artifact: `build\/libs\/PermPacks--all.jar`
\n– Dev server: `.\/gradlew runServer` (Paper 1.21)<\/p>\n

## License<\/p>\n

GPL-3.0. Contributions via Issues\/PRs are welcome.<\/p>\n","protected":false},"excerpt":{"rendered":"

Use permission nodes to manage your resourcepack stack!<\/p>\n","protected":false},"featured_media":120559,"template":"","meta":{"_minecraft_slug":"permpacks","_minecraft_project_id":"4JJte3V9","_minecraft_author":"Pectics","_minecraft_license":"AGPL-3.0-only","_minecraft_downloads":66,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"permpacks.zip","_minecraft_size_bytes":46383228,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T20:34:40.897741Z","_minecraft_date_created":"2025-09-26T18:04:12.837163Z","_minecraft_date_modified":"2025-09-26T17:19:56.278460Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/permpacks","_minecraft_icon_attachment_id":120559,"_minecraft_imported_at":"2026-06-07T02:13:53+00:00","_minecraft_import_hash":"04203aa6757241d796122b958d2a9b4e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,127,92],"mod_loader":[132],"minecraft_version":[62,37,73,74,38,78,79,80,81],"class_list":["post-120558","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-utility","mod_loader-paper","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"],"yoast_head":"\nPermPacks - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/permpacks\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"PermPacks - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Use permission nodes to manage your resourcepack stack!\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/permpacks\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta property=\"og:image\" content=\"https:\/\/github.com\/Pectics\/PermPacks\/blob\/main\/assets\/logo_180x.png?raw=true\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/permpacks\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/permpacks\\\/\",\"name\":\"PermPacks - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/permpacks\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/permpacks\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/permpacks-icon-930b84ae1edb44188d34a810469134cfaa52cf76_96.webp\",\"datePublished\":\"2026-06-07T02:13:52+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/permpacks\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/permpacks\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/permpacks\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/permpacks-icon-930b84ae1edb44188d34a810469134cfaa52cf76_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/permpacks-icon-930b84ae1edb44188d34a810469134cfaa52cf76_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/permpacks\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"PermPacks\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"PermPacks - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/permpacks\/","og_locale":"en_US","og_type":"article","og_title":"PermPacks - Minecraft","og_description":"Use permission nodes to manage your resourcepack stack!","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/permpacks\/","og_site_name":"Minecraft","og_image":[{"url":"https:\/\/github.com\/Pectics\/PermPacks\/blob\/main\/assets\/logo_180x.png?raw=true","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/permpacks\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/permpacks\/","name":"PermPacks - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/permpacks\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/permpacks\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/permpacks-icon-930b84ae1edb44188d34a810469134cfaa52cf76_96.webp","datePublished":"2026-06-07T02:13:52+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/permpacks\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/permpacks\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/permpacks\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/permpacks-icon-930b84ae1edb44188d34a810469134cfaa52cf76_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/permpacks-icon-930b84ae1edb44188d34a810469134cfaa52cf76_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/permpacks\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"PermPacks"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/120558","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/120559"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=120558"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=120558"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=120558"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=120558"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}