ВЕРСИИ (113)

## Ornithe Standard Libraries 0.23.0 OSL 0.23.0 supports Minecraft versions between Alpha 1.0.1_01 and Release 1.14.4. ## Core 0.12.0 ### Namespaced Identifiers New functionality has been added to namespaced identifiers, and a change has been made to equality checks. ```java NamespacedIdentifier { // Returns the char used as the separator in the String-representation of the namespaced identifier. // This separator is also used to check equality of namespaced identifiers. char separator(); // Returns a copy of this namespaced identifier with the given namespace. NamespacedIdentifier namespaced(String namespace); // Returns a copy of this namespaced identifier where the identifier is a substring of this identifier. NamespacedIdentifier subidentifier(int beginIndex); // Returns a copy of this namespaced identifier where the identifier is a substring of this identifier. NamespacedIdentifier subidentifier(int beginIndex, int endIndex); } ``` New functionality has also been added to the `NamespacedIdentifiers` utility class, in the form of various `isValid` methods that return a `boolean` result. These complement the various `validate` methods that throw an exception on invalid input. ```java NamespacedIdentifiers { // Returns whether the given namespaced identifier conforms to spec (only chars a-z0-9-._/ allowed). static boolean isValid(NamespacedIdentifier identifier); // Returns whether the given String is a valid namespace. static boolean isValidNamespace(String namespace); // Returns whether the given String is a valid identifier. static boolean isValidIdentifier(String identifier); // Returns whether the given char is allowed in the String representation of a namespaced identifier. static boolean isCharAllowed(char chr); } ``` A change has been made to the `NamespacedIdentifiers#equals(NamespacedIdentifier, NamespacedIdentifier)` method. It now also checks equality of the `NamespacedIdentifier#separator()` result in addition to equality of the `NamespacedIdentifier#namespace()` and `NamespacedIdentifier#identifier` results. ### Topological Sorting Added `TopoSort` utility class, which can perform as topological sort on a list of nodes, given all the incoming edges for each node. ## Executors 0.1.1 Added `ReentrantDirectExecutor`, an `Executor` that handles reentrance with a queue. This is internal API for the Resource Loader API. ## Block States 0.2.0 ### Block Entity Extension - Fixed several server-side Mixin issues that caused crashes in dedicated server environments in 12w42a and below. - To aid in fixing above issue, some methods were added to `BlockEntity` on the server side in 12w42a and below. ```java BlockEntity { // Returns the block at this block entity's position in the world. Block getBlock(); // Returns the metadata of the block at this block entity's position in the world. int getBlockMetadata(); } ``` ## Entities 0.1.2 Fixed a `NoSuchMethodError` in 1.9-1.10 when registering a spawn egg through `EntityTypeRegistry#registerSpawnEgg(EntityType, int, int)`. ## Networking 0.11.0 & 0.12.0 ### Channel Identifiers Serialization of channel identifiers has been changed to be more consistent and versatile. Previously, the way channels identifiers were converted to and from `String`s was different in 1.13-pre2 and below vs 1.13-pre4 and above. In 1.13-pre4 and above, Vanilla uses `Identifier`s for custom payload channels, and OSL does as well. As such, there is no special handling for `String` conversions, and the standard colon-separated format is used: `<namespace>:<identifier>`. ```java ChannelIdentifiers.from("example", "cookie"); // String representation -> "example:cookie" ``` In 1.13-pre2 and below, Vanilla uses `String`s for custom payload channels, with no validation exception for limiting the length to 20 (or 16 in older versions). However, by convention, a sort of namespaced identifier is used with a vertical bar separator (`|`). All channel identifiers made through OSL were serialized to this legacy format. ```java ChannelIdentifiers.from("EXAMPLE", "Cookie"); // String representation -> "EXAMPLE|Cookie" ``` #### Changes - Channel identifiers created through `ChannelIdentifiers.from()` now ALWAYS serialize to the standard colon-separated format. - New factory `ChannelIdentifiers.legacy()` methods have been added that create channel identifiers that ALWAYS serialize to the legacy vertical-bar-separated format. - `StringChannelIdentifierParser` can now parse both kinds of identifiers from `String`s. ```java ChannelIdentifiers.from("example", "cookie"); // String representation -> "example:cookie" ChannelIdentifiers.legacy("example", "cookie"); // String representation -> "example|cookie" ``` New `register` methods have been added as well as a short-hand for channel construction and registration. ```java ChannelIdentifiers.register("example", "cookie"); // the line above is equivalent to the line below ChannelRegistry.register(ChannelIdentifiers.from("example", "cookie")); ``` ### Packet Buffers New (de)serialization methods have been added to `PacketBuffer`. ```java PacketBuffer { // Reads a collection from this PacketBuffer. // The constructor takes in the size of the collection as an int. // The reader reads individual elements from this PacketBuffer. <T, C extends Collection<T>> C readCollection(IntFunction<C> constructor, Function<PacketBuffer, T> reader); // Similar to readCollection, but pre-configured to return a List <T> List<T> readCollection(Function<PacketBuffer, T> reader); // Writes the given collection to this PacketBuffer. // The writer takes in this PacketBuffer and an element and writes that element to the buffer. <T> ByteBuf writeCollection(Collection<T> collection, BiConsumer<PacketBuffer, T> writer); // Reads an OSL TextComponent from this PacketBuffer. // The TextComponent is parsed from stringified JSON. TextComponent readTextComponent(); // Writes the given OSL TextComponent to this PacketBuffer. // The text component is written as stringified JSON. ByteBuf writeTextComponent(TextComponent text); } ``` ### Client Connection Events A new method has been added to client connection context objects. ```java ConnectionContext { // still exists but deprecated and may be removed in the future @Deprecated default boolean isServerLocal() { return !this.isMultiplayer(); } // Returns whether connected to a multiplayer game or a singleplayer game. boolean isMultiplayer(); } ``` ## Registries 0.3.0 & 0.3.1 ### Networking The Registry Sync packet now used ID `osl:registries` in all versions (was previously `osl|registries` in 1.13-pre2 and below). ### Fixes Fixed several Mixin issues in dedicated server environments in 12w17a and below, which lead to crashes. ## Resource Loader 0.9.0 ### Fixes - Improved behavior on game start-up. Previously resource reloads would run twice in certain versions below 1.6. - Fixed profiling giving incorrect data on reload times for individual reloaders in 1.13 and below. - Fixed vanilla reload listeners not being profiled during game start-up. - Fixed `NoSuchMethodError` when opening the resource packs screen in 13w26a-1.7.10 when mod-provided virtual resource packs were present. ### Triggering Resource Reloads. A `reloadResources()` method has been added to `Minecraft` with the same purpose and function as the existing Vanilla method in 1.6 and above: it refreshes the pack repository, triggers a full resource reload, and updates the world renderer if necessary. ### Texture Packs In Early Alpha - Support for loading texture packs from the `.minecraft/texturepacks/` folder has been added to early Alpha versions (a1.2.1_01 and below). - No texture packs screen has been added, but a texture pack is selected from the `skin` option in `options.txt` just like in a1.2.2-1.5.2. - Support for loading folder texture packs has been added to 12w07a and below. - Fixed issues with folder texture packs in 12w08a-1.2.5, where the pack description and icon would not load in the texture packs screen. ### Resource Reloader Dependencies A dependency system for resource reloaders has been implemented that allows modders to control the order in which their reloaders are run. The old API still exists but is deprecated and may be removed in the future. New API has been added to `ReloadableResourceManager`. ```java ReloadableResourceManager { // still exists, but is now deprecated // all reloaders added through this method will be run last void addReloader(ResourceReloader reloader); // registers the given reloader to the given identifier void registerReloader(NamespacedIdentifier identifier, ResourceReloader reloader); // declares a dependency on the reloaders with given identifiers // this will ensure the given reloader will run *after* all its dependencies void registerReloaderDependencies(NamespacedIdentifier identifier, NamespacedIdentifier... dependencies); } ``` All Vanilla reload listeners are registered as identifiable reloaders to ensure correct ordering between them, and to allow modders to insert their own reloaders anywhere in between. The identifiers used are public API in the `AssetsReloaders` and `DataReloaders` classes. These classes also list `before_vanilla` and `after_vanilla` markers that can be used to ensure your reloaders run before or after all Vanilla reload listeners. ```java resourceManager.registerReloader(EarlyReloader.IDENTIFIER, new EarlyReloader()); resourceManager.registerReloader(LateReloader.IDENTIFIER, new LateRelloader()); // BEFORE_VANILLA marker runs before all Vanilla reload listeners // register a dependency from it on your own reloader to ensure your own reloader runs first resourceManager.registerReloaderDependencies(AssetsReloaders.BEFORE_VANILLA, EarlyReloader.IDENTIFIER); // AFTER_VANILLA marker runs after all Vanilla reload listeners // register a dependency from your own reloader on it to ensure your own reloader runs last resourceManager.registerReloaderDependencies(LateReloader.IDENTIFIER, AssetsReloaders.AFTER_VANILLA); ``` ## Localization 0.2.0 The language reloader in 11w48a-1.5.2 is now registered to `minecraft:languages`. ## Text Components 0.1.0 This API is now finally out of Alpha. ### 0.1 Alpha 7 `TextComponents#resolve(Object)` can now correctly resolve Vanilla `Text` components in 13w21a-1.6.4. ### 0.1 Alpha 8 - Added `TextComponents.convert(TextComponent, Class<T>)` that converts the given text component to the given type. Converters for `String` and Vanilla `Text` components have been added. - `String` conversion is identical to calling `TextComponent#buildFormattedString()`. - Added `MessageConsumer` interface with `sendMessage(TextComponent)` method and implemented it in Vanilla's `CommandSource`. - For now, the implementation will simply forward calls to Vanilla's `sendMessage(String)` (1.5-) or `sendMessage(Text)` (1.6+) methods, converting the `TextComponent` to a `String` or Vanilla `Text` component respectively. In the future this may be changed to support features that OSL `TextComponent`s have that formatted `String`s or Vanilla `Text` components do not.

