Difference between revisions of "Useful Functions"

From Multi Theft Auto: Wiki
Jump to: navigation, search
(Undo revision 49990 by Marcin778 (talk))
Line 1: Line 1:
 +
<pageclass class="#228B22"></pageclass>
 +
{{MessageBox|
 +
  bordercolorhex = 000000 |
 +
  bordertype = dotted |
 +
  bgcolorhex = EFEFEF |
 +
  image = File:Package-x-generic.png |
 +
  title = Don't forget to check out the [[Useful Classes]] |
 +
  subtext = <span style="font-size: 85%;">''That page lists user-made classes that are not included by default in MTA. ''</span> |
 +
}}
 +
{{Adding_Pages_to_Categories_and_Templates}}
  
= Strzeżcie się tych pseudo skrypterów, którzy tworzą swoje pseudo serwery! =
+
This page lists user-made Lua functions that are not included by default in MTA. Its purpose is to quickly provide some useful functions for scripters, so they do not waste time recreating them when needed.
 
+
<br/>
== '''Emm - krul i władca wszystkich skrypterów''' ==
+
{{Useful_Functions}}
 
+
[[ES:Funciones Útiles]]
== '''marcin778 - optymalizacja to podstawa''' ==
+
[[ru:Useful Functions]]
 
+
[[de:Nützliche_Funktionen]]
Witam, od około miesiąca pracuje wraz z jedną osobą nad projektem RPG, który będzie nosił nazwę creativeGame. Mamy duże inspiracje oraz wiele ciekawych pomysłów, zadbaliśmy o to aby były to nie powtarzalne pomysły, czyli gdzie indziej takich rzeczy nie znajdziecie. Cały czas pracujemy nad serwerem. Modelarz ukończył już jeden z kilku wozów dla PSP. Dla policji(SAPD) są już pierwsze skrypty tj. wyposażenie dość rozbudowane, i trwają prace nad bazą danych SAPD. Gotowe także są już sygnały dźwiękowe oraz barierki/pachołki z oświetleniem zarówno jak i bez.  Dzięki sporej kreatywności i wyobraźni sądzimy, że uda nam się wybić na scenie MTA. Nie uważamy się za najlepszych, jednakże dzięki pomysłom możemy osiągnąć sukcesy. W zanadrzu i przygotowaniu mamy już bardzo wiele unikalnych rzeczy, wiele nowych prac dorywczych i aspektów zmieniających rozgrywkę, powodując, że nie będzie ona polegała na znanym schemacie z innych serwerów czyli
+
[[PL:Użyteczne Funkcje]]
-Zarabiaj
+
[[Ar:وظائف مفيدة]]
-Kup auto
 
-Kup Dom
 
-Dostań się do frakcji
 
Przez ów plan gry wiele serwerów zostaje po prostu zamkniętych z powodu małej ilości graczy. Dlatego wprowadzimy wiele nowych atrakcji i niespodzianek, których gdzie indziej nie znajdziecie. Poprzez 'nowe' prace dorywcze mam na myśli takie, których jeszcze nie widzieliście. Większość z nich nie polega tylko na jeżdżeniu po checkpointach. Mamy również wiele niespodzianek odnośnie pojazdów. Między innymi:
 
-Pasek rozrządu się zrywa
 
-Przestają działać przewody zapłonowe
 
-Przepalają się żarówki od reflektorów
 
I wiele więcej takich smaczków.
 
Planowaliśmy również dodać dźwięki silnika dla pojazdów, aczkolwiek zrezygnowaliśmy ponieważ przy dużej ilości pojazdów w jednym miejscu z włączonym silnikiem nastąpiły by ogromne spadki FPS oraz zlewające się dźwięki były by nie do zniesienia. Niestety ten element odpada. Nie martwcie się i tak was zaskoczymy.
 
 
 
Nie chcę tutaj przedstawiać zbyt wiele by nasze pomysły nie zostały skradzione.
 
 
 
Na chwilę obecną stan prac określa się na ok 25%
 
 
 
Planowana data startu serwera jest szacowana na lipiec 2017, oczywiście data ta na pewno ulegnie zmianie, aczkolwiek muszę tutaj ją uwzględnić.
 
 
 
