AdminTerminal

!Minecraft
!Java

AdminTerminal 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

• Direct System Command Execution: Execute OS shell commands via /at execute
• Working Directory Navigation: Change current working directory with /at cd
• Process Management: Terminate all plugin-created processes via /at killall
• System Information: View server OS details via /at platform
• Alert System: 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:

• use_alarm: Enable/disable command execution alerts
• force_english: 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

/at platform

Example output:

[AT] Server OS: Linux (x86_64) - 5.15.0-83-generic

Change Directory

/at cd /home/minecraft

Example output:

[AT] Working directory changed to: /home/minecraft

Execute System Command

/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

/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: Submit Issue

---

License

• See LICENSE