# Player notes

Staff++ reworked how the player notes work to be more consistent with the staff++ other features.\
Notes are now stored in the database and can be synced across multiple servers.\
\
Staff++ also added the ability to create private notes.

### Commands

| Command                                  | Description                                                                                                                                              |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| /notes \[playername?] \[filters?] \[-l?] | <p>Retrieve all notes of a player, either in a GUI or in chat.</p><p>More info <a href="/pages/-Min2uD2FYaP2F5W4VrI#searching-player-notes">here</a></p> |
| /note \[playername] \[note] \[-private?] | Create a note for a player                                                                                                                               |
| /pnote \[playername] \[note]             | Create a private not for a player (this can also be conceived with the /note command using the -private option). This command is just for convenience.   |

### Permissions

View [permissions](/permissions-and-commands/permissions.md) page

### Searching player notes

You can use the /notes command to search for notes. Staff++ provides you several filters which you can use with the notes command:

| Filter                 | Description                                                                                                                             |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| -id=\[noteId]          | search by a note's ID                                                                                                                   |
| -private=\[true/false] | Search only private or only public notes                                                                                                |
| -target=\[playername]  | Search notes specifically linked to a player (you can also just provide the playername as first parameter instead of using this option) |
| -notedBy=\[playername] | Search all notes created by the given player                                                                                            |
| -note=\[note text]     | Search all notes that contain the given text. If you want to use spaces in you need to surround it with double quotes                   |

#### Example

Find all private notes for player "garagepoort" containing the words "is hacking"

```
/notes garagepoort -private=true -note="is hacking"
```

![](/files/-MinKus3HhP7YZXnQO--)

Or in chat with the list "-l" option

```
/notes garagepoort -private=true -note="is hacking" -l
```

![](/files/-MinL77DMH_VSVjH9Ao-)

{% hint style="info" %}
Note that private notes are marked with \[P] in chat.
{% endhint %}

### Private notes

Staff members can create private notes if they have the correct [permission](/features/player-notes.md#permissions). A private note can only be seen by the player who has created it. \
\
A private note can be create with the `/note` command using the `-private` option. Or by using the `/pnote` command.&#x20;


---

# 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://wiki.staffplusplus.org/features/player-notes.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.