Workshop Library

Steam Workshop addon downloading, mounting, and management system for the Lilia framework.

---

Overview

The workshop library provides comprehensive functionality for managing Steam Workshop addons in the Lilia framework. It handles automatic downloading, mounting, and management of workshop content required by the gamemode and its modules. The library operates on both server and client sides, with the server gathering workshop IDs from modules and mounted addons, while the client handles downloading and mounting of required content. It includes user interface elements for download progress tracking and addon information display. The library ensures that all required workshop content is available before gameplay begins.

---

lia.workshop.addWorkshop(id)

Queue a workshop addon for download and notify the admin UI.

During module initialization or whenever a new workshop dependency is registered.

Parameters:

string|number id Workshop addon ID to download (will be converted to string).

Example Usage:

    -- Register a workshop addon dependency
    lia.workshop.addWorkshop("3527535922")
    lia.workshop.addWorkshop(1234567890) -- Also accepts numbers

---

lia.workshop.gather()

Gather every known workshop ID from mounted addons and registered modules.

Once modules are initialized to cache which workshop addons are needed.

Returns:

table Set of workshop IDs that should be downloaded/mounted.

Example Usage:

    -- Gather all workshop IDs that need to be downloaded
    local workshopIds = lia.workshop.gather()
    lia.workshop.cache = workshopIds

---

lia.workshop.send(ply)

Send the cached workshop IDs to a player so the client knows what to download.

Automatically when a player initially spawns.

Parameters:

Player ply The player entity to notify.

Example Usage:

    -- Send workshop cache to a specific player
    lia.workshop.send(player.GetByID(1))

---

lia.workshop.hasContentToDownload()

Determine whether there is any extra workshop content the client needs to download.

Before prompting the player to download server workshop addons.

Returns:

boolean true if the client is missing workshop content that needs to be fetched.

Example Usage:

    -- Check if client needs to download workshop content
    if lia.workshop.hasContentToDownload() then
        -- Show download prompt to player
    end

---

lia.workshop.mountContent()

Initiate mounting (downloading) of server-required workshop addons.

When the player explicitly asks to install missing workshop content from the info panel.

Example Usage:

    -- Start downloading missing workshop content
    lia.workshop.mountContent()

---