Screenów nie daję z obawy przed kradzieżą pomysłów oraz z powodu iż jak na razie nie ma zbyt wiele do pokazania. Wszystko jeszcze powstaje.
 
 
 
== '''luki123luki123 - zwyciężca konkursu na najgorszego programiste GTAO''' ==
 
Witam ciebie drogi użytkowniku forum.
 
Chciałbym ciebie prosić o pomoc o tym jak według ciebie zrobić serwer.
 
Możesz opisać jedynie jeden aspekt ( np. Policje, Mechanika etc. ) aby pomóc mi nad stworzeniem serwera który będzie według was przyjemny do grania.
 
Nie chce stworzyć kolejnego serwera "pseudola" których jest pełno na polskiej scenie MTA:SA ale coś co będzie nowym innowacyjny projektem na scenie MTA:SA. Ale nie zapominajmy że to ma być serwer RPG więc pomysłu podsyłacie na to jaki ma być serwer RPG a nie RP czy też Zombie itp.
 
 
 
Wszelkie propozycje będę rozpatrywał bardzo uważnie.
 
Zacznę pisać projekt kiedy wizja serwera będzie w pełni utworzona.
 
Więc czym szybciej zostanie ukończona wizja tym szybciej serwer wystartuje.
 
Mam już kilka innowacyjny pomysłów na serwer ale czekam na wasze zdanie, ponieważ chce zrobić serwer dla graczy a nie na swoja własną wizje.
 
 
 
Zapraszam do pisania propozycji
 
 
 
== '''AlteX - co miesiac tworzy nowy serwer taki on szybki''' ==
 
Witajcie .
 
 
 
Po długich zastanowieniach oraz rozmowach , nasza ekipa doszła do wniosku aby stworzyć w pełni autorski serwer pod nazwą " Your common dream " .
 
 
 
Ten projekt powstaje dzięki użytkownikom tego forum gdyż to wy daliscie nam do zrozumienia aby stworzyć coś swojego a nie tworzyć serwer na skryptach z neta .
 
 
 
Administracja :
 
AlteX - skrypty/mapy/dodatki
 
Barcioo - Skrypty/Forum/Grafiki .
 
 
 
Nasz projekt ma powstawać dzięki waszym propozycją abyście dodali też coś od siebie i mieli się czym pochwalić przy oficjalnym starcie serwera .
 
Oczywiście osoby które będą dawały nam ciekawe propozycje z automatu będą betatesterami serwera abyście sami mogli przetestować swój pomysł .
 
Pracę nad serwerem ruszają od jutra , więc już niedługo powinny ukazać się pierwsze ss'y z naszej pracy wszystkie aktualizację będą dodawane na bieżąco .
 
 
 
Chcesz stworzyć coś swojego albo dołączyć się do naszej ekipy ? Nie ma problemu wystarczy że znasz się na lua lub potrafisz stworzyć mapę jedyną w swoim rodzaju . Wystarczy że napiszesz do mnie na pw forum i opiszesz tam co potrafisz a nawet możesz podeslać ss'a swojej pracy , a my zaprosimy cię do wspólnego ustalenia jak to dalej będzie .
 
Przewidywany start serwera : 01.02.2017 .
 
Twoje Wspólne Marzenie
 
Dlaczego akurat wybrałem taką nazwę ?
 
To chyba jest oczywiste ,
 
chce aby nasz serwer spełnił twoje marzenia .
 
 
 
Zapraszam do dawania nam propozycji co ma się znaleść na serwerze a my nad tym pomyślimy i może właśnie twój pomysł zostanie stworzony w naszym projekcie .
 
Dziękuje za poświęcenie czasu na przeczytanie tej zapowiedzi i życzę ci wspaniałych pomysłów .
 
 
 
== '''NankY. - chuj wie kto to ale pseudole robi dobre''' ==
 
settingMTA - Serwer RPG(Role Play Gaming) czyli odgrywanie realnego życia oraz czysta rozgrywka, na serwerze znajdziemy: Doświadczoną administrację, autorskie zasoby/mapy/grafiki oraz brak jakichkolwiek błędów/luk w Game-Modzie.
 