# Ornithe Standard Libraries 0.22.2 OSL 0.22.2 supports Minecraft versions between Alpha 1.0.1_01 and Release 1.14.4. ## Block States 0.1.1 Fixed module for 15w47a-1.9.3-pre1 not loading, which prevented the Blocks and Items APIs to load for these versions as well. ## Localization 0.1.3 Fixed server-side translations in 1.1-1.5. ## Items 0.3.1 Fixed `ClassNotFoundException` in b1.9-pre3.

# Ornithe Standard Libraries 0.22.1 OSL 0.22.1 supports Minecraft versions between Alpha 1.0.1_01 and Release 1.14.4. ## Changes OSL now bundles [Conditional Mixin](https://github.com/OrnitheMC/conditional-mixin/) 1.0.0. ## Entities 0.1.1 Fixes a crash in Alpha 1.1.x. - note: to fix the crash, a Vanilla multiplayer bug was fixed where all sheep and cows appear as chickens on the client.

# Ornithe Standard Libraries 0.22.0 OSL 0.22.0 supports Minecraft versions between Alpha 1.0.1_01 and Release 1.14.4. ## Core 0.11.0 ### Direction and BlockPos The Core API now provides its own `Direction` enum and `BlockPos` class. These provide the same functionality as the equivalent Vanilla classes in 1.8 and above, but are available for all supported Minecraft versions. They are utilized by the new Block States API in 1.7 and below. ## Registries 0.2.0 ### Registry Keys Expanded the `RegistryKeys` class with registry keys for biome, block entity, and entity registries. ### Legacy String IDs Namespaced IDs were introduced in 1.7 for blocks and items, and were slowly adopted for other registries in subsequent updates. Namespaced IDs are all lowercase and use snake\_case. Legacy `String` IDs were not namespaced and were usually PascalCase instead. These legacy IDs cannot be used as namespaced IDs without some form of conversion. The `LegacyStringIds` class provides methods to convert between namespaced IDs and the legacy format `String` IDs. For legacy ID -> namespaced ID conversion, this means: - Converting strings from PascalCase to snake\_case. Consecutive uppercase letters are assumed to be an abbreviation and stick together: `TNTMinecart` -> `tnt_minecart`. - A `.`-separated prefix is assumed to be a namespace: `example.Cookie` -> `example:cookie`. If the ID has no such prefix, the `minecraft` namespace is assumed. For namespaced ID -> legacy ID conversion, this means: - Converting strings from snake\_case to PascalCase: `minecart_tnt` -> `MinecartTnt`. - Namespaces are prefixed to the ID, separated by a `.`-character: `example:cookie` -> `example.Cookie`. For IDs with the `minecraft` namespace no prefix is attached. ### Registry Sync - Added new built-in ID-mapper: `DynamicInt2ObjectMapMapper`, for maps whose contents may change throughout a world session. - When remapping registries, old numerical ID values will be re-used when possible, preventing unnecessary increase of numerical ID values. - Improved logging of errors during remapping. ## Block States 0.1.0 The Block States API implements block states in 1.7.10 and below, and extends functionality in 1.8 and above. ### Block States in 1.7.10- - Many methods in `Block` that take in `int` parameters for block data values, directions and coordinates, are deprecated in favor of equivalent methods that take in `BlockState`, `Direction`, and `BlockPos` parameters. - The `WorldView`, `WorldChunk`, and `WorldChunkSection` classes have been extended with `BlockState` getters and setters. - A `StatefulBlock` implementation is provided that forwards calls to the deprecated methods to the equivalent methods that use block states. - The chunk format is not modified whatsoever. The block state getters and setters convert block states to/from block IDs and block data values and call the existing block ID and block data value getters and setters. example usage: ```java package com.example; import net.minecraft.block.Block; import net.minecraft.block.material.Material; import net.minecraft.world.World; import net.ornithemc.osl.blockstates.api.block.StatefulBlock; import net.ornithemc.osl.blockstates.api.state.BlockState; import net.ornithemc.osl.blockstates.api.state.StateDefinition; import net.ornithemc.osl.blockstates.api.state.property.BooleanProperty; import net.ornithemc.osl.blockstates.api.state.property.IntegerProperty; import net.ornithemc.osl.core.api.util.math.BlockPos; public class CookieBlock extends StatefulBlock { public static final IntegerProperty BITES_TAKEN = IntegerProperty.of("bites_taken", 0, 7); public static final BooleanProperty BAKED = BooleanProperty.of("baked"); public CookieBlock() { super(Material.COOKIE); } @Override public void buildStateDefinition(StateDefinition.Builder<Block, BlockState> builder) { builder.add(BITES_TAKEN, BAKED); } @Override public BlockState getStateFromMetadata(int metadata) { int bitesTaken = metadata & 0x7 boolean baked = (metadata & 0x8) != 0; return this.defaultState() .set(BITES_TAKEN, bitesTaken) .set(BAKED, baked); } @Override public int getMetadataFromState(BlockState state) { int bitesTaken = state.get(BITES_TAKEN); int baked = state.get(BAKED) ? 0x8 : 0; return baked | bitesTaken; } @Override public void onAdded(World world, BlockPos pos, BlockState state) { ... } @Override public void onRemoved(World world, BlockPos pos, BlockState state) { ... } } ``` ### Block States in 1.8+ - In 1.8, many methods are added that forward calls to equivalent methods in `Block` (Vanilla did not do this until 1.9) - In 1.12 and below, several methods are added that do exist in 1.13+, like `isAir`, `ticksRandomly`, `canBePlaced`, `onAdded`, `onRemoved`, and more. ## Blocks 0.3.0 Moved `Block` functionality extensions into the Block States API. ## Items 0.3.0 ### Fixes - Fixes item model cache resetting when leaving a world or server, leading to corrupted GUI item textures when joining another world or server. ## Block Entities 0.1.0 Basic APIs for registering block entity types. ```java package com.example; import net.ornithemc.osl.blockentities.api.BlockEntityEvents; import net.ornithemc.osl.entrypoints.api.ModInitializer; public class ExampleInitializer implements ModInitializer { @Override public void init() { BlockEntityEvents.REGISTER_BLOCK_ENTITY_TYPES.register(ExampleBlockEntityTypes::init); } } ``` ```java package com.example; import net.minecraft.block.entity.BlockEntityType; import net.ornithemc.osl.blockentities.api.BlockEntityTypeRegistry; import net.ornithemc.osl.blockentities.api.BlockEntityTypes; import net.ornithemc.osl.core.util.NamespacedIdentifiers; public final class ExampleBlockEntityTypes { public static final BlockEntityType<CookieBlockEntity> COOKIE = BlockEntityTypeRegistry.register(NamespacedIdentifiers.from("example", "cookie"), BlockEntityTypes.builder(CookieBlockEntity::new, ExampleBlocks.COOKIE)); public static void init() { } } ``` ## Block Entities Rendering 0.1.0 Basic APIs for registering block entity renderers. ```java package com.example; import net.ornithemc.osl.blockentities.api.client.BlockEntityRenderingEvents; import net.ornithemc.osl.entrypoints.api.client.ClientModInitializer; public class ExampleInitializer implements ClientModInitializer { @Override public void initClient() { BlockEntityRenderingEvents.REGISTER_BLOCK_ENTITY_RENDERERS.register(registry -> { registry.register(CookieBlockEntity.class, CookieBlockRenderer::new); }); } } ``` ## Entities 0.1.0 Basic APIs for registering entity types. ```java package com.example; import net.ornithemc.osl.entities.api.EntityEvents; import net.ornithemc.osl.entrypoints.api.ModInitializer; public class ExampleInitializer implements ModInitializer { @Override public void init() { EntityEvents.REGISTER_ENTITY_TYPES.register(ExampleEntityTypes::init); } } ``` ```java package com.example; import net.minecraft.entity.EntityType; import net.minecraft.entity.living.MobCategory; import net.ornithemc.osl.entities.api.EntityTypeRegistry; import net.ornithemc.osl.entities.api.EntityTypes; import net.ornithemc.osl.core.util.NamespacedIdentifiers; public final class ExampleEntityTypes { public static final EntityType<CookieMonsterEntity> COOKIE_MONSTER = EntityTypeRegistry.register(NamespacedIdentifiers.from("example", "cookie_monster"), EntityTypes.builder(CookieMonsterEntity::new, MobCategory.MISC)); public static void init() { } } ``` ## Entities Rendering 0.1.0 Basic APIs for registering entity renderers. ```java package com.example; import net.ornithemc.osl.entities.api.client.EntityRenderingEvents; import net.ornithemc.osl.entrypoints.api.client.ClientModInitializer; public class ExampleInitializer implements ClientModInitializer { @Override public void initClient() { EntityRenderingEvents.REGISTER_ENTITY_RENDERERS.register(registry -> { registry.register(CookieMonsterEntity.class, CookieMonsterRenderer::new); }); } } ``` ## Biomes 0.1.0 Basic API for registering biomes. ```java package com.example; import net.ornithemc.osl.biomes.api.BiomeEvents; import net.ornithemc.osl.entrypoints.api.ModInitializer; public class ExampleInitializer implements ModInitializer { @Override public void init() { BiomeEvents.REGISTER_BIOMES.register(ExampleBiomes::init); } } ``` ```java package com.example; import net.minecraft.world.biome.Biome; import net.ornithemc.osl.biomes.api.BiomeRegistry; import net.ornithemc.osl.core.util.NamespacedIdentifiers; public final class ExampleBiomes { public static final CookieBiome COOKIE = BiomeRegistry.register(NamespacedIdentifiers.from("example", "cookie"), new CookieBiome(new Biome.Settings().setName("Cookie"))); public static void init() { } } ``` ## Localization 0.1.2 - Fixes `L10n.get` throwing error if no translation exists.

