> For the complete documentation index, see [llms.txt](https://docs.av-scripts.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.av-scripts.com/laptop-pack-v3/dark-market/metadata.md).

# Metadata

{% hint style="info" %}
The metadata function can be found in server/editable/metadata.lua
{% endhint %}

Items can support fixed, dynamic, or no metadata at all.\
To implement dynamic metadata, you must leave the metadata field empty in the item registration table and follow these steps instead:

* Add the item name inside the metadataItems table
* Every item will trigger an unique function which receives the following parameters:
  * **playerId**:`number` Buyer server id
  * **amount**:`number` Amount of items to generate
* The function should return a table containing the metadata info or false

> In the following example, we have added the items:
>
> * weed1g: When giving this item, we will add a random purity between 10 and 50 and a random strain name.
> * **laptop:** The item will always have a 99% of durability

```lua
local metadataItems = {
    -- this is just an EXAMPLE
    ['weed1g'] = function(playerId,amount)
        local metadata = {}
        local purity = math.random(10,50)
        local strain = lib.string.random(".....")
        metadata['purity'] = purity
        metadata['strain'] = strain
        return metadata
    end,
    ['laptop'] = function(playerId,amount)
        local metadata = {
            durability = 99
        }
        return metadata
    end,
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.av-scripts.com/laptop-pack-v3/dark-market/metadata.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.