Skip to content

NexON39/MTA-XyzzyRP-Web-Administration-Panel

Repository files navigation

MTA XyzzyRP Web Administration Panel

PL

Opis panelu:

Internetowy panel administracyjny XyzzyRP został stworzony z myślą dla osób robiących serwer pod paczkę zasobów XyzzyRP oraz dla tych, którzy chcieliby wprowadzić na swój serwer pewne urozmaicenie. Panel posiada sporą ilość funkcji, statystyk itp. które pozwolą lepiej zarządzać swoim serwerem. Panel jest upowszechniony za w pełni za darmo oraz jest wydany na licencji MIT. Wszystkie problemy, pomysły oraz pytania można zadawać w zakładce Issues na githubie, wiadomości prywatnej na discordzie czy e-mail. Chętnie odpowiem na wszystkie pytania. Panel jest w pełni responsywny oraz zoptymalizowany pod urządzenia mobilne

Wymagania:

  • PHP 7.1 lub wyższa (panel pisany na wersji 8.1.2)
  • Serwer webowy na którym możemy uruchomić aplikację (Apache, nginx itp.)
  • Baza danych mysql
  • Serwer MTA z paczką zasobów XyzzyRP
  • mtasa-php-sdk (Uwaga! Ten podpunkt można pominąć, ponieważ panel ma wbudowaną tę bibliotekę, lecz w razie problemów zapoznać się z instalacją dodatkowych pakietów php mtasa-php-sdk, HTTPlug)
  • Poprawnie skonfigurowany zasób XyzzyRP "DB", "DB2" oraz załadowany moduł mta_mysql.dll
Uwaga! Panel jest w pełni kompatybilny z oryginalną paczką zasobów XyzzyRP. W przypadku użycia nieoryginalnego kodu paczki zasobów może on nie być w pełni kompatybilny.

Instalacja:

  1. Pobieramy repozytorium MTA-XyzzyRP-Web-Administration-Panel. Jeżeli używasz GITa możesz zrobić za pomocą polecenia
    $ git clone https://github.com/NexON39/MTA-XyzzyRP-Web-Administration-Panel
  2. Z folderu [requirements]/SQL wgrywamy skrukturę tabel bazy danych z pliku XyzzyRP_AP.sql do swojej bazy danych
  3. Na serwerze MTA tworzymy konto ACL o wybranym loginie i haśle np. Login: myUser, Hasło: myPassword
  4. Wgrywamy nasz zasób na serwer z folderu [requirements]/[xyyzyrp_ap]
  5. W pliku konfiguracyjnym ACL (acl.xml) w grupie 'Admin' dodajemy naszego użytkownika np. <object name="user.myUser"></object> oraz dodajemy obiekt naszego zasobu <object name="resource.xyzzyrp_ap_lua"></object>
  6. Wgrywamy nasz panel administracyjny na serwer webowy
  7. Przechodzimy do pliku includes/dbconfig_class.php oraz konfigurujemy według podanego wzoru
    public $dbhost = "dbhost"; //host mysql (domyślnie localhost/127.0.0.1)
    public $dbuser = "user"; //nazwa uzytkownika mysql (domyślnie root)
    public $dbpass = "pass"; //hasło użytkownika mysql (domyślnie brak hasła)
    public $dbname = "dbname"; //nazwa bazy danych
  8. Przechodzimy do pliku includes/mtaconfig_class.php oraz konfigurujemy według podanego wzoru
    public $server_ip = "serverip"; //ip serwera (domyślny 127.0.0.1)
    public $server_port = "serverport"; //port http serwera (domyślny 22005)
    public $acl_user = "myUser"; //nazwa uzytkownika acl panelu (np. xyzzyrp_ap)
    public $acl_pass = "myPassword"; //haslo uzytkownika acl panelu
  9. Uruchamiamy zasób xyzzyrp_ap_lua na serwerze
  10. Wchodzimy na adres panelu i logujemy się (domyślny dodany użytkownik to login: admin, hasło: admin

Główne funkcję panelu:

  • Statystyki serwera (przegląd osób online z ostatnich 14 dni, liczba zarejestrowanych itp.)
  • Dane użytkowników serwera (frakcje, domy itp.)
  • Operacje na użytkownikach (ban, kick, aj, dodawanie gp itp.)
  • Logi administracyjne panelu webowego
  • Dodawanie oraz usuwanie użytkowników panelu
  • Zmiana hasła oraz nicku w panelu
  • Darkmode

Informację:

Autor: NexON39

Kontakt discord: NexON39#5665

Kontakt e-mail: [email protected]

Wersja panelu: 1.0.0

W przyszłości planuję liczne aktualizację oraz nowości i mam nadzieję, że pomysł projektu się podoba i komuś się sprzyda ;)