## Ornithe Standard Libraries 0.21.1 OSL 0.21.1 supports Minecraft versions between Alpha 1.0.1_01 and Release 1.14.4. ## Networking 0.10.1 ### Fixes - Fixed memory leaks. - Fixed crash when disconnected from the server before login. ## Resource Loader 0.8.1 ### Fixes - Improve logging of errors when reading `pack.mcmeta`. - Fixes NPEs and crashes when resource pack summary cannot be parsed. ## Text Components 0.1 Alpha 6 The JSON format of OSL text components now supports hex color notation using a `#` prefix.

# Ornithe Standard Libraries 0.21.0 OSL 0.21.0 supports Minecraft versions between Alpha 1.0.1_01 and Release 1.14.4. ## Core 0.10.0 All of the Core API's registry classes (`SimpleIdRegistry`, `DefaultedIdRegistry`, `IdBiMap`) have been deprecated in favor of the new Registries API introduced in this update. They will be removed in a future update. ### Namespaced Identifiers Namespaced identifiers created through `NamespacedIdentifiers` factory methods no longer allow uppercase letters ([A-Z]). ```java NamespacedIdentifiers.from("example", "Thing"); // this will now throw an error NamespacedIdentifiers.from("example", "thing"); // this is still valid ``` New `prefixed` and `suffixed` methods have been added to create derivative namespaced identifiers with a prefix or suffix. ```java NamespacedIdentifier id = NamespacedIdentifiers.parse("example:cookie"); NamespacedIdentifier prefixed = id.prefixed("blocks/"); // -> "example:blocks/cookie" NamespacedIdentifier suffixed = id.suffixed(".json"); // -> "example:cookie.json" ``` ## Registries 0.1.0 The Registries API provides an alternative to Vanilla's registry system, with a more modern feature set and available for all Minecraft versions. Not all of Vanilla's registries are registered in the new registry system (only the block and item registries are at this time), but this will change over time as OSL's feature set expands. This update also provides a Registry Sync API for synchronizing numerical IDs between the server and client and across game sessions, to help avoid network desync and world corruption bugs. I want to give a shoutout to [Cat Core](https://github.com/thecatcore/), who helped develop and test this API and the accompanying changes in the Blocks and Items APIs. ### Events The `BOOTSTRAP_REGISTRIES` event is fired on game start-up, during bootstrapping. All registries should be loaded before this or in a listener to this event. Bootstrapping registries (i.e. populating their contents) may happen before this, but will be forced right after this event anyway. ```java RegistryEvents.BOOTSTRAP_REGISTRIES.register(() -> { ... }); ``` ### Registries Registries should be created and registered in your mod's entrypoint: ```java public class ExampleInitializer implements ModInitializer { @Override public void init() { ExampleRegistries.init(); } } ``` ```java public final class ExampleRegistries { public static final ResourceKey<Registry<CookieRecipe>> COOKIE_RECIPE_REGISTRY = RegistryKeys.from(NamespacedIdentifiers.from("example", "cookie_recipe")); public static final Registry<CookieRecipe> COOKIE_RECIPE = Registries.registerDefaulted(COOKIE_RECIPE_RECIPES, NamespacedIdentifiers.from("example", "chocolate_chip"), CookieRecipes::init); public static void init() { } } ``` ```java public final class CookieRecipes { public static final CookieRecipe CHOCOLATE_CHIP = Registry.register(ExampleRegistries.COOKIE_RECIPE, NamespacedIdentifiers.from("example", "chocolate_chip"), new ChocolateChipCookieRecipe()); public static void init() { } } ``` ### Registry Sync Numerical IDs may be used for serialization in server-client communication or in world saves. If this is the case, you must register your registry to be synchronized. ```java public final class ExampleRegistries { public static final ResourceKey<Registry<CookieRecipe>> COOKIE_RECIPE_REGISTRY = RegistryKeys.from(NamespacedIdentifiers.from("example", "cookie_recipe")); public static final Registry<CookieRecipe> COOKIE_RECIPE = Registries.registerDefaulted(COOKIE_RECIPE_RECIPES, NamespacedIdentifiers.from("example", "chocolate_chip"), CookieRecipes::init); public static void init() { SyncedRegistries.register(COOKIE_RECIPE_REGISTRY); } } ``` It is not recommended that you use the numerical IDs for any other purposes. If it is unavoidable, however, you can register a custom `IdMapper` or `IdFixer` to ensure there are no network desync or corruption bugs. This API provides several `IdMapper` implementations you can use, such `BooleanArrayMapper`, `IntArrayMapper`, `ListMapper`, and `Int2ObjectMapMapper`. You can of course create a custom implementation as well. See below for some examples from OSL's Blocks and Items APIs. ```java // the `EndermanEntity.HOLDABLE_BLOCKS` array uses block IDs as indices to the array! SyncedRegistries.registerMapper(RegistryKeys.BLOCK, NamespacedIdentifiers.from("block/enderman_holdable"), BooleanArrayMapper.of(() -> EndermanEntity.HOLDABLE_BLOCKS, a -> EndermanEntity.HOLDABLE_BLOCKS = a)); ``` ```java // these maps in `ItemModelShaper` use item IDs as keys to the map! SyncedRegistries.registerMapper(RegistryKeys.ITEM, NamespacedIdentifiers.from("item_model_location"), ItemModelRegistryMapper.of(this.models)); SyncedRegistries.registerMapper(RegistryKeys.ITEM, NamespacedIdentifiers.from("item_model"), ItemModelRegistryMapper.of(this.modelCache)); ``` ## Blocks 0.2.0 Transitioned to the new Registries API and implemented Registry Sync. This comes with some API changes, the biggest of which is the deprecation of the `register(int, NamespacedIdentifier, Block)` method in 17w46a and below, in favor of `register(NamespacedIdentifier, Block)`, which automatically assigns a numerical ID to the block. ```diff --BlockRegistry.register(999, NamespacedIdentifiers.from("example", "cookie"), new CookieBlock()); ++BlockRegistry.register(NamespacedIdentifiers.from("example", "cookie"), new CookieBlock()); ``` In versions between 12w07a and 1.6.4 you can pass a special value into the `Block` constructor to trigger automatic ID assignment: ```java BlockRegistry.register(NamespacedIdentifiers.from("example", "cookie"), new CookieBlock(Block.AUTO_ASSIGN_ID)); ``` ## Items 0.2.0 Transitioned to the new Registries API and implemented Registry Sync. This comes with some API changes, the biggest of which is the deprecation of the `register(int, NamespacedIdentifier, Item)` method in 17w46a and below, in favor of `register(NamespacedIdentifier, Item)`, which automatically assigns a numerical ID to the item. ```diff --ItemRegistry.register(999, NamespacedIdentifiers.from("example", "cookie"), new CookieItem()); ++ItemRegistry.register(NamespacedIdentifiers.from("example", "cookie"), new CookieItem()); ``` In versions between 1.6.4 and below you can pass a special value into the `Item` constructor to trigger automatic ID assignment: ```java ItemRegistry.register(NamespacedIdentifiers.from("example", "cookie"), new ItemBlock(Item.AUTO_ASSIGN_ID)); ``` ## Networking 0.10.0 ### Connection Events Connection events have been overhauled to fix some issues and add more features. For all connection events, listeners now receive a `context` object that holds information about the connection. The context objects give access to the following: ```java ClientConnectionContext { Minecraft minecraft(); // singleplayer connections only String worldName(); // multiplayer connections only String serverAddress(); int serverPort(); // whether the connection is singleplayer boolean isServerLocal(); // DISCONNECT events only TextComponent disconnectReason(); } ``` ```java ServerConnectionContext { MinecraftServer server(); ServerPlayerEntity player(); // DISCONNECT events only TextComponent disconnectReason(); } ``` Here are some example usages of the new API: ```java ClientConnectionEvents.LOGIN.register(context -> { Minecraft minecraft = context.minecraft(); if (context.isServerLocal()) { String worldName = context.worldName(); } else { String serverAddress = context.serverAddress(); int serverPort = context.serverPort(); } }); ``` ```java ServerConnectionEvents.DISCONNECT.register(context -> { TextComponent disconnectReason = context.disconnectReason(); }); ``` ### Fixes - Fixed `DISCONNECT` events not being fired on the side that initiated the disconnect (e.g. when leaving the server the event was not fired client-side, and when kicking a player the event was not fired server-side). - Fixed crash in 1.14 server environments. - Fixed crash in 12w18a-12w19a due to invalid `mixins.json`. ## Resource Loader 0.8.0 ### Resource Locations The `ResourceLocation` class now has a factory method for creating a `NamespacedIdentifier` representing a resource location, that always uses the proper validation for the runtime Minecraft version and supported resource pack format. The validation rules are: - Resource pack format 1 and 2 (1.10.2 and below): no uppercase letters ([A-Z]) in namespaces, no validation on paths. - Resource pack format 3 (16w32a-17w47a): no uppercase letters ([A-Z]) in namespaces nor in paths. - Resource pack format 4 (17w48a and above): only [-.\_a-z0-9] allowed in namespaces and only [-.\_/a-z0-9] allowed in paths. ```java NamespacedIdentifier resourceLocation = ResourceLocation.of("example", "path/to/resource"); // check if the resource location is valid for the runtime Minecraft version and resource pack format ResourceLocation.isValid(resourceLocation); ResourceLocation.isValidNamespace("example"); ResourceLocation.isValidPath("path/to/resource"); ``` ### Resource Packs The pack icon for resource packs added through custom repository sources now falls back to the default pack icon if none is provided. In prior OSL versions the pack icon would fall back to the missing texture instead, which did not match Vanilla behavior. ### Fixes - ([#76](https://github.com/OrnitheMC/ornithe-standard-libraries/pull/76)) Fixed errors thrown during `RESOURCE_RELOAD_END` events being silently caught instead of rethrown. - Fixed crashes due to improper resource location validation. - Fixed resource metadata sometimes not loading in 1.13 and above. - Fixed sound freeze issues due to a `ZipFileSystem` thread interrupt bug. - Fixed crash in 12w15a-12w17a due to an invalid mixin. ## Localization 0.1.1 - Fixes potential NPEs if localization is not set up. - Fixes formatting errors in some versions (like command feedback in 1.6) by replacing illegal/unsupported formatting codes. ## Text Components 0.1 Alpha 4 Vanilla `Text` components can now be converted to OSL `TextComponent`s through `TextComponents.resolve`. ```java TextComponent literalText = TextComponents.resolve(new LiteralText("This is text!")); TextComponent translatableText = TextComponents.resolve(new TranslatableText("this.is.text")); ``` ## Text Components 0.1 Alpha 5 Fixes a start-up crash in 1.6.4 and below due to a missing entrypoint.

