Minecraft plugin AdvancedServerList

🔌 About AdvancedServerList

AdvancedServerList — is a plugin for Minecraft servers that allows deep customization of the server entry shown on a player's multiplayer screen. AdvancedServerList lets you create multiple server list profiles, select which profile is shown using priorities and conditions, and change MOTD, player count text, player-count hover and the server favicon.

🎯 Purpose

AdvancedServerList solves the need to present different server list entries depending on context (maintenance, incompatible client versions, promotional messages, region‑specific text). It centralizes server list presentation into configurable profiles, avoiding manual edits and repeated restarts.

• Use cases:
  • Show maintenance or version warnings to players before they join.
  • Display dynamic player count text or hover details using placeholders.
  • Rotate promotional or seasonal MOTDs without restarting the server.

⚙ Main features

• Multiple Server List Profiles (YAML files) with priority and optional condition logic.
• Configure MOTD, player count text, player count hover and favicon per profile.
• Condition system supporting placeholders and logical operators to decide which profile displays.
• Placeholder support (built‑in placeholders and PlaceholderAPI integration when available).
• Platform builds for Paper/Spigot, BungeeCord/Waterfall and Velocity (separate jars).
• API for addons and third‑party plugins to add placeholders and listen to events.

(Confirmed: supports Paper/Spigot, BungeeCord and Velocity platforms).

🧩 Who it’s for

• Server owners running Paper/Spigot who want advanced server list presentation.
• Network operators using BungeeCord or Velocity who need per‑state entries.
• Plugin developers who want to extend server list behaviour via the AdvancedServerList API.

🏗 Examples

• An active server shows normal MOTD and player‑count text; a maintenance profile (higher priority) displays when maintenance mode is active.
• A version‑check condition shows a message if a joining player's client version is unsupported.
• Use PlaceholderAPI placeholders in MOTD and hover to show dynamic player stats.

(Confirmed: PlaceholderAPI integration and platform‑specific jars documented). ()

⌨️ Commands

(Confirmed list of subcommands available; individual permissions for each subcommand are not fully enumerated in the official docs — only the advancedserverlist.command.help node is explicitly referenced). ()

🔐 Permissions

Information about other explicit permission nodes and their defaults is not available in the official documentation pages referenced. Do not assume permission names or defaults not shown in official sources. If you require fine‑grained permission control, test on a staging server or consult the plugin source/addons. ()

⚙ Installation

📥 Installation

• Download the correct jar for your platform and place it into your server's plugins/ folder (Platform‑specific jars: Paper, BungeeCord, Velocity).
• Restart the server or proxy (full restart, not /reload).
• On first start the plugin creates an AdvancedServerList/ (or advancedserverlist/ on Velocity) folder with config.yml, a profiles/ folder and favicons/. ()

📦 Dependencies

• The Spigot/Paper build requires ProtocolLib. Optional integrations: PlaceholderAPI, ViaVersion, and proxy bridging addons (PAPIProxyBridge) are supported when present. ()

🧾 Configuration

• The plugin generates config.yml and a profiles/default.yml on first run. Profiles are single YAML files in the profiles/ folder. The default profile contains comments explaining available options.
• Conditions support built‑in placeholders; PlaceholderAPI placeholders can be used in many text fields when PlaceholderAPI is installed and the player has previously joined while AdvancedServerList was active. ()

Database

• AdvancedServerList stores a playercache.json (IP, UUID, names) used for cached placeholder values; cache behaviour can be disabled in config. No MySQL/SQLite server database configuration is required for core features. ()

🧠 Additional information

Known conflicts & limitations

• The Spigot/Paper build requires ProtocolLib — missing ProtocolLib will prevent the plugin from functioning on those platforms. ()
• When used in proxy environments (BungeeCord/Velocity) use the corresponding jar built for that proxy.
• Some placeholder values rely on cached player data; if playercache is disabled certain placeholders may not resolve.

FAQ

Q: Which platforms does AdvancedServerList support? A: Paper/Spigot, BungeeCord/Waterfall and Velocity builds are provided. ()

Q: Is PlaceholderAPI supported? A: Yes — PlaceholderAPI placeholders are supported in many text fields on the Spigot/Paper build when PlaceholderAPI is installed. ()

Q: Does AdvancedServerList send usage stats? A: Yes — the plugin reports statistics to bStats (can be disabled via the global bStats config). ()

Q: Is there an API for other plugins? A: Yes — AdvancedServerList exposes an API for adding placeholders, listening to events and modifying profiles. See the API docs for examples and maven coordinates. ()

Q: How do I migrate from ServerListPlus or MiniMOTD? A: The plugin includes /asl migrate <plugin> options to automate migrations for supported plugins. See the migration docs. ()

Support & addons

• There is an official documentation/wiki and an addons page listing third‑party integrations. For developer integration use the published API artifacts. ()

🤝 When to use this plugin

Use AdvancedServerList when you need flexible, condition‑based server list entries, multi‑profile management, PlaceholderAPI integration and an extensible API for addons. It fits Paper/Spigot servers and proxy networks where presenting different server list states is required.