# Floyd-Backpack<\/p>\n
## Overview<\/p>\n
Floyd-Backpack is a PaperMC server backpack plugin that provides each player with an independent 54-slot storage space. The plugin is developed based on the Floyd-Core framework and supports data persistence, internationalization, quick backpack access via tool items, and secondary confirmation to prevent accidental operations.<\/p>\n
## Features<\/p>\n
– **54-Slot Backpack**: Each player has independent double-chest capacity storage space, isolated by UUID
\n– **Backpack Tool**: Players automatically receive a tool item (Eye of Ender) when joining or respawning; right-click to open the backpack; to prevent accidental operations, the tool item cannot be stored in the backpack
\n– **Data Persistence**: Automatically saves when players quit, and batch persists to JSON files when the server shuts down
\n– **Clear Function**: One-click backpack clearing with secondary confirmation mechanism and configurable timeout
\n– **Internationalization**: Built-in English and Simplified Chinese, switchable via configuration file; backpack title updates dynamically with language
\n– **Hot Reload**: Supports reloading configuration without restarting the server
\n– **Thread Safety**: Backpack data uses `ReentrantLock` to ensure thread safety<\/p>\n
## Commands<\/p>\n
| Command | Alias | Permission | Description |
\n|——|——|——|——|
\n| `\/backpack` | `\/bp` | `floydbackpack.open` | Open personal backpack (default action) |
\n| `\/backpack open` | – | `floydbackpack.open` | Open personal backpack |
\n| `\/backpack clear` | – | `floydbackpack.clear` | Clear backpack (requires secondary confirmation) |
\n| `\/backpack clear confirm` | – | `floydbackpack.clear` | Confirm backpack clearing |
\n| `\/backpack clear cancel` | – | `floydbackpack.clear` | Cancel clearing |
\n| `\/backpack reload` | – | `floydbackpack.reload` | Reload configuration |
\n| `\/backpack help` | – | `floydbackpack.help` | Display help information |<\/p>\n
> Console cannot execute backpack-related commands.<\/p>\n
### Usage Examples<\/p>\n
“`bash
\n# Open backpack
\n\/bp<\/p>\n
# Or full command
\n\/backpack<\/p>\n
# Clear backpack (triggers secondary confirmation)
\n\/bp clear<\/p>\n
# Confirm clearing (irreversible operation)
\n\/bp clear confirm<\/p>\n
# Cancel clearing
\n\/bp clear cancel<\/p>\n
# Reload configuration
\n\/bp reload<\/p>\n
# View help
\n\/bp help
\n“`<\/p>\n
### Clear Operation Flow<\/p>\n
1. Enter `\/bp clear`, the system displays confirmation message and countdown
\n2. Enter `\/bp clear confirm` to confirm clearing (irreversible)
\n3. Enter `\/bp clear cancel` to cancel the operation
\n4. If not confirmed within timeout, the operation automatically expires<\/p>\n
## Permissions<\/p>\n
| Permission Node | Default Value | Description |
\n|———|——–|——|
\n| `floydbackpack.open` | `true` (everyone) | Allows players to open backpack |
\n| `floydbackpack.clear` | `op` (administrators) | Allows players to clear backpack |
\n| `floydbackpack.reload` | `op` (administrators) | Allows reloading configuration |
\n| `floydbackpack.help` | `true` (everyone) | Display help information |<\/p>\n
## Backpack Tool<\/p>\n
When players join the server or respawn, if there is no tool item in their inventory, they will automatically receive an **Eye of Ender** as the backpack tool.<\/p>\n
– **Acquisition Method**: Automatically issued when players join\/respawn
\n– **Usage Method**: Right-click while holding the tool item to open the backpack
\n– **Lock Protection**: The tool item **cannot** be placed into the backpack interface through clicking, dragging, Shift-moving, or hotkeys, preventing accidental storage
\n– **Recognition Mechanism**: Identified via `PersistentDataContainer` tags, supporting multi-language environments; also maintains backward-compatible recognition based on item type and enchantments
\n– **Alternative Method**: Can also use `\/bp` command to open the backpack<\/p>\n
## Configuration<\/p>\n
Configuration file location: `plugins\/FloydBackpack\/config.yml`.<\/p>\n
### Complete Configuration Items<\/p>\n
“`yaml
\nlogging:
\n file:
\n enable: true # Whether to enable file logging
\n level: INFO # Log level<\/p>\n
command:
\n backpack:
\n clear:
\n enable: true # Whether to enable backpack clear command
\n need-confirm: true # Whether secondary confirmation is required before clearing
\n confirm-interval: 30000 # Secondary confirmation timeout (milliseconds)<\/p>\n
i18n:
\n locale: en # Language setting, options: en \/ zh_cn
\n“`<\/p>\n
### Configuration Item Descriptions<\/p>\n
| Path | Type | Default Value | Description |
\n|——|——|——–|——|
\n| `logging.file.enable` | boolean | `true` | Whether to output logs to file |
\n| `logging.level` | string | `INFO` | Log output level |
\n| `command.backpack.clear.enable` | boolean | `true` | Whether to enable `\/bp clear` command |
\n| `command.backpack.clear.need-confirm` | boolean | `true` | Whether secondary confirmation is required before clearing backpack |
\n| `command.backpack.clear.confirm-interval` | long | `30000` | Timeout for secondary confirmation (milliseconds) |
\n| `i18n.locale` | string | `en` | Language locale setting |<\/p>\n
### Hot Reload<\/p>\n
After modifying the configuration file, there is no need to restart the server. Execute the following command to apply changes:<\/p>\n
“`bash
\n\/bp reload
\n“`<\/p>\n
## Internationalization<\/p>\n
The plugin includes two built-in language files:<\/p>\n
| Language | Filename | Config Value |
\n|——|——–|——–|
\n| English | `language\/en.yml` | `en` |
\n| Simplified Chinese | `language\/zh_cn.yml` | `zh_cn` |<\/p>\n
Execute `\/bp reload` after switching languages to take effect. The backpack interface title will dynamically update with the language setting. Old interfaces that are already open will be rebuilt with the new language title on next operation, without losing item contents.<\/p>\n
### Custom Language Files<\/p>\n
To add languages not built-in (such as Japanese), you can manually create language files:<\/p>\n
1. Create a new YAML file in the `plugins\/FloydBackpack\/language\/` directory (create the directory manually if it doesn’t exist)
\n2. Refer to the structure of built-in language files and translate all message keys. For example, create a Japanese file `language\/ja.yml`:<\/p>\n
“`yaml
\ncommand:
\n backpack:
\n console-not-allowed: “\u00a7c\u30b3\u30f3\u30bd\u30fc\u30eb\u304b\u3089\u3053\u306e\u30b3\u30de\u30f3\u30c9\u3092\u5b9f\u884c\u3067\u304d\u307e\u305b\u3093\u3002”
\n reload:
\n start: “\u00a7a\u8a2d\u5b9a\u3092\u518d\u8aad\u307f\u8fbc\u307f\u4e2d…”
\n success: “\u00a7a\u518d\u8aad\u307f\u8fbc\u307f\u304c\u5b8c\u4e86\u3057\u307e\u3057\u305f ({0}ms)\u3002”
\n failure: “\u00a7c\u518d\u8aad\u307f\u8fbc\u307f\u306b\u5931\u6557\u3057\u307e\u3057\u305f\u3002\u30b3\u30f3\u30bd\u30fc\u30eb\u3092\u78ba\u8a8d\u3057\u3066\u304f\u3060\u3055\u3044\u3002”
\n help:
\n line1: “\u00a7b[Floyd-Backpack] \u00a7a\u00a7l\u30d8\u30eb\u30d7”
\n line2: “\u00a76\u00a7n>> \u30b3\u30de\u30f3\u30c9”
\n line3: “\u00a73\/bp open \u00a7e- \u00a77\u30d0\u30c3\u30af\u30d1\u30c3\u30af\u3092\u958b\u304f”
\n line4: “\u00a73\/bp clear \u00a7e- \u00a77\u30d0\u30c3\u30af\u30d1\u30c3\u30af\u3092\u7a7a\u306b\u3059\u308b”
\n line5: “\u00a73\/bp reload \u00a7e- \u00a77\u8a2d\u5b9a\u3092\u518d\u8aad\u307f\u8fbc\u307f”
\n line6: “\u00a7e\u8a73\u7d30: \u00a7f\u00a7nhttps:\/\/github.com\/codeNoob2281\/Floyd-Backpack”
\n clear:
\n feature-disabled: “\u00a7c\u30d0\u30c3\u30af\u30d1\u30c3\u30af\u3092\u7a7a\u306b\u3059\u308b\u6a5f\u80fd\u306f\u7121\u52b9\u3067\u3059\u3002”
\n pending-operation-exists: “\u00a7e\u4fdd\u7559\u4e2d\u306e\u78ba\u8a8d\u64cd\u4f5c\u304c\u3042\u308a\u307e\u3059\u3002\u7d9a\u884c\u3057\u3066\u304f\u3060\u3055\u3044\u3002”
\n confirm-delete: “\u00a76\u30d0\u30c3\u30af\u30d1\u30c3\u30af\u3092\u7a7a\u306b\u3057\u3066\u3082\u3088\u308d\u3057\u3044\u3067\u3059\u304b\uff1f\u3053\u306e\u64cd\u4f5c\u306f\u5143\u306b\u623b\u305b\u307e\u305b\u3093\u3002”
\n confirm-timeout: “\u00a79\u6b8b\u308a {0} \u79d2\u4ee5\u5185\u306b\u78ba\u8a8d\u3057\u3066\u304f\u3060\u3055\u3044\u3002”
\n no-active-operation: “\u00a7e\u6709\u52b9\u306a\u78ba\u8a8d\u64cd\u4f5c\u304c\u3042\u308a\u307e\u305b\u3093\u3002”
\n operation-cancelled: “\u00a7e\u30d0\u30c3\u30af\u30d1\u30c3\u30af\u3092\u7a7a\u306b\u3059\u308b\u64cd\u4f5c\u306f\u30ad\u30e3\u30f3\u30bb\u30eb\u3055\u308c\u307e\u3057\u305f\u3002”
\n cleared: “\u00a7a\u30d0\u30c3\u30af\u30d1\u30c3\u30af\u3092\u7a7a\u306b\u3057\u307e\u3057\u305f\u3002\u00a7c{0}\u00a7a \u500b\u306e\u30a2\u30a4\u30c6\u30e0\u3092\u524a\u9664\u3002”
\n tip-confirm: “\u00a76\u78ba\u8a8d\u3059\u308b\u306b\u306f \u00a7c\/bp clear confirm \u00a76\u3092\u5165\u529b”
\n tip-cancel: “\u00a76\u30ad\u30e3\u30f3\u30bb\u30eb\u3059\u308b\u306b\u306f \u00a7c\/bp clear cancel \u00a76\u3092\u5165\u529b”
\n operation-expired: “\u00a7e[Floyd-Backpack] \u00a76\u524d\u56de\u306e\u64cd\u4f5c\u306f\u671f\u9650\u5207\u308c\u3067\u3059\u3002”
\nchest-ui:
\n backpack-title: “\u00a76{0}\u306e\u30d0\u30c3\u30af\u30d1\u30c3\u30af”
\nbackpack-tool:
\n item-name: “\u00a7b[Floyd-Backpack]\u00a76 \u53f3\u30af\u30ea\u30c3\u30af\u3067\u30d0\u30c3\u30af\u30d1\u30c3\u30af\u3092\u958b\u304f”
\n lore-line1: “\u00a7a\u3053\u306e\u30a2\u30a4\u30c6\u30e0\u3092\u6301\u3063\u3066\u53f3\u30af\u30ea\u30c3\u30af\u3067\u30d0\u30c3\u30af\u30d1\u30c3\u30af\u3092\u958b\u304f”
\n lore-line2: “\u00a7a\u307e\u305f\u306f \/bp \u30b3\u30de\u30f3\u30c9\u3092\u4f7f\u7528”
\n“`<\/p>\n
3. Modify the language configuration in `config.yml`:<\/p>\n
“`yaml
\ni18n:
\n locale: ja
\n“`<\/p>\n
4. Execute `\/bp reload` to make the new language effective<\/p>\n
> Language files must maintain the same YAML structure and key names as built-in files, otherwise the plugin may fail to load correctly. If the plugin cannot automatically read external language files, place the file in the source code `src\/main\/resources\/language\/` directory and rebuild.<\/p>\n
## Data Storage<\/p>\n
Player backpack data storage location:<\/p>\n
“` – Each player’s backpack data is saved independently with UUID naming ## Usage Notes<\/p>\n 1. **Clearing the backpack is an irreversible operation**; with secondary confirmation enabled, be sure to confirm before executing A simple backpack plugin for Paper server<\/p>\n","protected":false},"featured_media":71372,"template":"","meta":{"_minecraft_slug":"floyd-backpack","_minecraft_project_id":"YPofcEwE","_minecraft_author":"codeNoob2281","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":32,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"floyd-backpack.zip","_minecraft_size_bytes":6981864,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:21:54.863592Z","_minecraft_date_created":"2026-05-05T20:32:36.870842Z","_minecraft_date_modified":"2026-05-16T11:28:33.406771Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/floyd-backpack","_minecraft_icon_attachment_id":71372,"_minecraft_imported_at":"2026-06-04T01:21:29+00:00","_minecraft_import_hash":"a29d090615ad1a8c1d26b6a871c9d46e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,127,128,129,91,92],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-71371","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-storage","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","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","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\nplugins\/FloydBackpack\/backpack\/
\n“`<\/p>\n
\n– **Save Timing**: Automatically saved when players quit the server; batch saves all online player data when the server shuts down
\n– **Loading Method**: Loaded from disk when opening the backpack for the first time, subsequent operations use memory cache
\n– **Fault Tolerance**: If JSON data is corrupted, it is automatically backed up as `.bak.
\n– **Thread Safety**: Each backpack instance holds a `ReentrantLock`, ensuring data safety in multi-threaded environments<\/p>\n
\n2. **Console cannot execute any backpack commands**
\n3. Floyd-Core is embedded in the plugin as a Maven dependency, no additional installation required
\n4. Backpack tool items cannot be stored in the backpack interface; this prevents accidental storage that would make it impossible to open the backpack
\n5. After switching languages, execute `\/bp reload` to make the new language settings effective
\n6. It is recommended to regularly backup the data files in the `plugins\/FloydBackpack\/backpack\/` directory<\/p>\n","protected":false},"excerpt":{"rendered":"