Prace nad zasobami serwera nie idą zbyt szybko żeby nie robić niczego na "odwal się", serwer będzie posiadał m.in. autorskie modele postaci/budynków wykonane przez R3n0, serwer ma na celu pokazać że jednak RPG nie upadło że potrafią powstać serwery z autorskimi zasobami bo dotychczas powstają serwery na znanych Game-Modach typu: Our-Game, SquareRPG, TPR, YWG itp. serwer nie ma zamiaru korzystać z żadnych zasobów wymienionych GM. Serwer powstał z inicjatywy 2 skrypterów oraz 1 modelera: .nankY, NankjU., R3n0. sMTA jest 4 reaktywacją projektu Setting-Life tym razem na 100% udaną.
 
 
 
Forum serwera: sMTA.PL ( NIEAKTYWNE )
 
Nazwa serwera: settingMTA
 
Przewidywana ilość slotów na start: 250
 
Team-Speak 3 serwera: sMTA.GCLAN.PL
 
Założyciele serwera: .nankY, .nankjU
 
Hosting: OVH.PL ( DEDYK )
 
Przewidywany start serwera: 2016-01-20
 
 
 
Z poważaniem .nankY
 
Zakaz kopiowania grafiki/treści reklamy w celu użytku własnego
 
 
 
[ Dodano: 2016-12-29, 16:22 ]  
 
Dotychczasowe informacje dot. aktualizacji na serwerze będą umieszczane tutaj!
 
 
 
== '''Podhal - przydupas Aspera''' ==
 
Witaj, zapewne odwiedziłeś naszą zapowiedź na tym portalu gdyż poszukujesz:
 
- Innowacyjnego serwera RPG.
 
- Miejsca gdzie rozegrasz ciekawe akcje role play.
 
- Miejsca gdzie administracja zrozumie graczy.
 
- Serwera który nie jest tworzony dla pieniędzy.
 
- Serwera na autorskich zasobach.
 
- Serwera gdzie nie ma faworyzacji graczy.
 
 
 
Jak sądzisz czy jest jeszcze takie miejsce?
 
 
 
Oczywiście, że jest. Takie miejsce znajduje się właśnie przed waszymi
 
oczami, HanceRPG, serwer tworzony dla graczy nie dla pieniędzy.
 
 
 
Dlaczego to właśnie u nas masz rozpocząć rozgrywkę?
 
 
 
Cóż jest to bardzo ciężkie pytanie, zapewne nie wybierzesz nas przez zasób jednak
 
przez atmosferę, dobrą administracji znającą od podstaw skrypt rozgrywki gdyż
 
to właśnie z nimi rozpoczęliśmy pierwsze prace, pierwsze testy.
 
 
 
Nasz plan.
 
Nasz plan jest dosyć prosty, chcemy stworzyć nowe innowacyjne miejsce dla graczy
 
na którym każdy znajdzie coś dla siebie.
 
Jak wiemy większość projektów RPG jest wzorowanych na różnych life
 
jednak bez obaw. Naszego projektu to nie dotyczy, staramy się stworzyć miejsce
 
gdzie każda osoba znajdzie coś dla siebie, od funkcjonariuszy role play po gangsterów dm.
 
Tutaj każdy znajdzie coś dla siebie…
 
Postanowiliśmy rozwinąć to wszystko w kierunku nowego miasta jednak o tym za chwilę...
 
 
 
Miasto, miejsce rozgrywki.
 
Tak jak wyżej wspomniałem jesteśmy innowacyjnym projektem dlatego też pracujemy nad własnym miastem a dokładniej nad Las Mountenos. Miasto to nie będzie wzorować się na żadnej prawdziwej miejscowości, staramy się stworzyć własne miasto z własną historią którą zaraz zaprezentujemy.
 
 
 
Historia miasta
 
