# Loslegen

{% hint style="info" %}
ColorCodes werden immer mit einem `&` Zeichen definiert. Eine Liste der möglichen ColorColdes gibt es [hier](https://htmlcolorcodes.com/minecraft-color-codes/). Nutze bitte aus der angezeigten Tabelle die Spalte `CHAT CODE` und ersetze das `§` -Zeichen mit dem `&`-Zeichen.
{% endhint %}

Wenn du das BungeeSystem heruntergeladen und den Server gestartet hast, sollte jetzt in deinem Plugins-Ordner ein Ordner Namens *BungeeSystem* erstellt haben.\
Öffne nun diesen Ordner und bearbeite die `config.yml`.

## Lizenz eintragen

Füge in der `config.yml` dein private Lizenz ein. Wenn du noch keine Besitzt, öffne ein Supportticket auf meinem Discordserver.

{% hint style="info" %}
Warum benötige ich eine private Lizenz? Die Antwort gibt es [hier](https://gitlab.herrtechniker.eu//HerrTechniker/gitbook-pluginwiki/-/blob/main/bungeesystem/broken-reference/README.md)
{% endhint %}

`license: ""`

## Datenbank

Stelle in der `config.yml` den Datenbankentypen ein.

### MySQL

Setze `database: "mysql"` um deine Daten in einer `MySQL` Datenbank zu speichern. Auf die Daten kannst du Serverübergreifend zugreifen. Um die Verbindung zu MySQL Datenbank herzustellen öffne die Datei `mysql.yml` und trage deine MySQL Daten ein.

{% code title="mysql.yml" lineNumbers="true" %}

```yaml
mysql:
  HOST: localhost
  PORT: '3306'
  DATABASE: database
  USER: root
  PASSWORD: password
```

{% endcode %}

### Config

Setze `database: "sql"` um deine Daten Lokal auf dem Server zu Speichern. Auf diese Daten kann dann nur dieser eine Server zugreifen. Dafür wird vom Plugin im Plugins-ordner ein Ordner namens `database` erstellt. In diesem Ordner wird die Datenbankdatei `database.db` erstellt.

## Standard Sprache

### Mit LanguageAPI

Wenn du meine LanguageAPI für BungeeCord besitzt, kannst du den Punkt `defaultLanguage: "english"` auslassen, da die Sprache des Spielers über diese Verwaltet ist. Vergewissere dich nur, dass du alle Nachrichten in den Sprachen eingestellt hast, die in der `config.yml` der LanguageAPI eingestellt sind.

single-Dateisystem

Wenn du zum Beispiel die Sprache Deutsch, Englisch und Spanisch unterstützt, muss du in diesem Fall die Nachrichten auf z.B. Englischen kopieren und diesen am Ende der Datei einfügen und jede einzelne Sprache übersetzen.

multi-Dateisystem

Genau wie beim single-Dateisystem musst du hier nur z.B. die `english.yml`-Datei kopieren und in den Namen der Sprache umändern. In dem Beispiel mit der spanischen Sprache in `español.yml`. (Wenn du die Sprache als *español* in der `config.yml` der LanguageAPI so eingestellt hast)

{% hint style="info" %}
Schaue dir sonst nochmal die Einstellung zur Sprache bei der LanguageAPI an. [Klicke hier](/languageapi/loslegen.md#datei-system)
{% endhint %}

### Ohne LanguageAPI

Wenn du allerdings meine LanguageAPI nicht gekauft hast, kannst du unter dem Punkt `defaultLanguage: "english"` die Standard Psrache des BungeeSystems einstellen. Dies bedeutet jeder Spieler bekommt alle Nachrichten des Plugins auf dieser Sprache gesendet.

## Servername

Unter dem Punkt `servername: "yourserver.com"` kannst du den Name/Domainnamen deines Netzwerkes angeben. Dieser wird dann von einigen Modulen genutzt.

## Module

Hier findest du eine Auflistung aller Module die im BungeeSystem enthalten sind. Auf den nächsten Seiten findest du weitere Informationen zu jedem einzelnen Modul.

* Auto broadcast
* Broadcast
* Chat
* CloudNet
* Discord Bot
* FriendSystem
* Joinme
* Jumpto
* Lobby
* motd
* Move
* MSG
* OnlineTeam
* OnlineTime
* Party
* Ping
* Pull
* Punishment System
  * Ban
  * Mute
  * Andere
  * Report
* Teamchat

{% hint style="info" %}
Du kannst jedes Modul einzelnt aktivieren oder deaktivieren. Heißt wenn du z.B. schon ein Freunde System hast, kannst du in der `config.yml` die Einstellung `friend: false` auf false lassen. Jedes Modul ist Standard mäßig ausgeschalten (deaktiviert).
{% endhint %}

## Optionen

In dem Abschnitt `options` kannst du zu jedem Modul bestimmte Sachen einstellen.

## Standard Konfiguration

{% code title="config.yml" lineNumbers="true" %}

```yaml
# The standard license is only valid for 7 days. Please request your private license on my Discord (link: https://discord.gg/pnXAbH4DtT).
# You have to present your bill to prove that you bought the LanguageAPI.
license: ""

# Insert "mysql" to use mysql (cross-server access) or insert "sql" to use local database (only local servers have access)
database: "mysql"

# if LanguageAPI NOT enabled, what is the default-Language for this system (LanguageAPI by HerrTechniker)
defaultLanguage: "english"

# set her your server name. That can be displayed for example on the ban-/kick screen.
servername: "yourserver.com"

# prefix of the bungeesystem
prefix: "&7[&6BungeeSystem&7]&r"

# gave a player full rights of the BungeeSystem to execute every command (recommended for the owners)
permission: "bungeesystem.*"

# if you have the permission (see above) you will get an ingame message that a new update is released
updater: false

# Here you can enable every single module, that the BungeeSystem support
modules:
  autoBroadcast: false
  broadcast: false
  chat: false
  cloudnet:
    v3: false
  discord: false
  friend: false
  joinme: false
  jumpto: false
  lobby: false
  motd: false
  move: false
  msg: false
  onlineteam: false
  onlinetime: false
  party: false
  partychat: false
  ping: false
  pull: false
  punishment:
    ban: false
    kick: false
    mute: false
    report: false
  teamchat: false

# Here you can edit every setting from a module
options:
  broadcast:
    prefix: "&7[&6Broadcast&7]&r"
    permission: "bungeesystem.broadcast.use"
    aliases:
      - "bc"
  chat:
    prefix: "&7[&fChat&7]&r"
    permission: "bungeesystem.switch.chat"
    # you can read every chat message on every server except for the ingame-chat. This chat is only readable on the server where the player is
    ingameChatName: "ingame"
    chats:
      - "bedwars"
      - "skywars"
      - "gungame"
      - "mlgrush"
    aliases: []
  cloudnet:
    teamGroups:
      - "Owner"
      - "Admin"
      - "Moderator"
      - "Supporter"
      - "Developer"
      - "Builder"
  discord:
    prefix: "&5Discord &8|&r"
    # permission to execute '/link <user id>'-command and '/verify <code>'-command
    permission: "bungeesystem.discordverify.use"
    # using webhook for the chat messages in discord instead of the bot. The message from the bot is everytime as an embed (recommed)
    usingWebhook: true
    # should be the message in an embed (for the webhook).
    usingEmbedForWebhook: false
    # if enabled and the module chat also then the Discord channels are added to the channels of the chat module
    switchChat: false
    # if enabled all attachments will be ignored.
    # If disabled the player will get a message that a user send a video or an image that can not be displayed in the minecraft chat.
    ignoreAttachments: false
    # set a time which effect the synchronisation between minecraft and discord.
    # That means every x seconds the system will look if their a new player that linked minecraft with discord and it will sync roles and other stuff.
    # sync time in seconds (default = 600 seconds => 10 minutes)
    syncTime: 600
    # When the synchronisation is finished, should the player receive a message or not (true = the player receives a message)
    syncMessage: false
    # set a time which effect the synchronisation between minecraft and discord.
    # That means every x seconds the system checks if the player still has the same permissions.
    # If not, the rank is removed from Discord and reassigned to the rank the player has in Minecraft.
    # sync time in seconds (default = 1200 seconds => 20 minutes)
    repeatSyncTime: 1200
    aliases:
      link: []
      unlink: []
      verify: []
      discord: []
  friend:
    prefix: "&7[&9Friends&7]&r"
    jumpToMessage: true
    # permission ; max Requests
    # -1 = unlimited
    defaultRequests: 100
    maxRequests:
      - "bungeesystem.friends.requests.150;150"
      - "bungeesystem.friends.requests.256;256"
      - "bungeesystem.friends.requests.unlimited;-1"
    # permission ; max Friends
    # -1 = unlimited
    defaultFriends: 100
    maxFriends:
      - "bungeesystem.friends.friends.150;150"
      - "bungeesystem.friends.friends.256;256"
      - "bungeesystem.friends.friends.unlimited;-1"
    # if cloudnet v3 is enabled, please insert the cloudnet task, if not insert server names
    # if player connect to this server/task, all friends will get the switch message. if the message is enabled with the friend toggleswitch command
    whitelist:
      - "BedWars4x1"
      - "BedWars4x2"
      - "BedWars4x4"
      - "MLGRush"
      - "GunGame"
    aliases:
      - "freunde"
      - "freund"
      - "friends"
  joinme:
    prefix: "&7[&6JoinMe&7]&r"
    permission: "bungeesystem.joinme.use"
    permissionCooldown: "bungeesystem.joinme.cooldown"
    switchServerMessage: true
    availableSelfSetting: false
    # how long is the joinme available in seconds
    available: 20
    # the global delay (in seconds) for the next joinme (-1 for disable)
    globalCooldown: 10
    # the delay for the player (in seconds) for the next joinme (-1 for disable)
    defaultCooldown: 30
    whitelist:
      - "BedWars4x1"
      - "BedWars4x2"
      - "BedWars4x4"
      - "MLGRush"
      - "GunGame"
    aliases:
      - "jm"
  jumpto:
    prefix: "&7[&3JumpTo&7]&r"
    permission: "bungeesystem.jumpto.use"
    switchMessage: true
    aliases:
      - "jump"
  lobby:
    prefix: "&7[&6System&7]&r"
    switchMessage: false
    aliases:
      - "hub"
      - "leave"
      - "l"
  msg:
    prefix: "&6MSG &7|&r"
    aliases: []
  motd:
    maintenance:
      permission: "bungeesystem.maintenance.use"
      aliases:
        - "wartung"
  move:
    prefix: "&7[&dMove&7]&r"
    permission: "bungeesystem.move.use"
    aliases: []
  onlineteam:
    prefix: "&bTeamonline &7|&r"
    countOfTeamGroups: 6
    teamGroups:
      1:
        name: "&4Owner"
        permission: "bungeesystem.onlineteam.owner"
      2:
        name: "&cAdmin"
        permission: "bungeesystem.onlineteam.admin"
      3:
        name: "&1Moderator"
        permission: "bungeesystem.onlineteam.moderator"
      4:
        name: "&9Supporter"
        permission: "bungeesystem.onlineteam.supporter"
      5:
        name: "&bDeveloper"
        permission: "bungeesystem.onlineteam.developer"
      6:
        name: "&2Builder"
        permission: "bungeesystem.onlineteam.builder"
    aliases:
      - "ao"
      - "adminonline"
  onlinetime:
    prefix: "&7[&bOnlineTeime&7]&r"
    show:
      seconds: true
      minutes: true
      hours: true
      days: true
      years: true
    aliases:
      - "ot"
  party:
    prefix: "&7[&5PARTY&7]&r"
    switchServerMessage: true
    # if cloudnet v3 in modules-section enabled, please enter the tasks where the party members do not connect with the party leader
    whitelist:
      - "BedWars4x1"
      - "BedWars4x2"
      - "BedWars4x4"
      - "MLGRush"
      - "GunGame"
    # the value of default Members has a minimum of 2. By another unsupported value an error message will send with "Info defaultMembers error"
    defaultMembers: 8
    maxMembers:
      - "bungeesystem.party.members.16;16"
      - "bungeesystem.party.members.32;32"
      - "bungeesystem.party.members.unlimited;-1"
    aliases:
      - "p"
  partychat:
    prefix: "&7[&5PartyChat&7]&r"
    aliases:
      - "pc"
  ping:
    prefix: "&7[&9Ping&7]&r"
    permission: "bungeesystem.ping.use"
    aliases: []
  pull:
    prefix: "&7[&bPull&7]&r"
    permission: "bungeesystem.pull.use"
    aliases: []
  punishment:
    ban:
      prefix: "&7[&6BanSystem&7]&r"
      autoBan: false
      # how many points for permanent ban
      permanent: 100
      autoBanOperatorName: "AutoBanSystem"
      autoBanOperatorUUID: "00000001-0001-0001-0001-000000000001"
      autoBanReason: "auto ban"
      banReasons: 6
      infoMessageOther: true
      webhook: false
      aliases: []
    reduceBan:
      prefix: "&7[&6BanSystem&7]&r"
      infoMessageOther: true
      webhook:  false
      aliases: []
    tempBan:
      prefix: "&7[&6BanSystem&7]&r"
      infoMessageOther: true
      webhook: false
      aliases: []
    unban:
      prefix: "&7[&6BanSystem&7]&r"
      infoMessageOther: true
      webhook: false
      aliases: []
    banPoints:
      prefix: "&7[&6BanSystem&7]&r"
      aliases: []
    # check command only activated, if ban or/and mute module is activated
    check:
      prefix: "&6Check &8|&r"
      aliases: []
    history:
      prefix: "&6History &8|&r"
      aliases:
        - "h"
    kick:
      prefix: "&6Kick &8|&r"
      webhook: false
      aliases:
        - "k"
    mute:
      prefix: "&7[&6MuteSystem&7]&r"
      autoMute: false
      # how many points for permanent mute
      permanent: 100
      autoMuteOperatorName: "AutoMuteSystem"
      autoMuteOperatorUUID: "00000002-0002-0002-0002-000000000002"
      autoMuteReason: "auto mute"
      muteReasons: 4
      infoMessageOther: true
      webhook: false
      aliases: []
    reduceMute:
      prefix: "&7[&6MuteSystem&7]&r"
      infoMessageOther: true
      webhook: false
      aliases: []
    tempMute:
      prefix: "&7[&6MuteSystem&7]&r"
      infoMessageOther: true
      webhook: false
      aliases: []
    unmute:
      prefix: "&7[&6MuteSystem&7]&r"
      infoMessageOther: true
      webhook: false
      aliases: []
    mutePoints:
      prefix: "&7[&6MuteSystem&7]&r"
      aliases: []
    report:
      prefix: "&7[&cReport&6System&7]&r"
      teamInfoMessage: true
      webhook: false
      aliases:
        - "r"
    reports:
      prefix: "&7[&cReport&6System&7]&r"
      aliases: []
    permissions:
      ban: "bungeesystem.punishment.ban"
      banPoints: "bungeesystem.punishment.banpoints"
      unban: "bungeesystem.punishment.unban"
      mute: "bungeesystem.punishment.mute"
      mutePoints: "bungeesystem.punishment.mutepoints"
      unmute: "bungeesystem.punishment.unmute"
      check: "bungeesystem.punishment.check"
      history: "bungeesystem.punishment.history"
      kick: "bungeesystem.punishment.kick"
      reduceBan: "bungeesystem.punishment.reduceBan"
      reduceMute: "bungeesystem.punishment.reduceMute"
      tempMute: "bungeesystem.punishment.tempMute"
      tempBan: "bungeesystem.punishment.tempBan"
      # to report a player (player permission)
      report: "bungeesystem.punishment.report"
      # to see the reports and check them (team permission)
      reports: "bungeesystem.punishment.reports"
      punishmentBypass: "bungeesystem.punishment.punishmentbypass"
  teamchat:
    prefix: "&7[&5Teamchat&7]&r"
    permission: "bungeesystem.teamchat.use"
    aliases:
      - "tc"
```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki-de.herrtechniker.eu/bungeesystem/loslegen.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.