llamamod/docs/manual/17-sharing.md

Sharing levels

A level project is a single .llamalevel file. It contains your changes, the meshes and textures you imported and a thumbnail – no game data – and is usually only a few kilobytes (more if you imported large textures or models). Everyone who has the game can play it: LlamaMod builds the level from their copy of the CD.

Sending a level

1. File → Save (Ctrl+S). By default projects are saved in LlamaMod's levels folder (inside the data folder, see Installing LlamaMod).
2. Give the level a good name, author and description in Level settings – LlamaMod shows them on the mod card.
3. Send the .llamalevel file: forum post, Discord, e-mail, a download link.

Tip: Save once more just before you share: the thumbnail is taken from the current view and becomes the loading picture in the game. Frame something nice first.

Installing a level you received

Any of these works:

• Copy the file into the levels folder of LlamaMod's data folder (Settings → Data folder → Open folder, then levels) and restart LlamaMod. The level appears in the Levels category of the Mods tab.
• Open it in the editor (File → Open project) and choose Level → Add to LlamaMod…. (F5 only play-tests it: the copy is removed again when the game ends.)
• From the command line: LlamaMod --import-level <file.llamalevel>.

Then tick the level in LlamaMod, click Apply and ▶ Play. To get rid of it again, click Remove… on its card – the file is moved to the backups, see Mods.

Where the level appears in the game

Project	In the game
New level	on the world-9 map as TestLevel – chapter n (its own loading picture with the level name). Unlock world 9 in Save games → Unlock TestLevel (world 9), or play it with the editor's F5.
Edited original level	replaces that chapter (for example Village chapter 3) while the mod is on. Switch the mod off to get the original back.

Chapters and conflicts

Each new level occupies one of the TestLevel chapters 32–49 (or chapter 1). The editor picks a free chapter for new projects, but levels from different people may use the same one. If two active level mods use the same chapter – or two mods change the same original level – LlamaMod stops applying and names the files involved. Fix it in the mod's options: every new-level mod has a TestLevel chapter option (1, 32–49).

Note: Chapter 1 of the TestLevel is also used by the built-in Test World mod. The game keeps coins and flags for chapters 2–31 of world 9 in memory that belongs to other things (your progress, the text language …), so LlamaMod does not use them: levels saved with such a chapter by an older version move to a free chapter from 32 on. With more than 18 new levels, some share a chapter – only one of them can be on at a time.

Updating a shared level

Change the project and save it under the same file name; the receiver replaces the old file. LlamaMod notices the change (it keys every level by the file's contents) and rebuilds it on the next Apply.

Sharing parts of a level

• Prefabs – groups of objects you saved (Tools → Save selection as prefab…) live in the data folder's editor/prefabs folder and can be copied to another computer.
• Library assets – geometry saved with Geometry → Save selection to library… is a .llamamesh file in the library folder. Note that library files do contain textures from the game, so share them only with people who own it.
• Copy objects (for other levels) (Ctrl+Shift+C) puts objects as text on the clipboard – you can even paste that into a forum post for others to paste into their level.

Sharing this manual

The manual window's Export button saves the whole manual as HTML pages or as one HTML file with all pictures, ready to upload or attach to a forum post.