\n### \u201c*You’re not switching modes, you’re switching dimensions.*\u201d<\/p>\n
~~*2000 Downloads?! Thanks!*~~<\/p>\n
# 1 Feature<\/p>\n
## 1.1 Offline Player<\/p>\n
You can change the gamemode of a player, **even he (or she) was offline**.<\/p>\n
## 1.2 Permissions<\/p>\n
Allow permission group plugins (_like Luckperms_) to manage **which gamemodes can be switched to** and **which gamemodes cannot be switched to**.<\/p>\n
_e.g. Allow to switch to survival mode but not to any other mode._<\/p>\n
## 1.3 Alias<\/p>\n
**\/gamemode** is simplified to **\/gm** and **\/g**.<\/p>\n
_(of course you can still use \/gamemode)_<\/p>\n
## 1.4 Cross-Server Storage<\/p>\n
Support **MySQL** and **SQLite** storage backends. Player gamemodes are saved and synchronized across multiple servers in a network.<\/p>\n
## 1.5 Folia Support<\/p>\n
**Fully compatible with Folia servers** \u2014 using region-based scheduling for optimal performance.<\/p>\n
## 1.6 Lightweight<\/p>\n
The Plugin size is only **~25 KB** and has **almost no impact** on server performance!<\/p>\n
# 2 Caution<\/p>\n
## 2.1 Shortcut Keys<\/p>\n
If you need to use shortcut keys such as **F3+F4**, please install another plugin **F3NPerm**.<\/p>\n
## 2.2 Versions<\/p>\n
**1.8.X +**<\/p>\n
**All Bukkit based server** (Paper, Spigot, Purpur, Folia, etc.)<\/p>\n
# 3 Commands<\/p>\n
“`markdown \/g = \/gm = \/gamemode # 4 Permission Node<\/p>\n “`markdown # 5 Custom Config<\/p>\n ## 5.1 Basic Settings<\/p>\n “`yaml **Language** setting<\/p>\n “`yaml If a **new player joined your server**, **which gamemode should he (she) be**?<\/p>\n **survival**, **creative**, **adventure**, **spectator**<\/p>\n “`yaml Show logo or not when plugin enabled.<\/p>\n **true**, **false**<\/p>\n “`yaml Enable debug logging for troubleshooting.<\/p>\n **true**, **false**<\/p>\n ## 5.2 Storage Configuration<\/p>\n “`yaml **Storage backend type**: **yaml**, **sqlite**, **mysql**<\/p>\n ### SQLite Example<\/p>\n “`yaml ### MySQL Example<\/p>\n “`yaml ## 5.3 Custom Messages<\/p>\n “`yaml **Customizable Messages**. You can add **your own new language** here!<\/p>\n ## 5.4 An Example config.yml<\/p>\n “`yaml # 6 Developer API (Async)<\/p>\n ## Get Instance<\/p>\n “`java ## Get Player Gamemode<\/p>\n “`java ## Set Player Gamemode<\/p>\n “`java ## Listen to Gamemode Changes<\/p>\n “`java > **Note:** All APIs are **fully async** and thread-safe. The `GamemodeChangeEvent` is only fired for **online players** when their mode is actually changed. The `getPlayerMode()` method returns `null` if the player has no saved gamemode data.<\/p>\n # 7 Reprint Post<\/p>\n www.minebbs.com\/resources\/xgamemode.11041<\/p>\n hangar.papermc.io\/Wind_Blood\/XGamemode<\/p>\n modrinth.com\/plugin\/xgamemode<\/p>\n # 8 Feedback<\/p>\n Just e-mail me with **windblood@foxmail.com**. Thanks!<\/p>\n","protected":false},"excerpt":{"rendered":" You’re not switching modes, you’re switching dimensions.<\/p>\n","protected":false},"featured_media":172376,"template":"","meta":{"_minecraft_slug":"xgm","_minecraft_project_id":"J0B80Y0Q","_minecraft_author":"Wind_Blood","_minecraft_license":"CC-BY-NC-SA-4.0","_minecraft_downloads":2050,"_minecraft_follows":4,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"xgm.zip","_minecraft_size_bytes":491050,"_minecraft_version_count":50,"_minecraft_updated_at":"2026-05-16T06:15:48.570511Z","_minecraft_date_created":"2025-01-27T06:39:03.617429Z","_minecraft_date_modified":"2026-04-29T03:17:55.348640Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/xgm","_minecraft_icon_attachment_id":172376,"_minecraft_imported_at":"2026-06-09T22:02:14+00:00","_minecraft_import_hash":"064e82e8cda0a7abae3ed5c2f15a9bf7","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,43,125,89,126,90,127,128,129,91,123,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,21,20,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864,83,167,163],"class_list":["post-172375","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-cursed","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-storage","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","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-10","minecraft_version-1-21-11","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","minecraft_version-1-21-9","minecraft_version-1-7-10","minecraft_version-1-7-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n– \/xgamemode
\n– \/xgamemode reload
\n– \/gm
\n– \/gm
\n– \/gm
\n– \/gm
\n\/xg = \/xgm = \/xgamemode
\n“`<\/p>\n
\n– xgamemode.survival
\n– xgamemode.creative
\n– xgamemode.adventure
\n– xgamemode.spectator
\n– xgamemode.others.survival
\n– xgamemode.others.creative
\n– xgamemode.others.adventure
\n– xgamemode.others.spectator
\n– xgamemode.reload
\n– xgamemode.admin
\n“`<\/p>\n
\nlang: en-US
\n“`<\/p>\n
\ndefault_gamemode: survival
\n“`<\/p>\n
\nshow_logo: true
\n“`<\/p>\n
\ndebug: false
\n“`<\/p>\n
\nstorage:
\n type: yaml
\n“`<\/p>\n
\nstorage:
\n type: sqlite
\n # No additional config needed \u2014 data.db will be created automatically
\n“`<\/p>\n
\nstorage:
\n type: mysql
\n mysql:
\n host: localhost
\n port: 3306
\n database: minecraft
\n username: root
\n password: your_password
\n“`<\/p>\n
\nmessages:
\n en-US: # Original en-US Language by Wind_Blood
\n reloaded: “&aXGamemode Reloaded!”
\n # ……
\n custom_lang: # Add Your Custom Language!
\n reloaded: “Thank you for using XGamemode!”
\n # ……
\n“`<\/p>\n
\nlang: msgForMyServer
\ndefault_gamemode: survival
\nshow_logo: false
\ndebug: false
\nstorage:
\n type: yaml
\nmessages:
\n msgForMyServer:
\n reloaded: “\u5f88\u660e\u663e\u4f5c\u8005\u662f\u4e2d\u56fd\u4eba \u4f1a\u8bf4\u4e2d\u6587\u5f88\u6b63\u5e38 \u7136\u540e\u6211\u4e5f\u4e0d\u77e5\u9053\u4e3a\u4ec0\u4e48\u6211\u8981\u5728\u4e00\u5806\u82f1\u6587\u91cc\u5199\u4e00\u6bb5\u4e2d\u6587 \u633a\u597d\u7b11\u7684 \u54c8\u54c8\u54c8 \u5bf9\u4e86 \u770b\u5230\u6211\u5c31\u662f\u7f18\u5206 XGamemode \u5b98\u65b9 QQ \u53cd\u9988\u4ea4\u6d41\u7fa4\uff1a\u70b9\u51fb\u94fe\u63a5\u52a0\u5165\u7fa4\u804a\u3010XGamemode \u53cd\u9988\u7fa4\u3011\uff1ahttps:\/\/qm.qq.com\/q\/rpTk5LK7w4 \u6b22\u8fce\u52a0”
\n usage: “&cUsage: \/gm
\n console_usage: “&cUsage: \/gm
\n invalid_gamemode: “&cInvalid Gamemode!”
\n invalid_player: “&cInvalid Player!”
\n gamemode_self: “&aYour Gamemode Changed to {mode}!”
\n gamemode_all: “&aChanged All Player’s Gamemode to {mode}!”
\n gamemode_online: “&aAll Online Player’s Gamemode Changed to {mode}!”
\n gamemode_offline: “&aAll Offline Player’s Gamemode Changed to {mode}!”
\n no_permission: “&cYOU ARE NOT ALLOWED TO DO THAT!”
\n gamemode_other: “&a{player}’s Gamemode Changed to {mode}!”
\n gamemode_other_offline: “&a{player} (Offline)’s Gamemode Changed to {mode}!”
\n“`<\/p>\n
\nMain plugin = Main.getInstance();
\n“`<\/p>\n
\nplugin.getPlayerMode(playerUUID).thenAccept(mode -> {
\n if (mode != null) {
\n \/\/ mode is GameMode.SURVIVAL, CREATIVE, ADVENTURE, or SPECTATOR
\n \/\/ Player is online or has saved data
\n } else {
\n \/\/ Player not found or no saved gamemode yet
\n }
\n});
\n“`<\/p>\n
\nplugin.setPlayerMode(playerUUID, GameMode.SURVIVAL).thenAccept(success -> {
\n if (success) {
\n \/\/ Gamemode changed and saved successfully
\n \/\/ Works for both online and offline players
\n } else {
\n \/\/ Failed to save (database error, etc.)
\n }
\n});
\n“`<\/p>\n
\n@EventHandler
\npublic void onGamemodeChange(GamemodeChangeEvent event) {
\n Player player = event.getPlayer(); \/\/ Online player only
\n GameMode oldMode = event.getOldMode();
\n GameMode newMode = event.getNewMode();
\n}
\n“`<\/p>\n