LargerInventory

English | 中文

---

English

A Minecraft Spigot plugin that extends player inventory capacity through a paging system.

Features

• Paged Inventory - Expand player inventory up to 99 pages, far beyond the vanilla 27-slot limit
• Page Navigation Buttons - Intuitive previous/next page buttons with customizable position, appearance and sound
• Custom Textures - Support CustomModelData and resource packs for custom button icons
• Cross-page Pickup - Automatically store items to other pages when current page is full
• Cross-page Death Drop - Items from all pages drop on death (syncs with keepInventory game rule)
• Page Naming - Add bookmark names to inventory pages for easy management
• Quick Jump - /li goto <page> to jump directly to a specific page
• Permission-based Page Limits - Control max pages per player via permission nodes
• Backup & Restore - Create, list, restore and delete player inventory backups
• PlaceholderAPI - Provides placeholder variables for scoreboards and HUDs
• Resource Pack Push - Automatically send resource pack to players on join
• MySQL Support - Supports both SQLite and MySQL
• Hot Reload - Support /li reload to update configuration without server restart
• Auto-save - Periodically persist data to database
• Handover Container - Items auto-redistribute when page limit decreases, overflow goes to handover container
• Lazy Loading - Only load current page data to reduce memory usage
• LRU Cache - Keep only the 6 most recently accessed pages in memory for optimized performance
• i18n Support - Supports Chinese and English, switchable via configuration

Requirements

• Java 21+
• Spigot/Paper 1.21+

Installation

1. Download the latest JAR file from Releases
2. Place it in the server's plugins directory
3. Restart the server or use a plugin manager to load it

Commands

Command	Description	Permission
/li info [player]	View player inventory info	Player/Admin
/li goto <page>	Jump to a specific page	largerinventory.player.goto
/li name [name]	Name current page (empty to clear)	largerinventory.player.name
/li opencontainer [player]	Open handover container	Player/Admin
/li backup <create|list|restore|delete>	Backup management	largerinventory.admin.backup
/li forcereset	Force reset inventory exceeding limits	largerinventory.admin.forcereset
/li bypass	Bypass button slot protection in creative mode	largerinventory.admin.bypass
/li reload	Reload configuration	largerinventory.admin.reload

Permissions

Permission Node	Description	Default
largerinventory.player.opencontainer	Open own handover container	Player
largerinventory.player.info	View own inventory info	Player
largerinventory.player.goto	Quick jump to specific page	Player
largerinventory.player.name	Name inventory pages	Player
largerinventory.pages.<N>	Limit max pages to N	None
largerinventory.admin.forcereset	Force reset inventory	OP
largerinventory.admin.opencontainer	Open any player's handover container	OP
largerinventory.admin.reload	Reload configuration	OP
largerinventory.admin.info	View any player's inventory info	OP
largerinventory.admin.bypass	Bypass button slot protection in creative	OP
largerinventory.admin.backup	Backup and restore player inventory	OP
largerinventory.admin.*	All admin permissions	OP

PlaceholderAPI Variables

Variable	Description
%largerinventory_current_page%	Current page number
%largerinventory_max_page%	Maximum used page number
%largerinventory_effective_max_pages%	Effective page limit
%largerinventory_page_name%	Current page name

Data Storage

• SQLite: Data saved in plugins/LargerInventory/data.db (default)
• MySQL: Configure database.type: mysql and connection info in config.yml

中文

一个 Minecraft Spigot 插件，通过分页系统扩展玩家背包容量。

功能特性

• 分页背包 - 将玩家背包扩展为最多 99 页，远超原版 27 格限制
• 翻页按钮 - 直观的上一页/下一页按钮，支持自定义位置、外观和音效
• 自定义纹理 - 支持 CustomModelData 和资源包，可自定义按钮图标
• 跨页拾取 - 当背包页满时自动将物品存放到其他页，无需手动翻页
• 跨页死亡掉落 - 死亡时所有页面的物品都会掉落（与游戏规则 keepInventory 同步）
• 页面命名 - 为背包页添加书签名称，方便管理
• 快速跳页 - /li goto <页码> 直接跳转到指定页
• 权限页数限制 - 通过权限节点控制不同玩家的最大页数
• 备份恢复 - 支持创建、列出、恢复和删除玩家背包备份
• PlaceholderAPI - 提供占位符变量，集成记分板和 HUD
• 资源包推送 - 配置 URL 后自动推送资源包给进服玩家
• MySQL 支持 - 支持 SQLite 和 MySQL 双数据库
• 热更新 - 支持 /li reload 热更新配置，无需重启服务器
• 自动保存 - 定时将数据持久化到数据库
• 交接容器 - 页数缩减时物品自动回填，放不下的转入交接容器
• 懒加载 - 仅加载当前页数据，减少内存占用
• LRU 缓存 - 内存中仅保留最近访问的 6 页，优化性能
• 国际化支持 - 支持中文和英文，可在配置中切换

环境要求

• Java 21+
• Spigot/Paper 1.21+

安装

1. 从 Releases 下载最新版本的 JAR 文件
2. 放入服务器的 plugins 目录
3. 重启服务器或使用插件管理器加载

命令

命令	说明	权限
/li info [player]	查看玩家背包信息	玩家/管理员
/li goto <页码>	跳转到指定页	largerinventory.player.goto
/li name [名称]	为当前页命名（留空清除）	largerinventory.player.name
/li opencontainer [player]	打开交接容器	玩家/管理员
/li backup <create|list|restore|delete>	备份管理	largerinventory.admin.backup
/li forcereset	强制重置超出限制的背包	largerinventory.admin.forcereset
/li bypass	创造模式下临时解除按钮槽拦截	largerinventory.admin.bypass
/li reload	重载配置文件	largerinventory.admin.reload

权限

权限节点	说明	默认
largerinventory.player.opencontainer	打开自己的交接容器	玩家
largerinventory.player.info	查看自己的背包信息	玩家
largerinventory.player.goto	快速跳转到指定页	玩家
largerinventory.player.name	为页面命名	玩家
largerinventory.pages.<N>	限制最大页数为 N	无
largerinventory.admin.forcereset	强制重置背包	OP
largerinventory.admin.opencontainer	打开任意玩家交接容器	OP
largerinventory.admin.reload	重载配置	OP
largerinventory.admin.info	查看任意玩家背包信息	OP
largerinventory.admin.bypass	创造模式下解除按钮槽拦截	OP
largerinventory.admin.backup	备份和恢复玩家背包	OP
largerinventory.admin.*	所有管理员权限	OP

PlaceholderAPI 变量

变量	说明
%largerinventory_current_page%	当前页码
%largerinventory_max_page%	已使用的最大页码
%largerinventory_effective_max_pages%	有效页数限制
%largerinventory_page_name%	当前页名称

数据存储

• SQLite：数据保存在 plugins/LargerInventory/data.db（默认）
• MySQL：在 config.yml 中配置 database.type: mysql 及连接信息

Screenshots / 游戏截图

Paged Inventory / 分页背包

!Paged Inventory !Paged Inventory2!Paged Inventory3

Handover Container / 交接容器

!Handover Container 1!Handover Container 2

---