# Ornithe Standard Libraries 0.20.3 OSL 0.20.3 supports Minecraft versions between Alpha 1.0.1_01 and Release 1.14.4. ## Resource Loader 0.7.4 - Fixed more texture pack issues.

# Ornithe Standard Libraries 0.20.2 OSL 0.20.2 supports Minecraft versions between Alpha 1.0.1_01 and Release 1.14.4. ## Resource Loader 0.7.3 - Fixed texture pack resetting to default on game start-up.

# Ornithe Standard Libraries 0.20.1 OSL 0.20.1 supports Minecraft versions between Alpha 1.0.1_01 and Release 1.14.4. ## Blocks 0.1.1 - Fixed being unable to place blocks in air in Minecraft 1.1 and below. ## Text Components 0.1 Alpha 3 Now supports Minecraft Alpha 1.0.1_01-1.0.17_04

# Ornithe Standard Libraries 0.20.0 OSL 0.20.0 supports Minecraft versions between Alpha 1.0.1_01 and Release 1.14.4. ## Core 0.9.0 Added new registry utilities for the Blocks and Items APIs. ## Blocks 0.1.0 The Blocks API provides events and utilities for registering blocks. ### Events - `REGISTER_BLOCKS`: this event is invoked right after Vanilla block registration is completed. Mods should register blocks in listeners to this event. ### Block Registry The `BlockRegistry` class provides public access to the block registry, including a helper method for registering blocks. ```java int getId(Block) NamespacedIdentifier getKey(Block) Block getBlock(int) Block getBlock(NamespacedIdentifier) Set<NamespacedIdentifier> keySet() // 17w46a- Block register(int, NamespacedIdentifier, Block) // 17w47a+ Block register(NamespacedIdentifier, Block) ``` ### Block Extension This API extends the `Block` class with some functionality from later Minecraft versions. - Added `boolean isAir()` method in 17w46a and below. - Added `boolean is(Block)` method in 1.6.4 and below. ### Usage ```java package com.example; import net.ornithemc.osl.blocks.api.BlockEvents; import net.ornithemc.osl.entrypoints.api.ModInitializer; public class ExampleInitializer implements ModInitializer { @Override public void init() { BlockEvents.REGISTER_BLOCKS.register(ExampleBlocks::init); } } ``` ```java package com.example; import net.minecraft.block.Block; import net.ornithemc.osl.blocks.api.BlockRegistry; import net.ornithemc.osl.core.util.NamespacedIdentifiers; public final class ExampleBlocks { public static final CookieBlock COOKIE = BlockRegistry.register(NamespacedIdentifiers.from("example", "cookie"), new CookieBlock()); public static void init() { } } ``` ## Items 0.1.0 The Items API provides events and utilities for registering items. ### Events - `REGISTER_ITEMS`: this event is invoked right after Vanilla item registration is completed. Mods should register items in listeners to this event. - `REGISTER_BLOCK_ITEMS` (for 1.6.4 and below only): this event is invoked right after Vanilla block item registration is completed. Mods should register block items in listeners to this event. ### Item Registry The `ItemRegistry` class provides public access to the item registry, including helper methods for registering items. ```java int getId(Item) NamespacedIdentifier getKey(Item) Item getItem(int) Item getItem(NamespacedIdentifier) Set<NamespacedIdentifier> keySet() Item register(Block) Item register(Block, Item) Item register(BlockItem) // 17w46a- Item register(int, NamespacedIdentifier, Item) // 17w47a+ Item register(NamespacedIdentifier, Item) ``` ### Usage ```java package com.example; import net.ornithemc.osl.entrypoints.api.ModInitializer; import net.ornithemc.osl.items.api.ItemEvents; public class ExampleInitializer implements ModInitializer { @Override public void init() { ItemEvents.REGISTER_ITEMS.register(ExampleItems::init); } } ``` ```java package com.example; import net.minecraft.item.Item; import net.ornithemc.osl.core.util.NamespacedIdentifiers; import net.ornithemc.osl.items.api.ItemRegistry; public final class ExampleItems { public static final CookieItem COOKIE = ItemRegistry.register(NamespacedIdentifiers.from("example", "cookie"), new CookieItem()); public static void init() { } } ``` ## Keybinds 0.3.0 Keybinds API V2 is a minor rewrite of the Keybinds API. The API V1 is still present, but deprecated. ### Events - `REGISTER_KEYBINDS`: this event is invoked upon game start-up, right after Vanilla keybinds have been initialized. Mods should register keybinds in listeners to this event. ### Keybind Registry The `KeybindRegistry` class provides public access to the keybind registry, including helper methods for registering keybinds. ```java Set<String> getCategories() register( String: name, int: defaultKeyCode, String: category ) // 17w43a+ register( String: name, InputConstants.Type: type, int: defaultKeyCode, String: category ) register(KeyBinding) ``` ### Usage ```java package com.example; import net.ornithemc.osl.entrypoints.api.client.ClientModInitializer; import net.ornithemc.osl.keybinds.api.KeybindEvents; public class ExampleInitializer implements ClientModInitializer { @Override public void initClient() { KeybindEvents.REGISTER_KEYBINDS.register(ExampleKeybinds::init); } } ``` ```java package com.example; import org.lwjgl.glfw.GLFW; import net.minecraft.client.options.KeyBinding; import net.ornithemc.osl.keybinds.api.KeybindRegistry; public final class ExampleKeybinds { public static final KeyBinding COOKIE = KeybindRegistry.register("cookie", GLFW.GLFW_KEY_Z, "example"); public static void init() { } } ```

