XGamemode

插件

· 作者 Wind_Blood

你切换的不是模式,而是维度。

0 本站下载 0 关注 更新于 2 个月前

最新 4.6-rls · 26.2 · Bukkit / Folia

一键开服(送7天)

XGamemode Logo

“你不是在切换模式,你是在切换维度。”

2000 次下载?!谢谢!

1 功能特性

1.1 离线玩家

你可以更改玩家的生存模式(gamemode),即使他(或她)处于离线状态。

1.2 权限管理

允许权限组插件(如 Luckperms)管理可以切换到哪些生存模式以及不可以切换到哪些生存模式。

例如:允许切换到生存模式,但不允许切换到其他任何模式。

1.3 命令别名

/gamemode 被简化为 /gm 和 /g。

(当然,你仍然可以使用 /gamemode)

1.4 跨服务器存储

支持 MySQL 和 SQLite 存储后端。玩家的生存模式数据会在网络中的多个服务器之间保存并同步。

1.5 Folia 支持

完全兼容 Folia 服务器 —— 使用基于区域的调度以实现最佳性能。

1.6 轻量级

插件大小仅为 ~25 KB,对服务器性能的影响几乎为零!

2 注意事项

2.1 快捷键

如果你需要使用 F3+F4 等快捷键,请安装另一个插件 F3NPerm。

2.2 版本要求

1.8.X +

所有基于 Bukkit 的服务器(Paper, Spigot, Purpur, Folia 等)

3 命令

- /xgamemode
- /xgamemode reload
- /gm <mode>
- /gm <mode> <player>
- /gm <mode> -all
- /gm <mode> -online
- /gm <mode> -offline

/g = /gm = /gamemode
/xg = /xgm = /xgamemode

4 权限节点

- xgamemode.survival
- xgamemode.creative
- xgamemode.adventure
- xgamemode.spectator
- xgamemode.others.survival
- xgamemode.others.creative
- xgamemode.others.adventure
- xgamemode.others.spectator
- xgamemode.reload
- xgamemode.admin

5 自定义配置

5.1 基本设置

lang: en-US

语言设置

default_gamemode: survival

如果新玩家加入你的服务器,应该将他们设置为什么生存模式?

survival(生存)、creative(创造)、adventure(冒险)、spectator(旁观者)

show_logo: true

插件启用时是否显示 Logo。

true(是)、false(否)

debug: false

启用调试日志以进行故障排除。

true(是)、false(否)

5.2 存储配置

storage:
  type: yaml

存储后端类型:yaml、sqlite、mysql

SQLite 示例

storage:
  type: sqlite
  # 无需额外配置 —— data.db 将自动创建

MySQL 示例

storage:
  type: mysql
  mysql:
    host: localhost
    port: 3306
    database: minecraft
    username: root
    password: your_password

5.3 自定义消息

messages: 
  en-US: # Wind_Blood 提供的原始英文语言包
    reloaded: "&aXGamemode Reloaded!"
    # ......
  custom_lang: # 添加你自己的自定义语言!
    reloaded: "Thank you for using XGamemode!"
    # ......

可自定义的消息。你可以在这里添加你自己的新语言!

5.4 一个 config.yml 示例

lang: msgForMyServer
default_gamemode: survival
show_logo: false
debug: false
storage:
  type: yaml
messages: 
  msgForMyServer:
    reloaded: "很明显作者是中国人 会说中文很正常 然后我也不知道为什么我要在一堆英文里写一段中文 挺好笑的 哈哈哈 对了 看到我就是缘分 XGamemode 官方 QQ 反馈交流群:点击链接加入群聊【XGamemode 反馈群】:https://qm.qq.com/q/rpTk5LK7w4 欢迎加"
    usage: "&cUsage: /gm <mode> [player/-all/-online/-offline]"
    console_usage: "&cUsage: /gm <mode> <player/-all/-online/-offline>"
    invalid_gamemode: "&cInvalid Gamemode!"
    invalid_player: "&cInvalid Player!"
    gamemode_self: "&aYour Gamemode Changed to {mode}!"
    gamemode_all: "&aChanged All Player's Gamemode to {mode}!"
    gamemode_online: "&aAll Online Player's Gamemode Changed to {mode}!"
    gamemode_offline: "&aAll Offline Player's Gamemode Changed to {mode}!"
    no_permission: "&cYOU ARE NOT ALLOWED TO DO THAT!"
    gamemode_other: "&a{player}'s Gamemode Changed to {mode}!"
    gamemode_other_offline: "&a{player} (Offline)'s Gamemode Changed to {mode}!"

6 开发者 API (异步)

获取实例

Main plugin = Main.getInstance();

获取玩家生存模式

plugin.getPlayerMode(playerUUID).thenAccept(mode -> {
    if (mode != null) {
        // mode 为 GameMode.SURVIVAL, CREATIVE, ADVENTURE 或 SPECTATOR
        // 玩家在线或拥有已保存的数据
    } else {
        // 未找到玩家或尚无已保存的生存模式数据
    }
});

设置玩家生存模式

plugin.setPlayerMode(playerUUID, GameMode.SURVIVAL).thenAccept(success -> {
    if (success) {
        // 生存模式已成功更改并保存
        // 适用于在线和离线玩家
    } else {
        // 保存失败(数据库错误等)
    }
});

监听生存模式变更

@EventHandler
public void onGamemodeChange(GamemodeChangeEvent event) {
    Player player = event.getPlayer();      // 仅限在线玩家
    GameMode oldMode = event.getOldMode();
    GameMode newMode = event.getNewMode();
}

注意: 所有 API 均为完全异步且线程安全。GamemodeChangeEvent 仅在玩家的模式实际发生更改时针对在线玩家触发。如果玩家没有已保存的生存模式数据,getPlayerMode() 方法将返回 null。

7 转载文章

hangar.papermc.io/Wind_Blood/XGamemode

modrinth.com/plugin/xgamemode

8 反馈

只需通过电子邮件联系我 windblood@foxmail.com。谢谢!

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源