Skip to main content

Dodawanie domków

Domki są przechowywane w bazie danych w tabeli:

Tabela SQL
tW_houses

Każdy rekord w tej tabeli oznacza jedną posiadłość na serwerze.

Domki korzystają z wcześniej dodanych interiorów. W kolumnie interior_id należy podać ID interioru z bazy danych.

Szybka instrukcja​

Aby dodać nowy domek:

  1. Otwórz bazę danych.
  2. Przejdź do tabeli tW_houses.
  3. Dodaj nowy rekord.
  4. Ustaw pozycję domku w position.
  5. Ustaw cenę zakupu w property_price.
  6. Ustaw domyślną cenę najmu w rental_price.
  7. Wpisz ID interioru z bazy danych w interior_id.
  8. Ustaw, czy domek ma być otwarty w is_open.
  9. Ustaw kwotę rachunków w bills_price.
  10. Zapisz rekord w bazie danych.
  11. Zrestartuj zasób tW_houses.
info

Jeżeli domek nie ma mieć właściciela, pozostaw owner_uid puste.
Wtedy posiadłość będzie możliwa do kupienia przez graczy.

warning

Po dodaniu lub zmianie domków należy zrestartować zasób tW_houses.

Struktura tabeli​

Tabela tW_houses posiada następujące kolumny:

KolumnaOpis
positionPozycja domku na mapie. Wymaga formatu JSON.
owner_uidUID właściciela posiadłości. Puste pole oznacza domek możliwy do zakupu.
renter_uidUID najemcy. Puste pole oznacza brak najemcy.
property_priceCena zakupu posiadłości.
rental_priceDomyślna cena najmu za dobę.
interior_idID interioru z bazy danych.
is_openOkreśla, czy domek jest otwarty.
bills_priceKwota rachunków naliczana co tydzień.
current_billsAktualna kwota rachunków do opłacenia.
next_bills_dateData naliczenia kolejnych rachunków.
rental_dateData, do kiedy posiadłość jest wynajęta.
next_rental_checkData sprawdzenia, czy najem został opłacony.
each_rental_day_priceLista wpłaconych czynszów przez najemcę. Wymaga formatu JSON.

Opis wymaganych pól​

Poniżej znajduje się opis najważniejszych pól używanych przy dodawaniu domków.

position​

Kolumna position określa miejsce, w którym znajduje się domek.

Jest to pozycja wejścia do domku w świecie gry.

Dane w tej kolumnie muszą być zapisane w formacie JSON.

Przykład pozycji z gry:

Pozycja z /gp
{ 1234.50, -1432.20, 13.60 }

Wartość do wpisania w bazie danych:

JSON
[[1234.5,-1432.2,13.6]]
tip

Do wygenerowania poprawnego JSON-a możesz użyć narzędzia tableToJSON.

owner_uid​

Kolumna owner_uid określa UID postaci właściciela posiadłości.

Jeżeli pole zostanie puste, domek będzie możliwy do zakupu przez innych graczy.

Przykład domku z właścicielem:

Właściciel posiadłości
owner_uid = 15

Przykład domku bez właściciela:

Domek na sprzedaż
owner_uid = NULL
info

Jeżeli domek ma być dostępny do kupienia, nie ustawiaj owner_uid.

renter_uid​

Kolumna renter_uid określa UID postaci najemcy.

Jeżeli pole zostanie puste, domek nie będzie miał najemcy.

Przykład domku z najemcą:

Najemca
renter_uid = 24

Przykład domku bez najemcy:

Brak najemcy
renter_uid = NULL

property_price​

Kolumna property_price określa cenę zakupu posiadłości.

Jest to cena kupna domku, a nie cena najmu.

Przykład:

Cena zakupu
property_price = 250000

rental_price​

Kolumna rental_price określa domyślną cenę najmu za dobę.

Gracze mogą później zmienić tę wartość w panelu, jeżeli system na to pozwala.

Przykład:

Cena najmu za dobę
rental_price = 1500

interior_id​

Kolumna interior_id określa ID interioru z bazy danych.

Jest to ID rekordu interioru, który ma zostać przypisany do domku.

Przykład:

ID interioru z bazy danych
interior_id = 3
warning

interior_id oznacza ID interioru z bazy danych, a nie ID interioru z gry.

tip

Przed dodaniem domku upewnij się, że interior został wcześniej dodany w tabeli interiorów.

is_open​

Kolumna is_open określa, czy domek jest otwarty dla innych graczy.

Dostępne wartości:

WartośćZnaczenie
0Domek jest zamknięty. Do środka może wejść tylko właściciel i najemca.
1Domek jest otwarty. Inni gracze mogą wejść do środka.

Przykład zamkniętego domku:

Domek zamknięty
is_open = 0

