Trucker Career

Official server feature documentation can be found here

Moderators: Lead Developers, Junior Developers, Lead Admins, Developers

Post Reply
User avatar
TomsonTom
Party Developer
Posts: 1523
Joined: Wed Aug 06, 2008 3:28 pm
Location: Czech Republic

Trucker Career

Post by TomsonTom » Sat Oct 19, 2013 5:09 pm

Trucker Career
& Components Delivery

Script name: Trucking Script
Script author: TomsonTom



Intro | Cargo Transportation | Industries | Businesses | Ship | Commands
List of Job Ranks | List of Vehicles | List of Industries



Spoiler: show
Demonstration Video
This video is from August!
Some current features are not shown in the video!


[video]http://www.youtube.com/watch?v=vTum_5Y27A0[/video]


Map of locations: http://ls-rp.com/truck/trucking_map_new5_hd.jpg
Diagram: http://ls-rp.com/truck/

Wanna replace your in-game map with this one? See this tutorial (by Meir Peretz).


Summary
Don't have time to read it all? Here's a short summary of the most important things!

  • Truckers may choose what to transport, where from and where to transport it,
  • which means that realistic convoys are now possible!
  • It also means that trucking isn't just the "drive from A to B" boring job anymore! You now have to plan wisely!
  • Businesses now depend on truckers and their cargo,
  • which means that truckers will influence the LS:RP business economy,
  • which means no more infinite fuel in gas pumps, no infinite drinks in bars and no infinite meals in restaurants!
  • This also opens the way for contracts between business owners and trucker factions!
  • You can now rob truckers and steal their cargo,
  • which opens the way for bootlegged products in restaurants, bars, 24/7s, etc.,
  • and which should bring new roleplay opportunities to truckers, mafias and sheriffs!
  • You can now do trucking with your friends, who can help you load and unload the crates from your truck!
  • Official factions can order a Forklift to speed up the (un)loading process.
  • New factions (such as the Ocean Docks Labor Union) may be created and help truckers!
  • No more free trucks! You wanna work as a trucker? Join a faction or buy a truck yourself!
  • This should get rid of people who crash everything with their free trucks.

How to become a trucker in 10 minutes?
Find out here!


Introduction

For a long time, LS:RP lacked of a trucking job where people could drive a truck and transport different types of cargo all through San Andreas. It changed in 2011 when Damian introduced the Trucker Career. It has offered us a new way to earn money legally while having fun doing so. It has also brought us a new official faction! However it is not a secret that the trucking career is basically just about driving mindlessly from one checkpoint to another. You don't even need to care what you are transporting, because the script does everything for you. Isn't now the right time to do something about it?

With the new Vehicle System incoming, it is the right time to implement something like a new version of the trucker career script. It is going to offer much more entertaining activities, including loading cargo with your friends, robbing truckers and stealing their goods, planning the right route to pick up and sell all the cargo and much more! And the trucker career is finally going to be connected to the Business Script, allowing business owners to order components from truckers.


Cargo Transportation

What do truckers get money for? For transporting cargo from one place to another. Yeah, you got it right: this is the most important thing about this script. Let's dive into it and see how it works!

There are several kinds of commodities that can be transported. Some of them are stored in crates (boxes). Crates can be picked up by a player and moved on foot. They may be placed in a truck and transported. You may also put them on the ground and let someone else pick them up. Crates are bought in an industry and should be sold to another industry or a business (depending on the commodity).

Some of the commodities are however not stored in crates, but rather transported directly on special trucks. This includes wood logs on DFT-30 truck, vehicles on a Packer, scrap metal in a dump trailer, fuel in a tanker, etc.

Image

There is one important thing to be noticed. The cargo is now linked to the vehicle, not to the player that is driving it. This means that if your game (not the server) crashes while driving a truck, nothing gets removed and you may continue doing your job after re-connecting. This however does not apply to crates that are being held in one's hands. They get removed if you crash. Crates placed on ground get automatically removed after approximately 5 minutes.

This change is also important for players who would like to roleplay robbing truckers and stealing their goods. As it is now possible to pick up crates from unlocked vehicles and put them to another one, players may attack truckers, block the roads and steal the cargo. It should bring new amazing roleplay opportunities to both truckers and illegal factions, but also to our police departments and security agencies.

Not every vehicle is capable of transporting cargo. Crates may be transported in pickup trucks, vans and article trailer. Wood logs may be transported in a DFT-30. Vehicles in a Packer, liquids in a Tanker, loose commodities in a Dump Trailer, etc. To see the full list of trucker career vehicles and what they can transport, see List of Vehicles.

For more information about how to use the script, see the Commands section.


Industries

Industries are where you may sell and/or buy commodities. That depends on their economic sectors. In real life, the usual breakdown of economic sectors is following: primary, secondary and tertiary. Sometimes we also speak about quaternary sector, but that is not important for LS:RP. The primary and secondary sectors in LS:RP are represented by the industries. The tertiary sector is represented by businesses.

Primary industries produce raw materials, such as wood logs, meat and milk. They do not need any commodities to work and so they do not accept any cargo from truckers. However the truckers may buy commodities from these primary industries. They are usually cheap, because they are raw. Some examples of the primary industries would be farms and forests. In LS:RP we also include a refinery, a chemical plant and a federal mint in primary industries.

Commodities from primary sector are usually sold to secondary industries, which transform the raw or intermediate materials into goods. These industries require materials to produce goods! This means that truckers must sell primary commodities to secondary industries. Only then these industries will produce secondary commodities.

To help you understand which commodities are wanted or for sale, there is an information dialog for each industry. Every industry has got one or more storages. Each storage has got a limited capacity. In the screenshot below you can see that the industry is selling food. There are 26 packages (crates) of food available and every package costs $400. Every hour, some of the input commodities are transformed into food. On the screenshot you can see that the industry accepts 4 different commodities. You may sell them to the industry until the appropriate storage is full.

Image

For example (screenshot above): Right now, you may sell up to 3 tons of grain to the industry (22/25 tons are already in the storage). You would get $250*3 = $750 for that. Every hour, 5 packages of meat, 5 packages of fruit, 3 tons of grain and 500 liters of milk are consumed (removed) and transformed into +5 packages of food each. In this case, as there are enough of all 4 commodities available, 4*5 = 20 new packages of food would be generated next hour.

Image
Industry storages are marked with big white rotating arrows. Above these arrows there is a text label showing what is sold / bought there, how many of it is already in the storage, how big the storage is and how much money you get for selling it or how much money it costs to buy it.

In case you accidentally buy something from the storage, you may sell it back to the same storage and your money will be returned.

If you're buying or selling a commodity that is stored in a crate, you must buy/sell it on foot. You cannot just drive your truck to the arrow and think that some magic dwarfs are going to (un)load the cargo for you. However, if you're buying or selling a liquid, wood logs, etc. then you just drive your vehicle to the white arrow and use the same commands. Be aware that it takes some time to (un)load such cargo.


Businesses

Businesses are places such as restaurants, bars, 24/7s and fuel stations. All of them have always needed components to work. Until now components were delivered in special vans, but many business owners just asked an admin to refill their businesses. No one really cared about it. Those components were then automatically transformed into products after a certain amount of time. This is going to change! Businesses now won't have components and products, but only products.

All businesses are required to have products to operate. And it is truckers' job to refill them. Commodities bought from secondary industries are delivered to businesses and sold using the same commands. If a business' product price is higher than $0, it means that the owner is buying products and truckers may sell them to the business to refill it. If the cargo price (/cargoprice) is set to $0, the business is not accepting anything. It should bring new roleplay opportunities to business owners and truckers. Businesses are now going to depend on truckers.

How does it work? Every business has got a product storage of a limited size. By selling a cargo crate to a business, a specified amount of products is added to the business. The amount of products from 1 crate / commodity can be found in the table below. Note, please, that products are necessary to be able to /enter the business!

