# license

PracticeBot requires a valid license before normal features are unlocked.

{% hint style="danger" %}
Never post your license code publicly. Hide it in screenshots, logs, videos, and support tickets unless support explicitly asks for it in a private channel.
{% endhint %}

## License commands

| Command                      | Permission                  | Description                                                                           |
| ---------------------------- | --------------------------- | ------------------------------------------------------------------------------------- |
| `/pbadmin license`           | `practicebot.admin.license` | Shows current license status.                                                         |
| `/pbadmin license set <key>` | `practicebot.admin.license` | Saves and validates a license key.                                                    |
| `/pbadmin license refresh`   | `practicebot.admin.license` | Manually rechecks the license when the plugin is locked or support asks you to do so. |

## First activation

Run:

```
/pbadmin license set XXXX-XXXX-XXXX-XXXX
```

Then check status:

```
/pbadmin license
```

A valid license unlocks PracticeBot features. If the plugin is locked, only license management commands remain available.

## Recommended staff policy

Grant `practicebot.admin.license` only to trusted owners or senior administrators. This permission can change the saved license key.

## Troubleshooting license issues

| Message or behavior                                  | Meaning                                   | Action                                                     |
| ---------------------------------------------------- | ----------------------------------------- | ---------------------------------------------------------- |
| License missing                                      | No key is configured                      | Run `/pbadmin license set <key>`.                          |
| License invalid, expired, revoked, or not registered | The key is not accepted for this server   | Confirm the key and contact support privately.             |
| License validation timeout                           | Server could not reach validation service | Check host firewall, DNS, outbound HTTPS, and proxy rules. |
| License already active; refresh is not required      | The plugin is already unlocked            | No action needed.                                          |

Do not paste your full license key into public Discord channels, GitHub issues, GitBook pages, screenshots, or review comments.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://edelweiss-network.gitbook.io/practicebot/server-owner-guide/license.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.