Commands

Registered via ACF (co.aikar.commands) as a single class, PrivateChestCommand.

Base alias: /privatechest (/pc).

Subcommand	Permission	Description
`/pc add <player>`	—	Authorize `<player>` on the chest you're looking at.
`/pc remove <player>`	—	Revoke `<player>`'s access to the chest you're looking at.
`/pc remove <x> <y> <z> <player>`	—	Revoke `<player>`'s access to the chest at the given coordinates. Hidden (`@Private`) — used internally by the clickable "RETIRER" link in `/pc list`'s output, not meant to be typed.
`/pc list`	—	List members authorized on the chest you're looking at.
`/pc reload`	`privatechest.reload`	Reload `config.yml` and `messages.yml`.

Every subcommand except /pc reload resolves its target chest by ray-casting up to 7 blocks from the player's eye line (PCUtils#rayCastChestBlock); if the traced block isn't a Chest, the command replies no-chest-in-sight. All four target-resolving subcommands (including the coordinate variant) then require the caller to be the chest's ownerId — anyone else gets not-owner.

<player> arguments resolve as MinecraftPlayer (offline-aware, tab-completed via @networkPlayers).

`/pc add <player>`

Requires the caller to be the chest's owner. Fails with already-a-member if <player> is already in authorizedUsers; otherwise adds them and replies member-added.

`/pc remove <player>`

Requires the caller to be the chest's owner. Fails with not-a-member if <player> isn't currently authorized; otherwise removes them and replies member-removed.

`/pc remove <x> <y> <z> <player>`

Same semantics as /pc remove <player>, but looks up the chest at world coordinates <x> <y> <z> instead of ray-casting, using the uncached lookup (LockService#findByBlockUncached) so it also works for a target block in an unloaded chunk. Hidden from tab-completion/help (@Private); it exists as the destination of the clickable member-removal link in /pc list's output.

`/pc list`

Requires the caller to be the chest's owner. Replies no-members if authorizedUsers is empty. Otherwise sends members-list-header, then one members-list-entry line per authorized member (each with a clickable members-remove suffix that runs /pc remove <x> <y> <z> <that member>), then members-list-footer.

`/pc reload`

Permission: privatechest.reload. Calls AstralPrivateChest#loadConfiguration() to reload config.yml and messages.yml. Replies are plain (non-MiniMessage-configurable) Component.text — success in green, failure in red with the error also logged to the console.

Permission summary

Node	Grants
`privatechest.reload`	`/pc reload`.
`privatechests.bypass`	Not a command permission — bypasses chest access/break/hopper protection everywhere (see Overview → Access control). Note the plural `privatechests` prefix differs from the command permission's singular `privatechest`.

Astral Realms Documentation Help