MiniGameCore

插件

· 作者 Wueffi

适用于多人服务器的 Clean MiniGame 核心插件。

0 本站下载 0 关注 更新于 5 小时前

最新 2.2.0 · 26.3 · Folia / Paper

一键开服(送7天)

MiniGameCore

MiniGameCore 是一个用于在 Minecraft Paper 服务器上管理小游戏大厅的核心插件。它负责处理游戏的托管、加入、开始和停止——并支持动态计分板、统计数据和多世界(Multiverse)兼容。


? 安装

  1. 从 Modrinth 或 Releases 页面下载最新的 .jar 文件。
  2. 将文件放入你的 Minecraft 服务器的 plugins/ 文件夹中。
  3. 如需权限管理,你可以选择使用 LuckPerms 等插件。
  4. 重启服务器一次。

? 命令与权限

别名:/p 对应 /party,/tc 对应 /teamchat

命令 描述 权限
/mg host <game> 创建一个新的大厅 mgcore.host
/mg join <lobby-id> 加入大厅 mgcore.join
/mg ready 将你的状态设置为就绪 mgcore.ready
/mg unready 将你的状态设置为未就绪 mgcore.ready
/mg confirm 确认一项操作 mgcore.confirm
/mg leave 离开大厅或游戏 mgcore.leave
/mg start 手动开始游戏(如果允许) mgcore.start
/mg spectate <lobby-id|player> 以观察者身份加入游戏 mgcore.spectate
/mg reload 重新加载插件 mgcore.admin
/mg stop <lobby-id> 停止特定游戏 mgcore.admin
/mg stopall 停止所有活跃的游戏 mgcore.admin
/mg ban <player> 禁止玩家使用大多数 MiniGameCore 命令 mgcore.admin
/mg version 显示你正在使用的 MiniGameCore 版本 mgcore.use (默认)
/party create <name> 创建一个新的队伍 mgcore.party.create
/party join <player> 加入玩家的队伍 mgcore.party.join

| /party leave | 离开你的队伍 | mgcore.party.join | | /party invite <player> | 邀请一名玩家加入你的队伍 | mgcore.party.invite | | /party deny | 拒绝一名玩家对你队伍的邀请 | mgcore.party.invite | | /party list | 列出队伍成员 | mgcore.party.list | | /teamchat <message> | 仅向你的团队发送消息 | mgcore.teamchat |


⚙️ 插件配置

插件配置文件位于文件夹:./plugins/MiniGameCore。主配置文件为 config.yml。

config.yml

示例配置:

available-games:
- Game1
- Game2
- Game3
banned-players:
- 2e0749e5-4ec0-4201-b58d-c4277014749c
- 337482fe-8a15-47f6-bea5-a84918a86393
keep-worlds: false
disable-scoreboard: false
keep-inventories-after-games: true

注意:如果 keep-worlds: true,插件会将它们移动到 ./plugins/MiniGameCore/ArchivedWorlds,而不是删除它们。

加载游戏世界 & 配置它们

游戏世界和配置文件所在的文件夹是 ./MiniGameCore。每个游戏世界的命名格式应为:<游戏名称>_world。如果你希望一个游戏包含多个地图,其他世界的命名格式为 <游戏名称>_world<索引>。世界配置文件名为 config.yml,应位于对应游戏的子文件夹中。

所有可用选项如下:

字段 描述 必填 / 默认值
name 游戏的显示名称,例如在计分板或 /mg host 命令中显示 ✅ 是
maxPlayers 此游戏实例的最大玩家数量 ✅ 是
teams 队伍的最大数量(0 表示无队伍,可设置 2-8 支队伍) ❌ 否(默认:0)
minPlayers 此游戏的最小玩家数量 ❌ 否(默认:2)
spawnPoints 无队伍玩家的默认出生点 ✅ 视情况而定
teamSpawnPoints 各队伍的出生点(例如 0: [...], 1: [...]) ✅ 视情况而定
inventory 游戏开始时的初始物品(例如 ["WOODEN_SHOVEL"]) ❌ 否
allowed_break_blocks 允许破坏的方块(例如 ["SNOW_BLOCK"]) ❌ 否
allowed_place_blocks 允许放置的方块(例如 ["OAK_PLANKS"]) ❌ 否
respawnMode 控制重生行为:"true" 或 "false" ❌ 否(默认:false)
respawnDelay 重生前的延迟秒数(如果启用) ❌ 否(默认:0)
doDurability 控制物品耐久度:true(原版)或 false ❌ 否(默认:true)
allowPVP 允许 PvP:true(原版)或 false ❌ 否(默认:true)
blocked_damage_causes 阻止以下伤害来源发生 ❌ 否
timeLimit 经过 X 秒后停止游戏 ❌ 否(默认:600)
allowFriendlyFire 允许同一队伍的成员互相攻击 ❌ 否(默认:false)
allowCrafting 允许玩家在游戏中制作物品 ❌ 否(默认:false)
silenceDeathMessages 是否静默死亡消息 ❌ 否(默认:false)
hostPerm 只有拥有此权限的玩家才能主持此游戏 ❌ 否(默认:mgcore.host)
joinPerm 只有拥有此权限的玩家才能加入此游戏 ❌ 否(默认:mgcore.join)
doHunger 玩家的饥饿条是否应消耗 ❌ 否(默认:false)
allowOpeningContainers 允许玩家在游戏开始前打开容器 ❌ 否(默认:false)

8 人制 Spleef 游戏的配置示例:

game:
  name: Spleef
  maxPlayers: 8
  teams: 0
  spawnPoints:
    spawn1:
      x: -11
      y: 64
      z: 0
    spawn2:
      x: -7
      y: 64
      z: -7
    spawn3:
      x: 0
      y: 64
      z: -11
    spawn4:
      x: 7
      y: 64
      z: -7
    spawn5:
      x: 11
      y: 64
      z: 0
    spawn6:
      x: 7
      y: 64
      z: 7
    spawn7:
      x: 0
      y: 64
      z: 11
    spawn8:
      x: -7
      y: 64
      z: 7
  inventory:
    - "iron_shovel"
  allowed_break_blocks:
    - "snow_block"
  respawnMode: false
  doDurability: false
  allowPVP: false

‼️ API

你可以通过使用 Gradle 导入项目来使用 MiniGameCoreAPI!将以下内容粘贴到你的 build.gradle 文件中:

repositories {
    maven { url "https://jitpack.io"  }
}

dependencies {
    implementation 'com.github.Wueffi:MiniGameCore:master-SNAPSHOT'
}

在你的项目中,使用 import wueffi.MiniGameCore.x 导入类/事件/方法。

可用事件包括:
GameStartEvent,包含 event.getGameName() 和 event.getLobby()
GameOverEvent,包含 event.getLobby()

有用的 MGC 类包括:
Lobby
Team

可用的 API 方法包括:
getLobbyManager() -> 返回 LobbyManager 实例
winPlayer(Lobby lobby, Player player) -> 让单个玩家赢得游戏
winTeam(Lobby lobby, Team team) -> 让一个队伍赢得游戏
playerDeath(UUID playerid) -> 通知 MiniGameCore 某玩家死亡
playerAlive(UUID playerid) -> 通知 MiniGameCore 某玩家重生
getRespawnLocation(UUID playerid) -> 返回玩家的重生位置

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源