POIS Point of Interest System · Lua addon for Shroud of the Avatar
Lua Addon · Documentation

Mark it once.
Find it forever.

POIS lets you drop a point anywhere in Shroud of the Avatar, organize it by color, find it later from any scene, and share it with your guild as a single line of text — or pull in a whole curated library of points someone else already built.

5Core Windows
7Point Colors
∞Scenes Supported
1Line to Share
01

Download & Install

POIS installs the same way as any SotA Lua addon — unzip it into your Lua folder. A short backup step first means an update can never cost you your existing setup.

  1. Back up your Lua folder first. In your file explorer, right-click your Lua folder → Send to → Compressed (zipped) folder, then rename the result with today's date, e.g. Lua-backup-20260722.zip. If anything ever goes wrong with an update, you can restore from this instead of losing your whole addon setup.
  2. Find your Lua folder. You don't need to hunt through Program Files — log into SotA and type /datafolder into local chat. This opens the folder where SotA stores all of its files. Your Lua folder is right inside it.
  3. Download the release. Grab the latest POIS release zip from the addon's forum thread.
  4. Unzip into place. Extract the release so the pois folder lands directly inside your Lua folder, alongside any other addons you already have installed.
Why back up first? A backup takes thirty seconds and means an addon update is never a one-way door. Get in the habit of doing this before any addon update, not just POIS.
02

Enabling In-Game

SotA has a built-in Lua Script manager. This is where you load, enable, and reload every addon — including POIS.

  1. Log in and open the Lua Script manager from the game menu.
  2. If you unzipped POIS before logging in, it'll already be listed here — skip to step 4.
  3. If it's not showing (for example, you unzipped it while already logged in), click Reload Scripts. This tells the manager to look for new or changed addon files.
  4. Once POIS appears in the list, click On to enable it.
About Reload Scripts Reload Scripts reinitializes every Lua addon you have enabled, not just POIS — so you only need to click it when you've changed addon files while the game is already running. There's also a chat-command equivalent, /lua reload, which does the exact same full restart of every script from local chat instead of the menu.
03

The Tray Icon

Once enabled, a small tray icon appears on screen — this is home base for the whole addon.

POIS tray icon window

● Open / Close

Click the tray icon to open or close the main Points of Interest window.

● Reposition & Minimize

Drag the tray window anywhere, or minimize it down to just the icon. Both its position and its minimized/shown state are saved and restored across sessions.

● Show/Hide All (title bar icon)

A small icon on the tray's title bar toggles visibility for every point in your current scene, all at once — a one-click way to clear your screen without opening the main list.

● Quick Add (+)

The + icon on the title bar jumps straight to the Add Point window, so you can drop a new point without opening the full list first.

04

Main Window

The main window is where you manage points in your current scene: adding, filtering, searching, toggling visibility, and reaching every other window in the addon.

POIS main window showing the point list

Adding a Point

Click Add, type a name, and pick a starting color from the swatch row. Clicking Add Point drops a point at your current location, in whatever scene you're standing in right now.

POIS Add Point window
Points are scene-locked A point only ever shows up in the scene where it was created. Travel to a different scene and it won't appear — you'll only see it again when you return to that exact scene.

The Point List

Each row in the list breaks down into five pieces:

Scrolling the List

The scrollbar has a grab-and-drag thumb between the up/down arrows — drag it directly instead of clicking the arrows repeatedly for a long list.

05

Filtering & Searching the List

These controls only change what you're currently looking at in the list — not what's visible in the game world.

Important distinction Color filters and the search box only control what shows up in the list window. They have nothing to do with what renders in the game world — that's the On/Off column's job, back in the point list.

Color Filters

Click any swatch in the top row to hide every point that isn't that color from the list. Filters combine — enable several colors at once to see just that subset.

Search

Type into the search box for a live text filter against point names in the current scene, as you type.

All On / All Off

This single button toggles in-world visibility for every point currently matching your active color filters and search text — the filtered set, not the whole scene. It always shows the action a click will take:

Filter down to just your red points first, then click the toggle, and only your red points change — nothing else in the scene is touched.

06

Settings

Reachable from the main window's Settings button. Adjust and click Save, or Cancel to discard any changes.

POIS Settings window
07

Find

Search across every scene you've saved points in — not just your current one.

POIS Find window

Handy when you remember a point's name but you're not sure what scene you put it in. Results are grouped and sorted by scene.

08

Export

Turn a set of points into a single line of text you can share anywhere — Discord, a text file, a forum post.

  1. Click Export on the main window. A selection screen lists every point in your current scene, each with a checkbox defaulting to checked.
  2. Use Select All / Select None, or uncheck individual points you don't want included.
  3. Click Export Selected. This generates a long encoded string in a read-only box.
  4. Select all the text (Ctrl+A) and copy it (Ctrl+C).
POIS Export Points selection screen with checkboxes POIS Export Points output screen with the encoded string

That string is what you paste elsewhere to share — anyone with POIS can bring those exact points into their own game via Import.

09

Import

Bring someone else's exported points into your own list.

  1. Click Import on the main window.
  2. Paste the export string you were given into the box.
  3. Click Import.
POIS Import Points window

Every point in the string gets added to your list — if you're missing the scene those points belong to, that scene is created automatically.

Safe to import twice Importing the same export string more than once won't create duplicates. POIS checks each incoming point's exact in-world location against what you already have in that scene, and skips anything that's already there.
10

Point Libraries

A point library is a separate small addon that automatically populates a curated set of points into your list once it's loaded — community-maintained content, like "every resource node in this zone."

Library points show up in your list a little differently:

11

Track Points

Pin any points from your current scene to a small standalone window, without needing the main list open at all.

POIS Tracked Points window

Click Track on the main window to open a selection screen — check off whichever points you want, then click Track Selected. This replaces whatever was previously tracked; it's a fresh pick every time, not an accumulation.

The Tracked Points window shows just three things per point:

Tracking is scoped to the scene you were in when you tracked — distance and direction don't mean anything once you've left that scene, so the window closes automatically on a scene change. Closing it yourself (its own X button) works the same way: tracking is cleared entirely, not paused. Nothing about tracking is saved between sessions; it's meant purely as a short-term navigation aid, not a persistent list.

12

Font Size

Every POIS window shares one font-size control, shown as a number in its title bar.

Click it to cycle through sizes if the default text is too small or too large for you. It resizes buttons, text, and layout consistently across every window — not just the words.

13

Chat Commands

Prefer typing to clicking? Most of POIS is also reachable from local chat.

!pois help

Prints the full list of available commands directly into local chat. The most common ones:

CommandWhat it does
!pois listList points in the current scene
!pois list-scenesList every scene with saved points
!pois add <name>Add a point at your current location
!pois rename-point <key> <name>Rename a point
!pois remove <key>Remove a point
!pois search-scene-points <text>Search the current scene
!pois search-all-points <text>Search every scene
!pois show <key | all>Show a point (or every point) in-world
!pois hide <key | all>Hide a point (or every point) in-world
!pois color-<color> <key>Change a point's color
!pois set-view-distance <n>Same as the Settings field
!pois set-scale <n>Same as the Settings field
!pois set-height-offset <n>Same as the Settings field
Export & Import are UI-only These two specifically don't have a working chat-command path. SotA's local chat input has its own length limit that silently cuts off a long export string before it ever reaches the addon — so that workflow lives entirely in the window UI, where it's reliable. Typing !pois export-point, import-point, or export-points will point you back to the Export/Import windows instead of running.