Miasto zostało założone w 1999r. Przez nie jakiego Marca Diemado. Miasto do 2004r. działało głównie jako schronienie lub miejsce schronienia na jakiś czas dla rybaków, mafi, szajek, firm transportowych drogą morską. Jednak w 2009r. do miasta przeprowadził się znany biznesmann, John Smith razem z jego żoną Abellą Smith (Bogata para biznesmenów). Rozpoczęli normalnie, wybudowali jeden hotel w 2009 roku, rok później założyli spółkę mieszkalną ,,Sunny Smile” (Słoneczny Uśmiech). Kilka dni po utworzeniu spółki bogata para rozpoczęła budowę wielu domów. W 2010r. do miasta przeprowadziło się około 20.000 tysięcy mieszkańców dzięki owej spółce. Dnia 20.11.2014 rok w mieście mieszkało około 210.000 tys. mieszkańców i wszyscy żyją i żyli "prawdopodobnie" szczęśliwie.
 
 
 
Zasady, kary, regulaminy itp.
 
Zasady, kary będziemy robić razem z graczami dzięki forum które nie długo wystartuje.
 
Kary, kary na serwerze będą dosyć proste, oczywiście mówimy o karach za utrudnianie rozgrywki itp.
 
Tak więc kary będą dosyć znane, ban, kick, mute, adminjail.
 
 
 
Informacje ogólne
 
IP: Wkrótce.
 
Forum: W trakcie prac.
 
Planowany start: 26.02.2017r data najprawdopodobniej ulegnie zmianie.
 
 
 
Coś ode mnie :)
 
 
 
Cześć i czołem, dzisiaj prezentuje wam mój projekt nad którym obecnie pracuję, nie wiem czy przeczytaliście wszystko dlatego powiem Ci to wszystko tutaj na szybko. Tak więc pracuję razem z moją ekipą nad stworzeniem nowego miasta Las Mountenos. Planujemy razem stworzyć innowacyjne miejsce rozgrywki dla każdego gracza, więcej dowiecie się na forum które za jakiś czas zostanie udostępnione dla Was, miłego dnia ew. wieczoru. :)
 
 
 
PS. Zapraszam do zadawania pytań/komentowania pod tematem.
 
 
 
== '''Inni świetni programiści''' ==
 
 
 
'''Barcioo'''
 
 
 
'''ExtreM'''
 
 
 
'''gg55'''
 
 
 
'''VatraSs123'''
 
 
 
'''OskarYT'''
 
 
 
'''Rookspack'''
 
 
 
'''mixLoLmix'''
 
 
 
= i oczywiście ukochany przez nas wszystkich '''TRIN''' =
 

Revision as of 17:52, 1 January 2017

Package-x-generic.png Don't forget to check out the Useful Classes

That page lists user-made classes that are not included by default in MTA.
Contributors: Did you create a page but it's not on this list? Confused? Read: Adding Pages to Categories and Templates

This page lists user-made Lua functions that are not included by default in MTA. Its purpose is to quickly provide some useful functions for scripters, so they do not waste time recreating them when needed.

Table functions

  • isValueInTable » This function returns true if the value exists in the table, false if the value does not exist in the table.
  • setTableToSql » This function is used to save the table in the database (sql).
  • getTableFromSql » This functionality is used to obtain saved tables using the function (SetTableToSql ).
  • rangeToTable » This function converts a string range to a table containing number values.
  • setTableProtected » This function protects a table and makes it read-only.
  • Sort_Functions » These functions are able to sort your tables by a key.
  • table.compare » This function checks whether two given tables are equal.
  • table.copy » This function copies a whole table and all the tables in that table.
  • table.empty » This function checks whether a table is empty.
  • table.map » This function goes through a table and replaces every field with the return of the passed function, where the field's value is passed as first argument and optionally more arguments.
  • table.merge » This function merges two or more tables together.
  • table.random » This function retrieves a random value from a table.
  • table.removeValue » This function removes a specified value from a table.
  • table.size » This function returns the absolute size of a table.
  • table.getRandomRows » This function returns random rows from table.

ACL functions

  • aclGroupClone » This function clone a group to another group with/without ACLs and/or objects.
  • getPlayerAcls » This function returns a table of all ACL groups on a player.
  • isPlayerInACL » This function checks if a player element is in an ACL group.
  • isPlayerStaff » This function checks if a player is server admin or staff.
  • renameAclGroup » This function gives an existing ACL group a new name.

