server.properties -asetustiedosto
Tässä artikkelissa ohjeistetaan palvelimen asetuksien muuttamista. Asetustiedoston löydät Gamepanelissa, kun navigoit: Palvelimesi » Files » server.properties
Yksityisellä serverillä on suositeltavaa pitää pääsylista käytössä (white-list=true). Tällöin palvelimelle pääsee vain pelaajat, jotka ovat listalla.
Asetuksen selitykset:
Taulukossa on listattuna kaikki Minecraft-palvelimen asetustiedoston, server.properties asetukset ja niiden kuvaukset. Taulukon komennot ja server.properties-tiedosto on haettu Minecraftin versiosta 1.21.9.
Tiedoston asetukset ovat muotoa nimi=arvo.
Esimerkiksi:
- Asetuksessa:
level-name=worldonlevel-namemerkkijono-tyyppinen asetus, mikä saa syötteekseen merkkijonon:world - Asetuksessa:
max-players=20onmax-playersnumeroarvo tyyppinen asetus, mikä ottaa vastaan kokonaisluvun tai murtoluvun joissakin tapauksissa. Murtoluvun desimaalierotin on piste. - Asetuksessa:
enable-query=trueonenable-querytotuusarvo, joka ontrue(totta/kyllä) taifalse(taru/ei).
| Asetus | Tyyppi | Oletusarvo | Kuvaus |
|---|---|---|---|
| accepts-transfers | totuusarvo | false | Sallii pelaajien siirtämisen palvelimelta toiselle. Eli mahdollistaa /transfer komennon käytön palvelimellesi, millä pelaajan yhdistäminen/siirto toiselta palvelimelta hyväksytään omallesi. |
| allow-flight | totuusarvo | false | Sallii lennon selviytymistilassa. Hyödyllinen etenkin palvelimilla, joissa käytetään lentomodeja. |
| broadcast-console-to-ops | totuusarvo | true | Lähettää konsolin tulostuksia palvelimella oleville operaattoreille (OP). |
| broadcast-rcon-to-ops | totuusarvo | true | Lähettää konsolin rcon komentojen tulostuksia palvelimella oleville operaattoreille (OP) |
| bug-report-link | merkkijono | Tyhjä | Palvelimen osoite (URL) ongelmien raportoimiselle |
| difficulty | merkkijono | easy | Valitsee palvelimen vaikeustason. Asetusta voidaan säätää myös palvelimen sisällä komennolla: /difficulty vaikeustaso |
| enable-code-of-conduct | totuusarvo | false | Aktivoituna näyttää uudelle pelaajalle palvelimen sääntötiedoston, minkä pelaaja joutuu hyväksymään liittyäkseen palvelimelle. Yksinään asetus ei tee mitään, vaan on palvelimen tiedostoihin lisättävä: /codeofconduct/en_us.txt (englanti + muut kielet) /codeofconduct/fi_fi.txt (suomi) |
| enable-jmx-monitoring | totuusarvo | false | Mahdollistaa palvelimen tietojen kuten avarageTickTime ja tickTimes seurannan palvelimen ulkopuolella. |
| enable-query | totuusarvo | false | Sallii palvelimelle tehdyt kyselyt palvelimen asetuksiin liittyen (IP-osoite, portti, kartan nimi, maksimi pelaajat, jne). |
| enable-rcon | totuusarvo | false | Aktivoi rcon komennot palvelimella, mitkä mahdollistavat yhteyden palvelimen konsoliin verkon yli. Yhteys ei ole salattu, joten asetusta ei ole suositeltavaa epäluotettavissa verkoissa. |
| enable-status | totuusarvo | false | Asetus määrittää näkyykö palvelin listoissa aktiivisena. Asetus ei kuitenkaan pysäytä liittymästä palvelimelle. |
| enforce-secure-profile | totuusarvo | false | Mahdollistaa käyttäjien, joilla ei ole Mojang-allekirjoitettua julkista avainta liittyä palvelimelle. Asetus vaikuttaa pääasiassa palvelimen viesteihin, jolloin kaikki viestit jätetään tarkistamatta. (= Ei viestien reportointia) |
| enforce-whitelist | totuusarvo | false | Kun pääsylista (Whitelist) aktivoidaan tämän asetuksen ollessa true, kaikki pelaajat jotka eivät ole pääsylistalla heitetään ulos palvelimelta. |
| entity-broadcast-range-percentage | kokonaisluku (10-1000) | 100 | Prosenttiosuus entiteettien renderöinnin etäisyydelle. Pienemmällä luvulla on mahdollista säästää resursseja, mutta entiteetit katoavat lähempänä pelaajaa. Esimerkiksi 50 = puolet normaalista etäisyydestä ja 200 = kaksinkertainen etäisyys. |
| force-gamemode | totuusarvo | false | Pakottaa pelaajan pelitilan oletukseksi liittyessä palvelimelle, kun asetus on true. Oletus asetetaan server.properties tiedostossa, esimerkiksi: gamemode=survival. |
| function-permission-level | kokonaisluku (1-4) | 2 | Asettaa vaaditun oikeustason /function komennon käytölle. |
| gamemode | merkkijono | survival | Asettaa palvelimen oletuspelitilan. Pelitilat ovat:
|
| generate-structures | totuusarvo | true | Määrittää luoko palvelin uusia alueita luodessa rakennuksia, kuten kyliä. Rakennuksia ei poisteta jo generoiduista kartoista, mutta uusia ei luoda kun kuljet uudelle alueelle. |
| generator-settings | merkkijono | Määrittää millainen maailma luodaan uuden tallennuksen kohdalla. | |
| hardcore | totuusarvo | false | Määrittää vaikeamman muodon pelistä, jolloin pelaaja kuollessaan ei pääse uudelleensyntymään kyseisessä maailmassa. (Voidaan kiertää OP oikeuksilla asettamalla pelitilan komennolla /gamemode [pelitila]) |
| hide-online-players | totuusarvo | false | Poistaa käytöstä pelaajalistan näyttämisen moninpelin palvelinlistassa |
| initial-disabled-packs | merkkijono | Tyhjä | Määrittää Datapaketit, mitkä eivät käynnisty automaattisesti palvelimen käynnistymisen yhteydessä. |
| initial-enabled-packs | merkkijono | vanilla | Määrittää Datapaketit, jotka aktivoidaan automaattisesti palvelimen käynnistymisen yhteydessä. |
| level-name | merkkijono | world | Luo oletuksena world nimisen maailman, jos sellaista ei jo löydy. Asettamalla eri nimen voi luoda uuden maailman säilyttäen edellisen palvelimen tiedostoissa. Palvelimelle oman maailman tuomiseksi kannattaa seurata näitä ohjeita: Kartan tuominen |
| level-seed | merkkijono | Tyhjä | Maailman luomiseen käytetty seed. Samalla seedillä voi luoda samanlaisen maailman, kun toisessa saman pelin version palvelimessa tai yksinpelissä. Tyhjänä palvelin luo satunnaisen seedin. Palvelimen sisällä seedin saa nähtyä OP oikeuksilla /seed. Huomaa, että myös tavallisten pelaajien on mahdollista selvittää seed modeilla. Voit yrittää estää tätä ohjeemme mukaisesti. |
| level-type | merkkijono | minecraft:normal | Palvelimen luodessa uutta maailmaa, käytetään tämän asetuksen maailmatyyppiä. Maailma voi esimerkiksi olla:
|
| log-ips | totuusarvo | true | Asetus määrittää kirjataanko pelaajien IP-osoitteet lokiin. |
| management-server-enabled | totuusarvo | false | Ottaa käyttöön hallintapalvelimen (management server) etähallintaa varten. (WebSocket -rajapinta, ei sisällä valmista hallintapaneelia) |
| management-server-host | totuusarvo | localhost | Osoite, mistä osoitteesta hallintapalvelinta pyöritetään |
| management-server-port | kokonaisluku | 0 | Hallintapalvelimen portti. Arvo 0 valitsee satunnaisen vapaan portin. |
| management-server-secret | merkkijono | [Random text] | Hallintapalvelimen avain. |
| management-server-tls-enabled | totuusarvo | true | Asetus määrittää käytetäänkö TLS-salausta hallintapaneeli yhteydessä. |
| management-server-tls-keystore | merkkijono | Tyhjä | Asetus asettaa palvelimen polun TLS-avaimelle. management-server-tls-enabled ollessa päällä palvelin vaatii tiedoston olemassaolon käynnisty äkseen. |
| management-server-tls-keystore-password | merkkijono | Tyhjä | Asetuksessa määritetään Keystore-tiedoston salasana sen avaamiseksi. |
| max-chained-neighbor-updates | kokonaisluku | 1000000 | Asetus asettaa rajan päivitysten määrälle, mitä yksittäinen palikka kykenee aiheuttamaan maailmassa. -1 poistaa rajan käytöstä. |
| max-players | kokonaisluku | 20 | Asetus rajoittaa aktiivisten pelaajien määrää palvelimella. |
| max-tick-time | kokonaisluku (ms) | 60000 | Asettaa enimmäisajan tikille millisekunteina ennen, kuin palvelin pysäyttää itsensä. -1 poistaa rajan käytöstä. |
| max-world-size | kokonaisluku | 29999984 | Asetus asettaa palvelimen luomalle maailmalle maksimikoon. |
| motd | merkkijono | A Minecraft Server | Asettaa palvelimelle näkyvän viestin (MOTD) palvelin listaukseen. Voit käyttää muotoilua, kuten värikoodeja. |
| network-compression-threshold | kokonaisluku | 256 | Asetus määrittää lähetettyjen pakettien koko vaatimuksen niiden pakkaamiselle. Oletuksena paketoi 256 bittiset ja isommat paketit. Asettamalla -1 poistaa pakkauksen. |
| online-mode | totuusarvo | true | Varmistaa onko liittyvän pelaajan Minecraft-tili aito. Asetuksen asettaminen false tilaan ei ole suositeltavaa, sillä tällöin kuka tahansa voi liittyä palvelimelle nimelläsi. |
| op-permission-level | kokonaisluku (1-4) | 4 | Asettaa operaattoreille (OP) oikeustason. |
| pause-when-empty-seconds | kokonaisluku | 60 | Asettaa kuinka kauan palvelin odottaa ilman pelaajia ennen, kuin maailma pysäytetään. Asettamalla 0 poistuu tauotus käytöstä. |
| player-idle-timeout | kokonaisluku (min) | 0 | Asetus potkii pelaajan, joka on ollut toimettomana asetetun minuuttimäärän. Asettamalla 0 poistaa automaattisen potkaisun pois käytöstä. |
| prevent-proxy-connections | totuusarvo | false | Estää pelaajia liittymästä välityspalvelimen (proxy) kautta. |
| query.port | kokonaisluku | 25565 | Palvelimelle tehtyjen kyselyiden (query) portti, jos enable-query=true. |
| rate-limit | kokonaisluku | 0 | Rajoittaa pelaajan lähettämien yhteyspyyntöjen eli pakettien määrää. Asettamalla 0 poistuu paketti rajoitus käytöstä. |
| rcon.password | merkkijono | Tyhjä | Salasana palvelimen rcon-yhteydelle. |
| rcon.port | kokonaisluku | 25575 | Palvelimen rcon-portti. |
| region-file-compression | merkkijono | deflate | Palvelimen maailman alueiden (region) pakkausmenetelmä. Vaihtoehdot ovat joko: deflate, lz4 tai none. |
| require-resource-pack | totuusarvo | false | Jos resource-pack on asetettu päälle voidaan tällä asetuksella pakottaa pelaajat hyväksymään palvelimelle asetettu resurssipaketti. |
| resource-pack | merkkijono | Tyhjä | Palvelimelle asetettu resurssipaketti. Syötteeksi annetaan resurssipaketin latauslinkki. |
| resource-pack-id | merkkijono | Tyhjä | Resurssipaketin yksilöivä tunniste (UUID). Valinnainen, mutta helpottaa käyttäjien ohjelmia resurssipaketin tunnistuksessa. |
| resource-pack-prompt | merkkijono | Tyhjä | Palvelimella ollen käytössä require-resource-pack, näytetään tähän asetettu viesti sen yhteydessä. |
| resource-pack-sha1 | merkkijono | Tyhjä | Resurssipaketin SHA1-tarkiste. Valinnainen, mutta sen avulla voidaan varmistaa resurssipaketin eheys. |
| server-ip | merkkijono | Tyhjä | Palvelimen osoite, johon palvelin sitoutuu. Bittivirran palvelimella ip-osoite asetetaan käynnistyksen yhteydessä automaattisesti. |
| server-port | kokonaisluku | 25565 | Palvelimen portti. Bittivirran palvelimella asetetaan automaattisesti käynnistymisen yhteydessä. Mikäli haluat palvelimen oletusportin 25565, voit ostaa sen asiakasalueelta lisäosana. Tällöin IP-osoitteen perään ei tarvitse kirjoittaa porttia. |
| simulation-distance | kokonaisluku | 10 | Kuinka kaukana maailmaa simuloidaan pelaajan ympärillä. Esimerkiksi eläimet, tiputetut esineet, vesi/laava. Ei vaikuta maailman luontiin. |
| spawn-protection | kokonaisluku | 16 | Aloitusalueen suojatut alueet. Annettu arvo määrittää suojauksen alueen kaavalla: 2x+1. Esimerkiksi arvolla 1 on suojattu alue 3x3 palikan kokoinen ja oletusarvolla 33x33 palikan kokoisen alue aloituspisteellä. Asettamalla 0 poistaa suojauksen käytöstä. Suojatulta alueelta ei voi rikkoa kuutioita ilman operaattori (OP) oikeuksia. |
| status-heartbeat-interval | kokonaisluku | 0 | Palvelimen hallintapalvelimen aktiivisuus-päivitysten väli. Asettamalla 0 on tarkistusväli pois käytöstä. |
| sync-chunk-writes | totuusarvo | true | Kirjoittaa chunkit synkronisesti levylle vakauden parantamiseksi. Estää datan häviämisen ja korruptiota kaatumisen yhteydessä. |
| text-filtering-config | merkkijono | Tyhjä | Pelaajien luoman tekstin suodatusasetus. Tällä hetkellä ei ole käytössä kuin Minecraftin omilla palvelimilla. |
| text-filtering-version | kokonaisluku | 0 | Tekstisuodatuksen versionumero. |
| use-native-transport | totuusarvo | true | Asetus sallii tehokkaamman paketin lähetyksen pelaajilla, jotka käyttävät Linux käyttöjärjestelmää. |
| view-distance | kokonaisluku | 10 | Kuinka pitkälle pelaajasta chunkit eli alueet luodaan/näytetään. Arvolla on suuri vaikutus palvelimen suorituskykyyn. Suosittelemme yli 8 samanaikaisen pelaajan palvelimille asetusta 8 tai jopa pienempi pienillä palvelimilla. |
| white-list | totuusarvo | false | Ottaa käyttöön pääsylistan (whitelist) palvelimelle. Pelaajan lisäämiseen listalle voi käyttää tätä ohjetta Pääsylista |
Oletusasetustiedosto
Palvelimen IP-osoite ja portti vaihtelee oletusasetuksissa. Voit jättää asetuksen halutessasi tyhjäksi, tai joksikin muuksi arvoksi, sillä siihen korjataan aina palvelimesi osoite ja portti palvelimen käynnistyessä.
#Minecraft server properties
#[Generation date and time]
accepts-transfers=false
allow-flight=false
broadcast-console-to-ops=true
broadcast-rcon-to-ops=true
bug-report-link=
difficulty=easy
enable-code-of-conduct=false
enable-jmx-monitoring=false
enable-query=false
enable-rcon=false
enable-status=true
enforce-secure-profile=true
enforce-whitelist=false
entity-broadcast-range-percentage=100
force-gamemode=false
function-permission-level=2
gamemode=survival
generate-structures=true
generator-settings={}
hardcore=false
hide-online-players=false
initial-disabled-packs=
initial-enabled-packs=vanilla
level-name=world
level-seed=
level-type=minecraft\:normal
log-ips=true
management-server-enabled=false
management-server-host=localhost
management-server-port=0
management-server-secret=[Random text]
management-server-tls-enabled=true
management-server-tls-keystore=
management-server-tls-keystore-password=
max-chained-neighbor-updates=1000000
max-players=20
max-tick-time=60000
max-world-size=29999984
motd=A Minecraft Server
network-compression-threshold=256
online-mode=true
op-permission-level=4
pause-when-empty-seconds=60
player-idle-timeout=0
prevent-proxy-connections=false
query.port=25565
rate-limit=0
rcon.password=
rcon.port=25575
region-file-compression=deflate
require-resource-pack=false
resource-pack=
resource-pack-id=
resource-pack-prompt=
resource-pack-sha1=
server-ip=
server-port=25565
simulation-distance=10
spawn-protection=16
status-heartbeat-interval=0
sync-chunk-writes=true
text-filtering-config=
text-filtering-version=0
use-native-transport=true
view-distance=10
white-list=false
Lähteet https://minecraft.wiki/w/Server.properties Päivitetty 26.4.2026.
[Käytetty lähteenä 3.5.2026]