SurvivalAdmin

SurvivalAdmin

Professional administration plugin for Minecraft Survival servers with role-based access control.

One jar, Paper/Purpur/Spigot compatible. Made by Omega

✨ Features

• Role-based access control — user, staff, owner with permission inheritance
• UUID-based role storage — roles stored by player UUID, immune to name changes and spoofing
• Command blocking — regular users can only use whitelisted commands; all others are blocked
• Namespace/alias bypass prevention — blocks /bukkit:plugins, /minecraft:gamemode, etc.
• Tab completion filtering — blocked commands hidden from suggestions
• Custom messages — join, quit, death, kill messages with placeholders
• 15+ admin commands — heal, feed, tp, gamemode, fly, god, time, weather, invsee, kick, ban, tempban, mute, vanish, sit
• Inventory inspection — /inv to view/edit player inventory
• Ban with duration — /getoff [reason] supports 1h, 1d, 30m, permanent
• Vanish mode — /invis / /vanish to become invisible in TAB and the world
• Granular permissions — survivaladmin.kick, survivaladmin.ban, survivaladmin.mute, etc.
• Atomic file writes — crash-safe role storage
• Audit log — every admin action is logged with timestamp and actor
• YAML config — easy to edit config.yml

📦 Installation

1. Download SurvivalAdmin-2.0.0.jar from Releases
2. Put in plugins/
3. Start server — plugins/SurvivalAdmin/ is created with config.yml
4. Edit config.yml to set owners and staff
5. Restart server

⚙️ Configuration

config.yml

Roles

roles:
default: "user" # Default role for new players
staff: [] # List of staff player names (auto-migrated to UUID on first join)
owner:

• "DevOmega" # List of owner player names (auto-migrated to UUID on first join)

Granular permissions per role

permissions:
user: []
staff:

• survivaladmin.kick
• survivaladmin.ban
• survivaladmin.tempban
• survivaladmin.unban
• survivaladmin.mute
• survivaladmin.unmute
• survivaladmin.tp
• survivaladmin.heal
• survivaladmin.feed
• survivaladmin.gamemode
• survivaladmin.fly
• survivaladmin.god
• survivaladmin.time
• survivaladmin.weather
• survivaladmin.invsee
• survivaladmin.vanish

owner:

• survivaladmin.* # All permissions

Commands allowed for regular users (all others are blocked)

user-commands:

• "sit"
• "msg"
• "tell"
• "w"
• "me"
• "list"
• "help"

Custom messages (use {player}, {role}, {killer} placeholders)

messages:
no-permission: "§cУ вас немає доступу до цієї команди"
command-blocked: "§cЦя команда недоступна на цьому сервері"
role-given: "§aГравцю {player} видано роль {role}"
role-removed: "§cУ гравця {player} забрано роль {role}"
unknown-role: "§cНевідома роль: {role}"
player-not-found: "§cГравця {player} не знайдено"
join: "§a{player} приєднався до гри"
quit: "§c{player} покинув гру"
death: "§c{player} помер"
kill: "§c{player} був убитий гравцем {killer}"

roles.json (auto-generated)

Roles are stored by UUID in plugins/SurvivalAdmin/roles.json:
{
"c1c3bec8-a19f-3fc5-afef-b5c7e1c3ab21": {"role": "owner", "name": "DevOmega"},
"550e8400-e29b-41d4-a716-446655440000": {"role": "staff", "name": "Player1"}
}

Legacy name-based roles (from older versions) are automatically migrated to UUID on player join.

🔧 Commands

For all players

Command · Description
/sit · Sit down
/msg · Send private message
/help · Show available commands

For staff (requires staff or owner role)

Command · Description
/admin · Show admin panel
/kick [reason] · Kick a player
/ban [reason] · Ban a player
/tempban [reason] · Temporarily ban
/unban · Unban a player
/mute [reason] · Mute a player
/unmute · Unmute a player
/heal [player] · Heal player
/feed [player] · Feed player
/tp · Teleport to player
/gm [player] · Change gamemode
/fly [player] · Toggle flight
/god [player] · Toggle god mode
/time · Change time
/weather · Change weather
/inv · View/edit player inventory
/getoff [reason] · Ban with time and reason
/invis / /vanish · Toggle invisibility

For owners only

Command · Description
/staff · Give staff role
/unstaff · Remove staff role
/owner · Give owner role
/unowner · Remove owner role

🔒 Permissions

Permission · Description · Default
survivaladmin.owner · Owner permissions · op
survivaladmin.staff · Staff permissions · false
survivaladmin.user · User permissions · true
survivaladmin.kick · Kick players · false
survivaladmin.ban · Ban players · false
survivaladmin.tempban · Temporarily ban players · false
survivaladmin.unban · Unban players · false
survivaladmin.mute · Mute players · false
survivaladmin.unmute · Unmute players · false
survivaladmin.tp · Teleport to players · false
survivaladmin.heal · Heal players · false
survivaladmin.feed · Feed players · false
survivaladmin.gamemode · Change gamemode · false
survivaladmin.fly · Toggle flight · false
survivaladmin.god · Toggle god mode · false
survivaladmin.time · Change time · false
survivaladmin.weather · Change weather · false
survivaladmin.invsee · View player inventory · false
survivaladmin.vanish · Toggle invisibility · false

🛠️ Build

./build.sh

-> target/SurvivalAdmin-2.0.0.jar

Requires Paper/Purpur API jar (auto-detected from ../../servers/).