Account functions

Camera functions

  • smoothMoveCamera » This function allows you to create a cinematic camera flight.

Cursor functions

  • getCursorMovedOn » This function checks in which way the cursor is currently moving.

Drawing functions

Effects functions

  • attachEffect » This function allows you attach an effect to an element.

Elements functions

  • getElementSpeed » This function returns the specified element's speed in m/s, km/h or mph.
  • getElementsInDimension » This function returns a table of elements that are in the specified dimension.
  • getElementsWithinMarker » This function returns a table of elements that are within a marker's collision shape.
  • isElementInPhotograph » This function checks if an element is in the player's camera picture area.
  • isElementInRange » This function allows you to check if an element's range to a main point is within the maximum range.
  • isElementMoving» This function checks if an element is moving.
  • isElementWithinAColShape» This function checks if an element is within a collision shape element.
  • multi_check » This function checks one element to many, handy and clean.
  • setElementSpeed » This function allows you to set the speed of an element in kph or mph units.

Events

  • onVehicleWeaponFire » This code implements an event that is triggered when a player in a vehicle fires a vehicle's weapon.

Input functions

  • bindControlKeys » This function allows you to bind each key bound to a control individually. Doing this bypasses a little MTA restriction.
  • getBoundControls » This function returns a table of control names that are bound to the specified key.
  • unbindControlKeys » This function allows you to unbind each key bound to a control individually. Use this function with bindControlKeys.
  • getClipboard » This event returns the contents of the clipboard by pressing ctrl + v / ctrl + V. Event triggered ONLY if cursor is showing.

Data functions

  • byte2human » This function converts an integer (number of bytes) into a human-readable unit.
  • capitalize » This function capitalizes a given string.
  • convertNumber » This function converts and formats large numbers.
  • convertServerTickToTimeStamp » This function converts server ticks to a unix timestamp.
  • convertTextToSpeech » This function converts the provided text to a speech in the provided language which players can hear.
  • findRotation » This function takes two points and returns the direction from point A to point B.
  • findRotation3D » This function takes two sets of XYZ coordinates. It returns the 3D direction from point A to point B.
  • FormatDate » This function formats a date on the basis of a format string and returns it.
  • generateString » This function generates a random string with any characters.
  • generateRandomASCIIString » This function returns a random string which uses ASCII characters.
  • getAge » This function calculates the age of a given birthday.
  • getDistanceBetweenPointAndSegment2D » This function takes point coordinates and line (a segment) starting and ending coordinates. It returns the shortest distance between the point and the line.
  • getEasterDate » This function returns easter date monthday and month for a given year.
  • getKeyFromValueInTable » This function returns the key of the specified value in a table.
  • getOffsetFromXYZ » This function allows you to take an entity and a position and calculate the relative offset between them accounting for rotations.
  • getPointFromDistanceRotation » This function finds a point based on a starting point, direction and distance.
  • getRealMonthH » This function convert english months to arabic months
  • getRealMonthM » This function gives you the real months name
  • getRGColorFromPercentage »This function returns two integers representing red and green colors according to the specified percentage.
  • getScreenRotationFromWorldPosition » This function returns a screen relative rotation to a world position.
  • getTimestamp » This function returns the UNIX timestamp of a specified date and time.
  • isLeapYear » This function returns a boolean representing if a given year is a leap year.
  • isValidMail » This function checks whether a provided e-mail string is valid.
  • removeHex » This function is used to remove hexadecimal numbers (colors, for example) from strings.
  • RGBToHex » This function returns a string representing the color in hexadecimal.
  • secondsToTimeDesc » This function converts a plain seconds-integer into a user-friendly time description.
  • string.count » This function counts the amount of occurences of a string in a string.
  • string.explode » This function splits a string at a given separator pattern and returns a table with the pieces.
  • switch » This function allows the value of a variable or expression to control the flow of program execution via a multiway branch.
  • toHex » This function converts a decimal number to a hexadecimal number, as a fix to be used client-side.
  • var dump » This function outputs information about one or more variables using outputConsole.
  • wavelengthToRGBA » This function converts a physical wavelength of light to a RGBA color.
  • getDistanceBetweenElements » Esta funcion sirve para obtener la distancia entre dos elementos.
  • isLowerOrUpper »This function checks whether the letter is large or small.