Business Type
Gas Stations
Ammunations
24/7
Vehicle Dealerships
Car Modding Shops
Pay & Spray
Clothing Shops
Bars
Restaurant
Furniture Shop
Advertisement Center
Bank
Other Businesses
.
Accepted Commodities
fuel
weapons
appliances
vehicles
car parts
dyes
clothes
beverages
meal
furniture
paper
coins
nothing
.
How many products are generated from 1 unit of cargo?
10
10
5
3
10
3
5
5
5
10
20
100
nothing
.



Ship

Image
There are not many businesses in LS:RP and so to prevent secondary industries from overfilling, there is a new ocean ship in Ocean Docks. This ship accepts all secondary commodities for basic price. Truckers may sell their cargo to the ship just like to a regular industry / business. Business owners should set their components price to be slightly higher than the basic price on the ship, otherwise no truckers would sell their cargo to the business, but rather to the ship.

The ship docks in Ocean Docks for 40 minutes and then leaves for 5 minutes 40 seconds. After that time interval, another ship arrives with empty storage. Note that you must take the cargo on foot to the white arrows on the ship! However, if you are selling fuel, you DO NOT drive the truck on the ship, but you use a special place on the port.

DO NOT DRIVE VEHICLES ON THE SHIP (the only exception is Forklift)

Image
Image



Commands

Here is a list of commands you may use.

/cargo list
Shows you a menu with a list of cargo loaded in the nearest unlocked vehicle.
Note: By selecting cargo in the menu, you may pick it up from the vehicle.

Image

/cargo place
Places the cargo you're currently holding to the nearest unlocked vehicle.

/cargo fork
Works only when you're in a Forklift!
Enables you to select which cargo you want to fork (load on your Forklift) from the nearest unlocked vehicle.

Image


/cargo putdown
Places the cargo you're currently holding on the ground. (max 2 crates per player, 60 crates per server)

/cargo pickup
Picks up the cargo that is laying on the ground.

Image


/cargo buy (on foot)
Use this command when you're standing in the white rotating arrow. You'll buy 1 unit of cargo for the storage price. You can then put this cargo to your vehicle or sell it back to the storage using /cargo sell.

/cargo buy (in a Forklift)
Works same as on foot, except the cargo is not put in your hands, but in your Forklift.
Max: 3 crates / Forklift

/cargo buy (in a truck)
Works same as on foot, except the cargo is loaded on your truck. If you're loading a liquid or a loose cargo, it will take some time to load the cargo in your truck. During this time, you MAY exit your truck and roleplay connecting the trailer, etc.

/cargo sell
Works same as /cargo buy, except you're not buying the cargo, but selling it.
This also works next to an entrance to a business that is buying components from you!

/tpda
Opens a Trucker's PDA system. Here you can find a list of all industries, ship information, list of businesses that are accepting cargo and information about vehicles.

Image
Image


/industry
Shows information dialog about the industry you're currently standing at.

/trailer [...]
Those commands can be used when driving a truck with an attached trailer.
Image



List of Job Ranks

Only truckers may drive vehicles while there is cargo in them. The amount of cargo that can be loaded in a vehicle is defined below in the List of Vehicles. You may drive whichever vehicle you want if it is empty. But if there's cargo loaded in it, you're restricted by your experience (rank). You can get higher rank by waiting and working.

Note: Bricks loaded on Yosemite take 6 slots.

Courier Trainee
Hours required: 0
Can transport cargo in: Picador, Sadler, Sadler (shit), Bobcat, Walton, Yosemite

Courier
Hours required: 12
Can transport cargo in: same as above + Pony, Topfun, Burrito

Professional Courier
Hours required: + 24 more
Can transport cargo in: same as above + Rumpo, Boxville

Trucker Trainee
Hours required: + 32 more
Can transport cargo in: same as above + Benson, Mule + DFT-30 + Packer + Securicar

Trucker
Hours required: + 48 more
Can transport cargo in: same as above + Yankee + Flatbed

Professional Trucker
Hours required: + 48 more
Can transport cargo in: same as above + Article Trailers, Petrol Trailer, Dump Trailer


