HTNFW Documentation

Welcome to the HTNFW documentation. This guide will help you understand how to operate various systems within the HTNFW framework.
Core
Customising HTNFW Keybinds
All HTNFW keybinds are fully customizable from within your game. To change them, follow these steps:
- Load into the game.
- Press Pause to open the game menu.
- Go to Settings, then Keybinds, and select FiveM.
- Set your keybinds to whatever you’d like!
General Commands
Basic Commands
/h1 – Put your hat on.
/h0 – Take your hat off.
/m1 – Put your mask on.
/m0 – Take your mask off.
/g1 – Put your glasses on.
/g0 – Take your glasses off.
/outfitadd <slot> <name> – Add an outfit to your closet.
/311 <summary> – Non-emergency line.
/911 <report> – Emergency line.
/atm – Use the closest ATM.
/steal – Attempt to rob someone!
/bank – Check your bank balance!
/cash – Check your cash balance!
/outfits – List all current outfits!
/pnum – Shows your phone number to the nearest person!
/fix – Fix your current car!
/givekey – Hand over the keys for your car!
/ping <id> – Send someone your location.
/news – Check the newspaper.
/a – Answer the phone.
/h – Hang up the phone.
/trunkgetin – Crawl into a vehicle trunk!
/trunkejectself – Attempt to remove yourself from the trunk!
/trunkkidnap – Throw someone in the trunk - use /trunkeject to remove them!
/trunkeject – Eject anybody from the trunk of the vehicle you are in!
/anchor – Anchors a boat!
/ooc_toggle – Toggle out-of-character (OOC) chat!
/cid – Returns your citizen ID!
/hud – Toggles the visibility of the HUD UI.
/carry – Carry a person!
/bed – Seats the closest person in the nearest bed!
/tow – Puts a car on the back of a tow truck!
/logout – Relog or change characters when in your personalized clothing space.
/e <name> – Express yourself with an emote.
/transferBNE <id> <amount> – Transfer BNE to someone.
/givecash <id> <amount> – Give cash to someone.
/me <msg> – Express your feelings.
/requesttow <msg> – Request a tow operator to help you.
/towaccept <id> – Accept a tow offer.
/fire <cid> – Make someone jobless.
/t1 – Put your t-shirt on.
/t0 – Take your t-shirt off.
/b1 – Put your bag on.
/b0 – Take your bag off.
/e1 – Put your earrings in.
/e0 – Take your earrings out.
/vest – Take your vest on/off.
/911a <report> – Anonymous emergency line.
/311a <summary> – Anonymous non-emergency line.
/ui-r – Use only if experiencing UI issues.
Police Commands
/cctv <Store ID> – View cameras in stores.
/serial <serial> – Retrieve the owner of a weapon.
/callsign <callsign> – Set your callsign.
/jail <id> <amount> – Send a person to jail.
/impound – Opens the impound menu!
Here's the formatted section for Configuration:
Configuration
Discord Webhooks
Navigate to \resources\[htn-core]\htn-framework\server\logs\sv_webhooks.lua
and configure all the Discord webhooks you want to use.
Generating Discord Webhook URLs
Follow these steps to create webhook URLs in Discord:
- Open Discord: Log in to your Discord account and go to the server where you want to add a webhook.
- Access Channel Settings: Right-click on the text channel where you want the webhook to send messages and select Edit Channel.
- Go to Integrations: In the channel settings, click on Integrations in the left sidebar.
- Create Webhook: Click the Create Webhook button. If you don’t see this option, ensure you have the Manage Webhooks permission enabled for your role.
- Configure Webhook:
- Give the webhook a name.
- Choose the channel (if not already selected).
- Optionally, set a custom avatar.
- Click Copy Webhook URL to copy the URL to your clipboard.
- Paste Webhook URL: Return to the
\resources\[htn-core]\htn-framework\server\logs\sv_webhooks.lua
file and paste the webhook URL in the appropriate configuration section. - Save and Test: Save the configuration file. To verify, trigger an event in your framework that uses the webhook (e.g., a log event) and check if a message appears in the designated Discord channel.
- Repeat for Additional Webhooks: If you need multiple webhooks for different purposes (e.g., logs, alerts), repeat the process for each channel or webhook.
Civilian Jobs:
Trucking Job
Follow these steps to complete the trucking job and receive your payment:
- Get Your Truck
Location: (-17.878479003906, 6304.205078125, 31.374786376953, Heading: 205.59434509277)
Interaction: UseE
to interact at the door to get the truck. - Pickup Trailer
Follow the waypoint on the map to reach the trailer pickup location.
At the trailer pickup, go to the purple circle and pressE
to spawn the trailer. - Hitching Trailer & Delivery
- Hitch the trailer to your truck.
- Drive to the waypoint set on your GPS, which will be your delivery location.
- Arrive at the delivery location and press
E
to deliver the goods from your trailer. - Wait while your goods are unloaded.
- Completion
- You will be informed when the delivery is completed, and a waypoint will be set back to the trucking depot.
- Drive back to the depot.
- Once at the depot, drive into the purple zone and press
E
to return the truck and trailer. - You will then receive your payment.
Garbage Collecting Job
Follow these steps to complete the garbage collecting job and earn rewards:
- Start the Job
Location: (-321.47430419922, -1545.3040771484, 31.019914627075, Heading: 213.45729064941)
Interaction: Use the third eye and right-click to interact with the person on the stairs. Select "Garbage Management."
Choose to Join a Group or Create a Group. - Joining or Creating a Group
Once a group is created or joined, click View Groups, select your group, and ready up.
If you're the group owner, click View Applications to approve your friends to join your group. - Start the Garbage Collection
As soon as all group members are ready, a garbage truck will spawn.
Get in the truck and drive to the waypoint set for your first collection point. - Collecting Trash
- When you arrive at the collection point, the bins you need to collect trash from will be marked.
- A green arrow will appear above all bins that need to be collected.
- Walk up to the bin, press
E
to collect it, then go to the back of the truck and pressG
to throw the trash in. - The amount of trash to collect is random.
- You will be notified when all trash is collected, and a new pickup location will be provided.
- Repeat the Process
- Drive to the next location and repeat the steps above.
- Sometimes, you can collect valuable items from the trash to pawn for money or use for crafting.
- End the Round
- You can end the round whenever you want by returning to the starting location and returning the garbage truck.
Quarry Mining Job
Follow the steps below to complete the mining job and earn money from valuable ores:
- Get a Pickaxe
Purchase a pickaxe from any hardware store. - Start Mining
Location: 2959.7045898438, 2850.40625, 47.232666015625 (Heading: 0.0)
Interaction: Use third eye to interact with the quarry person. Right-click and select Start Mining. - Mining Tiers
You can choose from different levels of mining. Higher levels give you better chances of obtaining rare materials.
Each higher tier requires a rarer tool.
Select your desired level to begin mining. Each time you mine, you will receive a stone.
Continue mining until you've collected enough stones. - Wash Stones
Location: 1984.2136230469, 552.19140625, 161.08465576172 (Heading: 359.99990844727)
Requirement: You need a washpan to wash the stones. - Smelt Stones
Location: 1084.7944335938, -2002.1317138672, 31.412317276001 (Heading: 124.44853973389)
Smelt the washed stones to convert them into rare ores and resources. - Sell Your Materials
Location: 412.33709716797, 314.51171875, 103.01550292969 (Heading: 124.44853973389)
Interaction: Use third eye and right-click to interact with the pawn shop to sell the materials you've obtained from mining.
Lumber Job Guide
This guide explains how to start and complete the lumber job in HTNFW, from cutting down trees to receiving payment.
- Requirements
Tool Required: Purchase a woodcutting hatchet from any hardware store. - Start the Job
Location: Lumbermill at -553.8049, 5348.9478, 74.7456 (Heading: 249.0984)
Interaction: Use your third eye and right-click to interact with the boss at the lumbermill.
Action: Clock in and receive a job truck. - Cutting Down Trees
Drive To: The blue zone on your map, around -1514.1174, 4693.5967, 38.3039 (Heading: 282.8094)
Instructions:- Exit your truck and look around for trees.
- Use the third eye and right-click to chop them down.
- You will receive unprocessed logs for each tree you chop.
- Sell Unprocessed Logs
Location: Lumberjack Warehouse at 1205.4250, -1269.5020, 35.2210 (Heading: 284.0005)
Action: PressE
to hand over the logs and receive receipts. - Get Paid
Return to: The boss at the lumbermill.
Action: Hand in the receipts to get paid for your work.
Diving Job Guide
This guide explains how to perform the diving job in HTNFW, including preparation, treasure diving, and selling collected loot.
- Preparation
Required Item: Oxygen tanks (buy plenty, they deplete quickly). - Renting a Boat
Location: Diving pier at -1612.1382, 5260.9790, 3.9993 (Heading: 10.1068)
Action: Rent a diving boat to begin your mission. - Diving for Treasure
Instructions:- Check your map for a flashing or pulsing marker in the ocean — this is your dive location.
- Use the boat to travel to the marker.
- Open your inventory and use an oxygen tank before diving.
- Dive underwater and locate the sunken wreck.
- Look for interactable points at the wreck and press
E
to scavenge for treasure. - Continue scavenging until there’s nothing left to collect.
- Repeat or Sell
You can either head to the next diving location or sell your collected treasure. - Sell Your Treasure
Location: Warehouse at 2341.3489, 3127.8931, 48.2087 (Heading: 302.5056)
Action: Enter the warehouse, approach the desk and till, then pressE
to sell your items.
HTNFW Chicken Farming Job Guide
This guide explains how to start and complete the chicken farming job in HTNFW.
- Start Chicken Farming
Location: Chicken Ranch — 2388.5867, 5043.1821, 46.3242 (Heading: 314.30)
Action: Walk up to the farmer holding a clipboard and pressE
to begin catching chickens. - Catch Chickens
Run up to chickens in the pen and pressE
to dive and attempt to catch them.
Catch attempts are random, keep trying until all chickens are caught.
Once complete, you’ll automatically exit the pen with a box of chickens. - Transport Chickens
Walk up to your vehicle and place the chicken box in the trunk (boot). - Process Chickens
Location: Processing Station — -96.0172, 6206.9199, 31.0187 (Heading: 74.35)
Action: Walk up to the table, use your third eye, and right-click to start cutting chickens.
Once complete, your chickens will be processed and ready for packaging. - Package Chickens
Location: Conveyor Belt — -100.3022, 6210.4590, 31.0250 (Heading: 48.76)
Action: Use third eye and right-click on the conveyor belt to begin packaging your chickens into boxes.
Repeat until all chickens are packaged. - Sell Chickens
Location: Chicken Dealer — 169.3336, -1633.5288, 29.2917 (Heading: 194.79)
Action: Walk up to the building door and pressE
to sell your packaged chickens.
Continue until all items are sold.
Oil Refinery Job
Follow these steps to complete the oil refinery job and receive your payment:
- Start the Job
Location: (283.34866333008, -2857.5231933594, 6.0260314941406)
Interaction: Use your third eye at the refinery office and pressE
to start the oil extraction. - Transport Oil
Location: Extraction Site
Use a tanker truck to extract crude oil from the marked location. Transport it to the refinery for processing.
- Refining Oil
Once at the refinery, use the system to process the crude oil into refined oil.
After processing, load the refined oil into your truck. - Sell Refined Oil
Location: Refined Oil Depot
Deliver the refined oil to the depot for payment.
Whitelisted Jobs
Police Job
- Assign Yourself the Police Job
- Use the
/setjob
command to assign yourself the police job.
- Use the
- Go On Duty
- MRPD: 441.13, -981.88, 30.69 (Heading: 265.85)
- Chewmash: -3148.10, 1131.89, 21.07 (Heading: 113.53)
- Ranger: 387.17, 796.95, 187.68 (Heading: 274.84)
- Interaction: Use third eye to interact with the duty area. Right-click to go on or off duty.
- Get Changed Into Uniform
- MRPD: 459.85, -998.91, 30.69 (Heading: 89.35)
- Chewmash: -3153.52, 1134.44, 21.07 (Heading: 242.56)
- Ranger: 384.56, 794.48, 187.68 (Heading: 279.55)
- Interaction: Use third eye to interact and get changed into your uniform.
- Get a Car
- MRPD: 445.88, -974.39, 25.70 (Heading: 18.01)
- Interaction: Use third eye to interact with the garage attendant. Right-click and use the menu to buy a personal or community police car.
- Park Car
- MRPD: 438.29, -985.52, 25.70 (Heading: 77.70)
- Chewmash: -3152.98, 1160.48, 21.05 (Heading: 342.98)
- Interaction: Drive into a parking space and use the radial menu to park your car.
- Get Car Out of Garage
- Interaction: Stand in front of your parked car and use the radial menu to open the garage.
- Police Interactions
- Use the
/MDT
command or the radial menu for:- K9 (Spawn a K9)
- Interactions like search, panic button, gunshot residue test, DNA swab, examine target, revive, remove hats/masks, place/remove spike strips, and remove fake plates.
- Use the
- Armoury
- MRPD: 482.70, -995.83, 30.69 (Heading: 6.57)
- Ranger: 387.32, 799.06, 187.68 (Heading: 5.10)
- Chewmash: -3168.68, 1119.56, 21.07 (Heading: 1.48)
- Interaction: Use third eye to access the armoury and get PD items (guns, ID, watch, vests).
- Gun Serial Search
- MRPD: 485.22, -990.01, 30.69 (Heading: 10.44)
- Interaction: Use third eye on the laptop to search weapon serials. Hover over a weapon in your inventory to grab its serial.
Bean Machine Business
- Access the Fridge
- Location: (-635.204, 233.476, 81.882)
- Interaction: Use your targeting system to interact with the fridge.
- Options:
- Open Bean Machine Fridge: Access ingredients for crafting items.
- Open Bean Machine Storage: Access storage for products.
- Meal Packing
- Location: (-631.490, 225.356, 81.882, Heading: 122.18)
- Interaction: Use your targeting system to interact with the basket.
- Function: Pack meals for customers by selecting options.
- Cash Register
- Billing Customers:
- Interaction: Use the targeting system on the cash register to charge customers.
- Process: Enter the amount to charge and optional comment, then confirm.
- Customer Payment:
- Interaction: Customers use the register to select cash or bank payment, with an optional tip.
- Billing Customers:
Best Buds Business
- Ordering Products
- Location: (-619.54, -289.22, 35.34, Heading: 345.71)
- Interaction: Use targeting system to interact with the station and order products.
- Storage Space
- Location: (-618.26, -296.75, 35.34, Heading: 101.81)
- Interaction: Access the safe to store business items.
- Picking Bud
- Location: (-610.28, -295.70, 35.34, Heading: 101.05)
- Interaction: Use targeting system to harvest weed plants for crafting or packing.
- Crafting and Packing Products
- Location: (-615.92, -289.85, 35.34, Heading: 160.30)
- Interaction: Use targeting system to interact with the table.
- Options:
- Craft Products: Create items with harvested materials.
- Pack Small Bud: Package weed for sale.
- Cash Register
- Billing Customers:
- Interaction: Use the targeting system on the cash register to charge customers.
- Process: Enter charge amount and optional comment, then confirm.
- Customer Payment:
- Interaction: Customers can use the register to pay with cash or bank, with optional tips.
- Billing Customers:
EMS Job
- Get Job
- Use the
/setjob
command to assign yourself the EMS role.
- Use the
- Go On Duty
- Location: (-814.66, -1239.60, 7.34, Heading: 87.79)
- Interaction: Use third eye to go on duty.
- Order and Manage Supplies
- Location: (-820.04, -1242.72, 7.34, Heading: 151.62)
- Interaction: Use third eye to interact with the shop and purchase necessary supplies.
- Check-In and Bed Access
- Location: (-817.38, -1236.61, 7.34, Heading: 221.83)
- Interaction: EMS can check-in players or disable checkout.
- Purchase EMS Vehicles
- Location: (-861.47, -1226.64, 6.22, Heading: 55.52)
- Interaction: Use third eye to purchase EMS vehicles or share them with others.
- EMS Garage
- Location: (-825.48, -1195.30, 6.69, Heading: 273.62)
- Interaction: Use radial menu to access EMS parking or stand next to a vehicle to park it.
- Get EMS MDT
- Use
/mdt
command or radial menu for the EMS Mobile Data Terminal.
- Use
- EMS Interactions
- Use the radial menu in Medical to perform:
- Heal: Heal injured players.
- Escort: Escort players to safety.
- Seat/Unseat Players: Manage vehicle seats.
- Examine/Check ID: Perform examinations or check ID.
- Panic Button: Use in distress.
- Revive: Revive injured players.
- Use the radial menu in Medical to perform:
Admin:
Granting Yourself Admin Access
To grant yourself admin access in HTNFW:
- Open HeidiSQL: Launch HeidiSQL and connect to the HTNFW database.
- Locate the
__users
Table: Navigate to the__users
table within the database. - Find Your Steam Hex ID: Use SteamID Pro to find your Steam hex ID and search for this ID in the
__users
table. - Update Rank: Locate the
rank
column for your Steam hex ID and change it fromuser
todev
. - Save Changes: Save the changes in HeidiSQL and restart your game session to apply admin privileges.
Admin Menu: Assigning Jobs to Players
To assign jobs to players using the admin menu:
- Command: Use the
/setjob
command.- stateId: The player's state identifier (see below for how to find it).
- job: The job name (e.g., police, ems, unemployed).
- rank: The rank ID (1-6, see available jobs below).
Usage:
/setjob [stateId] [job] [rank]
Finding a User's Citizen ID (stateId)
To find a player's stateId
:
- Open HeidiSQL: Connect to the HTNFW database.
- Navigate to the
characters
Table: Go to thecharacters
table. - Search for Player: Search for the player by their character name.
- Copy
stateId
: Locate theid
column for the player and copy the value, which is theirstateId
.
Finding Available Jobs in HTNFW
To view the list of available jobs and their ranks:
- Open
sv_job_list.lua
: Open the filesv_job_list.lua
in a text editor. - Review Jobs and Ranks: This file lists all available jobs and their corresponding rank IDs (1–6). Use the rank ID (not the display name) when assigning jobs with the
/setjob
command.
Navigate to Job Manager: Go to the following directory:
\resources\[ht-core]\htn-framework\server\jobs\job_manager
Features:
HTNFW Apartment System Guide
This section explains how to use the apartment system in HTNFW, including accessing, managing, and upgrading apartments at two locations: Peaceful Street Apartments and Integrity Way Apartments. The Tier 1 Apartment is the standard apartment assigned to your character upon creation.
Main Options (Tier 1 Apartment - Peaceful Street)
Apartment Management Station:
- Location: -272.814, -703.605, 38.277 (Heading: 110.364)
- Interaction: Use your targeting system to interact with the station.
Options:
- View Active Rooms: Displays all currently occupied rooms for online players.
- Manage Current Room:
- Enter Room: Enter your assigned apartment.
- Unlock Door: Temporarily unlocks your apartment door for 10 seconds, allowing other players to enter.
Apartment Stash (Tier 1)
- Location: -292.016, -726.708, 57.807 (Heading: 346.438)
- Interaction: Use your targeting system to access the stash.
- Function: Store and retrieve personal items in your apartment’s dedicated stash.
Apartment Logout / Wardrobe (Tier 1)
- Location: -291.256, -718.836, 57.807 (Heading: 330.914)
- Interaction: Use your targeting system to interact with the wardrobe.
- Function: View and change your outfits or log out from this location.
Upgrading to Tier 2 Apartment (Integrity Way)
- Location: Visit City Hall and interact with the counter to upgrade.
- Process: Items from your Tier 1 apartment stash are automatically transferred to your new Tier 2 stash.
Accessing Tier 2 Apartment (Integrity Way)
- Location: -44.211, -586.905, 38.161 (Heading: 241.273)
- Interaction: Use your targeting system to interact with the management station.
Options: Same as Tier 1 — view active rooms, manage current room, enter room, unlock door.
Apartment Stash (Tier 2)
- Location: -11.692, -599.334, 79.430 (Heading: 152.482)
- Interaction: Use your targeting system to access the stash.
- Function: Store and retrieve personal items in your apartment’s dedicated stash.
Apartment Logout / Wardrobe (Tier 2)
- Location: -39.128, -590.035, 78.830 (Heading: 25.346)
- Interaction: Use your targeting system to interact with the wardrobe.
- Function: View and change your outfits or log out from this location.
HTNFW Scoreboard Guide
This section explains how to use the HTNFW scoreboard to view information about players currently on the server.
Using the Scoreboard
Open the Scoreboard:
- Action: Hold the U key to display a list of all players currently on the server.
Interact with the Scoreboard UI:
- Action: While holding the U key, right-click to bring up the interactive scoreboard UI.
Options:
- Use the on-screen buttons to navigate the UI.
- View recent player disconnects.
- Close the scoreboard when you're done.
Misc:
HTNFW Dumpster Diving Guide
This section explains how to interact with dumpsters in HTNFW to search for items or use them as temporary storage.
Dumpster Interaction
- Searching Dumpsters
- Interaction: Right-click on a dumpster to search for items.
- Function: Browse and collect any available items inside the dumpster.
- Temporary Storage
- Interaction: Open your inventory near a dumpster to access its stash locker.
- Function: Temporarily store items in the dumpster’s stash for later retrieval.
Criminal:
HTNFW Oxy Runs Guide
This section explains how to participate in the custom Oxy Runs system in HTNFW, a method to convert dirty money into clean money while completing delivery tasks.
Starting an Oxy Run
- Location: Navigate to the starting point at the coordinates (1787.830, 3896.816, 34.389, Heading: 351.550).
- Interaction: Use the prompt that appears to start the job.
- Process:
- A vehicle will spawn nearby after starting the job.
- Enter the vehicle, and a blip will appear on your map indicating the delivery location.
- Follow the blip to the location and complete the delivery process.
- Repeat the process multiple times as new blips appear.
Purpose and Rewards
- Function: Oxy Runs allow you to convert dirty money into clean money.
- Dirty Money Types: The following items are considered dirty money and can be converted during the run:
- rollcash
- band
- cashstack
- cashroll
- inkedmoneybag
- Conversion: At each drop-off, any dirty money items in your inventory will be removed and replaced with clean money.
- Additional Reward: Occasionally, you may receive an oxy item, which provides a small armor boost when used.
HTNFW Drug System Guide: Crack Production
This section explains how to produce crack in HTNFW, including accessing the production location and starting the mixing process.
Accessing the Production Location
- Location: Navigate to the door at the coordinates (712.346, 2532.649, 73.505, Heading: 275.189).
- Interaction: Use your targeting system to interact with the door.
- Function: Gain entry to the crack production area.
Starting the Crack Production Process
- Location: Once inside the building, navigate to the production table at the coordinates (1091.892, -3196.606, -38.993, Heading: 27.659).
- Interaction: Use your targeting system to interact with the table and access the production menu.
- Requirements: To start mixing, ensure you have the following items in your inventory:
- 3x bakingsoda
- 2x chloroform
- 2x dye
- Process: Select the option to start the mixing process, beginning your journey to become a crack dealer.
- Output: Upon completion of the mixing process, you will receive 1x 1gcrack.
HTNFW Chop Shop System Guide
This section explains how to participate in the HTNFW Chop Shop system, which involves locating, stealing, and delivering specific vehicles for rewards.
Starting a Chop Shop Job
- Purchase a Radio Scanner:
- Location: Visit the hardware store to purchase a radio scanner item.
- Use the Radio Scanner:
- Interaction: Use the radio scanner to open a context menu.
- Option: Select Request Current Chop Details.
- Result: If vehicles are needed, you will receive a chat message with details in the format:
- RADIO CHATTER: MODEL: [Vehicle Model], PLATE: [Plate], LOCATION: [Address]
Locating and Stealing the Vehicle
- Find the Vehicle:
- Check the provided address on your map and search the area for the specified vehicle.
- Steal the Vehicle:
- Lockpicking: Use a lockpick item to unlock the vehicle.
- Hotwiring: Hotwire the vehicle to gain control.
Delivering the Vehicle
- Drop-Off Location:
- Navigate to the chop shop drop-off point at the coordinates (-540.960, -2226.872, 5.685, Heading: 51.094).
- Chop the Vehicle:
- Interaction: Use your secondary interaction key to select Attempt Chop.
- Process: A progress bar will appear, indicating the chopping process.
Rewards
Upon completion, you will receive cash and a chance to obtain the following random items:
- goldbar (90% chance)
- pistolammo (75% chance)
- oxy (75% chance)
- bobross (50% chance)
- ciggy (75% chance)
- lockpick (85% chance)
- water (40% chance)
- sandwich (45% chance)
Note: Ensure you have a lockpick and the radio scanner before starting, and be cautious of in-game consequences related to illegal activities.