Global Fuel System

Revision as of 23:14, 20 January 2013 by imported>NelsonJenkins

The Global Fuel System is an open-use fuel system maintained by the NTBI Group. Anybody can implement GFS into their own vehicles.

System Outline

GFS is designed to act as a roleplay tool. For 7+ years, drivers have roleplayed filling up at nonfunctional fuel stations without any sense of activity or realism, or tried to work with lazy fuel systems that were impossible to understand. With GFS, vehicles have an extra layer of realism, and drivers no longer have to pretend when they're pumping gas - GFS makes it visibly and audibly clear.

Implementing GFS into vehicles is very easy. You will need to contact us to get a GFS toolkit, but after that setup is simple and requires no oversight from us. Instructions are included with the toolkit; if you understand LSL scripting, GFS is simple to integrate.

Open-Use & Usage Agreement

GFS is not open-source. Manufacturers are given access to the pump API; nothing more. To retain control over the system, and in case we wish to upgrade it in the future for more features, NTBI Group retains all rights over the pump and its code. You may not reverse-engineer or otherwise copy the design of the pump or its API to make your own. We distribute the pump freely and allow access to this API freely as a service to roleplayers and drivers in general - please don't fragment the market and create your own. If you have any features or suggestions you wish to add to the system, feel free to contact us and we will consider them.

Pump Usage

The GFS pump operates in the following manner:

  1. Park vehicle directly in front of the pump with fuel filler door on the same side as the pump (maximum 2m away)
  2. Click pump; it will check for the vehicle and you will be given control of the pump (basic instructions will also be sent to the user)
  3. For some vehicles, you must select which fuel type to use by clicking the appropriate button on the pump
  4. Click nozzle to insert it into the vehicle's fuel filler
  5. Click nozzle again to start/stop the pump (nozzle will automatically shut off when tank is full)
  6. Click pump again to finish (nozzle will be removed and fueling is completed)

In some situations, fueling can be interrupted:

  • The vehicle cannot be detected
  • The vehicle is not GFS compatible (or the GFS scripts are not running correctly)
  • The vehicle is moved from its original position
  • The vehicle is put into neutral gear or otherwise made physical (this is not done automatically; it must be set up by the manufacturer)
  • The vehicle's engine is started (again, this must be set up by the manufacturer)
  • The nozzle's target position is over 3m away from the pump (this is to avoid the filler cap being on the opposite side)
  • The operator (user) moves over 16m away from the pump
  • The raycast fails (this is usually a simulator performance issue)

Pump System Setup

Choose which system you want to have:

Single Pump - Manual Pricing

  1. Rez pump and position/rotate to fit.
  2. Click the pump and set prices in the Man Price menu.
  3. Done - when prices are set correctly, the pump will automatically turn on.

Multiple Pumps Automatic Gridwide Pricing (Global Pricing)

  1. Rez pumps and position/rotate to fit.
  2. Number individual pumps by clicking them and choosing "Pump #".
  3. Rez a price sign and position/rotate it.
  4. Click the price sign and choose Global Price.
  5. Click the price sign and choose Get Key. Copy the key given to you in local chat.
  6. Click each pump, select Auto Price, and paste the key. This should automatically sync the prices.
  7. Done - when all of your pumps are set correctly, your station is complete and ready for use.

The price will automatically change to a price given by the NTBI GFS server once every 24 hours. The prices are randomized once a day on the server, and each sign randomizes the prices a bit further to allow for different prices within the same city.

Multiple Pumps - Manual Pricing Synced to All Pumps (Local Pricing)

  1. Rez pumps and position/rotate to fit.
  2. Number individual pumps by clicking them and choosing "Pump #".
  3. Rez a price sign and position/rotate it.
  4. Click the price sign and set prices in the Local Price menu.
  5. Click the price sign and choose Get Key. Copy the key given to you in local chat.
  6. Click each pump, select Auto Price, and paste the key. This should automatically sync the prices.
  7. Done - when all of your pumps are set correctly, your station is complete and ready for use.

The pump can be customized using the Pump Texture option. PUMP PSD TEMPLATE The pump also has an optional price board which can be shown/hidden using the Show/Hide Board option.

The sign can be customized using the Sign Texture option. SIGN PSD TEMPLATE If you do not wish to set up a template, you can specify a logo using the Logo Texture option (logo must be 1:1 aspect ratio and should be alpha - upload as PNG - not JPG). If you use a logo, a "blank" backing template is included at the bottom of the INSTRUCTIONS notecard.