# Ornithe Standard Libraries 0.19.3 OSL 0.19.3 supports Minecraft versions between Alpha 1.0.1_01 and Release 1.14.4. ## Resource Loader 0.7.2 Fixes direct path resource access from the default resource pack not working in 1.6-1.12.

# Ornithe Standard Libraries 0.19.2 OSL 0.19.2 supports Minecraft versions between Alpha 1.0.1_01 and Release 1.14.4. ## Config 0.6.2 Fixes a crash in b13-b1.7 when joining a multiplayer server, caused by the crash fix from 0.19.0.

# Ornithe Standard Libraries 0.19.1 OSL 0.19.1 supports Minecraft versions between Alpha 1.0.1_01 and Release 1.14.4. ## Resource Loader 0.7.1 Fixes a bug where only one mod resource pack would be used for a resource even if other mod resource packs provided that same resource as well.

# Ornithe Standard Libraries 0.19.0 OSL 0.19.0 supports Minecraft versions between Alpha 1.0.1_01 and Release 1.14.4. ## Core 0.8.0 - Added several internal utilities for other OSL APIs to use. - Added `IOSupplier`, a `Supplier` that throws `IOException`s. - Added `Unit`, a singleton object. ## Branding 0.4.3 Refactored some things to make use of new Core utilities. ## Config 0.6.1 Fixed `CLOSE_WORLD` event not firing if the world is closed due to a level save conflict. This would lead to crashes upon joining another world. ## Entrypoints 0.6.1 Suppressed a Mixin warning that would appear in logs. ## Lifecycle Events 0.6.1 Fixed server `STOP` event firing twice on dedicated servers. ## Localization 0.1.0 The Localization API split off from the Resource Loader API. It provides utilities for localizing text, and handles loading in mods' translation files. ### Localizing Text The `L10n` class provides utilities for localizing text. ```java // localizing a translation key String localizedText = L10n.get("example.translationKey"); // localizing a translation key with formatting arguments String localizedTextWithArgs = L10n.get("example.translationKey", "Some Arg", 1); // localizing a translation key with a default value in case no localization exists String localizedTextOrDefault = L10n.getOrDefault("example.translationKey", "Example Text"); // checking whether a localization for a translation key exists boolean localizedTextExists = L10n.has("example.translationKey"); ``` ### Providing Translations Translation files can be added to your mod's resources and will be loaded automatically. While Minecraft natively only supports `.lang` files in versions 18w01a and below, and only `.json` files in 18w02a and above, the Localization API ensures both `.lang` and `.json` files are supported in any Minecraft version. The Localization API also adds support for all-lowercase translation file names in 1.10.2 and below (e.g. `en_us.lang` instead of `en_US.lang`). ### Localization in Minecraft Alpha and Beta While Minecraft supports localization in Minecraft Beta, the only supported language is English (US). OSL's Localization API implements support for other languages, but none are provided by default and no GUI screen for switching languages is added. Minecraft Alpha does not natively support localization at all, but OSL's Localization API implements the necessities for mods to make use of. Do note that OSL will not modify any Vanilla Minecraft text to localize it. ## Resource Loader 0.7.0 This update to the Resource Loader API is a major rewrite. All internals and code APIs have changed, and mods that make use of them will most likely need to be updated. See the [pull request](https://github.com/OrnitheMC/ornithe-standard-libraries/pull/62) for a detailed overview of the changes and update paths for mods that depend on the Resource Loader API. ## Text Components 0.1 Alpha 2 - Added `TextComponents.builder()` method for constructing components with a builder pattern. - Added `visit` methods to `TextComponent` for reading components with a visitor pattern.

# Ornithe Standard Libraries 0.18.0 OSL 0.18.0 supports Minecraft versions between Alpha 1.0.1_01 and Release 1.14.4. ## Core 0.7.1 The Core API now provides a transitive injected interface for Vanilla's `Identifier` class implementing OSL's `NamespacedIdentifier`. ## Branding 0.4.2 Fixes the version string used in Alpha 1.2.1_01 and earlier. The format now matches that used in following versions. ## Entrypoints 0.6.0 The `init` entrypoint is now invoked *before* `client-init` and -server-init`. This change was made in order to match behavior from Fabric Loader's entrypoints. ## Lifecycle Events Now supports Beta 1.3. ## Executors 0.1.0 This new API provides access to the main game instances as `java.util.concurrent.Executor`s, and supplies a background executor for running tasks off the main game thread. The `Minecraft` and `MinecraftServer` classes are made to implement `Executor`. Any tasks submitted are guaranteed to run on the main game thread. If called from a different thread, the task will be queued to be run at the start of the next tick. Instances can be acquired using the Lifecycle Events API. ```java MinecraftInstance.get().execute( // this code is guaranteed to be run on the main client thread! ); ``` The background executor can be acquired through the `net.ornithemc.osl.executors.api.BackgroundExecutor` class. ```java BackgroundExecutor.get().execute( // this code is guaranteed to be run on a background thread! ); ``` ## Networking Implementation 0.1.1 Fixes a crash due to a Mixin injection failure in late 1.7 snapshots. ## Text Components 0.1 Alpha 1 This new API provides an alternative to Vanilla's chat component system. This is an Alpha release of this API and changes are very likely, so use with caution! Text components can be made using factory methods in the `net.ornithemc.osl.text.api.TextComponents` class. Text components can be converted into legacy formatted strings as well. ```java TextComponent text = TextComponents.literal("this is a text component") .format(Formatting.BOLD) .append(" - and this is another one!"); String string = text.buildFormattedString(); ```

# Ornithe Standard Libraries 0.17.2 OSL 0.17.2 supports Minecraft versions between Alpha 1.0.1_01 and Release 1.14.4. ## Resource Loader 0.6.1 - Fixes crashes when mod resources are accessed before the game is done initializing. - Fixes crashes in `findResources` if the search directory does not exist.

# Ornithe Standard Libraries 0.17.1 OSL 0.17.1 supports Minecraft versions between Alpha 1.0.1_01 and Release 1.14.4. ## Branding 0.4.1 Fixes crashes in the Snooper screen.

# Ornithe Standard Libraries 0.17.0 OSL 0.17.0 supports Minecraft versions between Alpha 1.0.1_01 and Release 1.14.4. ## OSL is now on Gen2! From this point forward, all OSL releases will be for Gen2. Information on how to install Gen2 instances can be found on the [Wiki](https://wiki.ornithemc.net/wiki/Installing_Ornithe). ## Core 0.7.0 ### Namespaced Identifiers This update brings namespaced identifiers, an OSL alternative for Vanilla's `Identifier`, available for all supported Minecraft versions. The base of this API is the `NamespacedIdentifier` interface. It defines the `namespace` and `identifier` components, which are equivalent to `Identifier`s `namespace` and `path` respectively. The valid chars for `namespace` components are `a-zA-Z0-9-_.`. The valid chars for `identifier` components are `a-zA-Z0-9-_./`. Factory methods for `NamespacedIdentifier`s can be found in the `NamespacedIdentifiers` class, along with validation methods. The `NamespacedIdentifiers.from` methods will throw exceptions if the constructed identifier is invalid. For improved interoperability with Vanilla, `Identifier` is made to implement `NamespacedIdentifier`. This means you can pass `Identifier` objects in places in OSL's APIs where `NamespacedIdentifier` is expected. ## Entrypoints 0.5.0 ### Custom Run Arguments The API for parsing custom run arguments has been unified across Minecraft versions as well as between the client and server. `JOptSimple` is now used everywhere. ## Keybinds 0.2.0 Minecraft versions below 1.3 are now supported. ## Lifecycle Events 0.6.0 ### Minecraft game instance Access to the `Minecraft` game instance is now provided through the `MinecraftInstance` class. An exception is thrown if the instance is not available (before initialization or after shutddown). ### Minecraft server instance Access to the `MinecraftServer` instance is now provided through the `MinecraftServerInstance` class. An exception is thrown if the instance is not available (before initialization or after shutddown). ## Networking 0.9.0 The Networking API has been overhauled to be more consistent across Minecraft versions. ### Custom payload channels In previous versions, OSL relied entirely on Vanilla's definitions of custom payload channels. This meant `String`s were used before 1.13 and `Identifier`s were used after 1.13. From this version on, the API uses `NamespacedIdentifier`s for channels, and OSL will handle the conversion internally. To create a channel, use the factory methods in `ChannelIdentifiers` and register it in `ChannelRegistry`. For example: ```Java NamespacedIdentifier COOKIE_CHANNEL = ChannelRegistry.register(ChannelIdentifiers.from("example", "cookie")) ``` ### Packet serialization In previous versions, OSL relied on serialization methods provided by Vanilla. This meant `DataInput` and `DataOutput` were used before 1.7, and `PacketByteBuf`, a wrapper around Netty's `ByteBuf`, were used after 1.7. From this version on, the API provides its own `ByteBuf` implementation: `PacketBuffer`. It contains many of the same convenience methods `PacketByteBuf` does, but is used for every Minecraft version supported by the Networking API. ### Packet listener context Packet listeners are no longer given direct access to the game instance, network handler, or player instance. Instead, a context is provided though which these can be accessed. The context is also used to control asynchronous packet handling. For example: ```java ServerPlayNetworking.register(CookiePayload.CHANNEL, CookiePayload::new, (ctx, payload) -> { // ensure following code is only executed from the main thread ctx.ensureOnMainThread(); // access the current server, network handler, and player through the context MinecraftServer server = ctx.server(); ServerPlayNetworkHandler networkHandler = ctx.networkHandler(); ServerPlayerEntity player = ctx.player(); }) ```

