Bukkit.yml/nl

This page has been suggested for inclusion in the Official Documentation This page has been marked for inclusion in the Bukkit Official Documentation section, Docs. You can deliberate about its inclusion on its Talk page.

Bukkit.yml is een bestand dat je een groot scala aan opties geeft om jouw CraftBukkit server optimaal te configureren.

Onderdelen van YAML

De koppen hierboven zijn de meest bovenstaande sleutels van een YAML bestand.

settings

Algemene CraftBukkit server opties.

allow-end

Is de End toegestaan? (boolean)

Standaardwaarde: true

warn-on-overload

Laat de server "[WARNING] Can't keep up! Did the system time change, or is the server overloaded?" berichten zien? (boolean)

Standaardwaarde: true

permissions-file

De naam van je aangepaste permissies bestand (string, bestandsnaam)

Standaardwaarde: permissions.yml

update-folder

De naam van je bestandenmap waar de bijgewerkte plugins opgeslagen moeten worden. Deze zullen na een herstart van de server automatisch geïnstalleerd worden. (string, mapnaam)

LET OP: De map MOET in de plugins map zitten. Het kan geen absoluut pad zijn.

Standaardwaarde: update.

ping-packet-limit

Momenteel niet van toepassing. Voorheen: Hoeveel packets per seconde kan de ping lijst maximaal gebruiken. (geheel getal, packets/sec)

Standaardwaarde: 100

use-exact-login-location

Omdat Minecraft een functie heeft waarbij entities (zoals mobs) uit een blokje gedrukt kunnen worden wanneer zij vast zitten, zullen spelers zich soms boven de locatie vinden waar zij eigenlijk uitgelogd waren (dit gebeurt vaak in grotten). Deze optie kan het gedrag van deze functie veranderen. Wanneer deze op 'true' staat, zal een entity niet verplaats worden wanneer deze inlogt op geladen wordt. Als dit 'false' is, zal de server entities proberen te verplaatsen wanneer zij in blokjes vast komen te zitten.

Standaardwaarde: false

world-container

De naam van map waar alle wereld bestanden in worden opgeslagen. Als deze niet is opgegeven, zal het de standaardwaarde zijn. (string, mapnaam)

plugin-profiling

Laat het gebruik van /timings toe. Gebruikt om de verstreken tijd van 'events' door plugins te meten.

Standaardwaarde: false

connection-throttle

De vertraging (in milliseconden) voordat een Minecraft client opnieuw een verbinding kan aanvragen met de server. Als deze waarde 0 is zal deze functie uitgezet worden en is je server kwetsbaar voor aanvallen. (long, milliseconden)

Standaardwaarde: 4000

query-plugins

Geeft de server een lijst van gebruikte plugins wanneer een query wordt aangevraagd? (boolean)

Standaardwaarde: true

deprecated-verbose

Laat de server waarschuwingen zien wanneer een plugin een oud 'event' gebruikt. 'true' of 'false' zal als een schakelaar werken voor de waarschuwing. Maar een 'default' waarde zal altijd waarschuwingen laten zien, behalve wanneer de ontwikkelaar dit 'event' als niet gevaarlijk heeft bestempeld. (string)

Standaardwaarde: default

shutdown-message

Dit is het bericht dat wordt laten zien wanneer de server afsluit.

Standaardwaarde: Server closed

spawn-limits

CraftBukkit server optie die bepaalt hoeveel dieren en mobs er kunnen leven in een chunk.

monsters

Deze optie geeft aan hoeveel monsters er kunnen leven in een chunk.

Minecraft standaardwaarde: 70.

animals

Deze optie geeft aan hoeveel dieren er kunnen leven in een chunk.

Minecraft standaardwaarde: 15.

water-animals

Optie om aan te geven hoeveel water dieren er kunnen leven in een chunk.

Minecraft standaardwaarde: 5.

ambient

Deze optie geeft aan hoeveel 'ambient' mobs (ook wel vleermuizen) kunnen leven in een chunk.

Minecraft standaardwaarde: 15.

Let op: Dieren die tot leven zijn gebracht door spelers volgen niet deze regels. Die hebben hun eigen regels.

chunk-gc

CraftBukkit will check for check for chunks that should have been unloaded but for some reason failed to do so.

period-in-ticks

The ticks between each chunk garbage collection consideration. If set to 0, chunk gc will be disabled.

Bukkit default: 600.

load-threshold

Number of chunks that need to be loaded since the last garbage collection before considering garbage collection. If set to 0, chunk gc will be disabled.

Bukkit default: 0.

ticks-per

CraftBukkit server options that determine the tick delay for specific features

animal-spawns

This bukkit.yml setting allows servers to set the tick delay for animal spawns.

Example Usage:

• A value of 1 will mean the server will attempt to spawn animals every tick.
• A value of 400 will mean the server will attempt to spawn animals every 400th tick.
• A value below 0 will be reset back to Minecraft's default.

