Minecraft 自定义昼夜 Mod

Minecraft 自定义昼夜 Mod

一个仅服务端的 Fabric 模组,适用于 Minecraft,可让你配置昼夜时长。

游戏机制

☀️ 自定义昼夜模组 🌙

完全掌控 Minecraft 的昼夜循环——无需客户端模组。

一个轻量级、仅服务端的 Minecraft Fabric 模组,让你精确自定义主世界中白天和黑夜的时长。无论你想在阳光下进行马拉松式建造,还是想要短暂而紧张的黑夜——这个模组都能轻松实现。

Fabric License: MIT Modrinth


✨ 特性

  • 两种自定义方式——使用速度倍率或设置精确的刻(tick)数时长
  • 交互式聊天菜单——在聊天中点击按钮实时调整设置,无需客户端模组
  • 实时时长预览——菜单以人类可读的时间显示生成的白天、黑夜和完整周期时长
  • 配置热重载——无需重启服务器即可即时更改设置
  • 保存与恢复默认值——将更改持久化到磁盘,或一键重置所有内容
  • 安全限制——数值被限制在安全范围内以防止服务器崩溃
  • 游戏内命令——在聊天中查看状态、重载配置、设置数值以及切换日志
  • 带版本标记的日志——所有控制台和聊天消息均包含模组名称和版本
  • 兼容原版客户端——玩家无需安装任何东西
  • 零世界数据更改——可随时安全地添加或移除

🚀 快速开始

  1. 将模组的 .jar 文件放入服务器的 mods/ 文件夹(需要 Fabric Loader 和 Fabric API)。
  2. 启动服务器——将自动创建默认配置文件。
  3. 在游戏内运行 /customdaynight——交互式设置菜单将打印在聊天中。按 T 打开聊天,然后点击任意按钮并按 Enter 应用。
  4. 或者直接编辑 config/customdaynightmod.properties(见下文)。
  5. 在菜单中点击 [Save](然后按 Enter)将更改持久化到磁盘。

⚙️ 配置

文件: config/customdaynightmod.properties

# 速度倍率(1.0 = 正常速度,0.5 = 一半速度 / 时长翻倍)
day_multiplier=1.0
night_multiplier=1.0

# 以刻为单位的绝对时长(当 > 0 时覆盖倍率)
absolute_day_length=0
absolute_night_length=0

# 将昼夜切换记录到服务器控制台
log_phase_changes=true

快速参考: 1 Minecraft 刻 = 50 毫秒 · 20 刻 = 1 秒 · 12,000 刻 = 10 分钟实时时间(白天和黑夜的默认时长)。

工作原理

设置 作用
day_multiplier / night_multiplier 缩放时间推进的速度。值为 0.5 使该阶段持续两倍时长;2.0 使其快两倍。
absolute_day_length / absolute_night_length 将阶段时长设置为精确的刻数。当设置为大于 0 的值时,优先于倍率。
log_phase_changes 当为 true 时,每次世界在白天和黑夜之间切换时向服务器控制台打印一条消息。

⚠️ 安全限制

为防止服务器不稳定,所有数值都会自动限制在安全范围内:

设置 最小值 最大值 备注
day_multiplier / night_multiplier 0.01 100.0 防止时间冻结或极端速度
absolute_day_length / absolute_night_length 20 刻(1 秒) 2,400,000 刻(约 33 小时 20 分) 设置为 0 以禁用(改用倍率)

如果通过命令或配置文件输入了超出允许范围的值,它将被静默限制,并在聊天中显示警告。


📖 示例

示例 1:为建造者延长白天(50 分钟白天 / 10 分钟黑夜)

absolute_day_length=60000
absolute_night_length=12000

☀️ 白天持续 50 分钟(60,000 刻)——充足的建造时间。
🌙 黑夜持续 10 分钟(12,000 刻)——标准时长。

示例 2:仅减慢白天(20 分钟白天 / 10 分钟黑夜)

day_multiplier=0.5
night_multiplier=1.0
阶段 默认 使用此配置
☀️ 白天 10 分钟 20 分钟(一半速度 → 时长翻倍)
🌙 黑夜 10 分钟 10 分钟(不变)

提示: 你可以混合搭配——例如,使用 absolute_day_length 设定精确的白天时长,同时使用 night_multiplier 缩放黑夜。


🔧 命令

所有命令需要 管理员权限等级 4(完全 OP)。

交互式菜单

命令 描述
/customdaynight 打开交互式设置菜单(与 /customdaynight menu 相同)
/customdaynight menu 打开交互式设置菜单

菜单显示所有当前设置,分为速度倍率和固定时长(覆盖)两组。每行都有可点击的 [−] 和 [+] 按钮,会将目标命令预填入你的聊天栏,还有一个 [✎] 按钮会预填入空白值供输入。操作按钮 [Save]、[Reload] 和 [Defaults] 的工作方式相同。点击按钮,然后按 Enter 应用。

更喜欢用分钟而不是刻? 使用 /customdaynight duration day <minutes> 或 /customdaynight duration night <minutes>——接受小数(例如 12.5)。

为什么不单击即应用? 原版客户端在每次点击需要管理员权限的 run_command 时都会显示*"确认命令执行"*对话框。预填聊天栏可以避免该弹窗并保持流程快捷:点击 → Enter。

将鼠标悬停在任意数值上可查看其含义和允许范围。固定时长在设置为 0 时显示 OFF,表示该阶段改由上面的倍率控制。

底部的时长摘要显示有效的白天、黑夜和完整周期时长(例如 ☀ Day: 10m 0s · ☽ Night: 10m 0s · ⏱ Full Cycle: 20m 0s)。

提示: 按 T 打开聊天,点击任意按钮,然后按 Enter。

配置命令

命令 描述
/customdaynight duration day <minutes> 以实时分钟设置白天阶段时长(接受小数,例如 12.5)。底层使用固定时长。
/customdaynight duration night <minutes> 以实时分钟设置黑夜阶段时长。
/customdaynight set dayMultiplier <value> 设置白天速度倍率
/customdaynight set nightMultiplier <value> 设置黑夜速度倍率
/customdaynight set absoluteDayLength <value> 以刻为单位设置绝对白天时长(0 为禁用)
/customdaynight set absoluteNightLength <value> 以刻为单位设置绝对黑夜时长(0 为禁用)

实用命令

命令 描述
/customdaynight reload 从磁盘重载配置文件(丢弃未保存的更改)
/customdaynight save 将当前内存中的设置保存到配置文件
/customdaynight defaults 将所有设置重置为默认值(不保存到磁盘)
/customdaynight status 显示当前设置菜单
/customdaynight togglePhaseLogging 开启或关闭昼夜切换消息

🔗 链接


📄 许可证

本项目根据 MIT 许可证 授权。