Configuration

Detailed file-by-file explanation for menu settings, route definitions, cooldowns, rewards, and step-specific excavator configs

This script uses more than one config file, and each file has a different job:

• config/main.lua

• config/excavator.lua

• config/dirt_digging.lua

• config/pipe_dirt_digging.lua

• config/rock_crushing.lua

If you remember only one rule, remember this:

• config/main.lua = menu access, XP, payout style, clothing, UI, and general behavior

• config/excavator.lua = actual routes, scenario groups, vehicles, rewards, and steps

• the other three files = step-specific balance values

Quick Answers

• Menu command, key, or tablet item: config/main.lua -> Config.ScriptUI

• Change XP or clothing: config/main.lua

• Disable a route: config/excavator.lua -> route disabled = true

• Change cooldown: config/excavator.lua -> route cooldown

• Change team size, vehicles, rewards, or step order: config/excavator.lua

• Change dirt digging amount: config/dirt_digging.lua -> totalDigCount

• Change pipe digging distances or models: config/pipe_dirt_digging.lua

• Change crush distance or crush count: config/rock_crushing.lua

What Is Inside config/main.lua?

The real source file controls:

• Config.locale

• Config.ScriptUI

• Config.Levels

• Config.InfoBox

• Config.ScoreBox

• Config.CleanMoney

• Config.JobClothing

• Config.AvgAwards

• Config.debug

Default item-based menu access uses:

itemName = "excavator_op_tablet"

What Is Inside config/excavator.lua?

This file controls the route logic itself:

• employers

• specialSkillbars

• blips

• limitVehiclesToMemberCount

• scenarios

The real source groups scenarios by difficulty:

• easy

• medium

• hard

Each difficulty contains route entries, and each route entry includes fields such as:

• disabled

• name

• teamSize

• cooldown

• rewards

• vehicles

• steps

How Do I Disable One Route?

Open:

config/excavator.lua

Then find the exact route entry under the difficulty you are testing and set:

disabled = true

Do not disable the wrong route block and expect the live route to disappear. easy, medium, and hard are separate lists.

How Do I Change Cooldown, Rewards, Vehicles, Or Team Size?

Use the same route entry in config/excavator.lua.

The values you will usually edit are:

• cooldown

• teamSize = { min = 1, max = 2 }

• rewards = { ... }

• vehicles = { ... }

• steps = { ... }

If your change does not show up, you probably edited a different difficulty route than the one you started in game.

Which Step Keys Exist In The Default Source?

The real source uses step keys such as:

• dirt_digging

• unload_rocks

• rock_crushing

• pipe_dirt_digging

When you change the steps array in config/excavator.lua, you are deciding which gameplay modules the route uses and in what order.

What Does config/dirt_digging.lua Control?

This file is for the normal dirt digging step. Real fields include:

• totalDigCount

• dirtLevelModels

Use this when you want to change how many digs are required or how the dirt pile stages look.

What Does config/pipe_dirt_digging.lua Control?

This file is for the pipe digging step. Real fields include:

• totalDigCount

• excavatorDigDistance

• truckUnloadDistance

• dirtPileModel

• attachedDirtModel

• boru01Model

Use this file when the question is about pipe excavation balance, distances, or related models.

What Does config/rock_crushing.lua Control?

This file is for the crushing step. Real fields include:

• smallRockModel

• excavatorBoneIndex

• excavatorCrushDistance

• minCrushCount

• maxCrushCount

Use this when you want rocks to take more or fewer hits, or when the excavator drill interaction feels too strict or too loose.

If Your Changes Do Not Apply

Check these in order:

1. Did you edit config/main.lua or the correct route file?

2. Did you edit the correct difficulty route inside easy, medium, or hard?

3. Did you restart 0r-excavatorjob after the edit?

4. Did you change route settings in config/excavator.lua when the real problem was step balance inside dirt_digging.lua, pipe_dirt_digging.lua, or rock_crushing.lua?