I would love to see some of these in your readme.md

I’d prefer to keep the readme on the lighter side as there is full documentation (though not perfect) here.

I added some additional example PRs on GitHub

Thanks I’ll try to take a look at them this weekend if I get some time.

I am happy to contribute to the readme if you wouldnt mind

Contributions are always welcome. As mentioned above, the documentation would probably be a better place to contribute…though that might not be immediately straight forward as the documentation is mostly auto-generated from these files.

I added some additional example PRs on GitHub, I am happy to contribute to the readme if you wouldnt mind…

Someone posted a similar snippet here.

Is it possible to register a function without a keyboard shortcut?

Yes, you can use an empty string or nil

FYI, since I am lazy, I dont want to modify my plugins/config/startup.lua every time I make a new script, so I played with your code above and am able to dynamically load the modules without having to add a new “require” every time.

-- Auto load all ".lua" script files from "plugins/config/lua" folder

package.path = package.path .. ";" .. npp:GetPluginsConfigDir() .. "\\lua\\?.lua"
local f = io.popen('dir "' .. npp:GetPluginsConfigDir() .. '\\lua\\*.lua" /b') 
for mod in f:lines() do require( mod:sub(0,-5) ) end

Question: Is it possible to register a function without a keyboard shortcut? (Just to appear in the menu, and not have to worry about finding an empty keyboard shortcut)

Thanks for a wonderful new addition to the NPP ecosystem.

Glad you are finding it useful.

Include external .lua files within script?

This is already possible using Lua’s require().

You have to make sure the external files are in the right location or adjust the path that Lua searches for. In my startup script I have:

package.path = package.path .. ";" .. npp:GetPluginsConfigDir() .. "\\scripts\\?.lua"

require "myfile"
require "myotherfile"

My external files are in a subdirectory next to the startup.lua file in a file called scripts

API to add/remove toolbar buttons (or even new sidebars/toolbars)

In theory adding/removing buttons should be possible, though I don’t have any immediate plans to implement it. I assume by “sidebars/toolbars” you mean docked dialogs…though not impossible this probably won’t be added any time soon if ever.

Show scripts in menu

As most people are familiar with PythonScript adding an individual script to a menu…LuaScript works differently. You don’t add entire scripts to the menu, but rather register functions to be called. This is done by using AddShortcut. For example this script adds 2 new menu items.

1. Include external .lua files within script?
2. API to add/remove toolbar buttons (or even new sidebars/toolbars)
3. Show scripts in menu

Thank you for your great work. I appreciate it.

Best regards.