LargerInventory

A Spigot plugin. Players can have larger inventory

Quick challenge

How far can you run before the mobs catch you?

LargerInventory

English | 中文

---

English

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

Features

- i18n Support - Expand player inventory up to 99 pages, far beyond the vanilla 27-slot limit - i18n Support - Intuitive previous/next page buttons with customizable position, appearance and sound - i18n Support - Support CustomModelData and resource packs for custom button icons - i18n Support - Automatically store items to other pages when current page is full - i18n Support - Items from all pages drop on death (syncs with keepInventory game rule) - i18n Support - Add bookmark names to inventory pages for easy management - i18n Support - `/li goto <page>` to jump directly to a specific page - i18n Support - Control max pages per player via permission nodes - i18n Support - Create, list, restore and delete player inventory backups - i18n Support - Provides placeholder variables for scoreboards and HUDs - i18n Support - Automatically send resource pack to players on join - i18n Support - Supports both SQLite and MySQL - i18n Support - Support `/li reload` to update configuration without server restart - i18n Support - Periodically persist data to database - i18n Support - Items auto-redistribute when page limit decreases, overflow goes to handover container - i18n Support - Only load current page data to reduce memory usage - i18n Support - 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

- MySQL: 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 <页码>` 直接跳转到指定页 - 国际化支持 - 通过权限节点控制不同玩家的最大页数 - 国际化支持 - 支持创建、列出、恢复和删除玩家背包备份 - 国际化支持 - 提供占位符变量，集成记分板和 HUD - 国际化支持 - 配置 URL 后自动推送资源包给进服玩家 - 国际化支持 - 支持 SQLite 和 MySQL 双数据库 - 国际化支持 - 支持 `/li reload` 热更新配置，无需重启服务器 - 国际化支持 - 定时将数据持久化到数据库 - 国际化支持 - 页数缩减时物品自动回填，放不下的转入交接容器 - 国际化支持 - 仅加载当前页数据，减少内存占用 - 国际化支持 - 内存中仅保留最近访问的 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%` | 当前页名称 |