How do I change the language?

Set `Config.Locale` to the desired locale code: **shared/config.lua** ```lua Config.Locale = 'en' ```

How do I update the script?

1. Download latest from CFX Portal 2. Backup `shared/config.lua` and `server/config_server.lua` 3. Replace all files except config 4. Restart the resource Database migrations run automatically on startup. Tank data (position, health, liquid level) is preserved.

F.A.Q

Q: How do I disable the 3D circle UI above tanks?

**shared/config.lua** ```lua Config.ENABLE_DUI = false ``` Tank interactions remain available via target/TextUI, but the animated fill indicator is hidden.

Q: Why do my tanks keep disappearing?

`Config.DELETE_OLD_DAYS` deletes tanks whose level and health have not changed for that many days, checked at resource start. By default only empty tanks go, set by `Config.DELETE_OPTIONS`. To turn it off: **shared/config.lua** ```lua Config.DELETE_OLD_DAYS = false ```

Q: How does rain filling work?

Tanks with a liquid type listed in `Config.RainyFillableTypes` fill during rain. The amount per cycle is set by `rainFillAmount` on each container type. A connected player reports the weather, so tanks do not fill while the server is empty. Disable globally with: **shared/config.lua** ```lua Config.EnableRainCollection = false ```

Q: How does tank durability work?

Tanks lose health by `decayRate` every minute. At 0 the tank is broken: by default players can still take liquid with 50% spilled, but cannot fill it until it is repaired. `repairItems` on each container type sets the items that restore health. Tanks built as base pieces do not decay.

2 min readUpdated 2 weeks ago

Setup

Set Config.Locale to the desired locale code:

shared/config.lua

1Config.Locale = 'en'

shared/config.lua

1Config.ENABLE_DUI = false

Tank interactions remain available via target/TextUI, but the animated fill indicator is hidden.

Mechanics

Config.DELETE_OLD_DAYS deletes tanks whose level and health have not changed for that many days, checked at resource start. By default only empty tanks go, set by Config.DELETE_OPTIONS. To turn it off:

shared/config.lua

1Config.DELETE_OLD_DAYS = false

Tanks with a liquid type listed in Config.RainyFillableTypes fill during rain. The amount per cycle is set by rainFillAmount on each container type. A connected player reports the weather, so tanks do not fill while the server is empty. Disable globally with:

shared/config.lua

1Config.EnableRainCollection = false

Tanks lose health by decayRate every minute. At 0 the tank is broken: by default players can still take liquid with 50% spilled, but cannot fill it until it is repaired. repairItems on each container type sets the items that restore health. Tanks built as base pieces do not decay.

Yes. A player can dismantle an empty tank to get the item back. A broken tank can be dismantled with liquid inside when AllowDismantleWhenBroken is on, and that liquid is lost. Inside an Outpost base, only the player who placed it and the base holders can. Fixed tanks from Config.FixedTanks cannot be dismantled.

Jerry Cans

Jerry cans store dynamic fluid amounts via item metadata. Define accepted liquid types and capacity per item in Config.JerryCans. The inventory system must support item metadata for this feature.

Updates

Download latest from CFX Portal
Backup shared/config.lua and server/config_server.lua
Replace all files except config
Restart the resource

Database migrations run automatically on startup. Tank data (position, health, liquid level) is preserved.