SimpleBackpack v7.0-beta

🔒 SimpleBackpack v7.0-beta

⚠️ This is a BETA / DEVELOPMENT release. Use it for testing and report any bugs you find.

Requirements: Paper 26.2+, Java 25

📋 Changes since last release

• changelog: fold 7.0.1 fixes into the unreleased 7.0 entry
• Document 7.0.1 fixes and cleanups in changelog
• Clean up dead code, docs drift and test quality issues
• Report players-only message to non-player command senders
• Harden BackpackManager and drop dead locale plumbing
• Fix stale backpack data after quick reconnect (quit/unload race)
• Fix /team accept dropping the accepting player and enforce team size
• ci: make gradlew executable for Linux builds
• build: pin paper-api to published 26.2.build.116 and fix project name
• docs: document new backpack options and admin subcommands
• perf: preload backpacks from disk asynchronously on player join
• perf: evict unused backpacks from memory when players quit
• refactor: extract TeamStorage for teams.yml persistence
• refactor: extract PluginSettings from the plugin main class
• feat: play a barrel open sound when opening the backpack
• feat: add /backpackadmin clear, enable and disable subcommands
• feat: one-time first-join welcome message for new players
• feat: add backpack.disabled-worlds to block usage per world
• feat: localize GUI titles and labels through the lang files
• docs: document lang files, MiniMessage titles and update-checker switch
• ci: build and test every push and pull request with JDK 25
• fix: reuse a shared HttpClient and add update-checker.enabled switch
• fix: show player name instead of UUID in admin backpack view title
• fix: show offline team members by name instead of raw UUID
• fix: skip redundant quit autosave right after an inventory-close save
• fix: save death-cleared backpacks asynchronously and drop unused sync save
• fix: block inviting yourself to a team
• fix: discard admin edits when the owner has the backpack open live
• chore: ignore Eclipse bin output directory
• refactor: move translations from config.yml to per-language lang/ files
• chore: align default backpack title fallback with MiniMessage
• feat: MiniMessage for titles and messages with legacy color fallback
• refactor: migrate scheduling to Paper's AsyncScheduler and region schedulers
• chore: drop player-not-found message superseded by Brigadier validation
• feat!: build commands as typed Brigadier trees with native suggestions
• refactor: convert SharedSession to a record
• chore: remove unused message keys from default config
• refactor: read auto-snapshot option directly and drop stale config cache
• refactor: share a single Messages instance between plugin and manager
• chore: drop unused Vault softdepend
• fix: drop pending team invite when the invited player quits
• fix: write audit log synchronously while the plugin is disabling
• fix: recover items from removed slots when loading a shrunken backpack
• fix: close stale views before backpack resize and drop overflow items
• fix: keep preview viewers' own inventory usable and block transfers only
• fix: ignore config GUI clicks outside the config inventory
• docs: document 7.0 changes and correct compatibility claims
• chore: bump version to 7.0
• feat!: migrate commands to Paper's Brigadier lifecycle API
• refactor: Adventure components for inventory titles and messages
• build: derive plugin.yml version from project version
• refactor: inventory holders return their actual inventory
• chore: remove dead code and redundant manager config state
• feat: admin GUI with PDC-based entries and pagination
• fix: rely on vanilla shift-click transfers in backpack views
• perf: async audit log writes with size-based rotation
• perf: async quit autosave and race-free save locking
• perf: O(1) team ownership lookups via TeamRegistry
• fix: expire team invites after five minutes
• fix: deterministic team owner succession
• fix: do not wipe shared backpacks on a member's death
• fix: honor admin.enable-gui configuration option
• refactor: modernize UpdateChecker transport and notification logic
• fix: cancel drag events into protected inventories
• fix: prevent item loss when shrinking the backpack
• refactor: centralize localized messages in Messages class
• docs: document 6.0 improvements
• docs: align platform support and strengthen tests
• fix: identify admin gui by holder
• fix: resolve shared backpacks for team members
• fix: harden GitHub update checks
• fix: make backpack saves atomic
• feat: persist teams and transfer ownership
• fix: enforce backpack lifecycle and command options
• fix: identify backpack inventories by holder
• feat: update version to 6.0 and validate backpack size in BackpackManager

📜 Commands

Command	Description	Permission
/backpack	Open your personal backpack	simplebackpack.use
/bp	Alias for /backpack	simplebackpack.use
/backpackconfig	Open the backpack configuration GUI	simplebackpack.config
/backpackreload	Reload the SimpleBackpack config	simplebackpack.reload
/invite <player>	Invite a player to your team	simplebackpack.team.invite
/team	Show your team members	simplebackpack.team
/leave	Leave your current team	simplebackpack.team.leave
/backpackadmin gui	Open admin overview GUI	simplebackpack.admin
/backpackshare <player> [minutes]	Temporarily share your backpack	simplebackpack.use

🔌 Integrations

• bStats — Anonymous metrics (can be disabled server-side)
• GitHub — Built-in update checker with chat notifications for operators/admins
• Adventure API — All player-facing messages and titles are sent as components; legacy § color codes in configs keep working

🔧 Configuration

plugins/SimpleBackpack/config.yml:

• Backpack name, size, color
• Team settings (enabled, max size)
• Admin settings (GUI, auto-snapshot)
• Command visibility (classic mode, show team/admin commands — requires restart)
• Feature flags (enable sharing)
• Messaging (enabled, language)
• Live config reload (live-config-reload=false disables /backpackreload)
• Keep contents on death

🧱 Compatibility

Platform	Version	Support
Paper	26.2+	✅ Recommended
Purpur	26.2+	✅ Works (Paper fork)

Commands use Paper's Brigadier lifecycle API — Spigot/Bukkit servers are not supported.

📦 Installation

1. Download SimpleBackpack-7.0.jar below
2. Place it in your plugins/ folder
3. Restart your server (Paper 26.2+, Java 25)

📚 Documentation

• README – Full docs & examples
• Modrinth – Download on Modrinth

---

Built from commit 65dbee3 on 2026-08-23 17:26 UTC