GUI functions

  • centerWindow » This function centers a CEGUI window element responsively in any resolution.
  • guiMoveElement » This function moves guiElement by/like using moveObject.
  • isMouseOnGUICloseButton » This function allows you to check whether the mouse cursor/pointer is within a gui-window's native close button.
Comboboxes
Gridlists
Labels
  • guiLabelAddEffect » This function add a effects to the gui-label like (shadow, outline).

Marker functions

Math functions

  • mathNumber » This function is a workaround for the client-side floating-point precision of 24-bits.
  • math.hypot » This function returns the Hypotenuse of the triangle given by sides x and y.
  • math.percent » This function returns a percentage from two number values.
  • math.round » Rounds a number whereas the number of decimals to keep and the method may be set.
  • reMap » Re-maps a number from one range to another.
  • math.isPointInPolygon » Check if point is inside polygon or not.
  • math.polygonArea » Compute area of any polygon.
  • math.randomDiff » Generates a pseudo-random integer that's always different from the last random number generated.

Map functions

  • assignLod » This function lets you conveniently generate and apply a LOD model to a mapping object

Ped functions

  • getAlivePlayers » This function returns a table of the alive players client-side.
  • getAlivePlayersInTeam » This function returns a table of the alive players in a team.
  • getPlayersInVehicles » This function returns a table of the players insides vehicles from a specified dimension.
  • getGuestPlayers » This function gets a players not login or players Guest .
  • getOnlineAdmins » This function returns a table of all logged-in administrators.
  • getPedEyesPosition » This function allows you to get peds eyes position.
  • getPedMaxHealth » This function returns a pedestrians's maximum health by converting it from their maximum health stat.
  • getPedMaxOxygenLevel » This function returns a ped's maximum oxygen level by converting it from their maximum underwater stamina stat.
  • getPlayerFromNamePart » This function returns a player from partial name.
  • getPlayerFromSerial » This function returns a player from their serial.
  • getPlayersByData » This function returns a table of players that have the specified data name.
  • getPlayersInGroup » This function returns all Players In Group .
  • getPlayersInPhotograph » This function returns a table of all players in photograph.
  • isPedAiming» This function checks if a pedestrian is aiming their weapon.
  • isPedAimingNearPed » This is similar to isPedAiming but uses a colshape to be more precise.
  • isPedDrivingVehicle » This function checks if a specified pedestrian is driving a vehicle.
  • isPlayerInTeam » This function checks if a player is in a specified team.

Player functions

  • countPlayersInRange » This function returns the number of players that are within a certain range of the specified coordinates.

Resource functions

Sound functions

Browser functions

  • playVideo » This function plays a video on the screen.

Team functions

Vehicle functions

Weapon functions

XML functions

  • getXMLNodes » This function returns all children of a XML node.

Utility

  • animate » This function allows you to use interpolateBetween without render event and easily used.
  • callClientFunction » This function allows you to call any client-side function from the server's side.
  • callServerFunction » This function allows you to call any server-side function from the client's side.
  • Check » This function checks if its arguments are of the right type and calls the error-function if one is not.
  • coroutine.resume » This function applies a fix for hidden coroutine error messages.
  • getBanFromName » This functions returns the ban of the given playername.
  • getCurrentFPS » This function returns the frames per second at which GTA: SA is running.
  • IfElse » This function returns one of two values based on a boolean expression.
  • isCursorOnElement » This function checks whether the cursor is in a particular area.
  • isMouseInCircle » This function checks if a cursor position is in circular area or not.
  • isMouseInPosition » This function allows you to check whether the mouse cursor/pointer is within a rectangular position.
  • iterElements » This function returns a time-saving iterator for your for-loops.
  • thisCommandHandlersExist » This method checks a string if this exist as command Handlers
  • vector3:compare » This method checks whether two vectors match, with optional precision.
  • preprocessor » This function allow you to use gcc macros.