# 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="#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](https://wiki.staffplusplus.org/permissions-and-commands/permissions) 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"
```

![](https://3621425798-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MPQohtcLxhXAvpSXOMt%2F-Min7a-3-qquw3Pbly3T%2F-MinKus3HhP7YZXnQO--%2Fnote_overview.png?alt=media\&token=19451703-b311-4d24-afb1-38cbfb7fd49b)

Or in chat with the list "-l" option

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

![](https://3621425798-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MPQohtcLxhXAvpSXOMt%2F-Min7a-3-qquw3Pbly3T%2F-MinL77DMH_VSVjH9Ao-%2Fnote_overview_chat.png?alt=media\&token=41841eae-d84c-47f2-8243-9e79c711b013)

{% 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](#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;