Note: If set to 0, animals spawning will be disabled. We recommend using spawn-animals to control this instead.

Minecraft default: 400.

monster-spawns

This bukkit.yml setting allows servers to set the tick delay for monster spawns.

Example Usage:

• A value of 1 will mean the server will attempt to spawn monsters every tick.
• A value of 400 will mean the server will attempt to spawn monsters every 400th tick.
• A value below 0 will be reset back to Minecraft's default.

Note: If set to 0, monsters spawning will be disabled. We recommend using spawn-monsters to control this instead.

Minecraft default: 1.

autosave

This bukkit.yml setting allows servers to set the number of ticks for each save-all event.

Example Usage:

• A value of 1 will mean the server will attempt to autosave the world every tick.
• A value of 6000 will mean the server will attempt to autosave the world every 5 minutes.
• A value below 0 will be reset back to Bukkit's default.

Minecraft default: 6000.

Bukkit default: 0.

Note: Many Bukkit servers already run autosave plugins which generate save-all tasks, thus it was decided to disable this feature in Bukkit, as the Minecraft default setting was causing a lot of lag for many servers, and was found redundant. If you wish to enable this, remember the setting is per tick, and thus should be set to a reasonably high number (6000 = 5 minutes at peak server efficiency).

auto-updater

Controls the built in update checker.

• enabled: (boolean) Is the update checker enabled. Default: true
• on-broken: (string array) What to do if the version the server is on is known to have a large bug or exploit. Can be "warn-ops" and/or "warn-console". Default: [warn-console, warn-ops]
• on-update: (string array) What to do if the version the server is on is out of date. Can be "warn-ops" and/or "warn-console". Default: [warn-console, warn-ops]
• preferred-channel: (string) Which release channel is preferred for this server. Can be "rb", "beta" or "dev". Default: rb
• host: (string) The update checker location. You probably should never change this, unless you know what you're doing. Default: dl.bukkit.org

aliases

This section allows you to map aliases to commands. Example:

aliases:
    # This creates a new command called "canihasbukkit", which when used it actually performs "version"
    canihasbukkit: version
    
    # And this will execute both "save-all" and then "stop" when you type "savestop"
    savestop: [save-all, stop]
    
    # If a command already exists called "give", it will be rewritten. This is handy if you've two plugins
    # fighting for the same name.
    give: somepluginsgive

database

This section lets you set various database-related configuration options, for the database which will be shared by plugins that use the internal eBeans server. Most plugins do not use this, so whether or not you need to configure it is up to you. Changing these properties will change how all plugins that use the eBeans server integrated with Bukkit connect to their database.

• username: (string) Username to connect to database. May be ignored depending on driver.
• password: (string) Password to connect to database. May be ignored depending on driver.
• isolation: (one of SERIALIZABLE, ...) Generally leave this alone unless advised otherwise.
• driver: (string, JDBC class name) The JDBC driver class that should be used. See the documentation for your database's Java driver for this value.
• url: (string, JDBC database URL) The URL to connect to the database. For MySQL/PostgreSQL or other server-client databases, this will generally include the hostname, port and database name. For file-based databases, such as SQLite, this will usually include the filename.

The following are examples of what each configuration would look like for the two most commonly used database applications.

SQLite Configuration (default):

database:
  username: bukkit
  isolation: SERIALIZABLE
  driver: org.sqlite.JDBC
  password: walrus
  url: jdbc:sqlite:{DIR}{NAME}.db

Note: the {DIR} and {NAME} words represent the directory of the plugin data folder and the name of the individual db file. They are actual variable names Bukkit uses, therefore changing these settings are not recommended.

MySQL Configuration example:

database:
  username: {USERNAME}
  isolation: SERIALIZABLE
  driver: com.mysql.jdbc.Driver
  password: {PASSWORD}
  url: jdbc:mysql://{IP}:{PORT}/{DATABASENAME}

Note: {USERNAME}, {PASSWORD}, {IP}, {PORT}, and {DATABASENAME} are not actual variable names that Bukkit uses like in the SQLite example. They just represent data you should change to get the MySQL configuration to work correctly.

*OPTIONAL* worlds

This section lets you define the generators for the worlds that bukkit loads by default.

Prereqs: You MUST have the generator installed already, and the generator's developer must have {{{load: startup}}} in their plugin.yml.

If you want your world, named 'world1' (the same thing you have as 'level-name' in server.properties) and wanted to use the CleanroomGenerator with no params, you could do this:

 settings:
   ...
 aliases:
   ...
 database:
   ...
 worlds:
   world1:
     generator: CleanroomGenerator

If you wanted some custom params:

 settings:
   ...
 aliases:
   ...
 database:
   ...
 worlds:
   world1:
     generator: CleanroomGenerator:10,stone,20,dirt,1,grass