Special thank's

The original program was written by MonkOnHotTinRoof. I had his permission to maintain and develop it because it stopped the development. Thank's a lot Monkter for your initial prog

Dev Team
Gai-Luron : Official Coder
Bass-Driver: Support & Coder
LakynVonLegendaus: Support & Coder
Yisc[NL] : Support & Script Coder
Sinanju: Support

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.

LFSLapper Development Subforum : Help, Request, Bugs, Scripts
http://www.lfsforum.net/forumdisplay.php?f=262

Download
Version 7.0.9.1

LFSLapper's Manual (Work in progress)
Tutorials

LFSLapper will work for both Demo and Licensed hosts and can be used also for single player games.
Will also work on dedicated servers and Linux OS (Mono required).

Specifications:

• Runs on Windows using .NET, or on Linux with Mono
  
• Written in Microsoft C#.
  
• Source is available under GNU license.
  
• Multi-threaded: A single LFS Lapper instance can manage multiple LFS servers.
  
• Able to reload the configuration without leaving LFS.
  
• Connection to LFS server using UDP or TCP.
  
• Uses the SQLite 3 database for easy data management
  
• Complete scripting language (GLScript) to develop your own scripts and events
  • Management of events triggered by LFS
    
  • Event Timer for Delayed Effects
    
  • Logic tests (IF/ELSE, CASE/SWITCH)
    
  • Loops (WHILE, FOR, FOREACH)
    
  • Global or local variable scope
    
  • Able to call internal LFSLapper functions
    
  • Call script sub-functions
    
  • Easy to use LFS buttons. Multiple buttons on the screen. Fully configurable
    
  • Buttons can auto-close on Timer and generate actions
    
  • Blinking Buttons
    
• Easy to include other custom modules or scripts
  
• Automatic detection of program crashes
  
• Automatic restart
  
• Notification by e-mail on crash.
  
• Complete management of log files for easy debugging of your scripts.
  

Features:

• Create qualification user groups using external files or configuration file
  
• Hotlaps or drift mode
  
• Store lap PBs in Grip (Hotlap) or drift mode
  
• Can calculate PB by an average of 1 to 10 laps
  
• Calculate and store points in drift mode.
  
• Top PBs display in LFS.
  
• Display charts in LFSH (Hottlaps, Drift)
  
• Event-specific scripts
  
• View driver PBs from LFS World
  
• View driver statistics (fuel, km, ...) from LFS World
  
• Export files via FTP to use or display on websites.
  
• Call personalized web pages and run the code returned by these pages
  
• Allows setting the date format for regional support.
  
• Management of node events (enter/exit custom track locations)
  
• GLScript allows function calls on Timer.
  
• Setting permissions on the server according to criteria of lap times by car and circuit.
  
• Manage lists of swear words
  
• Manage driver and car handicapping (Car, Car/track, Driver)
  
• Manage use of driving aids in LFS
  
• Full vote management of LFS to End Race, Restart Race, Restart Qualification
  
• Sort race grid relative to PB or WR
  
• Automatic Car/Track rotation
  
• Display leading or following times separating the driver from other racers
  
• Personalized messages on record (WR)
  
• List qualifying drivers on the server
  
• Events called on Lapper start, new driver connections, disconnections, leaving pits, split times, enter pits, etc. ...
  
• Define custom commands to be executed via LFS chat.
  
• Message flood detection
  
• Set the maximum number of laps allowed by a racer during a session
  
• Detects loss of car control (customisable)
  
• Detects drivers that are too slow
  
• Detects drivers that are parked on the track
  
• Displays speed or distance values depending on the unit chosen by the drivers: km / h, km or mph, mp
  
• Calculates acceleration time
  
• Configurable pit windows
  
• Penalty management: Speeding in pit lane. Jumping the start before the green light
  
• Add/remove autoX objects
  
• Carcollision detection
  
• Object collision detection
  
• Actions buttons
  
• ... And much more
  

Quick start

1. Make sure you have .NET Framework installed (Mono will work, too).
   
2. Extract archive to arbitrary directory.
   
3. please read doc/readme.txt.
   