List of Vehicles

There are many vehicles that may be used for trucking! But not all of them can transport everything! There are two important things. The first one is the capacity. Every truck has got a storage of a limited slots. One slot is taken by 1 crate of something or 1 cubic meter of liquids or 1 tonne of loose material. The second important thing to notice is what the truck can transport. Most of the trucks can only transport crates! But there are other important commodities such as wood logs, vehicles, fuel, milk, etc.

Transporting Crates
Image

The following commodities are transported in crates:
gunpowder, steel shapes, clothes, wood planks, beverages, meal, car parts, appliances, fruits, meat, eggs

    Image
    Picador
    Can transport: crates
    Capacity: 2 slots

    Image
    Sadler
    Can transport: crates
    Capacity: 2 slots

    Image
    Sadler (shit)
    Can transport: crates
    Capacity: 2 slots

    Image
    Bobcat
    Can transport: crates
    Capacity: 3 slots

    Image
    Walton
    Can transport: crates
    Capacity: 4 slots

    Image
    Yosemite
    Can transport: crates, bricks*
    Capacity: 6 slots

    Image
    Pony
    Can transport: crates
    Capacity: 10 slots

    Image
    Topfun (RC van)
    Can transport: crates
    Capacity: 10 slots

    Image
    Burrito
    Can transport: crates
    Capacity: 10 slots

    Image
    Rumpo
    Can transport: crates
    Capacity: 12 slots

    Image
    Boxville
    Can transport: crates
    Capacity: 12 slots

    Image
    Benson
    Can transport: crates, bricks*
    Capacity: 16 slots

    Image
    Mule
    Can transport: crates, bricks*
    Capacity: 18 slots

    Image
    Yankee
    Can transport: crates, bricks*
    Capacity: 24 slots

    Image
    Article Trailer 1
    Can transport: crates, bricks*
    Capacity: 36 slots

    Image
    Article Trailer 2
    Can transport: crates, bricks*
    Capacity: 36 slots

    * 1 pallet of bricks = 6 slots

Transporting Liquids
The following commodities are liquids:
fuel, milk, dyes

    Image
    Petrol Trailer
    Can transport: liquids
    Capacity: 40 slots (40 m³)

Transporting Loose Material
The following commodities are loose:
scrap metal, cotton, cereal, malt, aggregate

    Image
    Flatbed
    Can transport: loose
    Capacity: 16 slots (16 tonnes)

    Image
    Dump Trailer
    Can transport: loose
    Capacity: 30 slots (30 tonnes)

Transporting Wood Logs & Transformers
Image


    Image
    DFT-30
    Can transport: wood logs, transformers, bricks
    Capacity: 18* slots

    *18 slots = 1 wood logs; or 1 transformer; or 3 brick pallets

Transporting Vehicles
Image


    Image
    Packer
    Can transport: vehicles
    Capacity: 2 slots

Transporting Expensive Cargo
Image

The following commodities are expensive:
weapons, coins
Note! You'll need a special permission to transport these commodities!

    Image
    Securicar
    Can transport: crates, strongboxes
    Capacity: 16 slots
Last edited by TomsonTom on Sun Dec 01, 2013 4:46 pm, edited 2 times in total.
:)

User avatar
TomsonTom
Party Developer
Posts: 1523
Joined: Wed Aug 06, 2008 3:28 pm
Location: Czech Republic

Re: Trucker Career [New]

Post by TomsonTom » Tue Oct 29, 2013 2:44 pm