# Ornithe Standard Libraries 0.16.3 ## Fixes ### Lifecycle Events API - Fixes a crash in server versions prior to a0.2.0.

# Ornithe Standard Libraries 0.16.3 ## Fixes ### Lifecycle Events API - Fixes a crash in server versions prior to a0.2.0.

# Ornithe Standard Libraries 0.16.3 ## Fixes ### Lifecycle Events API - Fixes a crash in server versions prior to a0.2.0.

# Ornithe Standard Libraries 0.16.2 ## Fixes ### Lifecycle Events API - Fixes a crash in server versions prior to b1.2.

# Ornithe Standard Libraries 0.16.2 ## Fixes ### Lifecycle Events API - Fixes a crash in server versions prior to b1.2.

# Ornithe Standard Libraries 0.16.2 ## Fixes ### Lifecycle Events API - Fixes a crash in server versions prior to b1.2.

# Ornithe Standard Libraries 0.16.1 ## Fixes ### Resource Loader API - Fixes a bug in 17w43a and above that caused mod resources to be loaded incorrectly or not at all.

# Ornithe Standard Libraries 0.16.1 ## Fixes ### Resource Loader API - Fixes a bug in 17w43a and above that caused mod resources to be loaded incorrectly or not at all.

# Ornithe Standard Libraries 0.16.1 ## Fixes ### Resource Loader API - Fixes a bug in 17w43a and above that caused mod resources to be loaded incorrectly or not at all.

# Ornithe Standard Libraries 0.16.0 ## Additions ### Core API - New convenience methods for getting and setting registry mappings.

# Ornithe Standard Libraries 0.16.0 ## Additions ### Core API - New convenience methods for getting and setting registry mappings.

# Ornithe Standard Libraries 0.16.0 ## Additions ### Core API - New convenience methods for getting and setting registry mappings.

# Ornithe Standard Libraries 0.15.3 ## Fixes ### Config API - Crash in Beta versions due to the World config scope being destroyed upon game startup. ### Resource Loader API - Alternate language file formats are not loaded.

# Ornithe Standard Libraries 0.15.3 ## Fixes ### Config API - Crash in Beta versions due to the World config scope being destroyed upon game startup. ### Resource Loader API - Alternate language file formats are not loaded.

# Ornithe Standard Libraries 0.15.3 ## Fixes ### Config API - Crash in Beta versions due to the World config scope being destroyed upon game startup. ### Resource Loader API - Alternate language file formats are not loaded.

# Ornithe Standard Libraries 0.15.2 ## Fixes ### Resource Loader API - Crash due to missing mixin entry in 13w26a-1.10.2.

# Ornithe Standard Libraries 0.15.2 ## Fixes ### Resource Loader API - Crash due to missing mixin entry in 13w26a-1.10.2.

# Ornithe Standard Libraries 0.15.2 ## Fixes ### Resource Loader API - Crash due to missing mixin entry in 13w26a-1.10.2.

# Ornithe Standard Libraries 0.15.1 ## Fixes ### Config API - Crash due to NPE in 1.3-1.5.2. - Wrong mixin entry in 13w16a-1.6.4. ### Lifecycle Events API - b1.2_01 and b1.2_02 not supported due to wrong version range in mod.json. ### Resource Loader API - Crash due to NoSuchMethodError in 13w26a-14w21b.

# Ornithe Standard Libraries 0.15.1 ## Fixes ### Config API - Crash due to NPE in 1.3-1.5.2. - Wrong mixin entry in 13w16a-1.6.4. ### Lifecycle Events API - b1.2_01 and b1.2_02 not supported due to wrong version range in mod.json. ### Resource Loader API - Crash due to NoSuchMethodError in 13w26a-14w21b.

# Ornithe Standard Libraries 0.15.1 ## Fixes ### Config API - Crash due to NPE in 1.3-1.5.2. - Wrong mixin entry in 13w16a-1.6.4. ### Lifecycle Events API - b1.2_01 and b1.2_02 not supported due to wrong version range in mod.json. ### Resource Loader API - Crash due to NoSuchMethodError in 13w26a-14w21b.

# Ornithe Standard Libraries 0.15.0 ## Additions ### Config API - Expanded Minecraft version support to b1.3-b1.7.3, 1.3-1.13.2. - More option types for primitives: `byte`, `char`, `double`, `float`, `long`, `short`. - `ModifiableOption`: intended to be used for modifiable objects (e.g. lists). - `ListOption`: implementation of `ModifiableOption` for `List`s. - `MapOption`: implementation of `ModifiableOption` for `Map`s. ## Changes ### Config API Serialization has been refactored. With the introduction of object serializers, option serialization can be simplified as object serializers can be re-used for different option types. ## Fixes ### Networking API - Crash in b1.4 and below. - Inconsistent max channel lengths in Beta versions.

# Ornithe Standard Libraries 0.15.0 ## Additions ### Config API - Expanded Minecraft version support to b1.3-b1.7.3, 1.3-1.13.2. - More option types for primitives: `byte`, `char`, `double`, `float`, `long`, `short`. - `ModifiableOption`: intended to be used for modifiable objects (e.g. lists). - `ListOption`: implementation of `ModifiableOption` for `List`s. - `MapOption`: implementation of `ModifiableOption` for `Map`s. ## Changes ### Config API Serialization has been refactored. With the introduction of object serializers, option serialization can be simplified as object serializers can be re-used for different option types. ## Fixes ### Networking API - Crash in b1.4 and below. - Inconsistent max channel lengths in Beta versions.

# Ornithe Standard Libraries 0.15.0 ## Additions ### Config API - Expanded Minecraft version support to b1.3-b1.7.3, 1.3-1.13.2. - More option types for primitives: `byte`, `char`, `double`, `float`, `long`, `short`. - `ModifiableOption`: intended to be used for modifiable objects (e.g. lists). - `ListOption`: implementation of `ModifiableOption` for `List`s. - `MapOption`: implementation of `ModifiableOption` for `Map`s. ## Changes ### Config API Serialization has been refactored. With the introduction of object serializers, option serialization can be simplified as object serializers can be re-used for different option types. ## Fixes ### Networking API - Crash in b1.4 and below. - Inconsistent max channel lengths in Beta versions.

# Ornithe Standard Libraries 0.14.2 ## Fixes ### Branding Patch API - Incompatibility with the Lifecycle Events API in beta versions.

# Ornithe Standard Libraries 0.14.2 ## Fixes ### Branding Patch API - Incompatibility with the Lifecycle Events API in beta versions.

# Ornithe Standard Libraries 0.14.2 ## Fixes ### Branding Patch API - Incompatibility with the Lifecycle Events API in beta versions.

# Ornithe Standard Libraries 0.14.1 ## Fixes ### Branding Patch API - Invalid client entrypoint in the mod.json.

# Ornithe Standard Libraries 0.14.1 ## Fixes ### Branding Patch API - Invalid client entrypoint in the mod.json.

# Ornithe Standard Libraries 0.14.1 ## Fixes ### Branding Patch API - Invalid client entrypoint in the mod.json.

# Ornithe Standard Libraries 0.14.0 ## Changes ### Branding Patch API The Branding Patch now has an API, allowing mods to register custom components that modify the branding information displayed on the title screen and the debug overlay. Check out the [readme](https://github.com/OrnitheMC/ornithe-standard-libraries/blob/main/libraries/branding/README.md) for more information. ## Fixes ### Networking API - Passing `null` or 0 size data into a custom payload can result in a crash or a freeze. ### Resource Loader API - The checks for valid resource location namespaces and paths is too strict and incompatible with Vanilla in MC 1.6-1.12.

# Ornithe Standard Libraries 0.14.0 ## Changes ### Branding Patch API The Branding Patch now has an API, allowing mods to register custom components that modify the branding information displayed on the title screen and the debug overlay. Check out the [readme](https://github.com/OrnitheMC/ornithe-standard-libraries/blob/main/libraries/branding/README.md) for more information. ## Fixes ### Networking API - Passing `null` or 0 size data into a custom payload can result in a crash or a freeze. ### Resource Loader API - The checks for valid resource location namespaces and paths is too strict and incompatible with Vanilla in MC 1.6-1.12.

