
Temporal API
Temporal API is a specialized library mod and API that by itself does not add any functionality for regular players. Its main purpose is to provide developers with a powerful toolkit for creating addons compatible with the New TARDIS modification.
Core Features
Configuration Settings
The system includes two key parameters:
- TARDIS Base Speed - determines the standard movement speed of the time portal in number of blocks per second
- Hotbar Manual Search - a client-side setting that, when activated, allows searching for manuals across the entire quick access slot set instead of limiting to the active hand only
Item Tags
The API introduces two categories of tags for custom items:
- Sonic - allows assigning custom items for installation in the sonic port. To add functionality, the SonicPutEvent must be used. Native support includes: Data Drive from Temporal Additions and Fourteenth's Sonic Screwdriver from ASEOHA
- Manual - defines which items can be used to display control button names. Native support is provided for Temporal Additions and ASEOHA
Advancement Triggers
The system includes three automatic triggers for tracking achievements:
- Takeoff (tardis:tardis_takeoff) - activates when the TARDIS takes off, passes the 'dimension' parameter indicating the original dimension
- Landing (tardis:tardis_landed) - triggers upon landing, passes 'dimension' (landing location) and 'crashed' (emergency landing flag)
- Flight Event (tardis:succeed_flight_event) - records flight events with 'flight_event' (event identifier) and 'success' (execution result) parameters
Forge Event System
ComponentEvent
ComponentChanged - activates when the player changes an item in the engine slot
ControlEvent
ControlHitEvent - occurs when using or pressing buttons on the TARDIS console (cancellation possible)
SonicPutEvent - when placing an item in the sonic port (cancellation possible) Sound device insertion event
SonicTakeEvent - when removing an item from the sonic port (prevention of removal possible)
FlightEventEvent
StartFlightEvent - triggers when a random flight event is applied to the TARDIS (cancellation possible)
SuccessFlightEvent - when a flight event is successfully completed
FailFlightEvent - when a flight event fails execution
Other Events
- MinigameStartEvent - before launching the wires minigame when placing an item in the engine slot (cancellation possible)
TardisEvent
TakeoffEvent - immediately before takeoff code execution (cancellation possible)
LandEvent - immediately before landing code execution (cancellation possible)
SpeedCalculationEvent - after calculating TARDIS flight speed (cannot be canceled)
FuelUseCalculationEvent - after calculating fuel consumption (cannot be canceled)
EngineFillEvent - before the TARDIS receives random leaky capacitors (cancellation possible)