# Virtual Host Command Plugin for Bukkit\/Minecraft
\nEver thought of having different domains\/subdomains for the same Minecraft\/Bukkit server and depending on the domain a player joins offer different settings?
\nThis plugin is a bit like apache virtual hosts, detecting the host name of the Minecraft server the player used (CNAMEs). You can configure what commands to run on joining the server depending on the host name. E.g. you can have a server with multiverse and subdomains hub.example.com and pvp.example.com and then send the player directly to the hub-world or the arena-world depending on the domain they used to connect to the server.
\n> **Note:** Bedrock proxy with **geyser** does not supply the host name on join \u2013 so it’s not working for vhosts. It only supplies the IP address, so you need a different IP address for each domain connecting via geyser\/proxy.
\n> **FIX** add the following to you geyser config.yml:<\/p>\n
# Forward the hostname that the Bedrock client used to connect over to the Java server
\n # This is designed to be used for forced hosts on proxies
\n forward-hostname: true<\/p>\n
> **Note:** We heavily rely on the supplied hostname. This is not always given in PingServerList list event, so **motd** and **icon** per vhost does not always work on all server implementations. For paper-mc we added a workaround to get the hostname used for the ping.<\/p>\n
Here is an example of four vhosts running on the same server with the same IP address but accessed using different vhosts via different CNAMEs:<\/p>\n
<\/p>\n
### Update 0.9.2
\n – minor fixes, cleanup, housekeeping
\n – added *ifInWorld* and *ifNotInWorld* conditions (see example config)<\/p>\n
### Update 0.9.3
\n – small fixes
\n – added *motd* and *icon* config for vhosts (see example config)<\/p>\n
## Example Config
\nsee up2date file in *plugins\/VirtualHostCommandPlugin\/config.yml*<\/p>\n
# Example config file for VirtualHostCommand bukkit plugin
\n # Location: plugins\/VirtualHostCommandPlugin\/config.yml<\/p>\n
vhosts:
\n host_example:
\n # the hoostname is matched agains the joining hostname via starts-with, so parts work as well
\n # you can also add the port, sub.domain.com:port
\n # it’s mandatory, and always case-insensitive
\n hostname: example.com
\n # (optional) only run if player joined this world(s)
\n ifInWorld: “world_some_regex”
\n # (optional) only run if player did not join this world(s)
\n # if ifInWorld and ifNotInWorld present, they must be both true
\n ifNotInWorld: “world_some_regex”
\n # (optional) MOTD for this vhost
\n # NOTE: this only works if you server implementation returns a hostname in the ping event, many don’t \ud83d\ude41
\n # for paper-mc we have added a workaround to fetch the vhost hostname pinged via reflection.
\n motd: “some colorfull MOTD server messagenmultiline if you like!”
\n # (optional) server icon filename, format like server-icon.png, same root directory
\n # NOTE: same restrictions as for ‘motd’ config option apply
\n icon: server-icon-example.png
\n # List of commands to be executed if joining via this hostname
\n commands:
\n # he following placeholders are allowd:
\n # %player% , %hostname% and %port%
\n – some command …
\n – another cmmand with %player% to replace with player name
\n – msg %player% haha it works from %hostname%<\/p>\n
host_example2:
\n # example with an IP
\n hostname: “123.45.67.89”
\n commands:
\n – some command …
\n – another cmmand with %player% to replace with player name
\n – msg %player% haha it works<\/p>\n
host_hub:
\n hostname: hub.myworld.com
\n ifNotInWorld: “^world_hub”
\n commands:
\n – gamemode %player% survival
\n – msg %player% crazy shit
\n – mv tp %player% world_hub<\/p>\n
see https:\/\/github.com\/cgaffga\/mc-vhost\/tree\/main\/docs<\/p>\n
## Source
\nSource code can be found at https:\/\/github.com\/cgaffga\/mc-vhost\/<\/p>\n
## Download
\n* Builds in https:\/\/github.com\/cgaffga\/mc-vhost\/tree\/main\/dist\/
\n* Spigot https:\/\/www.spigotmc.org\/resources\/virtualhostcommandplugin.113311\/
\n* Bukkit https:\/\/legacy.curseforge.com\/minecraft\/bukkit-plugins\/virtualhostcommandplugin
\n* Modrinth https:\/\/modrinth.com\/mod\/virtual-host-command-plugin<\/p>\n","protected":false},"excerpt":{"rendered":"
Ever thought of having different domains\/subdomains for the same Minecraft\/Bukkit server and depending on the domain a player joins offer different settings? This plugin is a bit like apache virtual hosts, for Minecraft servers<\/p>\n","protected":false},"featured_media":166791,"template":"","meta":{"_minecraft_slug":"virtual-host-command-plugin","_minecraft_project_id":"GLqGwlxD","_minecraft_author":"cgaffga","_minecraft_license":"Apache-2.0","_minecraft_downloads":187,"_minecraft_follows":7,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"virtual-host-command-plugin.zip","_minecraft_size_bytes":6363,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:52:33.581526Z","_minecraft_date_created":"2023-12-16T10:38:38.168426Z","_minecraft_date_modified":"2023-12-13T12:29:25.395847Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/virtual-host-command-plugin","_minecraft_icon_attachment_id":166791,"_minecraft_imported_at":"2026-06-09T18:34:06+00:00","_minecraft_import_hash":"d05b74e9481fcfae0bded7710117a83b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,127,129,123],"mod_loader":[130,132,134],"minecraft_version":[60,93,94,101,102,62,37,73,74,38,78,79,80,81],"class_list":["post-166790","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-spigot","mod_category-technology","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n