Usage

How it works

1. Head to the Mining Center NPC and rent a truck ($100).
2. Drive to a mining zone marked on the map.
3. Equip your pickaxe or drill and mine ore nodes. Each node breaks after enough hits and drops a *_ore item on the ground.
4. Pick up the ore — stand directly over the ore and open your inventory (the ore is not an ox_target interaction). Your character carries it with an animation. Load it into your truck bed or drop it in the zone dumpster storage.
5. Drive to the Cleaning Center NPC and process your ores. Each ore takes ~12 seconds to clean and converts *_ore into the refined mineral.
6. Return to the Mining Center NPC and sell your materials for cash.

NPCs

Mining Center NPC

• Sell Materials - open the sell shop for refined ores
• Rent Vehicle - rent a Bison truck for $100
• Return Vehicle - return the truck within 10 m of the Mining Center for a full $100 refund
• Toggle Zone Blips - show or hide mining zone blips on the map

Cleaning Center NPC

• Clean Ores - select an ore type, choose an amount and process raw ores into refined minerals (~12 s per ore)

Gems NPC

• Appraise Gems - reveal the hidden quality tier of your raw gems
• Sell Gems - open the gem sell shop

Gem mining

Once you reach Rank 5, enter the Tunnel zone to find raw gems. Take them to the Gems NPC in the city to appraise their quality, then sell them for a bonus price.

Tools

Tool	Item key	Type	Damage/hit	Debounce	Notes
Pickaxe	weapon_pickaxe	Native GTA weapon	10	None	Cannot mine drill-only ores
Drill	weapon_drill	Custom weapon	1	300 ms	Accepts drill bits; overheats
Cobalt Drill Bit	weapon_drill_cobalt	Drill bit	+10% bonus	-	Slower durability drain; 5 s cool-off
HSS Drill Bit	weapon_drill_hss	Drill bit	+10% bonus	-	Low heating rate; requires Rank 4
Diamond Drill Bit	weapon_drill_diamond	Drill bit	+20% bonus	-	Minimal heating; requires Rank 5

Drill bits are installed into the drill at the Mining Center shop. They wear down with use and break when durability reaches zero.

Ores

Ore	Item key (raw)	Item key (refined)	Sell price	Tool requirement
Iron	iron_ore	iron	$12	Any
Copper	copper_ore	copper	$14	Any
Zinc	zinc_ore	zinc	$14	Any
Lithium	lithium_ore	lithium	$12	Any
Magnesium	magnesium_ore	magnesium	$14	Any
Limestone	limestone_ore	limestone	$14	Any
Stone	basic_looking_ore	basic_looking	$10	Any
Aluminium	aluminium_ore	aluminium	$14	Cobalt drill bit
Nickel	nickel_ore	nickel	$17	HSS drill bit
Gold	gold_ore	gold	$25	Diamond drill bit
Diamond	diamond_ore	diamond	$35	Diamond drill bit

Raw ores must be cleaned at the Cleaning Center NPC before they can be sold.

Zones

Zone	Max ores	Available ores
Quarry	25	Iron, Copper
Paleto Bay	20	Iron, Copper, Zinc, Aluminium, Lithium, Gold, Diamond
Swamp	20	Iron, Copper, Zinc, Aluminium, Lithium, Nickel, Magnesium, Limestone, Gold, Diamond
Stab City	20	Iron, Copper, Zinc, Aluminium, Lithium, Nickel, Magnesium, Limestone, Gold, Diamond
Radar Array	20	Iron, Copper, Zinc, Aluminium, Gold, Diamond
Union Road	20	Iron, Copper, Zinc, Aluminium, Gold, Diamond
Tunnels (underground)	7	Iron, Copper, Zinc, Aluminium, Gold, Diamond + Gems (Rank 5+)

Gems

Gems are found only in the Tunnel zone and are exclusive to players at Rank 5 or higher. They drop directly as typed gem items with a hidden quality that is revealed when appraised at the Gems NPC.

Gem	Item key	Quality tiers	Sell price range
Sapphire	sapphire_gem	Dirty / Common / Uncommon / Clear / Perfect	$25 – $85
Ruby	ruby_gem	Dirty / Common / Uncommon / Clear / Perfect	$15 – $85
Emerald	emerald_gem	Dirty / Common / Uncommon / Clear / Perfect	$25 – $85
Topaz	topaz_gem	Dirty / Common / Uncommon / Clear / Perfect	$25 – $85

Reputation & progression

Reputation is earned by selling ores at the Mining Center. Higher ranks unlock faster gathering speed, a chance to receive a double ore drop, and access to better drill bits.

Rank	XP required	Gathering speed	Double drop chance	Unlocks
1	1,000	0%	5%
2	2,000	4%	5%
3	3,000	4%	10%
4	4,000	8%	10%	HSS drill bit
5	5,000	8%	15%	Diamond drill bit, gem mining
6	6,000	12%	15%
7	7,000	12%	20%
8	8,000	16%	20%
9	9,000	16%	25%
10	10,000	20%	25%

At Rank 10 players have +20% gathering speed and a 25% double-drop chance.

Configuration

File	Purpose
config/sh_config.lua	Zones, ore types, sell prices, drill settings, gem config, reputation perks
config/sv_config.lua	Debug flag, Discord webhook

Feature toggles

config/sh_config.lua exposes Config.Features so server owners can replace built-in systems with their own scripts. When disabled, the relevant NPC menu option is removed and the server event bails out.

Config.Features = {
    sellShop = true, -- Mining Center ore sell shop (does not affect the gem sell shop)
    rentals  = true, -- Mining Center vehicle rent/return
}

Flag	When false
sellShop	The "Open Selling Shop" option is hidden and prp-mining:openSellStash is ignored server-side. The separate Gems sell shop is unaffected.
rentals	The "Rent Vehicle" / "Return Vehicle" options are hidden and both server events are ignored.

NPC render distance & vehicle return

Two distance values in config/sh_config.lua:

Variable	Default	Purpose
Config.PedRenderDistance	75.0	How far away the Mining Center, Cleaning Center and Gems NPCs stream in. Higher values make the peds visible from further away.
Config.VehicleReturnDistance	10.0	Max distance (metres) from the rental spawn point at which a rental truck can be returned for a refund.

Blips configuration

Blip sprite, color and scale are exposed in config/sh_config.lua under Config.Blips. Labels live in locales/*.json (MINING_CENTER_BLIP_LABEL, ORE_CLEANING_BLIP_LABEL, MINING_ZONE_BLIP_LABEL) for easy translation.

Config.Blips = {
    center   = { enabled = true, sprite = 365, color = 60, scale = 1.0 },
    cleaning = { enabled = true, sprite = 651, color = 60, scale = 0.8 },
    zone     = { sprite = 456, color = 60, scale = 1.0, radiusColor = 60 },
}

Field	Used by	Purpose
enabled	center, cleaning	Set to false to skip creating the static blip (useful when replacing the default NPCs with your own script)
sprite, color, scale	all	Standard GTA blip properties
radiusColor	zone	Color of the translucent radius blip around each mining zone