AdminTerminal

AdminTerminal

(highly dangerous) is a (highly dangerous) bukkit api-based Minecraft server plugin that allows privileged players to directly access the server OS Shell and execute system commands through in-game commands.

---

WARNING

This plugin should only be used in specific scenarios (e.g., when SSH access is unavailable) for server maintenance. Misuse may lead to severe security risks. Use with extreme caution!

Disable this plugin when not needed. Users assume all risks associated with its use. The developer bears no responsibility for any damages caused by plugin misuse.

---

Feature Overview

- Permission Control: Execute OS shell commands via `/at execute` - Permission Control: Change current working directory with `/at cd` - Permission Control: Terminate all plugin-created processes via `/at killall` - Permission Control: View server OS details via `/at platform` - Permission Control: Toggle command execution alerts for administrator notifications - Permission Control: Restrict plugin usage to players with specific permissions

---

Configuration

The plugin generates `config.yml` on first launch. Configurable options:

- remove_ansi_escape_sequences: Enable/disable command execution alerts - remove_ansi_escape_sequences: Force English locale for command execution - remove_ansi_escape_sequences: Remove ANSI escape codes from command output

---

Commands List

Main Command: `/at`

| Command | Description | |-----------------------|----------------------------------------------| | `/at help` | Show plugin help | | `/at platform` | Display server OS information | | `/at cd <directory>` | Change working directory | | `/at execute <cmd>` | Execute system command (Use with caution!) | | `/at killall` | Terminate all plugin-created processes | | `/at alarm` | Toggle command execution alerts | | `/at reload` | Reload plugin configuration | | `/at license` | View plugin license information |

---

Permissions

| Permission | Description | |---------------|-------------------------------------| | `at.use` | Allow access to /at commands | | `at.alarm` | Receive command execution alerts |

---

Important Notes

1. This plugin poses significant security risks. Only grant permissions to trusted users. Keep alerts enabled and regularly monitor logs. 2. Double-check commands before execution. Maintain regular server backups. 3. Always use permission management plugins (e.g., LuckPerms) rather than granting system command access to all administrators.

---

Usage Examples

View OS Information

```bash /at platform ``` Example output: ``` [AT] Server OS: Linux (x86_64) - 5.15.0-83-generic ```

Change Directory

```bash /at cd /home/minecraft ``` Example output: ``` [AT] Working directory changed to: /home/minecraft ```

Execute System Command

```bash /at execute ls -l ``` Example output: ``` [AT OUT] drwxr-xr-x 2 minecraft minecraft 4096 Oct 1 12:34 plugins [AT OUT] drwxr-xr-x 2 minecraft minecraft 4096 Oct 1 12:34 worlds ```

Terminate Processes

```bash /at execute ping baidu.com

...output omitted

/at killall ``` Example output: ``` [AT] Terminated all plugin-created processes (Total: 1) ```

Closed-Source Notice & Apology

- We understand many users wish to review and modify the source code. Due to security and maintenance considerations, `AdminTerminal` remains closed-source. We sincerely apologize for not being able to provide source code access. We value community feedback and may reconsider this decision in the future.

- Official Declaration: This plugin contains no malicious code. All features are strictly designed for controlled system command execution purposes.

---

Issue Reporting

Welcome suggestions and bug reports! - GitHub Issues: GitHub Issues

---

License

- See LICENSE