> For the complete documentation index, see [llms.txt](https://stellarskills.gitbook.io/stellarskills-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stellarskills.gitbook.io/stellarskills-docs/server.md).

# server

[All effects and shared choice parameters](/stellarskills-docs/readme.md) · [Effect math and limitations](file:///configuration/effects.md)

## `server.permission`

Server permission. Grants a permission while this node is active. The player-facing line never exposes the permission node.

| Property                    | Value                                           |
| --------------------------- | ----------------------------------------------- |
| Exact key                   | `server.permission`                             |
| Hook descriptor             | `permission_sync`                               |
| Optional integration owner  | None declared                                   |
| Runtime evidence            | Native consumer/source reference                |
| Source reference            | PermissionEffectService.java, SkillService.java |
| Declared enabled-by-default | True                                            |
| Probability flag            | False                                           |
| Allowed operations          | `unlock`                                        |
| Value label                 | Enabled                                         |
| Value help                  | Use UNLOCK with value 1.                        |
| Schema value example        | `1`                                             |

### Accepted filters/parameters

| Exact field      | Type / role           | Required | Example / options                                 | Plain-language help                                                                                   |
| ---------------- | --------------------- | -------- | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `permission`     | permission; parameter | Yes      | `example.feature.use`                             | Exact permission to grant. This value is server-only.                                                 |
| `provider`       | enum; parameter       | No       | `native`; choices: native, commands               | native affects StellarSkills/API checks; commands synchronizes an external permission plugin.         |
| `grant_command`  | command; parameter    | No       | `lp user {uuid} permission set {permission} true` | Console command used by provider=commands. Supports {uuid}, {player}, and {permission}.               |
| `revoke_command` | command; parameter    | No       | `lp user {uuid} permission unset {permission}`    | Console command used when the node is refunded, removed, or becomes unavailable.                      |
| `display`        | text; parameter       | No       | `Unlocks a protected server feature`              | Overrides the generated benefit line. Use this to conceal server-only IDs and implementation details. |
| `hidden`         | boolean; parameter    | No       | `false`; choices: false, true                     | When true, this effect remains active but is omitted from player benefit/profile text.                |

Also accepts the six [shared choice parameters](/stellarskills-docs/readme.md) for supported skill-node bundles. Field examples are placeholders, not guaranteed live registry IDs or complete recipes.