Difference between revisions of "Global Fuel System"

imported>NelsonJenkins
 
(32 intermediate revisions by 2 users not shown)
Line 1: Line 1:
The '''Global Fuel System''' is an open-use fuel system maintained by the NTBI Group.
+
The '''Global Fuel System''' is an open-use fuel system maintained by the NTBI Group. Anybody can implement GFS into their own vehicles.
 +
 
 +
<font size=3>'''[http://ntbigroup.com/updates/gimme.php?i=TlRCSSBHRlMgRnVlbCBQdW1w CLICK HERE TO GET THE GFS FUEL PUMP KIT]<br>[http://ntbigroup.com/updates/gimme.php?i=TlRCSSBHRlMgRnVlbCBDYW5z CLICK HERE TO GET THE GFS FUEL CANS]'''</font>
 +
 
 +
If you do not have an NTBI Group account, you can also get GFS equipment through the [https://marketplace.secondlife.com/stores/133128 NTBI Group Distribution store.]
 +
 
 +
For the developer's toolkit, see below.
  
 
==System Outline==
 
==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.
+
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 buggy or difficult to understand fuel systems. 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.
+
Implementing GFS into vehicles is very easy. Setup is simple and requires no oversight from us - you are free to use GFS as you wish, but you are not allowed to create your own dispensing devices (pumps, cans, containers, et cetera). Instructions are included with the toolkit; if you understand LSL scripting, GFS is simple to integrate.
 +
 
 +
'''Please be aware that we cannot offer support for integrating GFS into your vehicle.''' GFS is '''not''' "drop-in" compatible with any vehicle scripting system out of the box. GFS is a framework for scripters only.
 +
 
 +
<font size=3>'''[http://ntbigroup.com/updates/gimme.php?i=TlRCSSBHRlMgVG9vbGtpdA== Click here to get the GFS Toolkit]'''</font><br>(you ''must'' log in using an NTBI Group account - this is not available anywhere else)
 +
 
 +
==Compatible Vehicles==
 +
The following NTBI vehicles are compatible with GFS, sorted alphabetically:
 +
* [[TPF-4 Ambulance|Astaro TPF-4 Ambulance]] - [https://marketplace.secondlife.com/p/Astaro-TPF-4-Ambulance/5038231 Buy Here]
 +
* [[Lusch Himalaya]] - [https://marketplace.secondlife.com/p/Lusch-Motors-Himalaya/4792439 Buy Here]
 +
* [[SZYM Intruder]] - [https://marketplace.secondlife.com/p/SZYM-Intruder-Police-Car-Civilian-Sedan/4297604 Buy Here]
 +
Additionally, there is a large variety of third-party vehicles with GFS support from many of the grid's top vehicle creators.
  
 
==Open-Use & Usage Agreement==
 
==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.
+
GFS is ''not open-source''. Manufacturers are given access to the pump API and a sample script; 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==
 
==Pump Usage==
Line 13: Line 30:
 
# Park vehicle directly in front of the pump with fuel filler door on the same side as the pump (maximum 2m away)
 
# Park vehicle directly in front of the pump with fuel filler door on the same side as the pump (maximum 2m away)
 
# 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)
 
# 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)
 +
# For some vehicles, you must select which fuel type to use by clicking the appropriate button on the pump
 
# Click nozzle to insert it into the vehicle's fuel filler
 
# Click nozzle to insert it into the vehicle's fuel filler
 
# Click nozzle again to start/stop the pump (nozzle will automatically shut off when tank is full)
 
# Click nozzle again to start/stop the pump (nozzle will automatically shut off when tank is full)
Line 26: Line 44:
 
* The operator (user) moves over 16m away from the pump
 
* The operator (user) moves over 16m away from the pump
 
* The raycast fails (this is usually a simulator performance issue)
 
* The raycast fails (this is usually a simulator performance issue)
 +
 +
==Units==
 +
Starting in v1.0.4, the pump system comes in two models: a Gallons (Gal) and Liters (L) version. The Liters version will automatically convert prices to liter-denominated amounts, then double them to simulate European price premiums. It is not recommended to mix the two together in the same station.
 +
 +
==Pump System Setup==
 +
Choose which system you want to have:
 +
 +
===Single Pump - Manual Pricing===
 +
# Rez pump and position/rotate to fit.
 +
# Click the pump and set prices in the Man Price menu.
 +
# Done - when prices are set correctly, the pump will automatically turn on.
 +
 +
===Multiple Pumps - Automatic Gridwide Pricing (Global Pricing)===
 +
'''NOTE: Starting with v1.0.4, pumps will automatically connect themselves to a sign in the same region.''' If you have multiple stations in the same region (e.g. multiple signs), you will have to follow these instructions. Otherwise, with the exception of the "Pump #", the system will configure itself automatically.
 +
# Rez pumps and position/rotate to fit.
 +
# Number individual pumps by clicking them and choosing "Pump #".
 +
# Rez a price sign and position/rotate it.
 +
# Click the price sign and choose Global Price.
 +
# Click the price sign and choose Get Key. Copy the key given to you in local chat.
 +
# Click each pump, select Auto Price, and paste the key. This should automatically sync the prices.
 +
# 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)===
 +
# Rez pumps and position/rotate to fit.
 +
# Number individual pumps by clicking them and choosing "Pump #".
 +
# Rez a price sign and position/rotate it.
 +
# Click the price sign and set prices in the Local Price menu.
 +
# Click the price sign and choose Get Key. Copy the key given to you in local chat.
 +
# Click each pump, select Auto Price, and paste the key. This should automatically sync the prices.
 +
# 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. [http://ntbigroup.com/TEMPLATES/NTBI%20GFS%20Free%20Pump%20Texture.psd PUMP PSD TEMPLATE]<br>
 +
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. [http://ntbigroup.com/TEMPLATES/NTBI%20GFS%20Free%20Sign%20Texture.psd SIGN PSD TEMPLATE]<br>
 +
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).<br>
 +
If you use a logo, a "blank" backing template is included at the bottom of the INSTRUCTIONS notecard.

Latest revision as of 07:08, 27 January 2020

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

CLICK HERE TO GET THE GFS FUEL PUMP KIT
CLICK HERE TO GET THE GFS FUEL CANS

If you do not have an NTBI Group account, you can also get GFS equipment through the NTBI Group Distribution store.

For the developer's toolkit, see below.

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 buggy or difficult to understand fuel systems. 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. Setup is simple and requires no oversight from us - you are free to use GFS as you wish, but you are not allowed to create your own dispensing devices (pumps, cans, containers, et cetera). Instructions are included with the toolkit; if you understand LSL scripting, GFS is simple to integrate.

Please be aware that we cannot offer support for integrating GFS into your vehicle. GFS is not "drop-in" compatible with any vehicle scripting system out of the box. GFS is a framework for scripters only.

Click here to get the GFS Toolkit
(you must log in using an NTBI Group account - this is not available anywhere else)

Compatible Vehicles

The following NTBI vehicles are compatible with GFS, sorted alphabetically:

Additionally, there is a large variety of third-party vehicles with GFS support from many of the grid's top vehicle creators.

Open-Use & Usage Agreement

GFS is not open-source. Manufacturers are given access to the pump API and a sample script; 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)

Units

Starting in v1.0.4, the pump system comes in two models: a Gallons (Gal) and Liters (L) version. The Liters version will automatically convert prices to liter-denominated amounts, then double them to simulate European price premiums. It is not recommended to mix the two together in the same station.

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)

NOTE: Starting with v1.0.4, pumps will automatically connect themselves to a sign in the same region. If you have multiple stations in the same region (e.g. multiple signs), you will have to follow these instructions. Otherwise, with the exception of the "Pump #", the system will configure itself automatically.

  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.