> For the complete documentation index, see [llms.txt](https://docs.uci.ucserver.it/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.uci.ucserver.it/changelog/readme.md).

# Changelog

New updates and improvements

{% updates format="full" %}
{% update date="2026-05-20" tags="breaking-api-changes,minor" %}

## **4.1.0** 

#### This release pushed the new CustomModule system, which replaced the old CustomFlag system. Alongside a lot of bug fixes.

<a class="button primary" data-icon="down-to-line">Download</a><a class="button secondary" data-icon="book">Full Changelog</a>

***

* This should automatically update your custom items to the new format.

<details>

<summary>Fixes</summary>

#### Pre-release 1:

* Fixed Actions crashing the server

#### Pre-release 2:

* Fixed grenade properties not being applied correctly
* Fixed CustomScp207 instances applying their effect when Apply207Effect was false
* Fixed jailbird wearstate

#### Pre-release 4:

* Fixed ItemShot not activating grenade CustomItems
* Fixed damage not being applied for Weapon, ParticleDisruptor and MicroHid CustomItems

#### Pre-release 5:

* Fixed Scp-1509 crashing clients.

#### Pre-release 6:

* Fixed Null Reference Exception that occurred when invoking PlayerHandler.OnDrop
* Fixed Null Reference Exception that occurred when invoking PlayerHandler.OnChangingItem
* Fixed Null Reference Exception that occurred when invoking APICustomItem::InternalOnHurt
* Fixed Null Reference Exception that occurred when invoking APICustomItem::InternalOnHurting
* Fixed Null Reference Exception that occurred when invoking APICustomItem::InternalOnChangingItem
* Fixed Null Reference Exception that occurred when invoking APICustomItem::InternalOnChangedItem
* Fixed Invalid Operation Exception that occurred when invoking SummonedCustomItem::OnDetonated
* Fixed Argument Out Of Range Exception that occurred when invoking CustomCandy::InternalOnEffectsApplying
* Fixed Argument Out Of Range Exception that occurred when invoking CustomCandy::InternalOnUsingItem

</details>

<details>

<summary>Additions</summary>

#### Pre-release 1:

* Added CustomModules system

#### Pre-release 2:

* Added `uci backup` command

#### Pre-release 3:

* Added `AllowXPGain` to SCP127 CustomData (Defaults to true)
* Added backup CreditTag endpoint
* Added `RegisterCustomModule()` to `CustomModuleManager`

#### Pre-release 4:

* Added BurstFire CustomModule

#### Pre-release 6:

* Added AllowSprinting property in CustomArmors
* Added SecretLabNAudio support

</details>

<details>

<summary>Reworks</summary>

#### Pre-release 4:

* Reworked backend API.

***

#### :warning: Breaking Changes:

* Reworked `APICustomItem::OnInspecting` and `APICustomItem::OnInspected` to use `PlayerInspectingItemEventArgs` and `PlayerInspectedItemEventArgs`
* Replaced `AudibleDistance` in the CustomAudio module with `MinAudibleDistance` and `MaxAudibleDistance`

</details>
{% endupdate %}

{% update date="2026-05-13" tags="feature,improvement,fix,pre-release,breaking-changes" %}

## 4.1.0 Pre-release 6

See what’s new and improved in our latest pre-release.

<details>

<summary>Additions</summary>

* Added SecretLabNAudio support
* Added AllowSprinting property for armor CustomItems

</details>

<details>

<summary>Fixed</summary>

* Fixed TriggerOn flag values
* Fixed DictionaryExtension.TryGetValue extension not parsing enums
* Fixed NullReference Exception that ocurred when invoking PlayerHandler.OnDrop
* Fixed NullReference Exception that occurred when invoking PlayerHandler.OnChangingItem
* Fixed NullReference Exception that occurred when invoking APICustomItem::InternalOnHurt
* Fixed NullReference Exception that occurred when invoking APICustomItem::InternalOnHurting
* Fixed NullReference Exception that occurred when invoking APICustomItem::InternalOnChangingItem
* Fixed NullReference Exception that occurred when invoking APICustomItem::InternalOnChangedItem
* Fixed InvalidOperation Exception that occurred when invoking SummonedCustomItem::OnDetonated
* Fixed ArgumentOutOfRange Exception that occurred when invoking CustomCandy::InternalOnEffectsApplying
* Fixed ArgumentOutOfRange Exception that occurred when invoking CustomCandy::InternalOnUsingItem

</details>

<details>

<summary>Reworks (Breaking)</summary>

* Reworked `APICustomItem::OnInspecting` and `APICustomItem::OnInspected` to use `PlayerInspectingItemEventArgs` and `PlayerInspectedItemEventArgs`
* Replaced `AudibleDistance` in the CustomAudio module with `MinAudibleDistance` and `MaxAudibleDistance`

</details>
{% endupdate %}
{% endupdates %}


---

# 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.uci.ucserver.it/changelog/readme.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.