PlayerNotes
Give players a notebook right inside the game.Players forget things. The cave they meant to loot, the beaver dam run, the trade they promised a neighbor. PlayerNotes gives each of them a small private notebook in chat. /note add writes a line down, /note here marks the ground they stand on, and /note list reads it all back, even weeks later. Notes go into SQLite with no setup at all, or into MySQL when a cluster wants one shared table. Caps on note count and length keep the table small, and an optional Permissions node can turn notes into a VIP perk.
What players get
- Quick notes: players type /note add <text> to save a reminder they can read back any time.
- Map markers: /note here <label> saves the player's current map spot so they can find it again.
- SQLite or MySQL: SQLite works out of the box with zero setup, or switch to MySQL to share one notes table across servers.
- Off the game thread: a worker thread handles all reads and writes, so saving a note never lags the server.
- Note caps: set MaxNotesPerPlayer and MaxNoteLength to keep the table small and tidy.
- Private per player: each player only sees and edits their own notes, never anyone else's.
- Permissions gate: leave it open for everyone, or set a node to make notes a perk for one group of players.
- Rename the command: the /note word lives in config.json, so you can rename it to fit your server.
- Live reload: change config.json and run the reload command to pick it up without a restart.
- Admin wipe: clear one player's notes by their EOS id straight from the console.
Note commands
The /note word itself sits in config.json. Change it there if /note clashes with another plugin.| Command | What It Does |
| /note add <text> | Save a text note. |
| /note here <label> | Save your current map spot with a label. |
| /note list | Show your notes with numbers. |
| /note delete <n> | Remove note number n. |
| /note clear | Remove all your notes. |
| /note | With no words, shows your note list. |
Admin tools
| Command | What It Does | Where |
| PlayerNotes.Reload | Reloads config.json so new limits and settings take hold without a restart. | Both |
| PlayerNotes.Wipe <eos> | Wipes every note for one player by their EOS id. | Console |
Who can use notes
| Node | What It Unlocks |
| UsePermission (set in config) | Leave it empty and everyone can use notes. Set a node here to limit notes to players who have it, like a VIP perk. |
| PlayerNotes.Admin | Kept for later. The wipe command runs from the trusted console today, not from this node. |
Config
Every key is written up on the docs page. If you would rather click than edit JSON by hand, the online config editor does it for you.How to install it
You need AsaApi v2.01 or newer on a Windows server. SQLite is built in, so there is nothing extra to install. MySQL and Permissions are both optional.- Unzip PlayerNotes into ArkApi/Plugins/. Keep the folder named PlayerNotes, because AsaApi only loads a DLL from a folder with the same name.
- Open config.json and pick your note limits and your database.
- Restart the server and look for the PlayerNotes loaded line in ArkApi.log.
Asked a lot
Can players read each other's notes?No. A note is tied to the EOS id that wrote it. /note list only ever shows your own, and delete and clear only touch your own.
Does PlayerNotes need MySQL?
No. It writes to a local SQLite file by default, and that needs no setup at all. Flip UseMySQL to true only when several servers should share one notes table.
What happens to notes when a player quits for a few months?
Nothing. Their notes sit in the database until the player deletes them or you run PlayerNotes.Wipe <eos>. Nothing expires on its own.
Can I turn off the map spot notes?
Yes. Set AllowCoords to false and /note here stops saving spots. Plain text notes keep working.
Will a busy server feel the writes?
No. A worker thread does every database read and write off the game thread, and MaxNotesPerPlayer with MaxNoteLength keeps the table small.
How does it get on my server?
Drop the PlayerNotes folder into ArkApi/Plugins/ and restart. With SQLite there is nothing else to set up. When it loads, PlayerNotes leaves its own line in ArkApi.log.
Was any AI content used in the making of this?
The source code itself was fully created by myself I do use ChatGPT occasionally to generate product images and I do use ChatGPT to generate the website descriptions I do this because I don't speak native English perfectly I am natively from Sweden so I use GPT to help translate and write product descriptions. I also will sometimes use GPT to write better English logs. Majority of my Free plugins are open source so you can review the code yourself and freely fork and edit it to your liking.