Utility
Trackinfo maker
Trackinfo maker is an utility who generate a trackInfo.cfg with splitting of wr with your own coefs. I generate the default trackInfo.cfg with this utility
http://cgtavc.monespace.net/la ... wnload/l...ackinfo1.4.zip

Clean SPB
CleanSPB.exe is an utility who clean all spb on PB file
http://cgtavc.monespace.net/la ... nload/lapper/CleanSPB.rar


PBLFSLapperPHPViewer By Gai-Luron
http://cgtavc.monespace.net/la ... wnload/l...PViewer1.0.rar


All prog by Gai-Luron
LFSRelax :http://www.lfsforum.net/showthread.php?t=27913
LFSLapper :http://www.lfsforum.net/showthread.php?t=25756
LFSStat : http://www.lfsforum.net/showthread.php?t=24933

Hello,

New Release: 5.8.4.2

Support multi-language

Gai-Luron

Release 5.8.4.2b

Default language is English and not french. Mistake by me ^^


Gai-Luron

New release

Quote :

+-------------------------------+
|Changes from v5.842 to 5.843 |
+-------------------------------+
1. Fix crash when password is to big in config file. Now send an error message

2. working dir autocreation when a new entry is present in LFSServers.cfg.

3. Add a new directory "defaultfiles" containing default file for autocreation

4. Fix bug in driftdbs when player have a \0 ( zero ) in nickname

Hello,

Release 5.8.4.4 avaiable

Quote :

+-------------------------------+
|Changes from v5.843 to 5.844 |
+-------------------------------+
1. Add Krayy car reset code in LFSLapper
new events
Event OnMaxCarResets() : triggered when MaxCarResets is reached by a player
Event OnCarReset() : triggered when player do a car reset

New param var
MaxCarResets = #;
# number of allowed car reset before triggering OnMaxCarResets

2 Add 3 lapperVar var
RaceLaps = number or laps for a race
QalMins = number or minute in a qual
racelapsleft = Race lap left before end of race

getLapperVar( "RaceLaps" );
or
getLapperVar( "QalMins" );

3 Add updated GUI script From Tim

Hello,

Release 5.8.4.5 avaiable

Quote :

+-------------------------------+
|Changes from v5.844 to 5.845 |
+-------------------------------+
Add Krayy code

1 Add 1 lapperVar var
raceMins = Race in minute pour timed races
numConns = Number of player connected
numPlayers = Number of player on track

getLapperVar( "raceMins" );

2 Add 1 player var
pitStops = Number of pitstop do by a player

GetCurrentPlayerVar("pitStops");
or
GetPlayerVar("nickane","pitStops");

3 Add new GLScritp file "who.lpr". it work with connected.lpr and add
a new command for player
!who -> display player connected

4 Add new GLScritp file "handicapper.lpr". it work with connected.lpr
Allow an admin to assign, save and load handicaps in-race
a new command for player and admin
!hc -> display player connected

SVN repositary updated

Hello,

Release 5.8.4.6 avaiable

Quote :

+-------------------------------+
|Changes from v5.845 to 5.846 |
+-------------------------------+

1 ( Krayy ) Fix bug Reset some Var when race start

2 ( Krayy ) add new GLScript function
UserIsAdmin($userName);
Return 1 if true and 0 if false. Use admin.txt file to get admin
name and add UCID = 0 as admin ( console )
lpr file modified in accordance to the new function

3 Add $AdminFile in LFSLapper.lpr file to specify what file is used
for UserIsAdmin function

Hello,

Release 5.8.4.7 beta available for test purpose.

send me feedback for reorder feature.

Quote :

+-------------------------------+
|Changes from v5.846 to 5.847 |
+-------------------------------+

1 Add $AutoRestartOnFirstFinished = false; config var to determine if the time used
for the AutoRestartRaceSec value

2 Add new glscript command to force rotation to next track
forceRotation();

3 Fix bug on result Race

4 Remove array var $ConfVar[idOfVar] replaced by getConfigVar( idOfVar )

5 Add new command setConfigVar( idOfVar, value )
You can set some config var in event, list of config var that can be modified

