Upload a script to the Community Store

Submit a Lua script (or a zip of scripts) so other players can install it from the overlay Community Store.

Submissions are reviewed before they appear in the catalog. After you send the form you get a submission ID and Pending Review. The listing is not live until it is approved.

Do not zip the official SDK, the injected DLL, or the git repo. Official SDK updates use overlay Update SDK, not this form. Offline packs are a different flow: sharing and packs.

Before you upload

1. Keep the file under %USERPROFILE%\Documents\SharpTib\scripts (or another folder you can browse to).
2. Overlay → SCRIPTS → load the module. Check LOGS and fix errors first.
3. Save unsaved edits. Upload... on the Scripts tab saves the open file first; if that save fails, the form does not open.
4. Strip passwords, machine tokens, character dumps, and a second copy of scripts\sdk.

Open the upload form

Use either path. Both land on the same + Upload Script page.

From the script you have open

1. Start official Tibia and inject Arcane.
2. Overlay → SCRIPTS.
3. Select the module in the list.
4. Click Upload....
5. Community Store opens with that file already selected. Name, category, tags, and description are suggested from the filename — edit them before you submit.

From Community Store

1. Overlay → SCRIPTS → Community Store.
2. Click + Upload Script.
3. Click Browse Script File and choose a .lua or .zip.

Fill the form

The right-hand STORE PREVIEW updates as you type.

Script information

1. Script name * — the catalog title. Required, 64 characters or less.
2. Author name * — the public author label. Required, 40 characters or less.
3. Semantic version * — 1.0.0 style (not v1 or 1.0). Required.
4. Primary category * — Utility, Bot, PvP, Market, UI, Combat, Gathering, Crafting, Economy, or Other.
5. Description * — what the script does. Required, 1000 characters or less.

Tags (optional)

Pick up to five approved tags: Utility, Bot, PvP, Market, UI, Combat, Gathering, Crafting, Economy, Loot, Overlay, Timer, QoL.

Files

1. Browse Script File / Change Script File — one .lua (512 KiB or less) or one .zip (25 MiB or less).
2. Choose Thumbnail (optional) — PNG or JPEG, not empty, 2 MiB or less, no larger than 2048×2048.

Wait until the thumbnail preview finishes decoding. A still-validating image blocks submit.

Release notes (optional)

What changed in this version. 2000 characters or less. Use this when you upload an update, and to help reviewers.

Submit

1. Check I agree to the community guidelines. Submit stays disabled until this is checked and the other required fields pass.
2. Save Draft if you want to leave and come back. The draft is stored on this machine (Documents\SharpTib\script_store.json).
3. Click Submit Script. The button reads Submitting... while the upload runs.
4. On success the page shows SCRIPT SUBMITTED, a Submission ID, and Pending Review.
5. Upload Another clears the form. Browse Scripts opens All Scripts.

If submit is disabled, the first validation error is the dim text under the buttons (missing name, bad version, no file, guidelines unchecked). After a server error, Retry sends the same draft again.

After review

Approved scripts appear under Discover and All Scripts. Players install them from the store. Installed files live at scripts\store\<id>\ — that path is the live module, not a copy. Edit it in place.

To ship a new revision, open + Upload Script again (or Upload... on the file), bump the semantic version, and write release notes.

What to put in a zip

Use a zip only when the listing needs more than one file (a module plus its helpers). Keep it small.

Include:

• The .lua files players should run
• Only the extra data that module needs

Exclude:

• scripts\sdk\ — players already have the official SDK
• scripts\store\ — other people's installs
• scripts\backups\
• Native binaries, credentials, planner exe, map tiles

Limits

Field	Rule
Script name	Required, 64 characters or less
Author name	Required, 40 characters or less
Version	Semver, for example 1.0.0
Description	Required, 1000 characters or less
Release notes	Optional, 2000 characters or less
Tags	Up to 5 approved tags
.lua	512 KiB or less
.zip	25 MiB or less
Thumbnail	PNG or JPEG, 2 MiB or less, 2048×2048 or smaller

Troubleshooting

Submit Script stays disabled
Read the dim text under the buttons. Typical causes: version is not 1.0.0-style, no .lua / .zip selected, thumbnail still decoding, or guidelines not checked.

Could not open the selected script file
The Scripts-tab Upload... path is missing or empty. Save the file on disk first.

The selected files are unavailable or exceed the allowed size
The file was moved, or it is over the Lua / zip / thumbnail cap.

The listing is not in All Scripts yet
That is expected. The registry accepted the upload as Pending Review. Wait for approval.