# Ornithe Standard Libraries 0.14.0 ## Changes ### Branding Patch API The Branding Patch now has an API, allowing mods to register custom components that modify the branding information displayed on the title screen and the debug overlay. Check out the [readme](https://github.com/OrnitheMC/ornithe-standard-libraries/blob/main/libraries/branding/README.md) for more information. ## Fixes ### Networking API - Passing `null` or 0 size data into a custom payload can result in a crash or a freeze. ### Resource Loader API - The checks for valid resource location namespaces and paths is too strict and incompatible with Vanilla in MC 1.6-1.12.

# Ornithe Standard Libraries 0.13.3 ## Fixes ### Resource Loader API - Since v0.13.0, translations do not load in 1.5.2 and below.

# Ornithe Standard Libraries 0.13.3 ## Fixes ### Resource Loader API - Since v0.13.0, translations do not load in 1.5.2 and below.

# Ornithe Standard Libraries 0.13.3 ## Fixes ### Resource Loader API - Since v0.13.0, translations do not load in 1.5.2 and below.

# Ornithe Standard Libraries 0.13.2 ## Fixes ### Resource Loader API - Crash in 13w26a and above.

# Ornithe Standard Libraries 0.13.2 ## Fixes ### Resource Loader API - Crash in 13w26a and above.

# Ornithe Standard Libraries 0.13.2 ## Fixes ### Resource Loader API - Crash in 13w26a and above.

# Ornithe Standard Libraries 0.13.1 ## Fixes ### Resource Loader API - Crash in 1.5.2 and below.

# Ornithe Standard Libraries 0.13.1 ## Fixes ### Resource Loader API - Crash in 1.5.2 and below.

# Ornithe Standard Libraries 0.13.1 ## Fixes ### Resource Loader API - Crash in 1.5.2 and below.

# Ornithe Standard Libraries 0.13.0 ## Changes ### Resource Loader API - Language files can now be loaded as `.json` files in 1.12 and below. - Language files can now be loaded as `.lang` files in 1.13 and above. ## Fixes ### Resource Loader API - Crash in 1.13 and 1.14.

# Ornithe Standard Libraries 0.13.0 ## Changes ### Resource Loader API - Language files can now be loaded as `.json` files in 1.12 and below. - Language files can now be loaded as `.lang` files in 1.13 and above. ## Fixes ### Resource Loader API - Crash in 1.13 and 1.14.

# Ornithe Standard Libraries 0.13.0 ## Changes ### Resource Loader API - Language files can now be loaded as `.json` files in 1.12 and below. - Language files can now be loaded as `.lang` files in 1.13 and above. ## Fixes ### Resource Loader API - Crash in 1.13 and 1.14.

# Ornithe Standard Libraries 0.12.1 ## Fixes ### Resource Loader API - In 1.5 and below, Resource Loader uses absolute paths instead of paths relative to the mod root.

# Ornithe Standard Libraries 0.12.1 ## Fixes ### Resource Loader API - In 1.5 and below, Resource Loader uses absolute paths instead of paths relative to the mod root.

# Ornithe Standard Libraries 0.12.1 ## Fixes ### Resource Loader API - In 1.5 and below, Resource Loader uses absolute paths instead of paths relative to the mod root.

# Ornithe Standard Libraries 0.12.0 ## Fixes ### Resource Loader API - In 1.5 and below, Vanilla translations are broken if any mod translations are present.

# Ornithe Standard Libraries 0.12.0 ## Fixes ### Resource Loader API - In 1.5 and below, Vanilla translations are broken if any mod translations are present.

# Ornithe Standard Libraries 0.12.0 ## Fixes ### Resource Loader API - In 1.5 and below, Vanilla translations are broken if any mod translations are present.

# Ornithe Standard Libraries 0.11.3 ## Fixes ### Resource Loader API - Crash upon start-up in 13w07a and below.

# Ornithe Standard Libraries 0.11.3 ## Fixes ### Resource Loader API - Crash upon start-up in 13w07a and below.

# Ornithe Standard Libraries 0.11.3 ## Fixes ### Resource Loader API - Crash upon start-up in 13w07a and below.

# Ornithe Standard Libraries 0.11.2 ## Changes ### Networking API - Improved logging in Networking implementations. ### Resource Loader API - Expanded Minecraft version support to a1.2.2-1.13.2 (was 13w24a-1.13.2).

# Ornithe Standard Libraries 0.11.2 ## Changes ### Networking API - Improved logging in Networking implementations. ### Resource Loader API - Expanded Minecraft version support to a1.2.2-1.13.2 (was 13w24a-1.13.2).

# Ornithe Standard Libraries 0.11.2 ## Changes ### Networking API - Improved logging in Networking implementations. ### Resource Loader API - Expanded Minecraft version support to a1.2.2-1.13.2 (was 13w24a-1.13.2).

# Ornithe Standard Libraries 0.11.1 ## Changes ### Keybinds API - Expanded Minecraft version support to 1.3.1-1.14.4 (was 1.3.1-1.13.2).

# Ornithe Standard Libraries 0.11.1 ## Changes ### Keybinds API - Expanded Minecraft version support to 1.3.1-1.14.4 (was 1.3.1-1.13.2).

# Ornithe Standard Libraries 0.11.1 ## Changes ### Keybinds API - Expanded Minecraft version support to 1.3.1-1.14.4 (was 1.3.1-1.13.2).

# Ornithe Standard Libraries 0.11.0 ## Changes ### Core API - Expanded the events system. ### Branding Patch - Fixed crash. ### Entrypoints API - Expanded Minecraft version support to a1.0.6-1.14.4 (was a1.0.6-1.13.2). ### Lifecycle Events API - Expanded Minecraft version support to a1.0.6-1.14.4 (was a1.0.6-1.13.2). ### Networking API - Expanded Minecraft version support to b1.0-1.14.4 (was b1.0-1.13.2). ### Resource Loader API - Expanded Minecraft version support to 13w26a-1.14.4 (was 13w26a-1.13.2).

# Ornithe Standard Libraries 0.11.0 ## Changes ### Core API - Expanded the events system. ### Branding Patch - Fixed crash. ### Entrypoints API - Expanded Minecraft version support to a1.0.6-1.14.4 (was a1.0.6-1.13.2). ### Lifecycle Events API - Expanded Minecraft version support to a1.0.6-1.14.4 (was a1.0.6-1.13.2). ### Networking API - Expanded Minecraft version support to b1.0-1.14.4 (was b1.0-1.13.2). ### Resource Loader API - Expanded Minecraft version support to 13w26a-1.14.4 (was 13w26a-1.13.2).

# Ornithe Standard Libraries 0.11.0 ## Changes ### Core API - Expanded the events system. ### Branding Patch - Fixed crash. ### Entrypoints API - Expanded Minecraft version support to a1.0.6-1.14.4 (was a1.0.6-1.13.2). ### Lifecycle Events API - Expanded Minecraft version support to a1.0.6-1.14.4 (was a1.0.6-1.13.2). ### Networking API - Expanded Minecraft version support to b1.0-1.14.4 (was b1.0-1.13.2). ### Resource Loader API - Expanded Minecraft version support to 13w26a-1.14.4 (was 13w26a-1.13.2).

# Ornithe Standard Libraries 0.10.4 ## Changes ### Entrypoints API - Updated for compatibility with Fabric Loader 0.14.23/Quilt Loader 0.21. ### Networking API - Fixed crash in Minecraft 1.2.5 clients. ### Resource Loader API - Fixed crash on dedicated servers in 1.13.2.

# Ornithe Standard Libraries 0.10.4 ## Changes ### Entrypoints API - Updated for compatibility with Fabric Loader 0.14.23/Quilt Loader 0.21. ### Networking API - Fixed crash in Minecraft 1.2.5 clients. ### Resource Loader API - Fixed crash on dedicated servers in 1.13.2.

# Ornithe Standard Libraries 0.10.4 ## Changes ### Entrypoints API - Updated for compatibility with Fabric Loader 0.14.23/Quilt Loader 0.21. ### Networking API - Fixed crash in Minecraft 1.2.5 clients. ### Resource Loader API - Fixed crash on dedicated servers in 1.13.2.

# Ornithe Standard Libraries 0.10.3 ## Changes ### Keybinds API - Fixed incorrect location for mod icon. ### Resource Loader API - Fixed broken resource loader.

# Ornithe Standard Libraries 0.10.3 ## Changes ### Keybinds API - Fixed incorrect location for mod icon. ### Resource Loader API - Fixed broken resource loader.

# Ornithe Standard Libraries 0.10.3 ## Changes ### Keybinds API - Fixed incorrect location for mod icon. ### Resource Loader API - Fixed broken resource loader.

# Ornithe Standard Libraries 0.10.2 ## Changes ### Networking API - Fixed a crash on dedicated servers in Minecraft versions between b1.0 and 12w16a.

# Ornithe Standard Libraries 0.10.2 ## Changes ### Networking API - Fixed a crash on dedicated servers in Minecraft versions between b1.0 and 12w16a.

# Ornithe Standard Libraries 0.10.2 ## Changes ### Networking API - Fixed a crash on dedicated servers in Minecraft versions between b1.0 and 12w16a.