Podgląd panelu:



EN

Panel description:

The XyzzyRP web administration panel was created for people who make a server for the XyzzyRP package and for those who would like to introduce some variety to their server. The panel has a large number of functions, statistics, etc. that will allow you to better manage your server. The panel is distributed for free and is released under the MIT license. All problems, ideas and questions can be asked in the tab Issues on github, private message on discord or e-mail. I am happy to answer all your questions. The panel is fully responsive and optimized for mobile devices

Requirements:

  • PHP 7.1 or higher (panel written on version 8.1.2)
  • A web server where we can run the application (Apache, nginx, etc.)
  • Mysql database
  • MTA server with XyzzyRP resource pack
  • mtasa-php-sdk (Warning! This point can be omitted, because the panel has this library built-in, but in case of problems, see the installation of additional php packages mtasa-php-sdk, HTTPlug)
  • Correctly configured resource XyzzyRP "DB", "DB2" and loaded module mta_mysql.dll
Warning! The panel is fully compatible with the original XyzzyRP resource pack. If a non-genuine resource bundle code is used, it may not be fully compatible.

Installation:

  1. We download the repository MTA-XyzzyRP-Web-Administration-Panel. If you are using GIT you can do it with the command
    $ git clone https://github.com/NexON39/MTA-XyzzyRP-Web-Administration-Panel
  2. From the [requirements] / SQL folder, load the structure of the database tables from the file XyzzyRP_AP.sql to your database
  3. On the MTA server, create an ACL account with the selected login and password, e.g. Login: myUser, Password: myPassword
  4. We upload our resource to the server from the [requirements] / [xyyzyrp_ap] folder
  5. In the ACL configuration file (acl.xml) in the 'Admin' group, add our user, e.g. <object name="user.myUser"></object> and add the object of our resource <object name="resource.xyzzyrp_ap_lua"></object>
  6. We upload our administration panel to the web server
  7. We go to the file includes/dbconfig_class.php and configure according to the given pattern
    public $dbhost = "dbhost"; //host mysql (default localhost/127.0.0.1)
    public $dbuser = "user"; //username mysql (default root)
    public $dbpass = "pass"; //mysql user password (no password by default)
    public $dbname = "dbname"; //database name
  8. We go to the file includes/mtaconfig_class.php and configure according to the given pattern
    public $server_ip = "serverip"; // server ip (default 127.0.0.1)
    public $server_port = "serverport"; // the server's http port (default 22005)
    public $acl_user = "myUser"; // username acl of the panel (e.g. xyzzyrp_ap)
    public $acl_pass = "myPassword"; // password for the acl user of the panel
  9. Run resource xyzzyrp_ap_lua on the server
  10. Enter the panel address and log in (default user added is login: admin, password: admin

The main functions of the panel:

  • Server statistics (overview of people online for the last 14 days, number of registered users etc.)
  • Data of server users (factions, houses etc.)
  • Operations on users (ban, kick, aj, add gp etc)
  • Web panel administration logs
  • Add and remove panel users
  • Changing the password and nickname in the panel
  • Darkmode

Information:

Author: NexON39

Contact discord: NexON39 # 5665

Contact e-mail: [email protected]

Panel version: 1.0.0

In the future, I plan numerous updates and news and I hope that the idea of ​​the project will be liked and will be beneficial to someone;)

Panel preview: