
PermPacks
English | 中文
一个 Paper 插件,根据权限向玩家分发分层资源包堆栈。它支持远程 URL 和本地文件,内置自托管和 Amazon S3 上传后端,并可选择阻止外部资源包以确保一致性。
亮点
- 基于权限的资源包堆栈:根据玩家权限从
packs.yml中筛选资源包,按优先级升序加载;后面的资源包会覆盖前面的资源包。 - 多源统一分发:将
url和file项统一为单个客户端请求。 - 可插拔上传服务:内置
self_host(嵌入式 HTTP 服务器)和amazon_s3;自动计算并复用 SHA-1 以避免重复上传。 - 外部资源包拦截:安装 ProtocolLib 后,可拦截任何未被本插件标记的资源包。
- 热重载与诊断:重载配置并重新分发在线玩家;检查资源包详情和玩家堆栈状态。
要求
- Paper 1.21+,Java 21
- 可选:ProtocolLib(推荐用于外部资源包拦截)
安装
- 将
PermPacks-<version>-all.jar放入plugins/目录 - 启动服务器以生成
config.yml和packs.yml - 根据需要编辑配置文件,然后运行
/permpacks reload packs应用更改
注意:插件会创建缓存/仓库目录(例如 .filerepo/)。删除它们是安全的;它们会自动重新创建。
配置 (config.yml)
block_other_packs: false
file_upload:
enabled: false
cleanup: false
service: self_host # amazon_s3, self_host
self_host:
host: 127.0.0.1
port: 7077
amazon_s3:
endpoint: s3.amazonaws.com
region: cn-north-1
bucket: your-bucket-name
directory: uploads
access_key_id: ""
secret_access_key: ""
path_style_access: false
chunked_encoding: true
block_other_packs: 如果启用,则阻止任何未被本插件标记的资源包(需要 ProtocolLib)。file_upload.enabled: 启用packs.yml中file项的使用;禁用时,file项将被忽略。file_upload.service: 选择self_host(嵌入式 HTTP)或amazon_s3。file_upload.cleanup: 在启动时,移除仓库/桶中未引用的对象;仅保留当前配置中引用的对象。self_host.*: 嵌入式 HTTP 服务器的监听地址和端口。amazon_s3.*: S3 客户端和桶设置;支持路径样式寻址和分块编码。
资源包 (packs.yml)
优先级规则:默认为 0;允许负数。资源包按优先级升序加载;优先级相同的项按文件顺序加载,后面的项覆盖前面的项。
example:
permission: permpacks.pack.example
priority: 10
items:
- url: https://example.com/high.zip
hash: d41d8cd98f00b204e9800998ecf8427e
- file: plugins/OtherPlugin/assets.zip
hash: 900150983cd24fb0d6963f7d28e17f72
permission: 拥有此权限的玩家将获得该资源包(及其中的各项)。priority: 数值越小加载越早;后面的资源包覆盖前面的资源包。items.url: 直接下载 URL;建议提供官方 SHA-1 哈希值。items.file: 本地文件路径;需要上传服务。插件会验证、计算 SHA-1,并上传到自托管服务器或 S3 以生成可访问的 URL。
使用以下命令应用更改:/permpacks reload packs。
命令与权限
/permpacks reload configs(permpacks.admin): 重载config.yml和packs.yml。/permpacks reload packs(permpacks.admin): 根据当前配置重新缓存并重新分发。/permpacks info <PACK_ID>(permpacks.admin): 显示资源包的权限和各项详情(URL/文件和哈希值)。/permpacks check <PLAYER>(permpacks.admin): 比较玩家权限与实际分发的资源包;显示 ✔/✘。
别名:/ppacks, /pp
工作原理(内部机制)
- 启动:
PermPacks初始化Options、BinaryCache和上传服务(SelfHostService/S3Service),然后读取并缓存资源包。 - 分发:
Packer.distribute(player)根据权限过滤Packs,构建单个请求,并发送所有项;每项都在PackPacketTracker中标记。 - 拦截:当启用
block_other_packs时,PackBlocker(通过 ProtocolLib)会拦截任何之前未被标记的传出资源包。 - 清理:启用
file_upload.cleanup后,在启动期间会清理自托管/S3 上未引用的文件/对象。
从源代码构建
./gradlew build
- 产物:
build/libs/PermPacks-<version>-all.jar - 开发服务器:
./gradlew runServer(Paper 1.21)
许可证
GPL-3.0。欢迎通过 Issue/PR 贡献。
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
46
Beds Always Explode
rabiesland
使床在所有维度中爆炸的模组
诅咒玩法机制
30
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