adminfile,adminemail,smtpserver,loginmail,passmail,messagetime,showplayercontrol,defaulttopcar,
swearwordslist,swearwordsmax,handicapusers,swapside,autogears,shifter,helpbrake,axisclutch,autoclutch,
mouse,kbnohelp,kbstabilised,customview,votelifesec,voterestart,votequalify,voteend,autorestartracesec,
autorestartonfirstfinished,rotateeverynbraces,enablerotation,rotatetracks,rotatecars,showsplitpb,refreshqualusers,
qualusers,maxfloodlines,maxfloodlinestime,maxsessionlaps,minanglevelocity,maxnbinstunt,maxallowedlaptime1,
maxallowedlaptime2,onidletimeout1,idleexclude,onidletimeout2,gooddriftscore,minimumdriftscore,minimumdriftspeed,
minimumdriftangle,maximumdriftangle,accelerationstartspeed,accelerationendspeed,accelerationstartspeedmph,
accelerationendspeedmph,accelerationprivatemaxtime, maxfastdriveonpit,pitwindowstart,pitwindowstop,
maxcarresets,reordergrid

6 Add new config Var
$ReorderGrid
Set the automatic reoder, value can be
"WR" reorder relative to World Record
"PB" reorder relative to Server Record
"LFS" LFS config file reorder

you can modify it in setConfigVar

Hello,

Release 5.8.4.8 beta available for test purpose.

send me feedback.

Quote :

+-------------------------------+
|Changes from v5.847 to 5.848 |
+-------------------------------+

1 Add new Event : OnEnterPitLane( $fact )
Player Event trigerred when player enter in pit Lane
fact can be:
ENTER // entered pit lane
NO_PURPOSE // entered for no purpose
DT // entered for drive-through
SG // entered for stop-go


2 Add new Event : OnExitPitLane()
Player Event trigerred when player exit pit Lane


3 Add a Global Variable $ListOfPlayers[index] containing the list of all the players connectect to the server
when you reach the end of this list, return ""
Example:
$i=0;
WHILE( $ListOfPlayers[$i] != "" )
WriteLine( "> " . $i . " - " . $ListOfPlayers[$i] . "<");
$i = $i+1;
ENDWHILE
*******************************************************************************
PLEASE UPDATE YOUR SCRIPT TO USE THIS FEATURE INSTEAD OF $ar_user FROM PITBOARD
*******************************************************************************

4 Add new player var : wr
Return the World Record for the current track/Car for the player

5 Fix bugs in !who script and add the use of the ListOfPlayers
*******************************************************************************
PLEASE UPDATE YOUR SCRIPT TO USE THIS FEATURE INSTEAD OF $ar_user FROM PITBOARD
*******************************************************************************
6 Fix bugs in reorder

Hello,

Release 5.8.4.9 beta available for test purpose.

send me feedback.

Quote :

+-------------------------------+
|Changes from v5.848 to 5.849 |
+-------------------------------+
1 Add new player var : ontrack
getCurrentPlayerVar( "onTrack") equal 1 if player is on track and 0 of not

2 Add Winner flag on OnResult using new LFS char, limited button

3 Add new GLScript function to save a group to a file
UserGroupToFile( group, file );
Example:
UserGroupToFile( "admin", "./admin.txt" );

CAUTION:
In a future release ( not released for now ) i create new Lapper function to remove some not good designed functions
Function created:
openPrivBtn in replacement of OpenPrivateButton, this new function need UserName
closePrivBtn in replacement of ClosePrivateButton, this new function need UserName
privMsg need username in this future release
privRcm need userName in this future release
privDelayedCmd in replacement of privDelayedCommand , this new function need UserName

Function removed after a while, please update you script as soon i release this modified version, because in next month i remove definitively this function
openPrivButton
closePrivButton
getCurrentPlayerVar
privDelayedCommand


Each player event receive in this future version in argument the userName who triggered this event to have the ability to use the new function

Sorry for the inconvenience, but it's better for future language extension

Hello,

Release 5.8.5.0 beta available for test purpose.

send me feedback.

This version must be tested accurately because of change in script module to have the ability for a builtin function to return an Array.

Quote :

