Chrono API

This mod was extracted from Deus Chrono-Machina to separate its reusable time-control engine from the original mod's gameplay content. It provides a clean foundation that other mods can use for time manipulation without requiring Deus Chrono-Machina itself.

Features

• Set tick rates from 0.0001 to 100 TPS.
• Pause and resume time globally or around an entity owner.
• Create scoped and bounded time fields for arenas and special gameplay areas.
• Whitelist entities so they can continue acting during a time pause.
• Record loaded world history and rewind entities, blocks, items, projectiles, inventories, and supported player state.
• Includes a Java API for addon developers and gameplay integrations.
• Includes extension hooks for custom time-field rules, rewind protection, player state, and client visuals.
• Includes client support for frozen entities, interpolation, rewind item trails, and rollback effects.
• Provides the /chrono command tree for testing and server administration.

Java API example

import chrono_api.api.ChronoTime;
import net.minecraft.server.level.ServerPlayer;

public void useChronoApi(ServerPlayer player) {
    ChronoTime.setTickrate(8.0F, player);
    ChronoTime.pause(true, player);

    // Later, release this player's field.
    ChronoTime.clear(player);
}

public boolean rewind(ServerPlayer player) {
    return ChronoTime.rewind(
            player.serverLevel(),
            player.position(),
            5.0D,
            player
    );
}

Commands

All commands require permission level 2.

• /chrono settickrate <value> — Set the current time rate.
• /chrono pausetime <true|false> — Pause or resume time.
• /chrono rewindTime <seconds> — Rewind available local history.
• /chrono whitelist add <targets> — Add entity exemptions.
• /chrono whitelist remove <targets> — Remove entity exemptions.
• /chrono whitelist clear — Clear exemptions.
• /chrono whitelist list — Show the whitelist size.

Requirements

• Minecraft 1.20.1
• Minecraft Forge 47 or newer in the 1.20.1 line
• Java 17