================================================================================
ASTRABANS — Staff punishments at warp speed
Astra Series · Punishment Plugin · Fairy · Minecraft 1.8 – 1.21.x
================================================================================
Fairy-powered ban suite with GUI workflow, punishment ladders, Discord
webhooks, and one-click imports from LiteBans, AdvancedBan, and more.
• Fairy framework
• SQLite · MySQL · MongoDB
• 1.8 – 1.21.x
• Galaxy MiniMessage UI
--------------------------------------------------------------------------------
FEATURES
--------------------------------------------------------------------------------
PUNISH GUI
Nested menu flow — punishment type, reason presets, durations, silent toggle,
and ladder shortcuts. Open with /punish <player>.
PUNISHMENT LADDERS
Auto-escalate warns → mutes → bans from YAML thresholds. Staff see the next
rung in the GUI before issuing.
TRIPLE STORAGE
SQLite (default), MySQL for networks, MongoDB for document stores. JDBC and
Mongo drivers download at runtime to plugins/AstraBans/lib/ — no manual
driver juggling.
5 LEGACY IMPORTERS
/astrabans import <source> — async import with error reporting:
litebans → LiteBans/litebans.db
advancedban → AdvancedBan/database.db
banmanager → BanManager/local_bans.db or bans.db
essentialsx → Essentials/bannedplayers.yml, bannedips.yml, userdata
maxbans → MaxBans/maxbans.db or bans.db
DISCORD + STAFF ALERTS
Per-action Discord webhooks and in-game staff alerts. Announcements support
MiniMessage gradients, legacy & codes, hex (&#), and rgb().
STAFF TOOLKIT
/history, /check, /alts, IP punishments, staff notes, unban/unmute/unwarn.
MUTE ENFORCEMENT
Blocks chat and commands while muted or IP-muted. Configurable bypass
permission (default: astrabans.bypass.mute).
AUTOMATIC EXPIRY
Timed punishments deactivate automatically across SQLite, MySQL, and MongoDB.
VERSIONED CONFIGS
YAML configs deep-merge on load and reload. Missing keys are filled from
defaults when config-version bumps.
CONFIG FILES (auto-migrated)
config.yml — storage, driver coordinates, color scheme
punishments.yml — announcements, kick templates, ladders, GUI presets
discord.yml — per-action webhook URLs and message templates
alerts.yml — in-game staff alerts per action
gui.yml — GUI titles, layout, items, slots, materials, lore
--------------------------------------------------------------------------------
COMMANDS
--------------------------------------------------------------------------------
Duration syntax: 30d, 7d2h3m, perm / permanent / -1
Silent flag: -s on any announcing command
--- Punishments ---
/punish <player>
Permission: astrabans.command.punish
GUI workflow with presets and punishment ladders.
/ban <player> [duration] [reason] [-s]
Permission: astrabans.command.ban
Timed or permanent ban.
/kick <player> [reason] [-s]
Permission: astrabans.command.kick
/warn <player> [reason] [-s]
Permission: astrabans.command.warn
/mute <player> [duration] [reason] [-s]
Permission: astrabans.command.mute
/ipban <player> [duration] [reason] [-s]
Permission: astrabans.command.ipban
/ipmute <player> [duration] [reason] [-s]
Permission: astrabans.command.ipmute
/notes <player> [reason]
Permission: astrabans.command.notes
Add a staff note (not broadcast).
--- Pardons ---
/unban <player>
Permission: astrabans.command.unban
/unmute <player>
Permission: astrabans.command.unmute
Clears mute and IP mute.
/unwarn <player>
Permission: astrabans.command.unwarn
Clears active warn.
--- Lookup ---
/history <player>
Permission: astrabans.command.history
Full punishment history.
/check <player>
Permission: astrabans.command.check
Active punishments only.
/alts <player>
Permission: astrabans.command.alts
Accounts sharing the same IP.
--- Admin ---
/astrabans help
Permission: astrabans.command.help
Permission-filtered command list.
/astrabans reload
Permission: astrabans.command.admin
Reload configs and reopen storage.
/astrabans import <source>
Permission: astrabans.command.admin
Sources: litebans, advancedban, banmanager, essentialsx, maxbans
--------------------------------------------------------------------------------
PERMISSIONS
--------------------------------------------------------------------------------
Command permissions (grant per role as needed):
astrabans.command.punish — /punish GUI
astrabans.command.ban — /ban
astrabans.command.kick — /kick
astrabans.command.warn — /warn
astrabans.command.unwarn — /unwarn
astrabans.command.mute — /mute
astrabans.command.ipban — /ipban
astrabans.command.ipmute — /ipmute
astrabans.command.notes — /notes
astrabans.command.unban — /unban
astrabans.command.unmute — /unmute
astrabans.command.history — /history
astrabans.command.check — /check
astrabans.command.alts — /alts
astrabans.command.help — /astrabans help
astrabans.command.admin — /astrabans reload, /astrabans import
Other permissions:
astrabans.staff.alerts — receive in-game staff alerts (configurable in
alerts.yml; this is the default)
astrabans.bypass.mute — bypass mute and IP-mute enforcement
(configurable in config.yml)
--------------------------------------------------------------------------------
PRICING
--------------------------------------------------------------------------------
AstraBans — Full license
$14.99 one-time
• Every command + punish GUI
• SQLite, MySQL, MongoDB
• Discord webhooks and staff alerts
• 5 legacy importers
• Free updates for the 1.x line
--------------------------------------------------------------------------------
Ready to upgrade staff moderation? Import your existing bans, open the punish
GUI, and ship Galaxy-styled messages today.
AstraBans · Astra Series · Fairy
================================================================================
ASTRABANS — Staff punishments at warp speed
Astra Series · Punishment Plugin · Fairy · Minecraft 1.8 – 1.21.x
================================================================================
Fairy-powered ban suite with GUI workflow, punishment ladders, Discord
webhooks, and one-click imports from LiteBans, AdvancedBan, and more.
• Fairy framework
• SQLite · MySQL · MongoDB
• 1.8 – 1.21.x
• Galaxy MiniMessage UI
--------------------------------------------------------------------------------
FEATURES
--------------------------------------------------------------------------------
PUNISH GUI
Nested menu flow — punishment type, reason presets, durations, silent toggle,
and ladder shortcuts. Open with /punish <player>.
PUNISHMENT LADDERS
Auto-escalate warns → mutes → bans from YAML thresholds. Staff see the next
rung in the GUI before issuing.
TRIPLE STORAGE
SQLite (default), MySQL for networks, MongoDB for document stores. JDBC and
Mongo drivers download at runtime to plugins/AstraBans/lib/ — no manual
driver juggling.
5 LEGACY IMPORTERS
/astrabans import <source> — async import with error reporting:
litebans → LiteBans/litebans.db
advancedban → AdvancedBan/database.db
banmanager → BanManager/local_bans.db or bans.db
essentialsx → Essentials/bannedplayers.yml, bannedips.yml, userdata
maxbans → MaxBans/maxbans.db or bans.db
DISCORD + STAFF ALERTS
Per-action Discord webhooks and in-game staff alerts. Announcements support
MiniMessage gradients, legacy & codes, hex (&#), and rgb().
STAFF TOOLKIT
/history, /check, /alts, IP punishments, staff notes, unban/unmute/unwarn.
MUTE ENFORCEMENT
Blocks chat and commands while muted or IP-muted. Configurable bypass
permission (default: astrabans.bypass.mute).
AUTOMATIC EXPIRY
Timed punishments deactivate automatically across SQLite, MySQL, and MongoDB.
VERSIONED CONFIGS
YAML configs deep-merge on load and reload. Missing keys are filled from
defaults when config-version bumps.
CONFIG FILES (auto-migrated)
config.yml — storage, driver coordinates, color scheme
punishments.yml — announcements, kick templates, ladders, GUI presets
discord.yml — per-action webhook URLs and message templates
alerts.yml — in-game staff alerts per action
gui.yml — GUI titles, layout, items, slots, materials, lore
--------------------------------------------------------------------------------
COMMANDS
--------------------------------------------------------------------------------
Duration syntax: 30d, 7d2h3m, perm / permanent / -1
Silent flag: -s on any announcing command
--- Punishments ---
/punish <player>
Permission: astrabans.command.punish
GUI workflow with presets and punishment ladders.
/ban <player> [duration] [reason] [-s]
Permission: astrabans.command.ban
Timed or permanent ban.
/kick <player> [reason] [-s]
Permission: astrabans.command.kick
/warn <player> [reason] [-s]
Permission: astrabans.command.warn
/mute <player> [duration] [reason] [-s]
Permission: astrabans.command.mute
/ipban <player> [duration] [reason] [-s]
Permission: astrabans.command.ipban
/ipmute <player> [duration] [reason] [-s]
Permission: astrabans.command.ipmute
/notes <player> [reason]
Permission: astrabans.command.notes
Add a staff note (not broadcast).
--- Pardons ---
/unban <player>
Permission: astrabans.command.unban
/unmute <player>
Permission: astrabans.command.unmute
Clears mute and IP mute.
/unwarn <player>
Permission: astrabans.command.unwarn
Clears active warn.
--- Lookup ---
/history <player>
Permission: astrabans.command.history
Full punishment history.
/check <player>
Permission: astrabans.command.check
Active punishments only.
/alts <player>
Permission: astrabans.command.alts
Accounts sharing the same IP.
--- Admin ---
/astrabans help
Permission: astrabans.command.help
Permission-filtered command list.
/astrabans reload
Permission: astrabans.command.admin
Reload configs and reopen storage.
/astrabans import <source>
Permission: astrabans.command.admin
Sources: litebans, advancedban, banmanager, essentialsx, maxbans
--------------------------------------------------------------------------------
PERMISSIONS
--------------------------------------------------------------------------------
Command permissions (grant per role as needed):
astrabans.command.punish — /punish GUI
astrabans.command.ban — /ban
astrabans.command.kick — /kick
astrabans.command.warn — /warn
astrabans.command.unwarn — /unwarn
astrabans.command.mute — /mute
astrabans.command.ipban — /ipban
astrabans.command.ipmute — /ipmute
astrabans.command.notes — /notes
astrabans.command.unban — /unban
astrabans.command.unmute — /unmute
astrabans.command.history — /history
astrabans.command.check — /check
astrabans.command.alts — /alts
astrabans.command.help — /astrabans help
astrabans.command.admin — /astrabans reload, /astrabans import
Other permissions:
astrabans.staff.alerts — receive in-game staff alerts (configurable in
alerts.yml; this is the default)
astrabans.bypass.mute — bypass mute and IP-mute enforcement
(configurable in config.yml)
--------------------------------------------------------------------------------
PRICING
--------------------------------------------------------------------------------
AstraBans — Full license
$14.99 one-time
• Every command + punish GUI
• SQLite, MySQL, MongoDB
• Discord webhooks and staff alerts
• 5 legacy importers
• Free updates for the 1.x line
--------------------------------------------------------------------------------
Ready to upgrade staff moderation? Import your existing bans, open the punish
GUI, and ship Galaxy-styled messages today.
AstraBans · Astra Series · Fairy
================================================================================