# Ornithe Standard Libraries 0.10.1 ## Changes ### Lifecycle Events API - Fixed bugs and crashes caused by the server `STOP` event not being fired on integrated servers.

# Ornithe Standard Libraries 0.10.1 ## Changes ### Lifecycle Events API - Fixed bugs and crashes caused by the server `STOP` event not being fired on integrated servers.

# Ornithe Standard Libraries 0.10.1 ## Changes ### Lifecycle Events API - Fixed bugs and crashes caused by the server `STOP` event not being fired on integrated servers.

# Ornithe Standard Libraries 0.10.0 ## Changes ### Networking API - Data can now be wrapped in custom payload objects. Check out the [readme](https://github.com/OrnitheMC/ornithe-standard-libraries/blob/main/libraries/networking/README.md) for more information. - Expanded Minecraft version support to b1.0-1.13.2 (was 1.3-1.13.2). ### Resource Loader API - Fixed namespace detection in built-in mod resource packs. - Fixed a crash when attempting to load the icon of built-in mod resource packs. - Built-in mod packs now load the default pack icon if the mod does not provide its own icon. - Expanded Minecraft version support to 13w26a-1.13.2 (was 13w26a-1.12.2).

# Ornithe Standard Libraries 0.10.0 ## Changes ### Networking API - Data can now be wrapped in custom payload objects. Check out the [readme](https://github.com/OrnitheMC/ornithe-standard-libraries/blob/main/libraries/networking/README.md) for more information. - Expanded Minecraft version support to b1.0-1.13.2 (was 1.3-1.13.2). ### Resource Loader API - Fixed namespace detection in built-in mod resource packs. - Fixed a crash when attempting to load the icon of built-in mod resource packs. - Built-in mod packs now load the default pack icon if the mod does not provide its own icon. - Expanded Minecraft version support to 13w26a-1.13.2 (was 13w26a-1.12.2).

# Ornithe Standard Libraries 0.10.0 ## Changes ### Networking API - Data can now be wrapped in custom payload objects. Check out the [readme](https://github.com/OrnitheMC/ornithe-standard-libraries/blob/main/libraries/networking/README.md) for more information. - Expanded Minecraft version support to b1.0-1.13.2 (was 1.3-1.13.2). ### Resource Loader API - Fixed namespace detection in built-in mod resource packs. - Fixed a crash when attempting to load the icon of built-in mod resource packs. - Built-in mod packs now load the default pack icon if the mod does not provide its own icon. - Expanded Minecraft version support to 13w26a-1.13.2 (was 13w26a-1.12.2).

# Ornithe Standard Libraries 0.9.0 ## Additions ### Keybinds API The Keybinds API provides events for registering keybinds. ## Changes ### Config API - Fixed crash upon game start in 1.3-1.5. ### Networking API - Added `PLAY_READY` events that fire after channel registration is complete and data can safely be sent over the connection. - This remedies issues where data sent during the `LOGIN` events quietly fails to go through. If you need to send data upon login, use the `PLAY_READY` event instead!

# Ornithe Standard Libraries 0.9.0 ## Additions ### Keybinds API The Keybinds API provides events for registering keybinds. ## Changes ### Config API - Fixed crash upon game start in 1.3-1.5. ### Networking API - Added `PLAY_READY` events that fire after channel registration is complete and data can safely be sent over the connection. - This remedies issues where data sent during the `LOGIN` events quietly fails to go through. If you need to send data upon login, use the `PLAY_READY` event instead!

# Ornithe Standard Libraries 0.9.0 ## Additions ### Keybinds API The Keybinds API provides events for registering keybinds. ## Changes ### Config API - Fixed crash upon game start in 1.3-1.5. ### Networking API - Added `PLAY_READY` events that fire after channel registration is complete and data can safely be sent over the connection. - This remedies issues where data sent during the `LOGIN` events quietly fails to go through. If you need to send data upon login, use the `PLAY_READY` event instead!

# Ornithe Standard Libraries 0.8.0 ## Changes ### Branding Patch - Expanded Minecraft version support to a1.2.2-1.13.2 (was 1.3-1.13.2). ### Entrypoints API - Fixed client-side entrypoints silently failing in Minecraft 1.5.2 and below. - Expanded Minecraft version support to a1.0.6-1.13.2 (was 1.3-1.13.2). ### Lifecycle Events API - Expanded Minecraft version support to a1.0.6-1.13.2 (was 1.3-1.13.2).

# Ornithe Standard Libraries 0.8.0 ## Changes ### Branding Patch - Expanded Minecraft version support to a1.2.2-1.13.2 (was 1.3-1.13.2). ### Entrypoints API - Fixed client-side entrypoints silently failing in Minecraft 1.5.2 and below. - Expanded Minecraft version support to a1.0.6-1.13.2 (was 1.3-1.13.2). ### Lifecycle Events API - Expanded Minecraft version support to a1.0.6-1.13.2 (was 1.3-1.13.2).

# Ornithe Standard Libraries 0.8.0 ## Changes ### Branding Patch - Expanded Minecraft version support to a1.2.2-1.13.2 (was 1.3-1.13.2). ### Entrypoints API - Fixed client-side entrypoints silently failing in Minecraft 1.5.2 and below. - Expanded Minecraft version support to a1.0.6-1.13.2 (was 1.3-1.13.2). ### Lifecycle Events API - Expanded Minecraft version support to a1.0.6-1.13.2 (was 1.3-1.13.2).

# Ornithe Standard Libraries 0.7.0 ## Changes ### Entrypoints API - The `PARSE_RUN_ARGS` event has been moved forward to improve stability. It is now invoked immediately after entrypoints.

# Ornithe Standard Libraries 0.6.0 ## Changes OSL is now packaged as a Fabric mod and thus can run on both Fabric Loader and Quilt Loader. ### Branding Patch - Fixed crashes in Minecraft versions 1.7.9 through 1.7.10. ### Networking API - Fixed crash in Minecraft ~1.6. ### Resource Loader API - Fixed crash in Minecraft ~1.6.

# Ornithe Standard Libraries 0.5.0 ## Changes ### Config - Added path option. - Expanded Minecraft version support to 1.3-1.13.2 (was 14w02a-1.13.2). ### Lifecycle Events - Fixed server `stop` event being called twice on dedicated servers. - Expanded Minecraft version support to 1.3-1.13.2 (was 13w16a-1.13.2). ### Networking - Expanded Minecraft version support to 1.3-1.13.2 (was 13w41a-1.13-pre2).

# Ornithe Standard Libraries 0.4.1 ## Changes ### Networking API - Fixed crash on game start up.

# Ornithe Standard Libraries 0.4.0 ## Changes ### Lifecycle Events API - The server world `load` and `ready` events have been replaced by a single `init` event.

# Ornithe Standard Libraries 0.3.3 ## Changes ### Entrypoints API - Fixed a crash on dedicated servers.

# Ornithe Standard Libraries 0.3.2 There was an issue with v0.3.1 and it did not have the fixes we said it did, so here's v0.3.2 which has the fixes for real this time. ## Changes ### Lifecycle Events API - Fixed a crash on dedicated servers.

# Ornithe Standard Libraries 0.3.1 ## Changes ### Lifecycle Events API - Fixed a crash on dedicated servers.

# Ornithe Standard Libraries 0.3.0 ## Changes ### Networking API - Fixed compatibility with Minecraft 14w30c and below. - In 14w30c and below, you can now send and receive data directly through `byte[]` in addition to `PacketByteBuf`. - Async listeners have been removed for Minecraft 14w20b and below.

# Ornithe Standard Libraries 0.2.0 ## Additions ### Networking API The Networking API provides a framework for client-server communication. ## Changes ### Config API - The network serializers now serializer to/from `PacketByteBuf`s (used to be NBT). - Added NBT serializers.

# Ornithe Standard Libraries 0.1.0 Ornithe Standard Libraries (OSL) provides tools for modding with Ornithe. NOTE: OSL is still WIP, and each module could see significant changes before the first full release. ## Libraries ### Core API The Core API provides common utilities used by other modules, such as an events system and registries. ### Branding Patch This module patches the title screen with mod loader information in 16w05a and below, emulating what you would see in 16w05b and above. This is done by parsing the run args for the `versionType` option. ### Config API The Config API provides a framework for building and storing mod configs. ### Entrypoints API The Entrypoints API allows mod developers to submit entrypoints that are called before the game is initialized. ### Lifecycle Events API The Lifecycle Events API provides events to track the lifecycle of the Minecraft client and server. ### Resource Loader API The Resource Loader API allows mods to load their own resources into the game. ## Information for developers While we are planning to add utilities for OSL dependencies to Ploceus, in the meantime developers can manually declare dependencies on individual modules. You can check out our [maven](https://maven.ornithemc.net/#/releases/net/ornithemc/osl) for the latest available versions. Take note of the Minecraft version range and select the release that is compatible with your project. An example is given below: ```groovy dependencies { modImplementation 'net.ornithemc.osl:core:0.1.0' modImplementation 'net.ornithemc.osl:entrypoints:0.1.0+13w16a-04192037#1.13.2' } ```