Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Plugins

Purpose

A plugin is the module that runs the game’s server-side logic: it offers game-specific commands, queries and panel screens. This page shows the game’s plugin, the other plugins authorized in the selected environment and the state of each. You reach a plugin’s admin screens from here and from the sidebar.

When to use

  • To see whether a plugin is on in this environment.
  • To make a plugin temporarily read-only, drain it or turn it off (authorized admin).
  • To inspect a plugin’s version, permissions, operations and dependencies.
  • To bind a plugin to the game or move to a new version.

Step by step

See a plugin’s details

The card’s Ayrıntılar (Details) button lists the version, permissions, dependencies and the operations the plugin offers (query or command, who can access). The information is read from the plugin’s own declaration; it cannot be changed from here.

Change a plugin’s state

  1. Press the card’s Durumu değiştir (Change state) button. Only admins with the plugin management permission see the button.
  2. Choose the target from the Yeni durum (New state) list; the player and admin effect of the state you choose is written in the window.
  3. Write your reason and press Durumu değiştir. If you choose Kapalı (Off), a confirmation is also asked.

Transitions are limited: from On you can go to read-only, draining or off; from read-only and draining to on or off; from off to read-only or on.

Bind a plugin to the game and move to a new version

The game plugin card at the top of the page is for these operations:

  1. If no plugin is bound, choose the plugin from the list with Eklenti bağla (Bind plugin) and bind it.
  2. To move to a newly built version, first drain players with Drain başlat (Start drain); type the plugin ID to confirm.
  3. When the countdown ends, deploy the new version, then press Sürüme geç (Switch to version). The button is disabled until the countdown ends.

Warning

In the Kapalı (Off) state, players and admins cannot use the plugin in this environment and the plugin disappears from the sidebar. To turn it back on you must change the state separately.

Fields and options

FieldRequiredDescription
New stateYesOn, Read-only, Draining or Off
Action reasonYes8-500 characters
Plugin (bind window)YesOne of the plugins installed on the server
Plugin ID (drain window)YesThe ID must be typed exactly

The badge at the top of the card shows the plugin’s state in this environment. If it says “Bu ortamda yetkisiz” (Not authorized in this environment), the plugin is installed but there is no grant row for this environment; the plugin cannot be used here.

Common situations

SituationWhat to do
“Kurulu eklenti yok” (No plugin installed)The server was started without plugins. Plugins are added to the server build and activated by the operator.
The card has a warning “Yetki sürümü … kurulu sürüm …” (Grant version … installed version …)The environment’s grant does not match the installed version; version activation is pending. In this case only draining and turning off can be chosen.
“Bu durum geçişine izin verilmiyor” (This state transition is not allowed)The state may have changed while you were looking; refresh the page and try again.
The Durumu değiştir button is missingYou do not have the plugin management permission; ask an admin.
The Ekranları aç (Open screens) button is missingThe plugin defines no panel screen, or it is off in this environment.
A “Kullanımdan kalkan sorgular” (Deprecated queries) box appearsSome of the plugin’s queries have been replaced by a new surface. In the box you see the old name, its replacement and since which version it was deprecated; move your game code to the new surface.