---
title: "setproperty | open.mp"
description: "Add a new property or change an existing property."
canonical: https://omp.itsneufox.com/docs/scripting/functions/setproperty
language: en
---

# setproperty

## Description

Add a new property or change an existing property.

| Name | Description |
| --- | --- |
| id | The virtual machine to use, you should keep this zero. _(optional=0)_ |
| name\[\] | Used in combination with value when storing integers; don't use this if you want to store a string. |
| value | The integer value to store or the property's unique ID if storing a string. Use the hash-function to calculate it from a string. _(optional=cellmin)_ |
| string\[\] | The value of the property, as a string. Don't use this if you want to store an integer. |

## Returns

This function does not return any specific values.

## Examples

**Storing Integers**

```c
setproperty(.name = "MyInteger", .value = 42);

new value = getproperty(.name = "MyInteger");
printf("Value that was stored is: %d", value);
```

**Storing Strings**

```c
setproperty(0, "", 123984334, ":)");

new value[4];
getproperty(0, "", 123984334, value);
strunpack(value, value, sizeof(value)); // we need to unpack the string first
print(value);

//should print :)
```

Or... seeing as _all_ the parameters are optional, a piece of code like this similar:

```c
setproperty(.value = 123984334, .string = ":)");

// The rest is the same as above.
```

## Notes

tip

It is recommended to use the PVars/SVars or GVar plugin instead of these natives for being very slow.

## Related Functions

-   [getproperty](https://omp.itsneufox.com/docs/scripting/functions/getproperty): Get the value of a property.
-   [deleteproperty](https://omp.itsneufox.com/docs/scripting/functions/deleteproperty): Delete a property.
-   [existproperty](https://omp.itsneufox.com/docs/scripting/functions/existproperty): Check if a property exists.