+-------------------------------+
|Changes from v5.849 to 5.850 |
+-------------------------------+
1 Removed hardcoded Global Variable $ListOfPlayers[index] replaced, see below

2 Add new GLScrip Function GetListOfPlayers(), return an array containing list of players connected
Example
$i=0;
$ListOfPlayers = GetListOfPlayers();
WHILE( $ListOfPlayers[$i] != "" )
... Do What you Want ...
$i = $i +1;
ENDWHILE

3 Add new GLScrip Function GetListOfUsersGroup(), return an array containing list of user sorted in a specified group
Example
$i=0;
$ListOfUsers = GetListOfUsersGroup();
WHILE( $ListOfUsers[$i] != "" )
... Do What you Want ...
$i = $i +1;
ENDWHILE

Slow down!!

haven't had time to send through some suggestions before a new update is out!

PS: Huge thanks for putting arrays into GLScript...that'll make life a lot easier.

Hello,

I slow down but the last features GetListOfUsersGroup,GetListOfPlayers returning an array var change how the scripts must be writed in future and i want to release it quickly. Next features are less important on how write a script ( except GLScript command explained before, but the suppression of the obsolete command it's not for tomorrow , don't worry ).

Gai-Luron

Release 5.8.5.1 beta available for test purpose.

Here are the commands that I never had the time nor the courage to do. I hope they are useful for you

send me feedback.

NB: $CurrPly = GetPlayerInfo( $userName );
$CurrPly is a special array who continusly updated with correct player values
but you can't assign it to another var array using $newVar = $CurrPly;

Quote from Gai-Luron :

Release 5.8.5.1 beta available for test purpose.

Hi Gai-Luron,
I wanted to test the new version but there is no lapper.exe in version 5.8.5.1 .

And when i use ver5.849 then topUser and nearUser with a database storedvalue.dbs from ver.5.844 it gives a error

The following error apear when i type !point in lapper ver 5.849 with storedvalue.dbs from lapper ver. 5.844

Quote from Tim NL :

Hi Gai-Luron,
I wanted to test the new version but there is no lapper.exe in version 5.8.5.1 .

just create a new one
compile the LFSLapper.csproj and put it in the BIN folder

- Error sorted
- Exe available on new release, sorry

Release 5.8.5.2 beta available for test purpose.

send me feedback.

Release 5.9.0.1 beta available for test purpose.

There is a major change in configuration script to allow more flexibility in scripting. Update your main lpr file with new one. All modification to this main file is not a good thing, instead use myInc.lpr to overlap sub or event and catchevent, catchsub to add your feature to an existing main lpr file event or sub in you include files.

Now a script can be added without modify main lpr file

• All release's include script are modified by myself to use new catch feature, take a look in it to modify you own include script and send me the result if you want include new script in main release
  
• Script that are used are now in addonsused.lpr, modify this file to activate or deactivate a script. that's all
  
• Add driftmeter.lpr in default release. To activate it go in addonsused.lpr and remove # before the include
  
• In the future I only include script that don't modify main lpr file
  
• All player event now receive the userName who triggered the event, your old LFSLapper.lpr file is obsolete, modify it or take a freshen version
  

Sorry for this important modifications, but it's for improve LFSLapper scripting

send me feedback.

Might I make a suggestion that 5.853 be renamed as 5.901 and divorced from the 5.8* line, as it (to my mind anyway) represents a HUGE change in the scripting language that will require rewrites of pretty much every Lapper file out there. It might be better to leave those be and start the new fork so people dont get confused (or p**ded off)

Hello!

You are right, i add one or two feature that turn in my mind in GLScripting and do this fork.

Gai-Luron

Release 5.9.0.2 beta available for test purpose.

send me feedback.

Release 5.9.0.3 RC available for test purpose.

send me feedback.

Release 5.9.0.4 RC available for test purpose.

send me feedback.

cool u added some of the stuff i needed for my cruise addon

What a wonderful job you are doing mate.
So many changes since the last time I took a look at the code.
It's confusing me highly at the moment so I won't bother upgrading for a while, until I have enough time to sit down and have a real good look at all the things that have changed.
Anyway, great work and highly appreciated by many people.