原创 娱乐 经济 MagicSize —— 玩家体型自由缩放 · 氪金权限 · 趣味玩法 1.0.0

作者 Aisen ｜ 联系 QQ 1797950 ｜ 插件交流群 974349582

承接插件定制 · 玩法开发 · 功能扩展，低至 10 元起。

简介

MagicSize 是一款体型缩放插件。玩家打开体型菜单，点选精灵、小巧、匀称、魁梧、巍峨五种形态，或在聊天栏输入数值自定义体型。

适合做大厅装扮、会员特效、活动玩法（跑酷、躲猫猫、Boss 战体型差异）。

纯 Bukkit API 开发，兼容 1.20.5 ~ 1.21.x / 26.x，无需前置。

点击展开...

功能特性

• MySQL 群组互通 — 多子服共享体型数据，Velocity/Bungee 通用

• 体型菜单 — 玻璃边框界面，顶部实时显示当前体型

• 5 种形态 — 精灵 0.4 / 小巧 0.75 / 匀称 1.0 / 魁梧 1.5 / 巍峨 2.5，可在配置中自由增改

• 自定义体型 — 聊天栏输入精确数值，支持 cancel 取消

• 权限分级 — 不同组不同体型上限（如 VIP 到 4.0、MVP 到 8.0）

• 防卡保护 — 变大时自动上移，避免窒息

• 冷却机制 — 防刷切换，秒数可配

• 音效 + 粒子 — 切换时播放反馈效果

• 进服还原 — 退出重进自动恢复上次形态

• 权限回收 — 无权限玩家进服自动恢复默认

• PAPI 变量 — 当前缩放值对外暴露

• 管理员命令 — 调整 / 还原其他玩家体型

命令

• /ms — 打开体型菜单

• /ms custom — 输入自定义数值

• /ms set <数值> — 调整自己体型

• /ms set <玩家> <数值> — 调整其他玩家体型

• /ms reset — 恢复自己默认形态

• /ms reset <玩家> — 恢复其他玩家默认形态

• /ms reload — 重载配置

别名：/msize、/magicsize

点击展开...

权限

• magicsize.use — 打开菜单、自定义体型、调整自己 — 默认不给

• magicsize.set — 调整其他玩家体型 — 默认 OP

• magicsize.reset — 还原其他玩家体型 — 默认 OP

• magicsize.reload — 重载配置 — 默认 OP

权限分级（可选）

• magicsize.limit.vip — VIP 上限（默认 0.01 ~ 4.0）

• magicsize.limit.mvp — MVP 上限（默认 0.01 ~ 8.0）

示例（LuckPerms）

# 所有玩家可用基础体型
/lp group default permission set magicsize.use true

# vip 可变形范围更大
/lp group vip permission set magicsize.limit.vip true

# svip 几乎无限制
/lp group svip permission set magicsize.limit.mvp true

PlaceholderAPI 变量

• %magicsize_scale% — 当前体型缩放值（如 1.50）

配置示例

完整配置见插件生成的 plugins/MagicSize/config.yml，注释齐全。

storage: yaml          # yaml = 本地 | mysql = 群组互通

mysql:
  host: "127.0.0.1"
  port: 3306
  database: "magicsize"
  username: "root"
  password: "123456"

options:
  restore-on-join: true
  cooldown-seconds: 3
  anti-suffocate: true

limits:
  min: 0.01
  max: 2.0

presets:
  fairy:
    display: "&a✿ 精灵"
    scale: 0.40
    material: "FEATHER"
    slot: 10
  titan:
    display: "&c◆ 巍峨"
    scale: 2.50
    material: "OBSIDIAN"
    slot: 14

安装说明

1. 下载 MagicSize-1.0.0.jar，放入 plugins/

2. 启动服务器，自动生成 plugins/MagicSize/config.yml

3. 配置形态预设、范围、权限分级

4. 给玩家授权 magicsize.use

5. 执行 /ms reload 或重启服务器

兼容性

• 游戏版本 — 1.20.5 ~ 1.21.x / 26.x

• 服务端 — Paper / Purpur / Spigot

• Java — 8+

• 前置依赖 — 无（MySQL 模式需准备 MySQL 数据库）

• 可选依赖 — PlaceholderAPI

• 群组服 — Velocity / BungeeCord，配 MySQL 即可互通

常见问题

Q：最低什么版本能用？

1.20.5。再低的版本服务端没有体型缩放属性，插件会自动禁用并提示。

Q：群组服怎么共享体型数据？

把 storage 改成 mysql，所有子服配同一数据库即可。进服自动读取共享数据，跨服切换体型同步生效。

Q：MySQL 连不上怎么办？

插件会禁用并提示原因。检查 host/port/账号密码是否正确，数据库是否已创建。连接成功后控制台会显示「已连接 MySQL」。

Q：变大后卡进方块怎么办？

开启 anti-suffocate（默认开启），变大时会自动把玩家上移到有空间的位置。

Q：不同组想要不同的体型上限？

用 limit-tiers 权限分级。给组加 magicsize.limit.vip 之类节点即可覆盖默认范围。

Q：怎么让玩家进服自动恢复？

restore-on-join: true（默认开启），数据保存在 plugins/MagicSize/data/ 下。

感谢使用，欢迎反馈建议！