> ## Documentation Index
> Fetch the complete documentation index at: https://support.zonely.gen.tr/llms.txt
> Use this file to discover all available pages before exploring further.

# Minecraft – WebSender

> A setup guide for sending commands to your Minecraft server through the admin panel using the WebSender plugin.

## 1) Download and install the plugin

1. Download the WebSender plugin:\
   [https://zonely.gen.tr/plugins/zonely-websender.jar](https://zonely.gen.tr/plugins/zonely-websender.jar)
2. Copy the file into your server’s `plugins` folder.
3. Restart the server (or reload plugins). The configuration file will be created automatically on first launch.

## 2) Configure the plugin (config.yml)

Open the following file and adjust it as shown:\
`/plugins/WebSender/config.yml`

```yaml theme={null}
socketPort: 454 # A dedicated port for WebSender (must be different from the game port)
socketPassword: "YOUR_PASSWORD"  # Use a strong, unique password
senderPrefix: "[WebSender]"
wrongPassword: "Incorrect password, please enter it carefully."
wrongData: "Please check PHP variables."
succesfullyLogin: "Login is successful."
consoleInfo: "true"
commandPermission: "websender.admin"
nothavePerm: "You do not have permission!"
pluginReloaded: "Websender reloaded!"
```

<Tip>
  Use an **available port** for `socketPort` (for example **454** or **25575**). Do **not** use your Minecraft game port (for example 25565).
</Tip>

## 3) Security and networking

* In your server or provider firewall, open the `socketPort` to allow access **only from the panel server IP**.
* Never share the `socketPassword` and change it periodically.
* If possible, restrict access by IP or use a reverse proxy between the panel and the server.

## 4) Create a server record in the panel

1. Go to the **Servers** page → **Add Server**.
2. Fill in the fields:
   * **Server Name:** Internal name (for example `My Minecraft Server`).
   * **Plugin:** `Websender`
   * **Server IP Address:** The server IP or an accessible domain.
   * **Port:** From `config.yml` → `socketPort` (for example **454**)
   * **Password:** From `config.yml` → `socketPassword`
3. Click **Check Plugin Connection**.
4. If successful, click **Publish** to save.

<Warning>
  The **Port** and **Password** in the panel must exactly match the `socketPort` and `socketPassword` in `config.yml`.
</Warning>

## 5) Troubleshooting

* **Connection failed or timed out:**
  * Are IP and port correct? Is the port open in OS and provider firewalls?
  * Can the server be reached (ping, tracert)?
* **“Wrong password” warning:**
  * Do `socketPassword` and the panel password match?
  * After multiple failed attempts, a temporary block may occur. Wait briefly, then try again.
* **Settings not applying:**
  * Is `config.yml` in the correct directory?
  * Did you restart the server after making changes?

## 6) FAQ

**What is the default port?**\
There is no default; choose any **available** port (for example 454 or 25575).

**Can I use a domain instead of an IP?**\
Yes, as long as the panel can reach it.

**How should I write commands?**\
Do not use a leading slash in the panel. For example: `give %player% diamond 1`.

<Check>
  WebSender setup completed. You can now send commands to your Minecraft server through the panel.
</Check>