Virtual Storage Module

MIGRATION FROM PREVIOUS VERSIONS REQUIRES A WIPE.

-- PTBR --
VERSÃO ESTÁVEL 1.0.3

Virtualização
Com este mod é possível criar virtualização de diversos tipos de itens do jogo, desde
a classe ItemBase.
Utiliza um mecanismo de salvamento separado, porém, paralelo ao original, reaproveitando
métodos como OnStoreSave e OnStoreLoad, dando suporte máximo à maioria das entidades.

Precauções:
Não use este mod sem executar os devidos teste (TESTE É VIDA!)
Sempre faça um backup do storage_1 do seu servidor
Não utilize este mod com qualquer outro tipo de mod de virtualização (EXCETO ADDONS PARA O PROPRIO VSM), você vai perder itens (apenas desative os outros rermovendo-os ou pelas suas respectivas configs)
Sempre que achar um bug ME CONTATE

Como Usar?
Este mod é voltado para administradores e desenvolvedores que queiram virtualizar seus packs de storages
ou armazenamentos, se você for um verifique meus projetos de exemplo:
Barril vanilla
Caixotes vanilla

Experimente mods já prontos:
Vanilla Virtual Storage
RaG Virtual Storage

⚙️ Configuração no Profiles:
1 - Abra seu Settings.json em Profiles/iTzMods/VSM

2 - Escolha uma ou mais opções para usar:

{
"m_AutoCloseEnable": 1,
"m_AutoCloseIgnorePlayerNearby": 1,
"m_AutoClosePlayerDistance": 8.0,
"m_AutoCloseInterval": 10,
"m_BatchSize": 2,
"m_BatchInterval": 1,
"m_IncludeDecayItems": 0,
"m_IgnoredItems": [],
"m_UseCfgIgnoreList": 0,
"m_LogLevel": 6,
"m_ForceSpawnOnError": 0,
"m_IsRemovingModule": 0
}


Explicações rápidas:
m_AutoCloseEnable: Habilita/desabilita o fechamento automático de armazenamentos.
m_AutoCloseIgnorePlayerNearby: Ignora jogadores próximos ao tentar fechar.
m_AutoClosePlayerDistance: Distância mínima para considerar um player como "próximo".
m_AutoCloseInterval: Intervalo (em segundos) entre as tentativas de fechamento automático.
m_BatchSize: Quantidade de itens processados por lote (quanto maior, mais rápido, mas consome mais desempenho).
m_BatchInterval: Tempo entre cada lote (em segundos).
m_IncludeDecayItems: Incluir ou não itens que se degradam (ex: alimentos).
m_IgnoredItems: Lista de itens que serão ignorados durante a virtualização.
m_LogLevel: Define o nível de detalhamento dos logs gerados (0 a 6).
m_ForceSpawnOnError: Força o spawn do item no chão caso haja algum erro ao rerstaura-lo para o local original (isso pode duplicarr itens, use com cautela).

Para contatos
Agradecimento especial à Cowboy

PARA REEMBALAR CONTATE-ME

-- EN --
STABLE VERSION 1.0

Virtualization
With this mod, it is possible to create virtualization for various types of items in the game, starting from the ItemBase class. It uses a separate saving mechanism, parallel to the original, reusing methods like OnStoreSave and OnStoreLoad, providing maximum support for most entities.

Precautions:
Do not use this mod without performing proper testing (TESTING IS LIFE!)
Always make a backup of your server's storage_1.
Do not use this mod with any other virtualization mod (EXCEPT FOR ADDONS MADE FOR VSM ITSELF), you will lose items (just disable the others by removing them or through their respective configs).
Whenever you find a bug, CONTACT ME

ONCE THE MOD IS STABLE, I WILL RELEASE IT FOR REPACKAGING! DO NOT BE PREMATURE

How to Use?
This mod is aimed at administrators and developers who want to virtualize their storage packs, if you are one, check out my example projects:
Vanilla Barrel
Vanilla Crates

Try pre-made mods:
Vanilla Virtual Storage
RaG Virtual Storage

⚙️ Configuration in CfgGameplay.json:
1 - Open your Settings.json in Profiles/iTzMods/VSM

2 - Choose one or more options to use:

{
"m_AutoCloseEnable": 1,
"m_AutoCloseIgnorePlayerNearby": 1,
"m_AutoClosePlayerDistance": 8.0,
"m_AutoCloseInterval": 10,
"m_BatchSize": 2,
"m_BatchInterval": 1,
"m_IncludeDecayItems": 0,
"m_IgnoredItems": [],
"m_UseCfgIgnoreList": 0,
"m_LogLevel": 6,
"m_ForceSpawnOnError": 0,
"m_IsRemovingModule": 0
}


Quick explanations:
m_AutoCloseEnable: Enables/disables automatic closing of storage.
m_AutoCloseIgnorePlayerNearby: Ignores nearby players when trying to close.
m_AutoClosePlayerDistance: Minimum distance to consider a player as "nearby".
m_AutoCloseInterval: Interval (in seconds) between automatic closing attempts.
m_BatchSize: Number of items processed per batch (the higher, the faster, but more performance-intensive).
m_BatchInterval: Time between each batch (in seconds).
m_IncludeDecayItems: Whether or not to include decaying items (e.g., food).
m_IgnoredItems: List of items that will be ignored during virtualization.
m_LogLevel: Defines the detail level of generated logs (0 to 6).
m_ForceSpawnOnError: Forces the item to spawn on the ground if there is an error restoring it to the original location (this may duplicate items, use with caution).

For contacts
Special thanks to Cowboy

TO REPACK, CONTACT ME