Przykład otwartego domku:

Domek otwarty
is_open = 1

bills_price​

Kolumna bills_price określa kwotę rachunków naliczaną co tydzień.

Przykład:

Kwota rachunków
bills_price = 500

current_bills​

Kolumna current_bills określa aktualną kwotę rachunków do opłacenia przez właściciela lub najemcę.

Przykład:

Aktualne rachunki
current_bills = 0
tip

Przy dodawaniu nowego domku najczęściej można ustawić current_bills na 0.

next_bills_date​

Kolumna next_bills_date określa datę naliczenia kolejnych rachunków.

warning

Jeżeli nie ustawiasz właściciela w owner_uid, nie zmieniaj tej wartości ręcznie.
System powinien ustawić ją automatycznie.

Przykład:

Data kolejnych rachunków
next_bills_date = '2026-06-10'

rental_date​

Kolumna rental_date określa datę, do kiedy posiadłość jest wynajęta.

Zastosowanie tej wartości jest głównie wizualne.

Przykład:

Data końca najmu
rental_date = '2026-06-10'

next_rental_check​

Kolumna next_rental_check określa datę sprawdzenia, czy najem został opłacony.

warning

Jeżeli nie ustawiasz najemcy w renter_uid, nie zmieniaj tej wartości ręcznie.

Przykład:

Data sprawdzenia najmu
next_rental_check = '2026-06-10'

each_rental_day_price​

Kolumna each_rental_day_price przechowuje wpłacone czynsze przez najemcę.

Dane w tej kolumnie muszą być zapisane w formacie JSON.

Forma danych:

Format
[[kwota1, kwota2]]

Każda liczba reprezentuje kolejny dzień.

Przykład:

Przykład
[[1500, 1500, 1500]]

Powyższy przykład oznacza, że najemca opłacił trzy dni najmu po 1500.

tip

Do wygenerowania poprawnego JSON-a możesz użyć narzędzia tableToJSON.

Jak przygotować pozycję w formacie JSON?​

Pozycja z komendy /gp ma zwykle formę trzech wartości:

Pozycja z /gp
{ x, y, z }

Do bazy danych należy wpisać ją w formacie JSON:

JSON
[[x,y,z]]

Przykład:

Pozycja z /gp
{ 1234.50, -1432.20, 13.60 }

Poprawna wartość do bazy danych:

JSON
[[1234.5,-1432.2,13.6]]
info

Forma JSON pozycji wygląda tak: [[x,y,z]].

Przykład gotowego rekordu​

Poniżej znajduje się przykład gotowego rekordu domku.

KolumnaPrzykładowa wartość
position[[1234.5,-1432.2,13.6]]
owner_uidNULL
renter_uidNULL
property_price250000
rental_price1500
interior_id3
is_open0
bills_price500
current_bills0
next_bills_dateNULL
rental_dateNULL
next_rental_checkNULL
each_rental_day_priceNULL

Gotowy przykład wartości​

Jeżeli dodajesz rekord ręcznie w bazie danych, pola możesz uzupełnić w taki sposób:

Przykładowy rekord domku
position = '[[1234.5,-1432.2,13.6]]'
owner_uid = NULL
renter_uid = NULL
property_price = 250000
rental_price = 1500
interior_id = 3
is_open = 0
bills_price = 500
current_bills = 0
next_bills_date = NULL
rental_date = NULL
next_rental_check = NULL
each_rental_day_price = NULL

Podsumowanie​

Aby dodać domek:

  1. Dodaj nowy rekord w tabeli tW_houses.
  2. Ustaw pozycję domku w position.
  3. Jeżeli domek ma być na sprzedaż, pozostaw owner_uid puste lub ustaw NULL.
  4. Jeżeli domek nie ma najemcy, pozostaw renter_uid puste lub ustaw NULL.
  5. Ustaw property_price, czyli cenę zakupu.
  6. Ustaw rental_price, czyli cenę najmu za dobę.
  7. W interior_id wpisz ID interioru z bazy danych.
  8. Ustaw is_open na 0 lub 1.
  9. Ustaw bills_price.
  10. Po dodaniu domku zrestartuj zasób tW_houses.

Najważniejsze pola:

PoleZa co odpowiada
positionPozycja domku na mapie
owner_uidUID właściciela
renter_uidUID najemcy
property_priceCena zakupu
rental_priceCena najmu za dobę
interior_idID interioru z bazy danych
is_openCzy domek jest otwarty
bills_priceKwota rachunków
current_billsAktualne rachunki
next_bills_dateData kolejnych rachunków
rental_dateData końca najmu
next_rental_checkData sprawdzenia najmu
each_rental_day_priceLista wpłaconych czynszów
warning

Po dodaniu lub zmianie domków zrestartuj zasób tW_houses.