Frequently Asked Questions


  1. Where are the free public trucks?
    They disappeared. You can still rent a Bobcat for $2,500 around the airport and use it for trucking, but no free trucks are available anymore. You can join a trucking faction, borrow a truck from a friend or share one with more people if you don't have money for your own.

  2. Why did you remove the free trucks?
    Because players were using free trucks for their private trips and because they did not value such vehicles and they crashed everything with them. Do not worry about new players: basic pick up truck is available for chicken feed, so even a new player can afford one. The same thing already works with Towtrucks, by the way. There aren't any free Towtrucks on the server and no one is crying about it.

  3. Can I buy my own big truck like a Linerunner?
    Yes, but they are very expensive.

  4. Am I able to buy a trailer for my truck?
    No. Use public ones (see map). Every player may only spawn one private vehicle.

  5. The system is very complex. Can I have a tutorial?
    Simple things tend to be boring after a while. Complex things, however, cannot be fully understood in a minute and it makes them more interesting and enjoyable. You can read a simple tutorial here. If you want to do more advanced things, read this documentation or ask experienced truckers.

  6. What about the transportation of valuable cargo (weapons and coins)?
    They can only be transported in Securicars, but these cars are not available for civilians. Only official factions can buy them with admin assistance.

  7. What different objects can I load on my truck?
    GTA: San Andreas has got a lot of in-game objects, but many of them are unusable (too big, too small, breakable, cast weird shadows). For the sake of the vehicle slots system, it is much easier to transport cargo in crates. Well, we use crates in real life as well, don't we? Different kinds of cargo can be stored in crates: fruits, bottles of beverages, car parts, etc.

    Along with the crates, you are able to (visually) transport wood logs, transformers and bricks (on a DFT-30; bricks even on a Yosemite) and cars (on a Packer). Cargo is however only visible on some vehicles: pick-up trucks, DFT-30 and Packers. On other vehicles that have the cargo stored inside them (such as Burrito, Boxville, article trailer) cargo is invisible (makes sense, doesn't it?).


  8. My camera is weird when I transport big items in my truck.
    It is a problem in the GTA: San Andreas game engine and I cannot do anything about it. The objects have been adjusted but still some of them cause camera problems. All of those problems however disappear as soon as your truck starts moving.

  9. Are police able to determine whether the cargo is stolen?
    Yes and no. The script doesn't come with any magical command to find out whether the cargo is stolen. Not only it would use much more server resources, but also it could cause confusion in situations when your friend or employee bought the cargo for you. How could the server determine whether it was your friend or a robber?

    For the 'yes' part: police can ask the driver for in-character documents and receipts of the cargo. If the driver doesn't have anything like this, the cargo is probably stolen. Police may then role-play a call to the industry and ask for the name of who had bought the cargo. Just improvise and enjoy the role-play! (No OOC lying and powergaming, right? That's bannable.) Also, robbed people usually call 911 and explain who had stolen their cargo.


  10. I think that the profits / capacities / etc. are too low / high.
    I worked hard on deciding on all that and I think it is fair enough. If you have any serious problems with the values you can send me a PM and I will check it.

  11. When do car mechanics and detectives buy components?
    In the appropriate industries. Type /buycomp and a checkpoint will be crated there.

  12. How can I put the map in-game?
    See this tutorial (made by Meir Peretz).
:)

User avatar
TomsonTom
Party Developer
Posts: 1523
Joined: Wed Aug 06, 2008 3:28 pm
Location: Czech Republic

Re: Trucker Career [New]

Post by TomsonTom » Wed May 07, 2014 12:39 pm

Released.
:)

User avatar
TomsonTom
Party Developer
Posts: 1523
Joined: Wed Aug 06, 2008 3:28 pm
Location: Czech Republic

Re: Trucker Career

Post by TomsonTom » Sat Jul 19, 2014 12:58 pm

Changed vehicle permissions. Pickups can now be driven by all truckers + some other changes.
:)

User avatar
TomsonTom
Party Developer
Posts: 1523
Joined: Wed Aug 06, 2008 3:28 pm
Location: Czech Republic

Re: Trucker Career

Post by TomsonTom » Sun Mar 20, 2016 6:14 pm

Suddenly a weird bug appeared when using /cargo list. Clicking the "Pick Up" button did not do anything.

This bug has been fixed, but in case it does not work anytime in the future, use the /cargo listpickup [ID] workaround. This is a new command that was added as a possible solution.

Image
:)

Post Reply

Return to “Feature documentation”

Who is online

Users browsing this forum: No registered users