Item Notes lets you attach private, persistent notes to RuneScape items and maintain a lightweight local loan ledger. Notes follow the canonical item across inventory, bank, equipment, Grand Exchange, and other item interfaces.
- Add or edit a note by holding Shift and right-clicking an item.
- See saved notes in item hover tooltips and after examining the item.
- Customize the
Note:label and note text with independent color pickers or hex codes. - Add
@usernameto a note to create an active entry in the Item Loan Ledger. - Record the local date and time when a borrower is tagged.
- Mark loans as returned while preserving the remaining note text.
- Share notes between noted/unnoted and dose/charge variants through canonical item IDs.
- Store all data privately in the local RuneLite configuration profile.
- Hold Shift and right-click an item.
- Choose Add Note or Edit Note.
- Enter up to 256 characters and press Enter.
- To track a loan, include a tag such as
@Quickstart has a shrimp. - For RuneScape names containing spaces, use underscores:
@Clan_Mateis displayed as@Clan Matein the ledger. - Open the Item Notes sidebar to review active loans or mark one returned.
Leaving the editor blank removes the note. Removing the @username tag removes the active loan record.
| Add a note | Tag a borrower |
|---|---|
 |
 |
| Examine output | Hover tooltip |
|---|---|
 |
 |
| Loan ledger | Color settings |
|---|---|
|
 |
| Color picker | Sidebar icon |
|---|---|
 |
 |
Item Notes is intentionally local-only. It performs no network requests, does not inspect or publish clan rosters, does not verify tagged usernames, and does not send or modify game chat. A username in a note is private text entered by the user, not crowdsourced player data.
The loan ledger is a personal recordkeeping aid. Quantities, due dates, and loan terms are free-form note text, and the plugin does not verify ownership or enforce agreements.
This repository follows RuneLite's standalone external-plugin structure and targets Java 11.
./gradlew test
./gradlew runOn Windows, use gradlew.bat. The run task launches RuneLite in developer mode. Jagex Account users should follow RuneLite's Using Jagex Accounts development instructions.
Item Notes is licensed under the BSD 2-Clause License. See LICENSE.