Skip to main content

Shop Permissions

This page lists all permissions used by the Shop System.

Command Permissions

The shop system's player-facing commands (/ksshop) require no permissions by default. All players can browse and purchase from shops.

CommandPermissionDescription
/ksshop open <shopId>NoneOpen a shop by ID
/ksshop sell <shopId>NoneOpen a shop in sell mode
/ksshop listNoneList all available shops

Admin Permissions

Shop administration is accessed through the core admin panel or the Shop Admin page.

PermissionCommand / FeatureDescription
kyuubisoft.admin/ksadminOpens the admin panel, which includes access to the Shop Admin page

The Shop Admin page is registered in the admin panel and requires kyuubisoft.admin to access. From the admin panel, administrators can create, edit, and delete shops.

Per-Item Permissions

Individual shop items can require a custom permission for purchase. This is configured per-item in the shop JSON config:

{
"items": [
{
"itemId": "Weapon_Sword_Adamantite",
"name": "VIP Sword",
"cost": 50,
"permission": "shop.vip"
}
]
}
FieldDescription
permissionPermission string required to see and purchase this item. Players without it receive a "No permission" error.

When a player attempts to buy an item with a permission requirement they do not have, the purchase is rejected with a NO_PERMISSION result.

tip

Per-item permissions are optional. If permission is not set (or is null), all players can buy the item.

Permission Summary

PermissionTypeWhat it controls
kyuubisoft.adminAdminFull shop administration (create/edit/delete shops, manage items)
shop.{custom}DynamicPer-item purchase restriction (configurable per shop item)
info

There is no separate "shop admin" permission. Shop management is part of the unified KyuubiSoft admin panel, which uses the kyuubisoft.admin permission.