Timesync
Timesync 是一款 Paper 插件,用于将 Minecraft 的游戏时间与现实时间同步。
该插件完全控制指定世界的时间,并允许你选择时区的来源:固定的 UTC 偏移量、城市与国家,或地理坐标。
✨ 功能
-
? 将 Minecraft 时间与现实时间同步。
-
? 三种时区检测模式:
- UTC — 固定的时区偏移量,例如
UTC+3。
- City — 基于城市和国家检测时区。
- Coordinates — 基于坐标自动检测时区。
-
? 太阳和月亮的位置与现实时间相对应。
-
? 支持完整的 Minecraft 游戏内时间,包括游戏内的天数。
-
? 禁用原版自动时间推进功能,以防止 Minecraft 与 Timesync 发生冲突。
-
⚙️ 时间更新间隔可在设置中配置。
-
? City 和 Coordinates 模式下使用 Open-Meteo 来确定时区。
-
? Timesync 独立于 Atmosync 和其他插件运行。
? 要求
- Minecraft 1.21.1
- Paper 或兼容的核心端
- Java 21
⚙️ 配置
UTC
使用固定的时区偏移量:
location:
mode: "utc"
utc-offset: 3
例如,3 对应 UTC+3,而 -5 对应 UTC-5。
City
指定城市和国家:
location:
mode: "city"
city: "Moscow"
country: "Russia"
Timesync 将自动确定该城市的坐标及其时区。
Coordinates
你可以直接指定坐标:
location:
mode: "coordinates"
coordinates:
latitude: 55.75204
longitude: 37.61781
Timesync 将为这些坐标自动确定时区。
? 世界选择
Timesync 将同步指定的世界:
world:
name: "world"
⏱️ 更新间隔
刷新率以秒为单位设置:
time:
update-interval: 1
在此示例中,Timesync 每秒更新一次游戏时间。
?️ 睡眠
Timesync 不会在玩家睡觉后倒推游戏时间。
现实时间仍然是唯一真理。如果现实中确实是夜晚,Minecraft 就不应该在睡醒后突然跳转到早晨。
? Open-Meteo
在 City 和 Coordinates 模式下,Timesync 使用 Open-Meteo 来确定时区。
要使这些模式正常工作,服务器需要能够访问相应的 API。
如果 API 暂时不可用,Timesync 将无法确定相应模式的时区。
? 工作原理
Timesync 获取当前的现实时间:
Real time
↓
Time zone
↓
Current local time
↓
Minecraft time
↓
World
同时,原版的 DO_DAYLIGHT_CYCLE 被禁用,因此游戏时间不会脱离 Timesync 独立移动。
? 许可证
本项目根据仓库中指定的许可证分发。
Timesync
Timesync is a Paper plugin that synchronizes the in-game time of Minecraft with real-world time.
The plugin fully controls the time of the specified world and allows you to choose where to take the time zone from: a fixed UTC shift, a city and country, or geographic coordinates.
✨ Opportunities
-
? Synchronization of Minecraft time with real time.
-
? Three time zone detection modes:
- UTC — a fixed time zone offset, for example
UTC+3.
- City — time zone detection based on the city and country.
- Coordinates — automatic time zone detection based on coordinates.
-
? The sun and moon are in a position corresponding to real time.
-
? Full Minecraft in-game time is supported, including the in-game day number.
-
? Vanilla automatic time progression is disabled so that Minecraft does not conflict with Timesync.
-
⚙️ The time update interval is configurable in the settings.
-
? Open-Meteo is used to determine the time zone in City and Coordinates modes.
-
? Timesync works independently of Atmosync and other plugins.
? Requirements
- Minecraft 1.21.1
- Paper or a compatible core
- Java 21
⚙️ Configuration
UTC
Use a fixed time zone offset:
location:
mode: "utc"
utc-offset: 3
For example, 3 corresponds to UTC+3', and -5corresponds toUTC-5'.
City
Specify the city and country:
location:
mode: "city"
city: "Moscow"
country: "Russia"
Timesync will determine the coordinates of the city and its time zone automatically.
Coordinates
You can specify the coordinates directly:
location:
mode: "coordinates"
coordinates:
latitude: 55.75204
longitude: 37.61781
Timesync will automatically determine the time zone for these coordinates.
? World selection
Timesync will synchronize the specified world:
world:
name: "world"
⏱️ Update interval
The refresh rate is set in seconds.:
time:
update-interval: 1
In this example, Timesync updates the game time every second.
?️ Sleep
Timesync does not rewind game time after sleep.
Real time remains the source of truth. If it's really nighttime, Minecraft shouldn't suddenly jump to morning after sleeping.
? Open-Meteo
In City and Coordinates modes, Timesync uses Open-Meteo to determine the time zone.
For these modes to work, the server needs access to the corresponding API.
If the API is temporarily unavailable, Timesync will not be able to determine the time zone for the corresponding mode.
? How it works
Timesync retrieves the current real time:
Real time
↓
Time zone
↓
Current local time
↓
Minecraft time
↓
World
At the same time, the vanilla DO_DAYLIGHT_CYCLE is disabled, so the game time does not move independently of Timesync.
? License
The project is distributed under the license specified in the repository.
评论 0
登录后参与评分
还没有评论,来抢沙发吧