Dawn API Wiki

Dawn API is the core technical foundation for all mods developed by DawnTeamMC. While primarily serving as a library that facilitates the creation of complex features for other mods, it also functions as a standalone utility for map makers and modpack developers. It includes a suite of builder classes, data-fixing tools, and specialized entities that extend the base capabilities of Minecraft.

By centralizing common code, Dawn API ensures compatibility and performance across the entire DawnTeamMC suite, including popular mods like Promenade, Culinaire, and Artisanat. It is built specifically for the Fabric and Quilt loaders and integrates seamlessly with configuration APIs like Cloth Config.

Dawn API introduces two highly customizable entities that are used by other mods to create unique environmental effects and mechanics. These entities can also be summoned manually via commands for map-making purposes.

Custom TNT (dawn:custom_tnt)

The Custom TNT entity is a powerful extension of the vanilla TNT. Unlike standard TNT, it can be configured to mimic the appearance of any block and have its explosion properties modified via NBT data.

Flying Block (dawn:flying_block)

This entity is the inverse of the vanilla Falling Block. Instead of dropping due to gravity, the Flying Block moves upward. It is frequently used in the DawnTeamMC ecosystem for magical effects, rising debris, or specialized structures.

• Customization: Supports any block state.
• Behavior: Can be set to turn back into a solid block upon hitting a ceiling or reaching a certain height.
• NBT Parameters: Includes tags for BlockState, Time, DropItem, and HurtEntities.

Dawn API adds several powerful commands designed for debugging, map creation, and entity manipulation. These commands provide more granular control than standard vanilla options.

Entity Management

• /health: Allows precise control over an entity's health points.
  • add: Increases the target's health.
  • set: Sets health to a specific value.
  • query: Returns the current health of the entity.
• /foodbar: Manages hunger and saturation for players and supported entities.
  • add (food|saturation): Adds points to the respective bar.
  • set (food|saturation): Sets hunger or saturation levels.
  • query (food|saturation): Checks current levels.
• /motion: Directly modifies the velocity of an entity.
  • add: Adds momentum in a specific direction.
  • set: Overwrites the current motion vector.

Utility & Data

• /export: A developer-focused command that exports game content information or internal files to the game directory.
• /shape: Enables the creation of custom geometric shapes within the world, with full support for data packs to define complex structures.

Beyond visible features, Dawn API provides several backend mechanics that improve the modding experience and game stability:

• DawnFactory: A centralized registry system that simplifies the addition of new blocks, items, and entities.
• Variant Creators: Specialized tools for creating new mob variants, including CatVariantCreator and FrogVariantCreator, which allow for easy expansion of animal types.
• Banner Pattern Registry: A streamlined system for adding custom banner patterns to the game.
• Data Fixing: Includes robust tools for migrating data between mod versions, preventing world corruption when mods are updated.
• Compatibility Layers: Built-in hooks for Cloth Config (for in-game settings), Mod Menu (for mod listing), and AppleSkin (for enhanced food tooltips).

Dawn API is the mandatory dependency for the following mods. Without Dawn API, these mods will not function:

Dawn API uses a centralized configuration system. While it does not add a complex GUI of its own, it enables the configuration screens for all DawnTeamMC mods when Cloth Config API is installed. Users can typically find these settings in the config folder of their Minecraft instance, usually under dawn-api.json or within the specific sub-mod's config file.