Scroll of Creative Mode (Timed & Sandboxed Admin Rewards)

创造模式卷轴（限时与沙盒化管理员奖励）

通常来说，让非管理员玩家临时进入创造模式，以便进行大型建筑项目或领取活动奖励，会带来巨大的安全风险。标准的 /gamemode 命令没有内置计时器；飞行突然关闭时，玩家可能因坠落受到致命伤害；而且玩家可以不受限制地生成并囤积基岩、命令方块或成堆的稀有资源。

创造模式卷轴加入了一种完全独立、由管理员发放的消耗品，可开启限时沙盒会话，将临时创造模式权限与其他内容隔离。它让服务器版主能够放心授予创造模式建造权限，而不损害服务器经济或世界完整性。

功能

• 管理员专属自定义物品：独立的物品注册名（creativescroll:creative_scroll）。不加入任何生存模式合成配方或创造模式物品栏，因此只能由获授权的版主生成和发放。
• 持久化会话倒计时：通过服务器端实体数据附加项追踪剩余会话时间，并在动作栏显示实时计时器（MM:SS）。计时器会在玩家断开连接或服务器重启后无缝保留；计时结束后，玩家会自动恢复为服务器的全局默认游戏模式。
• 物品栏沙盒隔离：激活时保存玩家原有的生存模式物品栏；计时结束时清除所有创造模式生成的物品，并完整恢复玩家会话前的物品栏。
• 数据包层级的物品屏蔽列表：在服务器端直接拦截 ServerboundSetCreativeModeSlotPacket 数据包，拒绝受限方块和物品，防止它们被生成——即使客户端经过修改，也能保护你的服务器。
• 容器与丢弃隔离：卷轴会话期间，阻止玩家打开箱子、木桶、潜影盒、熔炉、漏斗、物品展示框，或丢弃物品（按 Q 或拖出物品栏），防止物品被偷运进永久储存容器。
• 到期安全着陆保护：卷轴到期时自动施加可配置时长的缓降效果，保护正在高空建造、可能因创造模式飞行关闭而坠落的玩家。
• 实时管理员管理：内置管理员命令，可即时重新加载配置规则，或提前结束进行中的会话，无需重启服务器。

工作原理

传统的游戏模式切换方案依赖外部权限插件或脆弱的命令方块循环，容易留下物品复制和储存漏洞。创造模式卷轴直接在服务器刻和网络数据包层级严格隔离各项状态。

玩家手持卷轴右键使用时，服务器会消耗卷轴，将当前物品栏序列化并保存为持久化附加记录，切换到创造模式，并启动精确到游戏刻的倒计时。会话期间，服务器端 Mixin 和 Fabric 交互回调会检查传入的物品栏槽位数据包、玩家丢弃物品操作和容器交互，实时拦截被禁止的物品 ID 和储存访问。倒计时归零（或管理员强制结束会话）后，玩家创造模式物品栏中的物品会被清除，原有的生存模式装备会被恢复，游戏模式会切回服务器默认设置，并施加缓降效果，确保安全落地。

使用说明

安装

1. 请确保服务器和客户端环境都已安装Fabric 加载器，并运行Minecraft 26.3和Fabric API。
2. 将 creativescroll-*.jar 文件放入服务器和客户端的 mods/ 目录中。
3. 启动一次游戏，自动生成自定义服务器参数配置文件。

获取与使用卷轴

由于创造模式卷轴仅限管理员发放，因此没有生存模式合成配方。

• 生成物品（管理员 / 服务器运营者）：
  /give <player> creativescroll:creative_scroll
• 激活：
  手持卷轴并在任意时刻右键使用，即可消耗卷轴并开始限时创造模式会话。

管理员命令：

运营者（Gamemaster / OP 等级 2+）可以在游戏中实时管理配置和当前会话：

• /CreativeScroll reload — 立即重新加载 config/creativescroll.json，无需重启服务器。
• /CreativeScroll expire <player> — 立即结束目标玩家正在进行的卷轴会话，恢复其生存模式物品栏、切回原游戏模式并施加缓降效果。

配置文件调整：

前往实例目录中的 /config/creativescroll.json，微调会话时长、反作弊保护和屏蔽物品列表：

{
  "defaultDurationSeconds": 1800,
  "slowFallingSeconds": 10,
  "sandboxInventory": true,
  "blockContainersAndDrops": true,
  "blockedItems": [
    "minecraft:bedrock",
    "minecraft:command_block",
    "minecraft:repeating_command_block",
    "minecraft:chain_command_block",
    "minecraft:structure_block",
    "minecraft:barrier",
    "minecraft:light",
    "minecraft:spawner",
    "minecraft:end_portal_frame",
    "minecraft:netherite_block",
    "minecraft:diamond_block"
  ]
}

• defaultDurationSeconds：单次卷轴会话的总时长，单位为秒（默认值 1800，即 30 分钟）。
• slowFallingSeconds：会话结束时施加的缓降安全效果持续时间，单位为秒（设为 0 可禁用）。
• sandboxInventory：设为 true 后，激活时备份玩家的生存模式物品栏，并在会话结束时清除创造模式生成的物品。
• blockContainersAndDrops：设为 true 后，卷轴会话期间禁止玩家打开储存容器、与物品展示框或盔甲架互动，以及丢弃物品。
• blockedItems：可自定义命名空间物品 ID 列表（例如 “minecraft:gold_block”、”minecraft:chest”），禁止玩家从创造模式物品栏中生成这些物品。