Back to mods
AngelLib project artwork

Modrinth · Minecraft mod

AngelLib

A shared code library and tweak/fix mod from Angelic Industries.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which AngelLib release should I use?

Updated today
Latest stable file 1.0.1
Game version 1.7.10
Loader Forge

AngelLib 1.0.1 targets 1.7.10 with Forge. Installation on the client is optional. Installation on the dedicated server is optional. All 1 required mods have matching files.

Where it goes

Is AngelLib required on the client, server, or both?

Installation on the client is optional. Installation on the dedicated server is optional.

Client Optional
Dedicated server Optional
Loader for this release Forge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source marks this as usable on both the client and server.

What else does AngelLib 1.0.1 need?

1.0.1. Change the file and its required mods may change too.

All 1 required mods have matching files

Install UniMixins first. We found matching files for this game-version and loader setup.

UniMixins Needed by AngelLib 1.0.1
required
Matching file found Matched file: 1.7.10-0.3.1

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add AngelLib without breaking your instance.

Built for AngelLib 1.0.1. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 1.0.1. It targets 1.7.10 with Forge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install UniMixins first. We found matching files for this game-version and loader setup.

  3. 03

    Put it on the correct side

    Installation on the client is optional. Installation on the dedicated server is optional.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 1.0.1. It opens that exact file at the source.

About this project

What does AngelLib add?

AngelLib

AngelLib 1.0.0 replaces FentLib. This is a breaking release: update dependent mods together; old packages, mod IDs, network payloads, and configuration paths are not supported.
A shared code library and tweak/fix mod.

logo

hub
curse
modrinth
mcmodcn
67
maven
forge
cord

Features

  • Support for animated GIF server icons. Just drop a server-icon.gif file in the server root directory. Size limits are configurable. HodgePodge is a soft dependency, required if you want to use larger GIFs (because of the packet size limit).
    animated_server_icons
    Use the /reload_icon command to reload the icon. Also works for server-icon.png.
  • API to modify the S00PacketServerInfo packet. Example:
public class ClientProxy extends CommonProxy {
    @Override
    public void preInit(FMLPreInitializationEvent event) {
      S00PacketServerInfoModifyService.registerDeserializeHandler((response, angellibData, serverData) -> {
        if (angellibData.has("server_to_client_payload")) {
          // Yoohoo we got something back!!!!
          // serverData contains stuff like server IP
        }
      });
    }
}

public class CommonProxy {
  public void preInit(FMLPreInitializationEvent event) {
    if (MiscUtil.isServer()) {
      S00PacketServerInfoModifyService.registerHandler((response, angelLibPresent) -> {
        // angelLibPresent is just a boolean indicating whether angellib is loaded
        return "server_to_client_payload";
        // You can return a String, a S00PacketServerInfoModifyService.KeyValue, or a JsonElement. If you return
        // a non-null value, it will be passed back to the client
      });
    }
  }
}
  • /dump_thaumonomicon <Optional Comment> command. Run it from the client, and all Thaumcraft research will be dumped as a static website. The comment will be visible under the page title, and you can indicate the pack or mods for with which the dump was done.
    Dump example
  • /warpdim [dimension ID] command. Painlessly warp to a dimension (meant for debugging).
  • SessionAccessTokenOverrideMixin allows overriding the session access token in dev launches via -Dangellib.accessTokenOverride=<token>.
  • Client sound utilities to set a custom max attenuation distance without increasing the sound volume. Methods:
SoundUtil.withMaxDistance(ISound sound, float maxDistance);
SoundUtil.playWithMaxDistance(ISound sound, float maxDistance);
SoundUtil.playWithMaxDistance(SoundHandler soundHandler, ISound sound, float maxDistance);
SoundUtil.playAt(ResourceLocation soundResource, double x, double y, double z, float volume, float pitch, float maxDistance);

Example:

SoundUtil.playAt(waveSound, x, y, z, 0.25F, 1.0F, 64.0F);
  • HTTP-on-Minecraft-port reverse proxying for local web UIs. Configure path-to-port mappings in config/angellib/http-port-routes.json so services like Dynmap can be reached through the server port, such as /dynmap/..., instead of separate ports.
    Set publicBaseUrl in config/angellib/angellib.cfg to the public base URL of the server; mods should append their own relative route paths on top of it.
  • QOI image format support and utils thanks to saharNooby/qoi-java. For usage example, check out how support for server-icon.qoi is implemented.
  • WebP image format support and utils thanks to haraldk/TwelveMonkeys. For usage example, check out how support for server-icon.webp is implemented.
  • Default server icon path can be configured using the serverIconDirectory config option.

Fishing Loot Config

Set enableFishingLootTable=true in config/angellib/angellib.cfg to enable AngelLib's fishing override. The loot table lives at config/angellib/fishing-loot.json. When enabled, vanilla still decides whether a catch is fish, junk, or treasure, but the item itself comes only from this JSON.

The JSON has top-level fish, junk, and treasure lists. Each entry uses vanilla-style weight, supports count and meta ranges, can be limited to a biome whitelist with biomes or inverted into a blacklist with invertBiomes, and biome selectors can be numeric IDs, biome names, or * to match any biome. Entries can also use explicit numeric enchant IDs or useVanillaEnchantingRules for vanilla-style random enchanting.

{
  "fish": [
    {
      "item": "minecraft:fish",
      "weight": 60,
      "count": { "min": 1, "max": 1 },
      "meta": { "min": 0, "max": 0 }
    },
    {
      "item": "minecraft:fish",
      "weight": 10,
      "count": { "min": 1, "max": 2 },
      "meta": { "min": 1, "max": 1 },
      "biomes": ["ocean", "river"]
    }
  ]
}

Patches

Dependencies

Building

./gradlew build.

Credits

License

LGPLv3.

Buy me a coffee

  • ko-fi.com
  • Monero: 893tQ56jWt7czBsqAGPq8J5BDnYVCg2tvKpvwTcMY1LS79iDabopdxoUzNLEZtRTH4ewAcKLJ4DM4V41fvrJGHgeKArxwmJ

license

Project description from Modrinth.

Pick your setup

AngelLib by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

1 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

AngelLib versions and loaders

13 of 13 releases match

Looking for an older file? The official Modrinth project page is in Resources.