DirkScripts
Live Script Configurator
Every fish, zone, permit, shop, tool, dig spot and player level in dirk_fishing is editable from the in-game Live Script Configurator. Changes save to the dirk_scriptConfig database table and apply live — no SQL imports, no Lua edits, no resource restart.
✅ Opening the configurator
You have two options, both registered by dirk_lib:
/dirk_fishing— opens the configurator straight to the fishing config./dirk_config— opens the chooser listing every dirk script on the server and lets you pick which one to configure.
Only players with the configured admin permission (set up via dirk_lib) can access either command.
The Live Script Configurator.
#Sidebar Controls
- Undo / Redo — full edit history.
- Save — persist pending changes (a badge shows the number of unsaved edits).
- History — timestamped audit log of every change, who made it, and the old vs new values.
- Discard — drop unsaved edits.
- Manual Edit (JSON) — open a raw JSON editor for the entire config.
- Reset Defaults — wipe everything and reload shipped defaults (with confirmation).
#Sections
The configurator has nine top-level sections, listed in the sidebar:
Basic · Players · Fish · Equipment · Stores · Zones · Bait Dig · Daily Challenges · Tournaments
#Basic
Six sub-tabs: General, Fishing, Traps, Permits, Skills, Controls.
| Sub-tab | What lives here |
|---|---|
| General | Debug mode, target vs interact, weight/distance units, item names (guidebook, fish finder, anchor, permit, gutting knife), map icon colours. |
| Fishing | Cast time, bite timing range, bait consumption chance, fish density per cell, anchor toggle / deploy time. |
| Traps | Trap interval, catch rate multiplier, stale-trap auto-expiry hours, trap pull timeout. |
| Permits | Global price, duration, payment accounts, replacement card cost, configured revoker job/rank. |
| Skills | XP curve — base level, max level, base XP to reach level 2, curve modifier. |
| Controls | Rebindable keybinds for reel, line release, reel lock, loadout, abandon rod, anchor, permit UI, card flip. |
#Players
Search and manage every player's fishing data. Each row shows character name, player name, online status, server ID, XP and level. Click a player to edit their level — XP recalculates automatically. Permits can also be viewed and revoked here.
#Fish
Full create / edit / delete for every species. Each fish has four sub-tabs:
- General — name, label, description, permit toggle, info-unlock level.
- Stats — bite chance (rarity slider), weight range, strength per kg, fight chance, abundance.
- Ecology — water types, depth range, accepted bait types (each with a per-bait preference weight), fixed base sell price (
$/kg). - Gutting — chance of finding worms, plus reward items with min/max amount and drop chance.
#Equipment
Eight categories: Rods, Reels, Lines, Hooks, Bait, Weights, Traps and Misc. Common fields are name, label, level requirement and description. Category-specific:
| Category | Extra Fields |
|---|---|
| Rods | Strength, cast distance range, prop model |
| Reels | Strength, depth limit |
| Lines | Strength |
| Hooks | Weight range it can handle |
| Weights | Weight value (grams) |
| Bait | Dig toggle, dig quantity, per-ground-type chance sliders (21 materials) |
| Traps | Capacity, prop model, trap-only fish list |
| Misc | Catch-all for the anchor, fish finder, gutting knife, guidebook, permit and trap items |
#Stores
CRUD for equipment shops, fish markets and the bait market. Every store has four tabs:
- Basic — ID, name, level requirement, type (Equipment / Fish Market / Bait Market), NPC models, payment methods, opening hours, map blip.
- Locations — every NPC spawn point as
(x, y, z, heading). - Categories — item groupings used in the store UI.
- Stock — per-item price. Equipment stock takes a flat
$price per item. Fish market stock takes a variance range as signed percentages (e.g.-5%…+5%or+5%…+20%) applied to the fish's base price — a live$/kgpreview shows the exact resulting range. Individual stock items can be level-locked so high-tier gear unlocks gradually.
#Zones
Interactive map editor with three layers:
- Fishing Zones — drawn polygons with info, level requirement, bite timing, density / abundance / weight modifiers, permit toggle and per-fish overrides.
- Depth Overrides — force a specific water depth in areas where GTA gets it wrong (use depth
0to mark unfishable). - Sea Boundary — a single polygon separating freshwater (inside) from saltwater (outside).
Layer visibility toggles let you focus on one type at a time while editing.
#Bait Dig
Three sub-tabs: Settings, Random Items, Tools.
- Settings — regen time for dug spots, random-item chance, grid density range.
- Random Items — bonus drops in dig spots (item or account, chance, amount range).
- Tools — per-tool stamina cost, dig time and durability.
#Daily Challenges
CRUD for daily challenge templates and reward tables. Each template defines:
- Goal type — catch X of a species, hit a weight goal, dig N bait, land above a rarity tier, etc.
- Reward — cash, items or XP.
- Eligibility pool — which player levels / zones / equipment unlock the challenge.
State resets at server-local midnight.
#Tournaments
CRUD for the upcoming tournament system. The Guidebook Tournaments tab is the player-facing surface — full functionality is work-in-progress and will land in a future point release.
#Manual JSON Editing
Click Manual Edit (JSON) to open the entire configuration in a validated JSON editor. Useful for:
- Bulk edits
- Backing up config
- Transferring settings between servers
Validation happens in real-time — errors show inline. Only changed keys are saved (the panel diffs against current state).
#History / Audit Log
Every change is logged with:
- Timestamp
- Admin who made it
- Setting path, old value, new value
Filter by admin name or setting path to find specific changes.
#Storage
Everything persists to the dirk_scriptConfig table — a single source of truth. No server restart is ever required to apply config changes.