Overview
This plugin enhances your server network with customizable MOTD (Server Info), Tablist, and Joinstates features. All settings are synchronized across all proxies, offering extensive customization through simple configuration files.
Supported Software
| Software | Plugin Support |
|---|
| Velocity | ✅ Yes |
| Bungeecord | ✅ Yes |
Want to add support for another server software? Submit a pull request on
GitHub! Quick Setup
- Download the plugin from GitHub
- Place it in your proxy template’s plugins folder
- Start your proxy server
- Set a joinstate for your group (e.g.,
maintenance for your proxy group)
Features
Server Info (MOTD)
Create multiple layouts in the layout/ folder for dynamic server information display:
first-lines:
- <color:#0ea5e9>A simplecloud.app network
second-lines:
- " "
player-info: []
version-name: ""
max-player-display-type: REAL # or DYNAMIC
dynamic-player-range: 1 # Only enabled if max-player-display-type is DYNAMIC
When running locally, actual slots are displayed due to controller health
checks. Players see different information based on your configuration.
groups:
- group-or-service: "*"
tab-lists:
- header:
- ""
- <color:#0ea5e9>SimpleCloud v3
- "Frame 1"
footer:
- ""
- " <color:#ffffff><online_players> players <color:#cbd5e1>are playing on your network "
- <color:#64748b> sɪᴍᴘʟᴇᴄʟᴏᴜᴅ.ᴀᴘᴘ
- ""
# Create another list entry for rotation
- header:
- ""
- <color:#0ea5e9>SimpleCloud v3
- "Frame 2"
footer:
- ""
- " <color:#ffffff><online_players> players <color:#cbd5e1>are playing on your network "
- <color:#64748b> sɪᴍᴘʟᴇᴄʟᴏᴜᴅ.ᴀᴘᴘ
- ""
tab-list-update-time: 1000 # Update interval in milliseconds
Joinstates
Manage server access with customizable states:
# Default state for new groups
default-state: public
join-states:
- name: public
join-permission: "" # Empty for public access
full-join-permission: simplecloud.join.full.public
motd-layout-by-proxy: public
- name: closedBeta
join-permission: simplecloud.join.closedbeta
full-join-permission: simplecloud.join.full.closedbeta
motd-layout-by-proxy: closed_beta
- name: maintenance
join-permission: simplecloud.join.maintenance
full-join-permission: simplecloud.join.full.maintenance
motd-layout-by-proxy: maintenance
Commands
| Command | Description |
|---|
/joinstate group <group> <state> | Set group joinstate |
/joinstate server <group> <numericalId> <state> | Set server joinstate |
/joinstate help | Show command help |
/joinstate groups | List groups and states |
/joinstate states | List all joinstates |
Placeholders
| Placeholder | MOTD | Tablist | Description |
|---|
<online_players> | ✅ | ✅ | Current online players |
<max_players> | ✅ | ✅ | Maximum network players |
<date> | ✅ | ✅ | Current date |
<env:NAME> | ✅ | ✅ | Environment variable |
<server_name> | ❌ | ✅ | Player’s current server |
<ping> | ❌ | ✅ | Player’s ping |
Permissions
| Permission | Description |
|---|
simplecloud.command.joinstate.* | All joinstate commands |
simplecloud.command.joinstate.help | View command help |
simplecloud.command.joinstate.groups | View groups and states |
simplecloud.command.joinstate.states | View all joinstates |
simplecloud.command.joinstate.server | Set server joinstate |
simplecloud.command.joinstate.group | Set group joinstate |
API Integration
API documentation will be available once the API is ready and public.
